可観測性MCPサーバー

GitLab可観測性は、Model Context Protocol（MCP）サーバーを提供するため、AIアシスタントやエージェントから自然言語を使用して可観測性データをクエリできます。

接続後、MCP対応クライアントはテレメトリーに関する質問を行い、独自のデータに基づいた回答を得ることができます。サポートされているクライアントには、Cursor、Claude（Claude CodeおよびClaude Desktop）、VS Code、Codexがあります。例:

• 過去1時間で最もエラー率が高いサービスはどれですか？
• チェックアウトサービスのエラーログを表示してください。
• 今日の支払いサービスのp99レイテンシーは何ですか？
• データを報告しているサービスを一覧表示します。

MCPサーバーは、GitLab可観測性インスタンス内のメトリクス、トレース、ログ、アラート、ダッシュボード、およびサービスをクエリできます。

前提条件

• グループまたは個人プロジェクトで可観測性を有効にする必要があります。セットアップ手順については、GitLab.comでの可観測性のセットアップを参照してください。
• グループの場合、デベロッパー、メンテナー、またはオーナーのロールが必要です。個人プロジェクトの場合、オーナーのロールが必要です。
• リモートHTTPサーバーをサポートするMCPクライアントが必要です。

APIキーを取得する

MCPサーバーは独自の認証情報を持ちません。各ユーザーは、自身のGitLab可観測性APIキーで認証し、そのAPIキーはMCPクライアントがすべてのリクエストで送信します。アクセスは、そのキーが表示を許可されている範囲にスコープされます。

APIキーを作成するには:

1. トップバーで検索または移動先を選択し、グループまたは個人プロジェクトを検索します。
2. 左側のサイドバーで監視 > API Keysを選択します。
3. キーを作成してコピーします。

MCPエンドポイントを取得する

1. トップバーで検索または移動先を選択し、グループまたは個人プロジェクトを検索します。
2. 左側のサイドバーで監視 > セットアップを選択します。
3. MCPサーバーセクションで、MCPエンドポイントをコピーします。

MCPエンドポイントは以下のパターンに従います:

https://<namespace_id>.mcp.gitlab-o11y.com/mcp

<namespace_id>を、可観測性を有効にしたネームスペースのIDに置き換えます。ネームスペースIDは、グループID、または個人プロジェクトで可観測性を有効にした場合の個人ネームスペースIDです。

クライアントを接続する

1. コピーしたエンドポイントを使用して、MCPサーバーを新しいリモートHTTP MCPサーバーとしてクライアントに追加します。
2. クライアントから認証を求められたら、作成したAPIキーを入力します。クライアントは、それをSIGNOZ-API-KEYヘッダーとして送信します。
3. クライアントで接続を確認します。例えば、利用可能なMCPツールを一覧表示し、可観測性データについて質問を開始します。

利用可能なツール

MCPサーバーは、可観測性データの読み取りと探索のためのツールを公開しており、以下が含まれます:

• メトリクス: 一覧表示とクエリ
• ログ: 検索と集約
• トレース: 個々のトレースとスパンの検索と検査
• サービス: トップオペレーションの一覧表示と表示
• アラート: アラートルールの一覧表示と検査
• ダッシュボード: ダッシュボードと保存されたビューの一覧表示と検査

AIアシスタントは、質問に答えるための適切なツールを選択し、インスタンスのデータから得られた結果を返します。

関連トピック

• 可観測性APIにアクセスする
• GitLab可観測性にテレメトリデータを送信する
• 可観測性のトラブルシューティング