OTLP メトリクスタイプ

OTLP Sum は、あるタイムウィンドウで報告された測定値の合計を表します。例えば、データベースへの接続の総数やエンドポイントへのリクエストの総数を追跡するために、Sum を使うことができます。Sum にはマッピングに影響を与える 2 つの特徴があります。

• Aggregation temporality、これは累積とデルタがあります。デルタメトリクスはタイムウィンドウが重ならないが、累積メトリクスは時間的に固定された開始点からのタイムウィンドウを表します。
• Monotonicity。モノトニックサムは決して減少せず、基礎となるカウントに追加することのみをサポートします。

デフォルトのマッピングは以下の通りです。

1. 累積モノトニックサムでは、連続するポイント間のデルタが計算され、カウントとして Datadog に報告されます。最初のポイントは保存されるが省略されます。OTLP ペイロードの値を復元するには、cumsum 算術関数を使用します。
2. 累積非モノトニックサムは Datadog ゲージとしてエクスポートされます。
3. デルタサムは、Datadog のカウントとしてエクスポートされます。

OTLP Gauge は、ある時刻にサンプリングされた値を表します。与えられたタイムウィンドウの最後の値だけが、OTLP のメトリクスに含まれます。

OTLP Gauge は集計セマンティックを提供しないので、Datadog Gauge にマップされます。整数と浮動小数点の両方の Gauge データポイントが Datadog のフォーマットで浮動小数点数にマップされます。

OTLP Histogram は、母集団の合計やカウントなどの特定の集計メトリクスを一連のバケットカウントとともに保存することで、与えられたタイムウィンドウにおける値の集合の統計的分布を表現するものです。ヒストグラムはマッピングに影響を与える 1 つの特徴を持っています。

• Aggregation temporality、これは累積とデルタがあります。デルタメトリクスはタイムウィンドウが重ならないが、累積メトリクスは時間的に固定された開始点からのタイムウィンドウを表します。

デフォルトのマッピングは以下の通りです。

1. デルタヒストグラムは、Datadog の分布として報告されます。利用可能な集計について理解するために、分布についての詳細をお読みください。
2. 累積ヒストグラムの場合、連続するポイント間のデルタが計算され、分布として Datadog に報告されます。OTLP ペイロードの値を復元するために、個々の集計で cumsum 算術関数を使用することができます。

注: OTLP のヒストグラムメトリクスは、ディストリビューションメトリクスにマッピングされています。OTLP がこのデータを送信する方法のため、最大、最小、およびパーセンタイルの集計は、正確な計算ではなく、近似値です。

Datadog Agent と OpenTelemetry Collector Datadog エクスポーターでは、histogram サブセクションで Histogram エクスポートを変更することができます。

• mode に counters を指定すると、以下のようなメトリクスが生成されます。

<METRIC_NAME>.bucket、lower_bound と upper_bound でタグ付けされています

指定された下限値と上限値を持つバケットのタイムウィンドウにおけるバケット数。
Datadog In-App Type: COUNT

• send_aggregation_metrics フラグが有効な場合、以下のメトリクスが生成されます。

<METRIC_NAME>.sum

タイムウィンドウ内に送信された値の総和。
Datadog In-App Type: COUNT

<METRIC_NAME>.count

タイムウィンドウ内に送信された値の数。
Datadog In-App Type: COUNT

<METRIC_NAME>.min

タイムウィンドウで送信された値の最小値。delta OTLP ヒストグラムでのみ利用可能です。Datadog エクスポーター v0.75.0 および Datadog Agent v6.45.0 および v7.45.0 以降利用可能です。
Datadog アプリ内タイプ: GAUGE

<METRIC_NAME>.max

タイムウィンドウで送信された値の最大値。delta OTLP ヒストグラムでのみ利用可能です。Datadog エクスポーター v0.75.0 および Datadog Agent v6.45.0 および v7.45.0 以降利用可能です。
Datadog アプリ内タイプ: GAUGE

注: send_aggregation_metrics は、ディストリビューションモードを使用していない場合にのみ有効です。Datadog エクスポーター v0.75.0 以前、Datadog Agent v6.45.0 および v7.45.0 では、代わりに send_count_sum_metrics を使用します。

OTLP Summary は、タイムウィンドウにわたる母集団の分位情報を伝えるレガシータイプです。OTLP Summary タイプは OpenTelemetry SDK では生成されませんが、後方互換性のために他のコンポーネントで生成されることがあります。

<METRIC_NAME>.sum

アプリケーションがメトリクスの生成を開始してからの値の総和。
Datadog In-App Type: COUNT

<METRIC_NAME>.count

母集団に含まれる値の数。
Datadog In-App Type: COUNT

<METRIC_NAME>.quantile、 quantile でタグ付けされています

指定された分位数の値。
Datadog In-App Type: GAUGE

デフォルトでは、累積モノトニック Sum タイプのメトリクスをエクスポートする、単一のアプリケーションから OpenTelemetry Counter インスツルメントを使用しているとします。次の表は、Datadog の動作をまとめたものです。

デフォルトでは、累積 Sum タイプのメトリクスをエクスポートする、単一のアプリケーションから OpenTelemetry UpDownCounter インスツルメントを使用しているとします。次の表は、Datadog の動作をまとめたものです。

OpenTelemetry Gauge のインスツルメントである temperature を、単一のアプリケーションから使用しているとします。 次の表は、Datadog の動作をまとめたものです。

OpenTelemetry Histogram インスツルメントである request.response_time.histogram を 2 つのウェブサーバーから使用しているとします。webserver:web_1 と webserver:web_2 です。ある収集期間において、 webserver:web_1 が [1,1,1,2,2,2,3,3] という値のメトリクスを報告し、 webserver:web_2 が [1,1,2] という値の同じメトリクスを報告しているとします。この収集期間中、次の 5 つの集計は、両方のウェブサーバーから収集されたすべての値のグローバルな統計的分布を表しています。

分布についてもっと読むと、さらなる集計の構成方法を理解できます。

また、counters モードを使用し、send_aggregation_metrics フラグを有効にし、ヒストグラムのバケットの境界を [-inf, 2, inf] とした場合、以下のメトリクスが報告されます。

レガシー OTLP Summary のメトリクス、request.response_time.summary をあるウェブサーバーから送信しているとします。ある収集期間において、ウェブサーバーは [1,1,1,2,2,3,3] という値でメトリクスを報告したとします。最小分位数、最大分位数、および中央値分位数が有効になっている場合、次のメトリクスが報告されます。