You need to enable JavaScript to run this app.
导航

Trace 数据格式

最近更新时间2024.04.03 11:19:11

首次发布时间2023.05.30 17:38:56

日志服务兼容 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 等。Span 类型的详细信息请参考 SpanKind

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 字符串格式。详细信息请参考 Event

Links

JSON

[{"TraceID" : "e29a0a64fd256081ad57e983d260****", "SpanId" : "198b93e4fc50****", "TraceState" : "Client", "Attributes" : {} }]

关联的其他 Span,JSON 字符串格式。详细信息请参考 Links

StatusCode

String

OK

状态码,即 OK、ERROR、UNSET。详细信息请参考 Status Code

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 版本号。