OpenTelemetry と Datadog のメトリクスを組み合わせる

概要

equiv_otel() 関数は Preview 提供中です。この機能に関するフィードバックがあれば、担当のアカウントチームまでお寄せください。

Datadog と OpenTelemetry (OTel) では、インテグレーションメトリクスの命名規則が異なります。このガイドでは、Datadog の equiv_otel 関数を使って、両方のシステムのメトリクスを 1 つのクエリにまとめる方法を説明します。

Datadog UI で Datadog と OpenTelemetry のメトリクスを横断的にクエリするには、OpenTelemetry メトリクスをクエリする方法を参照してください。

Datadog と OTel のメトリクスを併用すると、主に 2 つの課題があります。ここでは、NGINX の接続監視を例に見ていきます:

Datadog と OTel では、同じ計測値でも表し方が異なります:

Datadog: nginx.net.connections (アクティブ接続専用のメトリクス)
OTel: nginx.connections_current (すべての接続状態を 1 つのメトリクスにまとめたもの)
- Datadog のアクティブ接続メトリクスと一致させるには、state:active でフィルタする必要があります。

別々のメトリクスクエリをそのまま組み合わせると、正しくない結果になることがあります。たとえば、次のクエリを組み合わせるとします:

avg:nginx.net.connections
avg:nginx.connections_current{state:active}

得られるのは、すべての時系列を通した真の平均ではなく、平均の平均です。これは、従来のメトリクス関数がデータを 1 つのメトリクスとして扱うのではなく、別々のクエリの結果を結合するためです。

equiv_otel 関数を使うと、対応する Datadog と OTel のメトリクスを 1 つのクエリ内で自動的に組み合わせられます。主な動作は次のとおりです。

対応する OTel メトリクスもクエリに含めるには、Datadog のクエリを equiv_otel で包みます:

equiv_otel(avg:nginx.net.connections)

このクエリでは、次の処理が行われます。

OTel のクエリに Datadog のメトリクスを含める場合も、同じように使えます:

equiv_otel(avg:nginx.connections_current{state:active})

逆方向でも動作は同じで、対応する Datadog のメトリクス (nginx.net.connections) が自動的に含まれます。

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