您可以通过直接发送方式或OpenTelemetry Collector转发方式,将Zipkin平台上的Trace数据发送到日志服务。

前提条件

已创建Trace实例。更多信息,请参见创建Trace实例

直接发送

使用Zipkin协议直接发送Trace数据到日志服务时,您需要在Zipkin平台上配置接入点信息和鉴权信息,详细说明如下:
注意 为保证传输安全性,直接发送方式必须使用HTTPS协议。
  • 接入点信息
    • (推荐)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}.${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。 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文件中添加如下代码。

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

        receivers:
          zipkin:
            endpoint: 0.0.0.0:9411
        exporters:
          logging/detail:
            loglevel: debug
          alibabacloud_logservice/sls-trace:
            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/sls-trace]   #发送端配置为alibabacloud_logservice/sls-trace。
              # for debug
              #exporters: [logging/detail,alibabacloud_logservice/sls-trace]
        表 2. 变量说明
        参数 说明 示例
        ${endpoint} 日志服务的接入地址,格式为${region-endpoint},其中${region-endpoint}为Project访问域名,支持公网和阿里云内网(经典网络、VPC)。更多信息,请参见服务入口 cn-hangzhou.log.aliyuncs.com
        ${project} 日志服务Project名称。 test-project
        ${instance} 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。

后续步骤