文档中心

日志服务

请输入

Trace 存储

Trace 数据格式

日志服务兼容 OpenTelemetry 定义的数据格式，本文档介绍采集 Trace 数据时的定义字段。

采集并写入 Trace 数据到日志服务后，Trace 数据会以结构化的键值对格式保存到指定的日志主题中，并开启字段索引。日志服务定义的 Trace 数据字段说明如下。

Tip

日志服务 Trace 数据格式完全兼容 OpenTelemetry 协议的标准数据格式，通过 OpenTelemetry 协议写入的 Trace 数据可自动映射成 OpenTelemetry 的 Trace 数据格式。

日志服务字段	数据类型	示例	说明
Name	String	Poll	Span 名称。
TraceID	String	e29a0a64fd256081ad57e983d260xxxx	Span 所属的 Trace ID，十六进制格式。
SpanID	String	198b93e4fc50xxxx	Span ID，十六进制格式。
TraceState	String	lasterror=f39cd56cc44274fd5abd07ef1164246d10cexxxx	自定义的键值对，可选。
ParentSpanID	String	e29a0a64fd256081ad57e983d260xxxx	当前 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" : "e29a0a64fd256081ad57e983d260xxxx", "SpanId" : "198b93e4fc50xxxx", "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 版本号。

最近更新时间：2026.04.08 18:13:47

这个页面对您有帮助吗？

有用

无用