トレースアプリケーションメトリクス

トレースアプリケーションメトリクス

概要

トレースアプリケーションメトリクスは、トレース収集の有効化およびアプリケーションのインスツルメンテーションの後に収集されます。これらのメトリクスは、ダッシュボードとモニターで使用できます。トレースメトリクスのネームスペースは以下の形式になります。

  • trace.<スパン名>.<メトリクスサフィックス>
  • trace.<スパン名>.<メトリクスサフィックス>.<第 2 プライマリタグ>_service

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

<SPAN_NAME>
操作の名前または span.name(例: redis.commandpylons.requestrails.requestmysql.query)。
<METRIC_SUFFIX>
メトリクスの名前(例: durationhitsspan_count)。以下のセクションを参照してください。
<2ND_PRIM_TAG>
メトリクス名が 第 2 プライマリタグを考慮する場合、このタグはメトリクス名の一部です。
<TAGS>
トレースメトリクスタグ、可能なタグは、envserviceversionresourcesublayer_typesublayer_servicehttp.status_codehttp.status_class、Datadog Agent タグ(ホストと第 2 プライマリタグを含む)です。注: スパンに設定されたタグは数に含められず、トレースメトリクスのタグとして利用できません。

メトリクスサフィックス

Hits

trace.<SPAN_NAME>.hits
前提条件: このメトリクスは、すべての APM サービスに存在します。
説明: 特定のスパンのヒット数を表します。
メトリクスタイプ: COUNT
タグ: envserviceversionresourcehttp.status_code、Datadog Host Agent からのすべてのホストタグ、第 2 プライマリタグ
trace.<SPAN_NAME>.hits.by_http_status
前提条件: このメトリクスは、http メタデータが存在する場合 HTTP/WEB APM サービスに存在します。
説明: 特定のスパンのブレイクダウンの HTTP ステータスコード別ヒット数を表します。
メトリクスタイプ: COUNT
タグ: envserviceversionresourcehttp.status_classhttp.status_code、Datadog Host Agent からのすべてのホストタグ、第 2 プライマリタグ

レイテンシ分布

trace.<SPAN_NAME>
前提条件: このメトリクスは、すべての APM サービスに存在します。 説明: 異なる環境や the second primary tag にまたがるすべてのサービス、リソース、バージョンのレイテンシ分布を表します。
メトリクスタイプ: DISTRIBUTION.
タグ: envserviceresourceresource_nameversionsyntheticsthe second primary tag.

パーセンタイル集計

trace.<SPAN_NAME>.duration.by.resource_<2ND_PRIM_TAG>_service.<PERCENTILE_AGGREGATION>
前提条件: このメトリクスは、すべての APM サービスに存在します。
説明: 処理にかかる合計時間をリソース、サービス、第 2 プライマリタグ別に測定します。
メトリクスタイプ: GAUGE
パーセンタイル集計: 100p50p75p90p95p99p
タグ: envserviceresource第 2 プライマリタグ
trace.<SPAN_NAME>.duration.by.resource_service.<PERCENTILE_AGGREGATION>
前提条件: このメトリクスは、すべての APM サービスに存在します。
説明: リソースとサービスの各組み合せの処理にかかる合計時間を測定します。
メトリクスタイプ: GAUGE
パーセンタイル集計: 100p50p75p90p95p99p
タグ: envserviceresource
trace.<SPAN_NAME>.duration.by.<2ND_PRIM_TAG>_service.<PERCENTILE_AGGREGATION>
前提条件: このメトリクスは、すべての APM サービスに存在します。
説明: 第 2 プライマリタグとサービスの各組み合わせの処理にかかる合計時間を測定します。
メトリクスタイプ: GAUGE
パーセンタイル集計: 100p50p75p90p95p99p
タグ: envservice第 2 プライマリタグ
trace.<SPAN_NAME>.duration.by.service.<PERCENTILE_AGGREGATION>
前提条件: このメトリクスは、すべての APM サービスに存在します。
説明: 個々のスパンの期間を表します。これは、レイテンシーを追跡し、「ユーザーが経験した待機時間の中央値はどれくらいか?」や「最も遅い 1 %のユーザーはどれくらい待つ必要があるか?」などの質問に答えるために使用されます。
メトリクスタイプ: GAUGE
パーセンタイル集計: 100p50p75p90p95p99p
タグ: envservice

Errors

trace.<SPAN_NAME>.errors
前提条件: このメトリクスは、すべての APM サービスに存在します。
説明: 特定のスパンのエラー数を表します。
メトリクスタイプ: COUNT
タグ: envserviceversionresourcehttp.status_code、Datadog Host Agent からのすべてのホストタグ、第 2 プライマリタグ
trace.<SPAN_NAME>.errors.by_http_status
前提条件: このメトリクスは、すべての APM サービスに存在します。
説明: 特定のスパンのエラー数を表します。
メトリクスタイプ: COUNT
タグ: envserviceversionresourcehttp.status_classhttp.status_code、Datadog Host Agent からのすべてのホストタグ、第 2 プライマリタグ

スパン数

: これは非推奨のネームスペースです。

trace.<SPAN_NAME>.span_count
前提条件: このメトリクスは、すべての APM サービスに存在します。
説明: 特定のインターバルで収集されたスパンの量を表します。
メトリクスタイプ: COUNT
タグ: envserviceresource、Datadog Host Agent からのすべてのホストタグ、第 2 プライマリタグ
trace.<SPAN_NAME>.span_count.by_http_status
前提条件: このメトリクスは、http メタデータが存在する場合 HTTP/WEB APM サービスに存在します。
説明: 特定のインターバルブレイクダウンで収集されたスパンの量を HTTP ステータスコード別に表します。
メトリクスタイプ: COUNT
タグ: envserviceresourcehttp.status_classhttp.status_code、Datadog Host Agent からのすべてのホストタグ、第 2 プライマリタグ

Duration

trace.<SPAN_NAME>.duration
前提条件: このメトリクスは、すべての APM サービスに存在します。
説明: スパンの収集にかかる合計時間を計測します。具体的には、1 回のインターバルですべてのスパンにかかった総時間(子処理を待機していた時間を含む)です。
メトリクスタイプ: GAUGE
タグ: envserviceresourcehttp.status_code、Datadog Host Agent からのすべてのホストタグ、第 2 プライマリタグ

継続時間

trace.<SPAN_NAME>.duration.by_http_status
前提条件: このメトリクスは、http メタデータが存在する場合 HTTP/WEB APM サービスに存在します。
説明: 各 HTTP ステータスのスパンの収集にかかる合計時間を計測します。具体的には、1 回のインターバルおよび特定の HTTP ステータスで、すべてのスパンにかかった相対時間(子処理を待機していた時間を含む)です。
メトリクスタイプ: GAUGE
タグ: envserviceresourcehttp.status_classhttp.status_code、Datadog Host Agent からのすべてのホストタグ、第 2 プライマリタグ
trace.<SPAN_NAME>.duration.by_service
前提条件: このメトリクスは、すべての APM サービスに存在します。
説明: 各サービスで実際にかかった総処理時間を計測します(子処理を待機していた時間は除外されます)。
メトリクスタイプ: GAUGE
タグ: envserviceresourcesublayer_servicehttp.status_code、Datadog Host Agent からのすべてのホストタグ、第 2 プライマリタグ
trace.<SPAN_NAME>.duration.by_type
前提条件: このメトリクスは、すべての APM サービスに存在します。
説明:サービスタイプで実際にかかる処理の合計時間を計測します。
メトリクスタイプ: GAUGE
タグ: envserviceresourcesublayer_typehttp.status_code、Datadog Host Agent からのすべてのホストタグ、第 2 プライマリタグ
trace.<SPAN_NAME>.duration.by_type.by_http_status
前提条件: このメトリクスは、http メタデータが存在する場合 HTTP/WEB APM サービスに存在します。
説明:サービスタイプおよび HTTP ステータスコードで実際にかかった処理の合計時間を計測します。
メトリクスタイプ: GAUGE
タグ: envserviceresourcesublayer_typehttp.status_classhttp.status_code、Datadog Host Agent からのすべてのホストタグ、第 2 プライマリタグ
trace.<SPAN_NAME>.duration.by_service.by_http_status
前提条件: このメトリクスは、http メタデータが存在する場合 HTTP/WEB APM サービスに存在します。
説明:サービスおよび HTTP ステータスコードで実際にかかった処理の合計時間を計測します。
メトリクスタイプ: GAUGE
タグ: envserviceresourcesublayer_servicehttp.status_classhttp.status_code、Datadog Host Agent からのすべてのホストタグ、第 2 プライマリタグ

Apdex

trace.<SPAN_NAME>.apdex
前提条件: このメトリクスは、すべての HTTP/WEB APM サービスに存在します。
説明: 各ウェブサービスの Apdex スコアを計測します。
メトリクスタイプ: GAUGE
タグ: envserviceresource / resource_nameversionsynthetics第 2 プライマリタグ

次のレガシー apdex メトリクスは非推奨になりました。

trace.<SPAN_NAME>.apdex.by.resource_<2ND_PRIM_TAG>_service
前提条件: このメトリクスは、すべての HTTP/WEB APM サービスに存在します。
説明: リソース、第 2 プライマリタグ、サービスのすべての組み合わせの Apdex スコアを表します。
メトリクスタイプ: GAUGE
タグ: envserviceresource / resource_name第 2 プライマリタグ
trace.<SPAN_NAME>.apdex.by.resource_service
前提条件: このメトリクスは、すべての HTTP/WEB APM サービスに存在します。
説明: リソースとウェブサービスの各組み合わせの Apdex スコアを計測します。
メトリクスタイプ: GAUGE
タグ: envserviceresource / resource_name
trace.<SPAN_NAME>.apdex.by.<2ND_PRIM_TAG>_service
前提条件: このメトリクスは、すべての HTTP/WEB APM サービスに存在します。
説明: 第 2 プライマリタグとウェブサービスの各組み合わせの Apdex スコアを計測します。
メトリクスタイプ: GAUGE
タグ: envservice第 2 プライマリタグ
trace.<SPAN_NAME>.apdex.by.service
前提条件: このメトリクスは、すべての HTTP/WEB APM サービスに存在します。
説明: 各ウェブサービスの Apdex スコアを計測します。
メトリクスタイプ: GAUGE
タグ: envservice

その他の参考資料