トレースメトリクス

概要

トレース収集の有効化とアプリケーションのインスツルメントを行うと、トレースアプリケーションメトリクスが収集されます。

これらのメトリクスは、リクエスト数、エラー数、およびレイテンシーの測定値を取得します。これらは、トレース取り込みサンプリングの設定に関係なく、アプリケーションのトラフィックの 100% に基づいて計算されます。これらのメトリクスを使用してサービスやリソースの潜在的なエラーを特定し、ダッシュボード、モニター、および SLO を作成することで、アプリケーションのトラフィックの完全な可視性を確保します。

注: アプリケーションが OpenTelemetry ライブラリで計測され、SDK レベルでサンプリングが設定されている場合、APM メトリクスはサンプリングされたデータセットに基づいて計算されます。ただし、OpenTelemetry Collector レベルでサンプリングが設定され、サンプラープロセッサーが Datadog コネクタの上流にある場合、APM メトリクスはアプリケーショントラフィックの 100% に基づいて計算されます。

トレースメトリクスは、インテグレーション言語によって、サービスエントリスパンや特定のオペレーションに対して生成されます。たとえば、Django インテグレーションでは、さまざまな操作を表すスパン (Django リクエスト用のルートスパン 1 つ、各ミドルウェア用のスパン 1 つ、ビュー用のスパン 1 つ) からトレースメトリクスを生成しています。

トレースメトリクスのネームスペースは、次のようなフォーマットになっています。

trace.<SPAN_NAME>.<METRIC_SUFFIX>

次の定義と組み合わせます。

<SPAN_NAME>: オペレーションの名前または span.name (例: redis.command、pylons.request、rails.request、mysql.query)。
<METRIC_SUFFIX>: メトリクスの名前 (例: hits、errors、apdex、duration)。以下のセクションを参照してください。
<TAGS>: トレースメトリクスタグ、可能なタグは: env、service、version、resource、http.status_code、http.status_class、rpc.grpc.status_code (Datadog Agent v7.65.0+ が必要)、および Datadog Agent タグ (ホストおよび追加のプライマリタグを含む)。; 注: スパンに設定された他のタグは、トレースメトリクスのタグとしては利用できません。

メトリクスサフィックス

ヒット

trace.<SPAN_NAME>.hits: 前提条件: このメトリクスは、すべての APM サービスに存在します。
説明: 特定の名前 (例: redis.command、pylons.request、rails.request、または mysql.query) で作成されたスパンのカウントを表します。
メトリクスタイプ: COUNT
タグ: env、service、version、resource、resource_name、http.status_code、rpc.grpc.status_code、Datadog ホストエージェントからのすべてのホストタグ、および追加のプライマリタグ。
trace.<SPAN_NAME>.hits.by_http_status: 前提条件: このメトリクスは、HTTP メタデータが存在する場合、HTTP/WEB APM サービスに存在します。
説明: 特定のスパンのヒット数を HTTP ステータスコード別に表します。
メトリクスタイプ: COUNT
タグ: env、service、version、resource、resource_name、http.status_class、http.status_code、Datadog ホストエージェントからのすべてのホストタグ、および追加のプライマリタグ。

レイテンシー分布

trace.<SPAN_NAME>: 前提条件: このメトリクスは、すべての APM サービスに存在します。
説明: さまざまな環境と追加のプライマリタグにわたるすべてのサービス、リソース、バージョンのレイテンシー分布を表します。すべてのレイテンシー測定のユースケースに推奨されます。
メトリクスタイプ: DISTRIBUTION
タグ: env、service、version、resource、resource_name、http.status_code、rpc.grpc.status_code、synthetics、および追加のプライマリタグ。

エラー

trace.<SPAN_NAME>.errors: 前提条件: このメトリクスは、すべての APM サービスに存在します。
説明: 特定のスパンのエラー数を表します。
メトリクスタイプ: COUNT
タグ: env、service、version、resource、resource_name、http.status_code、rpc.grpc.status_code、Datadog ホストエージェントからのすべてのホストタグ、および追加のプライマリタグ。
trace.<SPAN_NAME>.errors.by_http_status: 前提条件: このメトリクスは、すべての APM サービスに存在します。
説明: 特定のスパンのエラー数を表します。
メトリクスタイプ: COUNT
タグ: env、service、version、resource、http.status_class、http.status_code、Datadog ホストエージェントからのすべてのホストタグ、および追加のプライマリタグ。

Apdex

trace.<SPAN_NAME>.apdex: 前提条件: このメトリクスは、すべての HTTP またはウェブベースの APM サービスに存在します。
説明: 各ウェブサービスの Apdex スコアを測定します。
メトリクスタイプ: GAUGE
タグ: env、service、version、resource / resource_name、synthetics、および追加のプライマリタグ。

レガシーメトリクス

以下のメトリクスは、後方互換性のために維持されています。すべてのレイテンシー測定のユースケースにおいて、Datadog は代わりに Latency Distribution metrics の使用を強く推奨します。

期間 (レガシー)

重要: 期間メトリクスは、後方互換性のためにのみ維持されています。すべてのレイテンシー測定のユースケースにおいて、Datadog は代わりにレイテンシー分布メトリクスの使用を強く推奨します。これにより、パーセンタイル計算と全体的なパフォーマンス分析の精度が向上します。

trace.<SPAN_NAME>.duration: 前提条件: このメトリクスは、すべての APM サービスに存在します。
説明: 収集サービスで認識された子スパンを含め、時間間隔内のスパンコレクションの合計時間を測定します。ほとんどのユースケースにおいて、Datadog は平均レイテンシーまたはパーセンタイルの計算に Latency Distribution の使用を推奨します。ホストタグフィルターを使用して平均レイテンシーを計算するには、次の式でこのメトリクスを使用できます:
sum:trace.<SPAN_NAME>.duration{<FILTER>}.rollup(sum).fill(zero) / sum:trace.<SPAN_NAME>.hits{<FILTER>}.rollup(sum).fill(zero)
このメトリクスは、パーセンタイル集計をサポートしていません。詳細については、Latency Distribution セクションを参照してください。
メトリクスタイプ: GAUGE
タグ: env、service、resource、http.status_code、Datadog ホストエージェントからのすべてのホストタグ、および追加のプライマリタグ。

期間別 (レガシー)

trace.<SPAN_NAME>.duration.by_http_status: 前提条件: このメトリクスは、HTTP メタデータが存在する場合、HTTP/WEB APM サービスに存在します。
説明: 各 HTTP ステータスのスパンのコレクションの合計時間を測定します。具体的には、ある間隔ですべてのスパンが費やした時間と、特定の HTTP ステータスの相対的な割合で、子プロセスの待機に費やされた時間を含みます。
メトリクスタイプ: GAUGE
タグ: env、service、resource、http.status_class、http.status_code、Datadog ホストエージェントからのすべてのホストタグ、および追加の主要タグ。

トレースメトリクスに対するサンプリングの影響

ほとんどの場合、トレースメトリクスはすべてのアプリケーショントラフィックに基づいて計算されます。ただし、特定のトレース取り込みサンプリング構成では、メトリクスはすべてのリクエストのサブセットのみを表します。

アプリケーション側サンプリング

一部の SDK はアプリケーション側サンプリングをサポートしており、Datadog Agent に送信される前にスパン数を削減します。たとえば、Ruby SDK はパフォーマンスオーバーヘッドを低減するためのアプリケーション側サンプリングを提供します。ただし、Datadog Agent は正確なメトリクスを計算するためにすべてのスパンを必要とするため、これによりトレースメトリクスに影響する可能性があります。

この設定をサポートする SDK は非常に少なく、一般的には使用は推奨されません。