日志服务兼容 OpenTelemetry 定义的数据格式,本文档介绍采集 Trace 数据时的定义字段。
采集并写入 Trace 数据到日志服务后,Trace 数据会以结构化的键值对格式保存到指定的日志主题中,并开启字段索引。日志服务定义的 Trace 数据字段说明如下。
说明
日志服务 Trace 数据格式完全兼容 OpenTelemetry 协议的标准数据格式,通过 OpenTelemetry 协议写入的 Trace 数据可自动映射成 OpenTelemetry 的 Trace 数据格式。
日志服务字段 | 数据类型 | 示例 | 说明 |
---|---|---|---|
Name | String | Poll | Span 名称。 |
TraceID | String | e29a0a64fd256081ad57e983d260**** | Span 所属的 Trace ID,十六进制格式。 |
SpanID | String | 198b93e4fc50**** | Span ID,十六进制格式。 |
TraceState | String | lasterror=f39cd56cc44274fd5abd07ef1164246d10ce2955 | 自定义的键值对,可选。 |
ParentSpanID | String | e29a0a64fd256081ad57e983d260**** | 当前 Span 的上级 SpanID。其中,第一个 Span 的 ParentSpanID 为空。 |
Kind | String | SERVER | Span 类型,例如 SERVER、CLIENT 等。 |
Start | Integer | 16830321652419908 | Span 开始时间。Unix 时间戳类型,单位为毫秒。 |
End | Integer | 1683032220248249 | Span 结束时间。Unix 时间戳类型,单位为毫秒。 |
Duration | Integer | 32489 | Span 的持续时间,即 Start 和 End 的差值,单位为毫秒。 |
Attributes | JSON | {component: "net/http", http.method: "GET", http.status_code: 200, http.url: "0.0.0.0:8083", net/http.reused: true, net/http.was_idle: true} | Span 相关的属性信息,详细信息请参考 Attribute Naming。 |
Events | JSON | [ { "Attributes": { "event": "GetConn" }, "Name": "", "Time": 1684420552720997000 }, { "Attributes": { "event": "ClosedBody" }, "Name": "", "Time": 1684420552786987000 } ] | Span 相关事件信息,JSON 字符串格式。 |
Links | JSON | [{"TraceID" : "e29a0a64fd256081ad57e983d260****", "SpanId" : "198b93e4fc50****", "TraceState" : "Client", "Attributes" : {} }] | 关联的其他 Span,JSON 字符串格式。 |
StatusCode | String | OK | 状态码,即 OK、ERROR、UNSET。 |
StatusDescription | String | Success | 状态的描述信息。 |
Resource | JSON | {"environment":"demo","service.name":"fib","service.version":"v0.1.0","telemetry.sdk.language":"go","telemetry.sdk.name":"opentelemetry","telemetry.sdk.version":"1.11.0"} | 资源字段。详细信息请参考 Resource Semantic Conventions。 |
ServiceName | String | TLS_OTEL_SERVICE | Span 来源的服务名。即 resource 中的 service.name。 |
Host | String | localhost | Span 来源的主机名,即 resource 中的 host.name。 |
OTLPName | String | opentelemetry | Trace SDK 名称。 |
OTLPVersion | String | 1.11.0 | Trace SDK 版本号。 |