概要
CLS Skillは、Tencent Cloud CLS（Cloud Log Service、略称CLS）の公式スキルパックであり、WorkBuddyなどのインテリジェントコラボレーションツール向けに構築されています。インストール後、ユーザーはCLSコンソールにログインすることなく、自然言語でログ検索、リソース管理、指標クエリ、アラート運用保守などの全プロセス操作を直接完了できます。
核心価値：
自然言語による対話、構文の敷居はゼロ：CQLやPromQLなどの専門的なクエリ構文を学ぶ必要がなく、日常言語で要件を記述するだけで、ログの検索、指標の照会、アラートの設定を正確に行うことができ、ログ分析の学習コストと操作の複雑さを大幅に削減できます。
没入型ワークベンチ、コンソール切り替えとはお別れ：WorkBuddyなどのツール内でログのライフサイクル全体をワンストップで管理でき、問題調査時にCLSコンソールの複数ページ間を繰り返し移動する必要がなく、集中力を維持し、障害対応の一貫性を向上させます。
複数ターンのコンテキストインタラクションによる問題の正確な特定：対話コンテキストに基づく連続分析をサポートします。例えば、最初にエラーログを照会し、次にエラー分布の傾向を分析し、最後に主要ログのコンテキスト詳細を展開して、根本原因を特定するまで段階的にドリルダウンします。
並行診断能力、全リンクでの迅速な調査：収集リンクの調査などの複雑なシナリオにおいて、マシングループの状態、Agentの稼働状況、収集設定およびバインディング関係を同時に確認でき、多次元で並行診断を行い、障害特定時間を短縮します。
CLS Skillは以下の機能を提供します：
|
ログ検索・分析 | キーワード検索 | 全文検索、キーバリュー検索、あいまい一致、範囲クエリなど、複数の検索方法をサポートし、目的のログを迅速に特定します。 |
| コンテキスト表示 | 任意のログの前後N件のレコードを表示し、問題発生時の完全なコンテキストを復元します。 |
| 統計分析 | SQL集計分析（GROUP BY、ORDER BY、LIMITなど）をサポートし、大量のログに対してグループ統計と傾向分析を実行します。 |
リソース管理 | ログトピック管理 | 名前、ID、タグ、ストレージタイプなどの条件でログトピックを検索して表示します。 |
| ログセット管理 | ログセットを検索して表示し、ログリソースの組織階層を把握します。 |
| インデックス管理 | インデックス設定情報を表示し、インデックス再構築タスクのステータスと進捗を追跡します。 |
マシングループと収集 | マシングループ管理 | マシングループのリストとメンバーステータス（オンライン/オフライン）を表示し、IP、OS、バージョンなどの条件でフィルタリングできます。 |
| 収集設定 | 収集ルール設定を表示し、収集設定とマシングループのバインディング関係を確認します。 |
指標クエリ | 指標タグクエリ | 指標のタグディメンションを表示し、マッチングルールによるフィルタリングをサポートします。 |
| PromQLクエリ | PromQL構文を使用して指標データに対して範囲クエリを実行し、Prometheusエコシステムと互換性があります。 |
アラート運用保守 | アラートポリシー管理 | アラートポリシーリストを表示し、名前、ステータスなどの条件でフィルタリングできます。 |
| アラート履歴 | アラートの発生と回復の記録を表示し、アラートレベル（警告/注意/緊急）や回復ステータスでフィルタリングできます。 |
| 実行詳細 | アラートポリシーの実行ログを詳細に表示し、アラート発生原因を分析します。 |
| ブロックルール | アラート屏蔽設定を表示し、アラートが静默化されているかどうかを確認します。 |
前提条件
サービス開通
クイックスタートを参照して、アカウント登録を完了し、Tencent Cloud CLSを有効にします。 キーの取得
注意：
SecretKeyは機密情報に該当します。適切に保管し、AIとの対話で直接送信しないでください。
サブアカウントを使用する場合、サブアカウントにCLS関連のCAM権限が付与されていることを確認する必要があります。最小権限ポリシーは以下を参照してください：
ログ検索：QcloudCLSReadOnlyAccess
ログ検索＋管理操作：QcloudCLSFullAccess
より細かい粒度で制御する必要がある場合は、CLS CAM認証のカスタムポリシーを参照してください。 Skillのインストール
方法1：WorkBuddyでインストール
1. WorkBuddyクライアントを開き、左側で専門家・スキル・リンカーを選択し、管理ページに入ります。
2. スキルマーケットで Tencent Cloud CLSを検索します。
3. インストールをクリックし、完了まで待ちます。会話で「Tencent Cloud CLSスキルをインストールしてください」と直接入力することもできます。
方法2：SkillHubでインストール
WorkBuddy以外のAIツールユーザー向けです。以下の内容をAIチャットウィンドウにコピーすると、インストールできます：
https://skillhub.cn/install/skillhub.mdに従って、tencentcloud-clsをインストールしてください。
認証情報の設定
インストール完了後、CLS Skillを正常に使用するには、SecretIdとSecretKeyを設定する必要があります。AIのプロンプトに従って、または以下の方法でSecretIdとSecretKeyをシステムの環境変数に設定してください。
macOS / Linux 設定ガイド
まずターミナルで以下のコマンドを実行し、ご利用のシェルタイプを確認してください：
/bin/zshが出力された場合は、以下のコマンドを実行してキーを~/.zshrcに書き込み、すぐに反映させてください：
# 1. 環境変数を~/.zshrcに追記します。
echo 'export TENCENTCLOUD_SECRET_ID="お客様のSecretId"' >> ~/.zshrc
echo 'export TENCENTCLOUD_SECRET_KEY="お客様のSecretKey"' >> ~/.zshrc
# 2. 現在のターミナルで設定をすぐに反映させます。
source ~/.zshrc
/bin/bashが出力された場合は、以下のコマンドを実行してキーを~/.bashrcに書き込み、すぐに反映させてください：
# 1. 環境変数を~/.bashrcに追記します。
echo 'export TENCENTCLOUD_SECRET_ID="お客様のSecretId"' >> ~/.bashrc
echo 'export TENCENTCLOUD_SECRET_KEY="お客様のSecretKey"' >> ~/.bashrc
# 2. 現在のターミナルで設定をすぐに反映させます。
source ~/.bashrc
Windows 設定ガイド
以下のコマンドを実行してキーをシステム環境変数に書き込んでください。注意：設定は新しく開いたターミナルウィンドウにのみ反映されます。変更を適用するには、ターミナルまたはAIツールを再起動してください。
setx TENCENTCLOUD_SECRET_ID "お客様のSecretId"
setx TENCENTCLOUD_SECRET_KEY "お客様のSecretKey"
インストールの検証
対話の中で「すべてのリージョンのログトピックをリストしてください」と入力します。ログトピックリスト（空のリストを含む）が返された場合、インストールは成功です。
注意：
アカウントにログトピックが1つもない場合、空のリストが返されても成功とみなされます。ご不明な点がある場合は、「広州地域のログトピックを表示」と入力してさらに検証してください。
利用ガイド
設定が完了したら、対話ウィンドウで自然言語を使用して直接ご要望を記述してください。要望を記述する際は、以下の要素を含めることをお勧めします。具体的であるほど、結果はより正確になります：
|
① 地域 | 広州/上海/北京など | 広州 |
② 対象 | トピック名/サービス名/ログタイプ | payment-topic |
③ 時間範囲 | 直近1時間/今日/直近7日間 | 直近1時間 |
④ 何をするか | エラー検索/統計分析/コンテキスト検索 | エラーログ |
「広州地域で、payment-topic の直近1時間のエラーログを調べて、各種エラーの件数を統計してください」
あいまいな質問の例：「広州にあるログ付きトピックで、最近エラーが発生したかどうかを確認してください」
説明：
あいまいな質問の場合、まず該当地域のすべてのトピックをリストし、その後、最近のエラーログを1つずつチェックします。
シナリオ実践
シナリオ1：30秒でエラーログを検索</pre>
オンラインで突然エラーが発生した場合、何が問題なのか、いつから始まったのか、影響範囲がどの程度なのかを迅速に特定します。
|
基本検索 | 広州地域のdefault-topicトピックの本日午後6時時点のエラーログを検索します。 |
フィルタ条件を追加 | payment-serviceのタイムアウトエラーのみ、直近30分のものを表示します。 |
ステータスコードでフィルタリング | statusCodeが500のリクエストをすべて検索し、時間の降順で並べ替えます。 |
適用シーン：朝会前に昨夜のエラーを確認する場合、アラート受信後に問題を特定する場合、スケジュールの振り返り時に履歴エラーデータを取得する場合。
シナリオ2：エラー分布の詳細分析</pre>
エラーリストを表示するだけでなく、サービス、エラーコード、時間のディメンションで統計分析を行うこともできます。
|
サービス別にグループ化して集計します | 各種エラーの件数をサービス別に集計します。 |
エラー分類TOP N | エラーコード別にグループ化して集計し、TOP 10のみを表示します。 |
時間トレンド | 1時間ごとのエラー率変化曲線、直近24時間。 |
多次元クロス分析 | サービスとエラーレベルという2つのディメンションでクロス集計します。 |
シナリオ3：ワンクリックでログのコンテキストを表示</pre>
重要なエラーログを1件見つけた後、エラー発生前後に何が起こったかを確認できます。時間範囲を手動で調整してページをめくって検索する必要はありません。
|
コンテキストを表示します。 | このDB_CONNECTION_TIMEOUTログのコンテキストを前後各2件展開します。 |
対象ログを中心とした前後のログを返し、連鎖障害の経路を復元するために使用します。
シナリオ4：収集経路の迅速なトラブルシューティング</pre>
ログが未収集の場合、1台ずつSSHでマシンにログインして調査する必要はなく、1つのコマンドで診断を完了できます。
|
ワンクリックで収集リンクを診断します。 | このトピックに対応するマシングループと収集設定を確認してください。 |
自動並行チェック：マシングループリスト → 各マシンのAgentオンライン状態 → 収集設定 → 設定バインディング関係を確認し、完全な診断結果を出力します。
料金説明
CLS Skill自体は無料で使用できるAIスキルパックであり、追加費用は発生しません。ただし、Skillを通じて使用するCLSサービスは実際の使用量に応じて費用が発生します。課金の詳細についてはCLS課金概要をご覧ください。 よくあるご質問
キー設定後にSkillが認証失敗を報告する場合？
1. 環境変数名のスペルが正しいことを確認してください：TENCENTCLOUD_SECRET_IDおよびTENCENTCLOUD_SECRET_KEY。
2. 設定を確認した後、端末またはAIツールを再起動しました。
クエリが空の結果を返す場合？
1. ログトピック名が正しいこと、およびリージョンが一致していることを確認してください。
2. 指定された時間範囲内に実際にログが書き込まれていることを確認します。
3. トピックで全文インデックスまたはキー値インデックスが有効になっていることを確認してください（有効でない場合、検索できません）。
SubUser サブアカウントで権限エラーが発生する場合？
サブアカウントに少なくともQcloudCLSReadOnlyAccessポリシーがバインドされていることを確認してください。管理操作を実行する必要がある場合は、QcloudCLSFullAccessが必要です。
クエリがタイムアウトするか、応答が遅い場合？
時間範囲を狭めるか、フィルター条件を追加します。