有奖捉虫:办公协同&微信生态&物联网文档专题 HOT
说明:
以下加粗字体为目前正在使用中的字段

Span 基础字段

字段名
类型
参数说明
例子
是否必要
Jaeger
OpenTelemetry
SkyWalking
TraceId
bytes
链路 ID
5053f7cfe6dc50c1
1
1
1
SpanId
bytes
SpanID
5053f7cfe6dc50c1
1
1
1
OperationName
string
调用操作
(接口名/执行语句等)
/api/v1/auth
1
1
1
StartTime
int64
开始时间戳
1692693930485
1
1
1
EndTime
int64
结束时间戳
1692693930485
1
1
1
Duration
int64
执行时间
128616
1
1
1
TraceState
string
w3标准

1

ParentSpanId
bytes
父 Span ID
(最新协议在 process 对象内)
5053f7cfe6dc50c1
1
1
1
LocalEndpoint
Endpoint
本地节点信息
(会体现在 process.service)


1
RemoteEndpoint
Endpoint
远端节点信息
(会体现在 process.service)


1
Annotation
string
表示某个时间点发生的 Event,Event 类型:
cs:ClientSend 请求;
sr:ServerReceive 到请求;
ss:Server 处理完成并 Send
Response;
cr:Client Receive 到响应
cs


1

通用标签

字段名
类型
参数说明
例子
是否必要
Jaeger
OpenTelemetry
SkyWalking
service.name
string
当前服务名
tapm-api
1
1
1
service.instance
string
当前服务所在机器 IP
127.0.0.1
1
1
1
component
string
组件类型
http
1
1
1
error
bool
判断是否错误
true
1
1
1
span.kind
string
Span 类型:
包括:
SPAN_KIND_UNSPECIFIED(未定义 Span)
SPAN_KIND_INTERNAL
(内部 Span)
SPAN_KIND_SERVER
(服务端侧 Span)
SPAN_KIND_CLIENT
(客户端侧 Span)
SPAN_KIND_PRODUCER
(生产者 Span)
SPAN_KIND_CONSUMER
(消费者 Span)
SPAN_KIND_SERVER
1
1
1
sampling.priorty
int
采样策略
1
1


ip
string
当前实例 IP 地址
127.0.0.1



port
int
当前实例端口
8080



peer.service
string
远端服务名
tapm-collector
OP
OP
1
peer.instance
string
远端服务实例
HTTP→ip+port



peer.address
string
远端地址
127.0.0.1:8080
OP

1
peer.hostname
string
远端域名
opentracing.io
1


peer.ipv4
string
IPv4 地址
127.0.0.1
1


peer.ipv6
string
IPv6 地址
2001:0db8:85a3:0000:0000:8a2e:0370:7334
1


peer.port
int
远端端口
8080
1



Http 服务

http.*
字段名
类型
参数说明
例子
是否必要
Jaeger
OpenTelemetry
SkyWalking
http.url
string
完整请求地址
https://domain.net/path/to?resource=here
1
1

http.status_code
int
http 返回状态码
200
1
1

http.target
string
请求地址 URL
/path/to?resource=here

1

http.host
string
请求域名 IP 地址+host
domain.net

1

http.scheme
string
URL 协议
https

1

http.flavor
string
http协议版本
1.0

1

http.user_agent
string
CERN-LineMode/2.15

1

http.request_content
_length
int
请求体长度(压缩后)
3495

1

http.request_content_length_uncompressed
int
请求体长度(未压缩)
5493

1

http.response_content_length
int
返回体长度(压缩后)
3495

1

http.response_content_length_uncompressed
int
返回体长度(未压缩)
5493

1

http.server_name
string
服务名
example.com

1

http.route
string
请求路由映射
/users/

1

http.client_ip
string
客户端地址
83.164.160.102

1


Rpc 服务

rpc.*
字段名
类型
参数说明
例子
是否必要
Jaeger
OpenTelemetry
SkyWalking
rpc.method
string
接口方法名
SayHello
建议
1
1

rpc.service
string
服务名称
proto.HelloService
建议
1
1

rpc.system
string
RPC 系统
gRPC
1
1

rpc.grpc.status_code
int
gRPC 调用状态码
0
1
1


数据库组件(Redis)

db.* / db.{DB.System}.*
字段名
类型
参数说明
例子
是否必要
Jaeger
OpenTelemetry
SkyWalking
db.instance
string
数据库实例名
customers
1
db.name

db.statement
string
执行语句
select * from user
1
1

db.type
string
数据库类型
redis
1
db.system

db.user
string
数据库用户名
root
1
1

db.operation
string
数据库操作
SELECT
建议

1

db.ip
string
数据库 ip
127.0.0.1
建议



db.port
string
数据库端口号
3306




异常标签

exception.* / error.*
字段名
类型
参数说明
例子
是否必要
Jaeger
OpenTelemetry
SkyWalking
error.kind
string
错误类型
error
1


error.object
string
错误对象
java.lang.UnsupportedOperationException
1


message(error.message)
string
可理解的错误信息
Could not connect to backend
1


error
bool
是否有异常
true



event
string
事件

1