全部产品
Search
文档中心

Simple Log Service:Impor data jejak dari Zipkin ke Layanan Log Sederhana

更新时间:Jul 06, 2025

Anda dapat mengimpor data jejak dari Zipkin ke Layanan Log Sederhana. Selain itu, Anda dapat menggunakan OpenTelemetry Collector untuk meneruskan data jejak ke Layanan Log Sederhana.

Prasyarat

Sebuah instance jejak telah dibuat. Untuk informasi lebih lanjut, lihat Buat Instance Jejak.

Impor data jejak dari Zipkin

Jika ingin menggunakan protokol Zipkin untuk mengimpor data jejak ke Layanan Log Sederhana, Anda harus mengonfigurasi titik akhir dan pengaturan autentikasi di SDK Zipkin. Berikut adalah penjelasan terkait pengaturan tersebut:

Penting

Untuk memastikan keamanan data selama transmisi, pastikan Anda mengimpor data melalui HTTPS.

  • Pengaturan Titik Akhir

    • HTTP 2.0: Titik akhir HTTPS dalam format ${endpoint}/zipkin/api/v2/spans. Contoh: https://test-project.cn-hangzhou-intranet.log.aliyuncs.com/zipkin/api/v2/spans. Kami merekomendasikan penggunaan jenis titik akhir ini.

    • HTTP 1.0: Titik akhir HTTPS dalam format ${endpoint}/zipkin/api/v1/spans. Contoh: https://test-project.cn-hangzhou.log.aliyuncs.com/zipkin/api/v1/spans.

    Ganti variabel ${endpoint} dengan nilai sebenarnya. Tabel berikut menjelaskan variabel tersebut.

    Tabel 1. Deskripsi Variabel

    Variabel

    Deskripsi

    Contoh

    ${endpoint}

    Titik akhir. Formatnya adalah ${project}.${region-endpoint}, di mana:

    • ${project}: nama Proyek Layanan Log Sederhana.

    • ${region-endpoint}: Titik akhir Layanan Log Sederhana untuk wilayah tempat proyek berada. Anda dapat mengakses Layanan Log Sederhana menggunakan titik akhir publik atau internal. Titik akhir publik dapat diakses melalui Internet. Titik akhir internal dapat diakses melalui jaringan klasik atau virtual private cloud (VPC). Untuk informasi lebih lanjut, lihat Titik akhir.

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

  • Pengaturan Autentikasi

    Anda dapat mengonfigurasi pengaturan autentikasi di bidang header HTTPS. Tabel berikut menjelaskan bidang-bidang tersebut.

    Bidang header HTTPS

    Deskripsi

    Contoh

    x-sls-otel-project

    Nama Proyek Layanan Log Sederhana.

    test-project

    x-sls-otel-instance-id

    ID instance jejak. Untuk informasi lebih lanjut, lihat Buat instance jejak.

    test-traces

    x-sls-otel-ak-id

    ID AccessKey akun Alibaba Cloud Anda.

    Kami merekomendasikan Anda menggunakan pasangan AccessKey dari pengguna RAM yang hanya memiliki izin tulis pada Proyek Layanan Log Sederhana. Pasangan AccessKey terdiri dari ID AccessKey dan Rahasia AccessKey. Untuk informasi lebih lanjut tentang cara memberikan izin tulis pada proyek tertentu kepada pengguna RAM, lihat Gunakan kebijakan kustom untuk memberikan izin kepada pengguna RAM. Untuk informasi lebih lanjut tentang cara mendapatkan pasangan AccessKey, lihat Pasangan AccessKey.

    Tidak ada

    x-sls-otel-ak-secret

    Rahasia AccessKey akun Alibaba Cloud Anda.

    Kami merekomendasikan Anda menggunakan pasangan AccessKey dari pengguna RAM yang hanya memiliki izin tulis pada Proyek Layanan Log Sederhana.

    Tidak ada

Gunakan OpenTelemetry Collector untuk meneruskan data jejak

Anda dapat menggunakan SDK Zipkin untuk mengimpor data jejak dari Zipkin ke OpenTelemetry Collector, lalu menggunakan OpenTelemetry Collector untuk meneruskan data tersebut ke Layanan Log Sederhana. Metode ini mendukung transmisi data melalui HTTP atau HTTPS.

  1. Instal OpenTelemetry Collector.

    1. Unduh OpenTelemetry Collector.

    2. Konfigurasikan OpenTelemetry Collector.

      1. Buat file bernama config.yaml.

      2. Tambahkan kode berikut ke file config.yaml.

        Ganti variabel dalam kode berikut dengan nilai sebenarnya. Untuk informasi lebih lanjut tentang variabel, lihat Deskripsi Variabel.

        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]              # Setel parameter penerima ke zipkin.
              exporters: [alibabacloud_logservice/traces]   # Setel parameter pengekspor ke alibabacloud_logservice/sls-traces.
              # untuk debug
              #exporters: [logging/detail,alibabacloud_logservice/traces]

        Tabel 2. Deskripsi Variabel

        Variabel

        Deskripsi

        Contoh

        ${endpoint}

        Titik akhir Layanan Log Sederhana. Formatnya adalah ${region-endpoint}. ${region-endpoint} sebenarnya adalah titik akhir untuk wilayah tempat Proyek Layanan Log Sederhana berada. Anda dapat mengakses Layanan Log Sederhana menggunakan titik akhir publik atau internal. Titik akhir publik dapat diakses melalui Internet. Titik akhir internal dapat diakses melalui jaringan klasik atau VPC. Untuk informasi lebih lanjut, lihat Titik akhir.

        cn-hangzhou.log.aliyuncs.com

        ${project}

        Nama Proyek Layanan Log Sederhana.

        test-project

        ${instance}

        ID instance jejak. Untuk informasi lebih lanjut, lihat Buat instance jejak.

        test-traces

        ${access-key-id}

        ID AccessKey akun Alibaba Cloud Anda.

        Kami merekomendasikan Anda menggunakan pasangan AccessKey dari pengguna RAM yang hanya memiliki izin tulis pada Proyek Layanan Log Sederhana. Untuk informasi lebih lanjut tentang cara memberikan izin tulis pada proyek tertentu kepada pengguna RAM, lihat Gunakan kebijakan kustom untuk memberikan izin kepada pengguna RAM. Untuk informasi lebih lanjut tentang cara mendapatkan pasangan AccessKey, lihat Pasangan AccessKey.

        Tidak ada

        ${access-key-secret}

        Rahasia AccessKey akun Alibaba Cloud Anda.

        Kami merekomendasikan Anda menggunakan pasangan AccessKey dari pengguna RAM yang hanya memiliki izin tulis pada Proyek Layanan Log Sederhana.

        Tidak ada

    3. Mulai OpenTelemetry Collector.

      ./otelcontribcol_linux_amd64 --config="./config.yaml"
  2. Konfigurasikan Zipkin.

    Ubah titik akhir keluaran Zipkin ke titik akhir tempat OpenTelemetry Collector dapat mendengarkan. Misalnya, jika titik akhir OpenTelemetry Collector adalah ${collector-host}, ubah titik akhir keluaran Zipkin menjadi ${collector-host}:9411.

Apa yang harus dilakukan selanjutnya