文档

接入Zipkin Trace数据

更新时间:
重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

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

前提条件

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

直接发送

使用Zipkin协议直接发送Trace数据到日志服务时,您需要在Zipkin的SDK侧配置新的接入点信息和鉴权信息。配置案例,请参见zipkin demo

警告

为保证传输安全性,直接发送方式必须使用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的接入地址,格式为${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。

后续步骤