链路数据采集¶
观测云的链路数据采集目前支持使用 Opentracing 协议的采集器。在 DataKit 中开启链路数据接收服务后,通过完成采集器在代码中的埋点,DataKit 将自动完成数据的格式转换和采集,最终上报到观测云。
数据采集¶
DataKit 目前支持采集 DDTrace
、Apache Jaeger
、OpenTelemetry
、Skywalking
、Zipkin
等第三方的 Tracing 数据。
采集前提¶
-
配置所有链路数据采集的相关采集器。
采集器配置¶
字段说明¶
DataKit 会根据采集器的不同将上报的数据转换为观测云链路数据的格式保留标签和指标。下面是常用的字段说明:
字段名 | 说明 |
---|---|
host |
主机名,默认全局标签。 |
source |
链路的来源,如果是通过 Zipkin 采集的则该值为 zipkin ,如果是 Jaeger 采集的该值为 jaeger ,依次类推。 |
service |
服务的名称,建议用户通过该标签指定产生该链路数据的业务系统的名称。 |
parent_id |
当前 span 的上一个 span 的 ID。 |
operation |
当前 span 操作名,也可理解为 Span 名称。 |
span_id |
当前 span 的唯一 ID。 |
trace_id |
表示当前链路的唯一 ID。 |
span_type |
Span 的类型,目前支持 :entry 、 local 、exit 、 unknow 。entry span 表示进入服务创建的 span,即该服务的对其他服务提供调用请求的端点,大部分 span 应该都是 entry span。只有 span 是 entry 类型的调用才是一个独立的请求。 local span 表示该 span 和远程调用没有任何关系,是本地方法调用的时候创建的 span,例如一个普通的 Java 方法。exit span 表示离开服务创建的 span,例如发起远程调用的时候,或者消息队列产生消息的时候。unknow span 表示未知的 Span。 |
endpoint |
请求的目标地址,客户端用于访问目标服务的网络地址,例如 127.0.0.1:8080 ,默认:null 。 |
message |
链路转换之前的采集的原始数据。 |
duration |
当前链路 span 的持续时间。 |
status |
链路状态,info:提示,warning:警告,error:错误,critical:严重,ok:成功。 |
env |
链路的所属环境,比如可用 dev 表示开发环境,prod 表示生产环境,用户可自定义。 |
更多字段列表,可参考 DataKit Tracing 数据结构。