接入Zipkin Trace数据

直接发送

• 接入点信息

  • （推荐）V2协议：HTTPS的接入点为${endpoint}/zipkin/api/v2/spans，例如https://test-project.cn-hangzhou-intranet.log.aliyuncs.com/zipkin/api/v2/spans。

  • V1协议：HTTPS的接入点为${endpoint}/zipkin/api/v1/spans，例如https://test-project.cn-hangzhou.log.aliyuncs.com/zipkin/api/v1/spans。

  其中，${endpoint}需根据实际情况替换，详细说明如下表所示。

  表 1. 变量说明

  变量	说明	示例
  ${endpoint}	日志服务Project的接入地址，格式为${project}.${region-endpoint}，其中： ${project}：日志服务Project名称。 ${region-endpoint}：日志服务Project所在地域的访问域名，支持公网和阿里云内网（经典网络、VPC）。更多信息，请参见服务入口。	test-project.cn-hangzhou.log.aliyuncs.com

• 鉴权信息

  您可以在HTTPS协议的Header中配置鉴权信息，具体字段及详细说明如下表所示。

  HTTPS Header Key	说明	示例
  x-sls-otel-project	日志服务Project。	test-project
  x-sls-otel-instance-id	Trace服务实例ID。更多信息，请参见创建Trace实例。	test-traces
  x-sls-otel-ak-id	阿里云账号AccessKey ID。 建议您使用只具备日志服务Project写入权限的RAM用户的AccessKey（包括AccessKey ID和AccessKey Secret）。授予RAM用户向指定Project写入数据权限的具体操作，请参见授权。如何获取AccessKey的具体操作，请参见访问密钥。	无
  x-sls-otel-ak-secret	阿里云账号AccessKey Secret。 建议您使用只具备日志服务Project写入权限的RAM用户的AccessKey。	无

通过OpenTelemetry Collector转发

您可以通过Zipkin SDK将Zipkin平台上的Trace数据发送至OpenTelemetry Collector，再通过OpenTelemetry Collector转发至日志服务。该方式支持通过HTTP协议或HTTPS协议传输数据。

1. 安装OpenTelemetry Collector。

   1. 下载OpenTelemetry Collector。

   2. 配置OpenTelemetry Collector。

      1. 创建config.yaml文件。

      2. 在config.yaml文件中添加如下代码。

         如下代码中的变量需根据实际情况替换。关于变量的详细说明，请参见变量说明。

         receivers:
           zipkin:
             endpoint: 0.0.0.0:9411
         exporters:
           logging/detail:
             loglevel: debug
           alibabacloud_logservice/traces:
             endpoint: "${endpoint}"
             project: "${project}"
             logstore: "${instance}-traces"
             access_key_id: "${access-key-id}"
             access_key_secret: "${access-key-secret}"
         
         service:
           pipelines:
             traces:
               receivers: [zipkin]              #接收端配置为zipkin。
               exporters: [alibabacloud_logservice/traces]   #发送端配置为alibabacloud_logservice/sls-traces。
               # for debug
               #exporters: [logging/detail,alibabacloud_logservice/traces]

         表 2. 变量说明

         参数	说明	示例
         ${endpoint}	日志服务Project的接入地址，格式为${region-endpoint}，其中${region-endpoint}为日志服务Project所在地域的访问域名，支持公网和阿里云内网（经典网络、VPC）。更多信息，请参见服务入口。	cn-hangzhou.log.aliyuncs.com
         ${project}	日志服务Project名称。	test-project
         ${instance}	Trace服务实例ID。更多信息，请参见创建Trace实例。	test-traces
         ${access-key-id}	阿里云账号AccessKey ID。 建议您使用只具备日志服务Project写入权限的RAM用户的AccessKey。授予RAM用户向指定Project写入数据权限的具体操作，请参见授权。如何获取AccessKey的具体操作，请参见访问密钥。	无
         ${access-key-secret}	阿里云账号AccessKey Secret。 建议您使用只具备日志服务Project写入权限的RAM用户的AccessKey。	无

   3. 启动OpenTelemetry Collector。

      ./otelcontribcol_linux_amd64 --config="./config.yaml"

2. 配置Zipkin。

   将Zipkin的输出端地址改为OpenTelemetry Collector监听的地址，例如OpenTelemetry Collector的地址为${collector-host}，则将Zipkin的输出端地址设置为${collector-host}:9411。