APM span オブジェクト

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

各プロパティは、テレメトリデータソース の otel_traces テーブル内の列に対応しています。 列の一覧については、サポートされているテレメトリデータの列 を参照してください。

APMスパン

APMスパンオブジェクトは、トレース内の1つのスパン（HTTPリクエスト、データベースクエリ、関数呼び出しなど、単一の操作）を表します。

スパンは、リクエストの最初の操作を表すルートスパンから始まる階層を形成します。 その他のすべてのスパンは、その操作が開始されたスパンの子スパンです。

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

プロパティ 型 説明
timestamp integer スパンが開始された時刻のUnix時間（ナノ秒単位）。

プロパティの動作:
- 読み取り専用
traceid string スパンが属するトレースのID。

プロパティの動作:
- 読み取り専用
spanid string スパンのID。

プロパティの動作:
- 読み取り専用
parent_spanid string 親スパンのID。
ルートスパンの場合は空です。

プロパティの動作:
- 読み取り専用
trace_state string トレースツールがトレースに付加する追加データ（存在する場合）（W3C Trace Contextを参照）。

プロパティの動作:
- 読み取り専用
span_name string スパンが表す操作の名前（例: mysqli_query）。

プロパティの動作:
- 読み取り専用
span_kind string スパンの役割。

指定可能な値:
Unspecified - スパンの種類が指定されていない;
Internal - アプリケーション内で実行された操作;
Server - 受信リクエストの処理;
Client - 送信リクエスト;
Producer - 非同期操作の作成（メッセージの送信など）;
Consumer - 非同期操作の処理。

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

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

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

プロパティの動作:
- 読み取り専用
scope_version string インストルメンテーションスコープのバージョン。

プロパティの動作:
- 読み取り専用
span_attributes object スパンのキーと値のスパン属性（例: db.system: mysql）。

プロパティの動作:
- 読み取り専用
duration integer スパンの継続時間（ナノ秒）。

プロパティの動作:
- 読み取り専用
status_code string スパンが表す操作のステータス。

指定可能な値:
Unset - スパンに明示的なステータスが割り当てられていない;
Ok - 操作が正常に完了した;
Error - 操作がエラーで完了した。

プロパティの動作:
- 読み取り専用
status_message string スパンのステータスに関する追加情報（存在する場合）。

プロパティの動作:
- 読み取り専用
events array スパンのeventオブジェクトの配列。操作中の注目すべき時点（例外など）を表します。

プロパティの動作:
- 読み取り専用
links array スパンのlinkオブジェクトの配列。同じトレースまたは別のトレース内の関連するスパンを指します。

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