APM 跟踪对象
以下对象与 apmtrace API 直接相关。
除 span_count 和 error_count 外，每个属性都对应于遥测数据源中 otel_traces 表的一列。
大多数属性对应于名称相同的列（例如，span_name 属性对应于 SpanName 列）。
如果名称不同，下表将指定数据源中的列。
有关列的列表，请参阅支持的遥测数据列。
APM 跟踪
APM 跟踪对象表示一次跟踪（请求通过您的应用程序和服务所经过的路径）。 一次跟踪由一个或多个 span 组成；每个 span 表示一个单独的操作。
APM 跟踪对象基于该跟踪的根 span（启动跟踪且没有父 span 的 span）。
除 span_count 和 error_count 外，所有属性都包含根 span 的数据；这两个属性根据跟踪中的所有 span 计算得出。
APM 跟踪对象具有以下属性：
| Property | Type | Description |
|---|---|---|
| timestamp | integer | 根 span 启动时的 Unix 时间（以纳秒为单位）。 Property behavior： - 只读 |
| traceid | string | 跟踪的 ID，属于该跟踪的所有 span 共享此 ID。 Property behavior： - 只读 |
| spanid | string | 根 span 的 ID。 Property behavior： - 只读 |
| trace_state | string | 跟踪工具附加到跟踪的其他数据（如果有）（请参阅 W3C Trace Context）。 Property behavior： - 只读 |
| span_name | string | 根 span 所表示操作的名称（例如 POST /zabbix.php）。Property behavior： - 只读 |
| span_kind | string | 根 span 的角色。 可能的值： Unspecified - 未指定 span 类型；Internal - 在应用程序内执行的操作；Server - 处理传入请求；Client - 传出请求；Producer - 创建异步操作（例如发送消息）；Consumer - 处理异步操作。Property behavior： - 只读 |
| service_name | string | 生成根 span 的服务名称（例如 zabbix-nginx），取自 OpenTelemetry 的 service.name 资源属性。Property behavior： - 只读 |
| resource_attributes | object | 根 span 的键值对 资源属性（例如 host.name: eabf8c2a5ddc）。Property behavior： - 只读 |
| scope_name | string | 生成根 span 的 检测范围名称。 Property behavior： - 只读 |
| scope_version | string | 检测范围的版本。 Property behavior： - 只读 |
| span_attributes | object | 根 span 的键值对 span 属性（例如 http.method: POST）。Property behavior： - 只读 |
| duration | integer | 跟踪持续时间，单位为纳秒。 Property behavior： - 只读 |
| status_code | string | 根 span 所表示操作的状态。 可能的值： Unset - 未向根 span 分配明确状态；Ok - 操作已成功完成；Error - 操作完成时发生错误。Property behavior： - 只读 |
| status_message | string | 有关根 span 状态的其他信息（如果有）。 Property behavior： - 只读 |
| events | array | 根 span 的 事件 对象数组，即操作期间值得注意的时间点（例如异常）。 Property behavior： - 只读 |
| links | array | 根 span 的 链接 对象数组，指向同一跟踪或其他跟踪中的相关 span。 Property behavior： - 只读 |
| span_count | integer | 跟踪中的 span 总数。 Property behavior： - 只读 |
| error_count | integer | 跟踪中 status_code 设置为 Error 的 span 数量。Property behavior： - 只读 |
事件
事件对象具有以下属性。
| Property | Type | Description |
|---|---|---|
| timestamp | integer | 事件发生时的 Unix 时间（以纳秒为单位）。 数据源列： Events.Timestamp |
| name | string | 事件名称。 数据源列： Events.Name |
| attributes | object | 包含事件附加信息（如有）的键值属性。 数据源列： Events.Attributes |
链接
链接对象具有以下属性。
| 属性 | 类型 | 描述 |
|---|---|---|
| traceid | string | 包含所链接 span 的 trace ID。 数据源列： Links.TraceId |
| spanid | string | 所链接 span 的 ID。 与 traceid 一起唯一标识所链接的 span。数据源列： Links.SpanId |
| trace_state | string | 所链接 span 的 trace state（如果有；请参阅 W3C Trace Context）。 数据源列： Links.TraceState |
| attributes | object | 包含链接附加信息的键值属性。 数据源列： Links.Attributes |