APMメトリクスオブジェクト

以下のオブジェクトは、apmmetric APIに直接関連しています。

typeを除く各プロパティは、テレメトリデータソースのメトリクステーブル（otel_metrics_gauge、otel_metrics_sum、otel_metrics_histogram、otel_metrics_exponential_histogram）の列に対応しています。 ほとんどのプロパティは、同じ名前の列に対応しています（例：metric_nameプロパティはMetricName列に対応します）。 名前が異なる場合は、以下の表にデータソースの列名を記載しています。 列の一覧については、サポートされているテレメトリデータ列を参照してください。

APMメトリック

APMメトリックオブジェクトは、メトリックのデータポイント（特定の時点における測定値または集計値）を表します。

APMメトリックオブジェクトには、次のプロパティがあります。

プロパティ 型 説明
type integer データポイントのタイプ。

指定可能な値:
0 - Gauge;
1 - Sum;
2 - Histogram;
3 - Exponential histogram。

タイプは、データポイントを保持するテーブル（otel_metrics_gauge、otel_metrics_sum、otel_metrics_histogram、または otel_metrics_exponential_histogram）によって決まります。

プロパティの動作:
- 読み取り専用
resource_attributes object データポイントのキーと値のリソース属性（例: host.name: eabf8c2a5ddc）。

プロパティの動作:
- 読み取り専用
resource_schema_url string リソース属性のOpenTelemetry スキーマのURL（存在する場合）。

プロパティの動作:
- 読み取り専用
scope_name string データポイントを生成したインストルメンテーションスコープの名前。

プロパティの動作:
- 読み取り専用
scope_version string インストルメンテーションスコープのバージョン（存在する場合）。

プロパティの動作:
- 読み取り専用
scope_attributes object インストルメンテーションスコープのキーと値の属性。

プロパティの動作:
- 読み取り専用
scope_schema_url string インストルメンテーションスコープとその属性のOpenTelemetry スキーマのURL（存在する場合）。

プロパティの動作:
- 読み取り専用
service_name string データポイントを生成したサービスの名前（例: zabbix-frontend）。OpenTelemetryのservice.nameリソース属性から取得されます。

プロパティの動作:
- 読み取り専用
metric_name string データポイントが属するメトリックの名前（例: http.server.request.duration）。

プロパティの動作:
- 読み取り専用
metric_description string メトリックの説明（存在する場合）。

プロパティの動作:
- 読み取り専用
metric_unit string メトリック値の単位（存在する場合）（例: sまたはBy。UCUMを参照）。

プロパティの動作:
- 読み取り専用
attributes object キーと値のデータポイント属性（例: http.request.method: POST）。

プロパティの動作:
- 読み取り専用
start_time_unix integer データポイントの測定期間が開始した時点のUnix時間（ナノ秒）。

プロパティの動作:
- 読み取り専用
time_unix integer データポイントのUnix時間（ナノ秒）。
Sum、Histogram、およびExponential histogramのデータポイントでは、測定期間の終了時点を示します。

プロパティの動作:
- 読み取り専用
value float データポイントの値。
GaugeおよびSumのデータポイントに適用されます。

デフォルト: 0。

プロパティの動作:
- 読み取り専用
flags integer データポイントフラグのビットマスク。
最下位ビットが設定されている場合（値が1の場合）、データポイントの値は記録されていません。

プロパティの動作:
- 読み取り専用
exemplars array exemplarオブジェクトの配列。exemplarは、記録時のトレースとスパンを含む、例として保持された個々の測定値です。

プロパティの動作:
- 読み取り専用
aggregation_temporality integer データポイントの値を時間の経過に伴って集計する方法。
Sum、Histogram、およびExponential histogramのデータポイントに適用されます。

指定可能な値:
0 - (デフォルト) 未指定;
1 - Delta（前のデータポイント以降の期間で集計）;
2 - Cumulative（start_time_unix以降の期間で集計）。

プロパティの動作:
- 読み取り専用
is_monotonic boolean 時間の経過に伴い、合計値が増加するか同じ値にとどまることのみが可能かどうか。
Sumのデータポイントに適用されます。

デフォルト: false。

プロパティの動作:
- 読み取り専用
count integer データポイント内の測定値の数。
HistogramおよびExponential histogramのデータポイントに適用されます。

デフォルト: 0。

プロパティの動作:
- 読み取り専用
sum float データポイント内のすべての測定値の合計。
HistogramおよびExponential histogramのデータポイントに適用されます。

デフォルト: 0。

プロパティの動作:
- 読み取り専用
bucket_counts array 各ヒストグラムバケット内の測定値の数を示す整数の配列。
バケットはexplicit_boundsによって定義されます。
Histogramのデータポイントに適用されます。

デフォルト: []。

プロパティの動作:
- 読み取り専用
explicit_bounds array ヒストグラムバケット間の境界を示す浮動小数点数の配列。
Histogramのデータポイントに適用されます。

デフォルト: []。

プロパティの動作:
- 読み取り専用
min float データポイント内の測定値の最小値。
HistogramおよびExponential histogramのデータポイントに適用されます。

デフォルト: 0。

プロパティの動作:
- 読み取り専用
max float データポイント内の測定値の最大値。
HistogramおよびExponential histogramのデータポイントに適用されます。

デフォルト: 0。

プロパティの動作:
- 読み取り専用
scale integer 指数ヒストグラムのスケール。バケットの境界と解像度を決定します。
スケールが大きいほどバケットは狭くなり、解像度は高くなります。スケールが小さいほどバケットは広くなり、解像度は低くなります。
Exponential histogramのデータポイントに適用されます。

デフォルト: 0。

プロパティの動作:
- 読み取り専用
zero_count integer 指数ヒストグラムのゼロバケット内の測定値の数。
Exponential histogramのデータポイントに適用されます。

デフォルト: 0。

プロパティの動作:
- 読み取り専用
positive_bucket_counts array 各指数ヒストグラムバケット内の正の測定値の数を示す整数の配列。
バケットの境界はscaleによって決まり、最初のバケットのインデックスはpositive_offsetに設定されます。
Exponential histogramのデータポイントに適用されます。

デフォルト: []。

プロパティの動作:
- 読み取り専用
positive_offset integer positive_bucket_counts内の最初のバケットのインデックス。
Exponential histogramのデータポイントに適用されます。

デフォルト: 0。

プロパティの動作:
- 読み取り専用
negative_bucket_counts array 各指数ヒストグラムバケット内の負の測定値の数を示す整数の配列。
バケットの境界はscaleによって決まり、最初のバケットのインデックスはnegative_offsetに設定されます。
Exponential histogramのデータポイントに適用されます。

デフォルト: []。

プロパティの動作:
- 読み取り専用
negative_offset integer negative_bucket_counts内の最初のバケットのインデックス。
Exponential histogramのデータポイントに適用されます。

デフォルト: 0。

プロパティの動作:
- 読み取り専用

Exemplar

exemplarオブジェクトには、次のプロパティがあります。

プロパティ 型 説明
traceid string 測定値が記録されたトレースのID（存在する場合）。
データソースの列: Exemplars.TraceId。
spanid string 測定値が記録されたスパンのID（存在する場合）。
データソースの列: Exemplars.SpanId。
value float 測定値。
データソースの列: Exemplars.Value。
time_unix integer 測定値が記録された時刻のUnix時間（ナノ秒単位）。
データソースの列: Exemplars.TimeUnix。
filtered_attributes object データポイントのattributesに含まれていない、測定値のキーと値の属性。
データソースの列: Exemplars.FilteredAttributes。