接入Trace数据

接入方案总览

日志服务支持如下接入方案。

• 使用OpenTelemetry、Jaeger（目前仅支持https、grpc方式）、Zipkin、OpenCensus等直接将Trace数据接入到日志服务。

• 使用OpenTelemetry Collector转发OpenTelemetry、Jaeger（全协议支持）、Zipkin、OpenCensus、AWS X-Ray、SignalFX（Splunk）等平台上的Trace数据到日志服务。

• 使用Logtail转发SkyWalking的Trace数据到日志服务。

• 使用自定义协议将Trace数据接入到日志服务，并通过日志服务加工功能将Trace数据格式转换为OpenTelemetry格式。

选择接入方案的原则

接入方案详情

此处分别从接入方式、Trace自动埋点成熟度、接入复杂性等方面列出日志服务所支持的接入方案。接入方案仅列出常用的Trace平台OpenTelemetry、SkyWalking、Jaeger、Zipkin。

• 各个开发语言中的Trace数据接入方案

  您可以通过自动埋点或半自动埋点方式接入Trace数据到日志服务，两者区别如下：

  • 自动埋点：开发者不需要关心所使用的框架、代码等信息，无需改动代码。Trace系统对支持的框架自动埋点。

  • 半自动埋点：开发者需要手动安装依赖包或进行一定的代码改造。

  平台	接入方案	自动化程度	接入复杂度
  Java	OpenTelemetry直接发送	自动埋点	低
  	通过OpenTelemetry Collector转发	自动埋点	中
  	通过SkyWalking接入	自动埋点	中
  Golang	OpenTelemetry直接发送	半自动埋点	低
  	通过OpenTelemetry Collector转发	半自动埋点	低
  Python	OpenTelemetry直接发送	半自动埋点	中
  	通过OpenTelemetry Collector转发	半自动埋点	中
  NodeJS	OpenTelemetry直接发送	半自动埋点	中
  	通过OpenTelemetry Collector转发	半自动埋点	中
  PHP	Zipkin直接发送	手动埋点	较高
  C++	Jaeger直接发送	手动埋点	较高
  C#	OpenTelemetry直接发送	半自动埋点	中
  	通过OpenTelemetry Collector转发	半自动埋点	中
  	通过SkyWalking接入	自动埋点	中
  Rust	OpenTelemetry直接发送	手动埋点	较高
  	通过OpenTelemetry Collector转发	手动埋点	较高
  Ruby	OpenTelemetry直接发送	手动埋点	较高
  	通过OpenTelemetry Collector转发	手动埋点	较高
  Android	接入Android用户体验监控数据	不涉及	低
  iOS	接入iOS用户体验监控数据	不涉及	低
  Web	接入Web的用户体验数据	不涉及	低
  小程序	接入小程序的用户体验数据	不涉及	低

• 各个平台中的Trace数据接入方案

  Trace平台	接入方案	接入复杂度
  OpenTelemetry	直接发送	低
  	通过OpenTelemetry Collector转发	中
  Jaeger	直接发送	低
  	通过OpenTelemetry Collector转发	中
  Zipkin	直接发送	低
  	通过OpenTelemetry Collector转发	中
  SkyWalking	通过Logtail转发	中
  OpenCensus	通过OpenTelemetry Collector转发	中
  AWS X-Ray	通过OpenTelemetry Collector转发	高
  SignalFX（Splunk）	通过OpenTelemetry Collector转发	高

常见的Trace接入场景

• 新构建Trace系统

  如果您的系统刚开始接入日志服务Trace，则推荐使用OpenTelemetry直接将Trace数据上传到日志服务。如果对应的语言没有OpenTelemetry接入方案或方案不完善，则使用Jaeger、Zipkin等支持OpenTracing或OpenCensus的接入方案。

• 现有Trace系统升级

  如果您当前的系统已经使用了Trace功能，则根据实际情况选择接入方案。

  • Trace系统已稳定运行的场景

    • 如果Trace系统支持上传Trace数据到OpenTelemetry Collector，则使用OpenTelemetry Collector转发Trace数据到日志服务。

    • 如果Trace系统使用的是自定义协议或其他非OpenTelemetry、OpenTracing协议，则可以将Trace数据打印到文件并通过Logtail上传到日志服务，并使用日志服务数据加工功能将Trace数据格式转化为OpenTelemetry格式。

  • Trace系统不完善或需要升级的场景

    • 如果Trace系统使用的是OpenTracing或OpenCensus协议，则可以使用平滑迁移方式。在原系统中，将Trace数据上传至OpenTelemetry Collector并转发到日志服务。期间，逐步替换其中的协议为OpenTelemetry，使用OpenTelemetry直接发送Trace数据到日志服务。

    • 如果Trace系统使用的是其他协议，则需要进行整体替换，否则两者共存期间Trace数据可能不完整。

• 线下Trace系统

  如果您的业务部署在线下IDC中，只有部分网关机有公网、专线，则可以在网关机上部署OpenTelemetry Collector，将其他机器上的Trace数据发送到网关机中，并通过网关机上的OpenTelemetry Collector将Trace数据转发到日志服务。

Trace Demo

日志服务提供各种语言的接入Demo。更多信息，请参见Trace Demos。