说明:
以下加粗字体为目前正在使用中的字段
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 | 无 | 否 | | 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 | | |