Datadog メトリクスと OpenTelemetry メトリクスを合わせてクエリする

多くの組織は Datadog と併用して OpenTelemetry (OTel) を使用しており、一部のホストが OTel メトリクスを生成して他のホストが Datadog メトリクスを生成するハイブリッド環境を構築しています。OTel および Datadog メトリクスは異なる命名規則やセマンティック定義を使用することが多いため、これらの環境においてインフラストラクチャーの統合ビューを作成するのは困難です。

Datadog は次のことを可能にすることでこのギャップを埋めるのに役立ちます。

  • OTel および Datadog メトリクスを一緒にクエリします。
  • メトリクスソースおよびマッピングを把握します。

クエリ内で OpenTelemetry および Datadog メトリクスを統合する

プレビューに参加しましょう。

テレメトリソースクエリ修飾子には、OTel ネイティブインスツルメンテーションプレビューが必要です。アクセスをリクエストするには、このフォームを使用します。

Request Access

メトリクスクエリエディタとダッシュボードウィジェットには、テレメトリソースクエリ修飾子が含まれており、Datadog が OTel および Datadog ソースからの同等のメトリクスをどのように処理するかを制御できます。修正を選択し、テレメトリソースセクションでネイティブテレメトリまたは統合テレメトリを選択します。

統合テレメトリが選択されている状態のテレメトリソースクエリ修飾子。

2 つのモードから選択します。

ネイティブテレメトリ (デフォルト)

  • このモードは、入力した特定のメトリクス名 (Datadog または OTel メトリクスのいずれか) のみをクエリします。
  • 同等のメトリクスからのデータは含まれません。

統合テレメトリ

  • このモードは、同等の Datadog および OTel メトリクスからのデータを自動的に 1 つのクエリに統合します。1 つのメトリクス名を入力する場合も同じです。
  • 同等のメトリクス (複雑なものを含む) 間のマッピングを処理し、関連するすべての時系列を単一のメトリクスとして集約します。
  • これは、Datadog または OTel メトリクスのどちらから始めても機能します。

2 つの異なるメトリクスを使用してシステム負荷をモニタリングしているとします。

  • OTel ネイティブ: system.cpu.load_average.15m
  • Datadog Agent: system.load.15

system.cpu.load_average.15m をクエリし、最大スペース集計を適用し、テレメトリソースを統合テレメトリに設定すると、Datadog は自動的に次を実行します。

  1. 同等の Datadog メトリクス: system.load.15 を特定します。
  2. system.cpu.load_average.15m および system.load.15 の両方からの時系列を結合します。
  3. 両方のソースからすべてのデータポイントで最大集計を適用します。

メトリクスのソースおよびマッピングを把握する

クエリ時の明確さを提供するため、メトリクスのソースと同等のメトリクスが表示されます。

  • ソースピル: クエリエディタでは、メトリクス名の横に Datadog または OTel のピルが表示され、その発信点が示されます。

  • 同等のメトリクスリスト: エディタには、クエリしたメトリクスと同等とみなされるメトリクスのリストも表示されます。これには、複雑な一対多のマッピングが含まれます。例えば、system.cpu.utilization は複数の Datadog CPU 状態メトリクス (system.cpu.idlesystem.cpu.iowait など) にマッピングされます。

ソースピルと同等のメトリクスリスト

詳細なマッピングを表示する

特定の OTel および Datadog メトリクスの関係を包括的に把握するには、Metrics Summary ページを確認してください。

  1. メトリクス > 概要の順に移動します。
  2. 既知の Datadog または OTel メトリクスを検索します。
  3. メトリクスの詳細サイドパネルを開きます。

または、クエリエディタでメトリクスを入力する際に Metrics Summary を編集をクリックします。

このパネルは複雑な関係を含むメトリクスマッピングを表示します。例えば、system.cpu.idlesystem.cpu.user などの複数の Datadog メトリクスに system.cpu.utilization がマッピングされる方法を示します。

OTel および Datadog のマッピングが表示された Metrics Summary の詳細パネル

これらのマッピングに使用されるタグベースのロジックも確認できます。同等のメトリクスにカーソルを合わせると、特定の条件が表示されます。例えば、system.cpu.idle にカーソルを合わせると、state=idle の場合に system.cpu.utilization にマッピングされ、値が 100 倍されることが示されます。

カーソルを合わせると表示されるタグベースのマッピングロジックのツールチップ

参考資料

お役に立つドキュメント、リンクや記事: