如何接入ZipkinTrace資料 - Simple Log Service

您可以通過直接發送方式或OpenTelemetry Collector轉寄方式，將Zipkin平台上的Trace資料發送到Log Service。

前提條件

已建立Trace執行個體。更多資訊，請參見建立Trace執行個體。

直接發送

使用Zipkin協議直接發送Trace資料到Log Service時，您需要在Zipkin的SDK側配置新的存取點資訊和鑒權資訊。

警告

為保證傳輸安全性，直接發送方式必須使用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}

Log ServiceProject的接入地址，格式為${project}.${region-endpoint}，其中：

${project}：Log ServiceProject名稱。
${region-endpoint}：Log ServiceProject所在地區的訪問網域名稱，支援公網和阿里雲內網（傳統網路、VPC）。更多資訊，請參見服務入口。

test-project.cn-hangzhou.log.aliyuncs.com

鑒權資訊

您可以在HTTPS協議的Header中配置鑒權資訊，具體欄位及詳細說明如下表所示。

HTTPS Header Key	說明	樣本
x-sls-otel-project	Log ServiceProject。	test-project
x-sls-otel-instance-id	Trace服務執行個體ID。更多資訊，請參見建立Trace執行個體。	test-traces
x-sls-otel-ak-id	阿里雲帳號AccessKey ID。建議您使用只具備Log ServiceProject寫入許可權的RAM使用者的AccessKey（包括AccessKey ID和AccessKey Secret）。授予RAM使用者向指定Project寫入資料許可權的具體操作，請參見授權。如何擷取AccessKey的具體操作，請參見存取金鑰。	無
x-sls-otel-ak-secret	阿里雲帳號AccessKey Secret。建議您使用只具備Log ServiceProject寫入許可權的RAM使用者的AccessKey。	無

通過OpenTelemetry Collector轉寄

您可以通過Zipkin SDK將Zipkin平台上的Trace資料發送至OpenTelemetry Collector，再通過OpenTelemetry Collector轉寄至Log Service。該方式支援通過HTTP協議或HTTPS協議傳輸資料。

安裝OpenTelemetry Collector。

下載OpenTelemetry Collector。

配置OpenTelemetry Collector。

建立config.yaml檔案。

在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}	Log ServiceProject的接入地址，格式為${region-endpoint}，其中${region-endpoint}為Log ServiceProject所在地區的訪問網域名稱，支援公網和阿里雲內網（傳統網路、VPC）。更多資訊，請參見服務入口。	cn-hangzhou.log.aliyuncs.com
${project}	Log ServiceProject名稱。	test-project
${instance}	Trace服務執行個體ID。更多資訊，請參見建立Trace執行個體。	test-traces
${access-key-id}	阿里雲帳號AccessKey ID。建議您使用只具備Log ServiceProject寫入許可權的RAM使用者的AccessKey。授予RAM使用者向指定Project寫入資料許可權的具體操作，請參見授權。如何擷取AccessKey的具體操作，請參見存取金鑰。	無
${access-key-secret}	阿里雲帳號AccessKey Secret。建議您使用只具備Log ServiceProject寫入許可權的RAM使用者的AccessKey。	無

啟動OpenTelemetry Collector。

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

配置Zipkin。
將Zipkin的輸出端地址改為OpenTelemetry Collector監聽的地址，例如OpenTelemetry Collector的地址為${collector-host}，則將Zipkin的輸出端地址設定為${collector-host}:9411。

Simple Log Service：接入Zipkin Trace資料

前提條件

直接發送

通過OpenTelemetry Collector轉寄

後續步驟