このページで
APMトレースオブジェクト
以下のオブジェクトは、apmtrace APIに直接関連しています。
span_countとerror_countを除く各プロパティは、テレメトリデータソースのotel_tracesテーブル内の列に対応しています。
ほとんどのプロパティは、同じ名前の列に対応しています（例: span_nameプロパティはSpanName列に対応します）。
名前が異なる場合は、以下の表にデータソースの列を記載しています。
列の一覧については、サポートされているテレメトリデータ列を参照してください。
APMトレース
APMトレースオブジェクトは、トレース（アプリケーションおよびサービスを通過するリクエストの経路）を表します。 トレースは1つ以上のスパンで構成されます。各スパンは単一の操作を表します。
APMトレースオブジェクトは、トレースのルートスパン（トレースを開始し、親スパンを持たないスパン）に基づきます。
span_count と error_count を除くすべてのプロパティには、ルートスパンのデータが含まれます。span_count と error_count は、トレースのすべてのスパンから計算されます。
APMトレースオブジェクトには、次のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| timestamp | integer | ルートスパンが開始された時刻のUnix時間（ナノ秒単位）。 Property behavior: - read-only |
| traceid | string | トレースに属するすべてのスパンで共有される、トレースのID。 Property behavior: - read-only |
| spanid | string | ルートスパンのID。 Property behavior: - read-only |
| trace_state | string | トレースツールがトレースに付加する追加データ（存在する場合）（W3C Trace Contextを参照）。 Property behavior: - read-only |
| span_name | string | ルートスパンが表す操作の名前（例: POST /zabbix.php）。Property behavior: - read-only |
| span_kind | string | ルートスパンの役割。 指定可能な値: Unspecified - スパンの種類が指定されていない;Internal - アプリケーション内で実行される操作;Server - 受信リクエストの処理;Client - 送信リクエスト;Producer - 非同期操作の作成（例: メッセージの送信）;Consumer - 非同期操作の処理。Property behavior: - read-only |
| service_name | string | ルートスパンを生成したサービスの名前（例: zabbix-nginx）。OpenTelemetryのservice.nameリソース属性から取得されます。Property behavior: - read-only |
| resource_attributes | object | ルートスパンのキーと値のリソース属性（例: host.name: eabf8c2a5ddc）。Property behavior: - read-only |
| scope_name | string | ルートスパンを生成したインストルメンテーションスコープの名前。 Property behavior: - read-only |
| scope_version | string | インストルメンテーションスコープのバージョン。 Property behavior: - read-only |
| span_attributes | object | ルートスパンのキーと値のスパン属性（例: http.method: POST）。Property behavior: - read-only |
| duration | integer | トレースの継続時間（ナノ秒）。 Property behavior: - read-only |
| status_code | string | ルートスパンが表す操作のステータス。 指定可能な値: Unset - ルートスパンに明示的なステータスが割り当てられていない;Ok - 操作が正常に完了した;Error - 操作がエラーで完了した。Property behavior: - read-only |
| status_message | string | ルートスパンのステータスに関する追加情報（存在する場合）。 Property behavior: - read-only |
| events | array | ルートスパンのeventオブジェクトの配列。つまり、操作中の注目すべき時点（例: 例外）です。 Property behavior: - read-only |
| links | array | ルートスパンのlinkオブジェクトの配列。同じトレースまたは別のトレースにある関連スパンを指します。 Property behavior: - read-only |
| span_count | integer | トレース内のスパンの総数。 Property behavior: - read-only |
| error_count | integer | status_code が Error に設定されている、トレース内のスパン数。Property behavior: - read-only |
イベント
イベントオブジェクトには、次のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| timestamp | integer | イベントが発生した時刻をナノ秒単位で表すUnix時間。 データソースの列: Events.Timestamp |
| name | string | イベントの名前。 データソースの列: Events.Name |
| attributes | object | イベントに関する追加情報がある場合に、その情報を格納するキーと値の属性。 データソースの列: Events.Attributes |
リンク
リンクオブジェクトには、次のプロパティがあります。
| Property | Type | Description |
|---|---|---|
| traceid | string | リンクされたスパンを含むトレースのID。 データソースの列: Links.TraceId |
| spanid | string | リンクされたスパンのID。traceid と組み合わせることで、リンクされたスパンを一意に識別します。データソースの列: Links.SpanId |
| trace_state | string | リンクされたスパンのトレースステート（存在する場合）（W3C Trace Contextを参照）。 データソースの列: Links.TraceState |
| attributes | object | リンクに関する追加情報を含むキーと値の属性。 データソースの列: Links.Attributes |