Datadog MCP Server で BYOC Logs をクエリする

This product is not supported for your selected Datadog site. ().

概要

Datadog MCP (Model Context Protocol) Server の search_datadog_logs ツールを使用して、BYOC (Bring Your Own Cloud) Logs インデックスに保存されたログをクエリします。このツールには、AI を活用したツールやインテグレーションを通じてアクセスできます。

注: BYOC Logs インデックスは search_datadog_logs でのみサポートされています。analyze_datadog_logs ツールと datadog/querying-patterns スキルは、BYOC Logs インデックスに対応していません。

前提条件

BYOC Logs のクエリ

BYOC Logs インデックスに保存されたログをクエリするには、search_datadog_logs を使用し、標準のログクエリに加えて BYOC Logs インデックス名を指定します。

最良の結果を得るために、プロンプトには以下も含めることをお勧めします。

  • (推奨) タイムレンジ (例: “過去 1 時間”、“過去 24 時間”)。
  • (推奨) クエリフィルター (サービス、ステータス、ログ内容)。

クエリパラメーター

次のテーブルは、search_datadog_logs で使用される主要パラメーターについて説明しています。

パラメーター説明例
queryDatadog クエリ構文を使用したログ検索クエリ"*" (すべてのログ)、"service:web"、"status:error"
indexes検索する BYOC Logs インデックス名の配列["byoc--dev--main"]
fromクエリの開始時刻"now-1h"、"now-24h"、"2024-01-15T00:00:00Z"
toクエリの終了時刻"now"、"2024-01-15T23:59:59Z"
sort結果の並べ替え順序"-timestamp" (降順)、"timestamp" (昇順)

パラメーターと自然言語クエリの例については、高度なクエリの例を参照してください。

BYOC Logs インデックス名の確認

BYOC Logs インデックス名を確認するには、以下の手順を実行します。

  1. Datadog ログエクスプローラーに移動します。
  2. 左側のファセットパネルで BYOC INDEXES セクションを探します。
  3. BYOC Logs インデックスが byoc--<cluster_name>--<index_name> の形式でリストされています。

クラスターを選択し、View Indexes をクリックすると、BYOC Logs コンソールでもインデックス名を見つけることができます。

高度なクエリの例

search_datadog_logs で AI 搭載ツールを使用する場合、自然言語で質問できます。このツールは、質問を適切なフォーマットの BYOC Logs クエリに変換します。

特定のサービスからのエラーログ

プロンプト: “過去 1 時間以内に byoc–dev–main インデックス内の nginx サービスから出力されたエラーログを表示してください。”

次のように変換されます。

{
  "query": "service:nginx status:error",
  "indexes": ["byoc--dev--main"],
  "from": "now-1h",
  "to": "now"
}

特定のログ内容を検索する

プロンプト: “過去 24 時間以内に byoc–prod–main の API サービスから出力されたログのうち、‘connection timeout’ を含むものを見つけてください。”

次のように変換されます。

{
  "query": "service:api \"connection timeout\"",
  "indexes": ["byoc--prod--main"],
  "from": "now-24h",
  "to": "now"
}

HTTP ステータスコードでフィルタリングする

プロンプト: “過去 24 時間以内に byoc–prod–main インデックスから出力されたログのうち、500 ステータスコードが記録されているものをすべて取得してください。”

次のように変換されます。

{
  "query": "status:500",
  "indexes": ["byoc--prod--main"],
  "from": "now-1d",
  "to": "now"
}

重要な注意事項

  • indexes パラメーターには、有効な BYOC Logs インデックス名 (byoc--<cluster_name>--<index_name> 形式) を含める必要があります。
  • 自然言語クエリを使用する際は、プロンプトに BYOC Logs インデックス名を明示的に記載してください。
  • BYOC Logs データは、インデックス化されるとすぐにリアルタイムでクエリできるようになります。
  • クエリ構文は標準の Datadog ログ検索構文に従います。

参考資料