全部产品
Search
文档中心

Managed Service for OpenTelemetry:Asosiasikan log aplikasi dengan ID jejak di Layanan Log Sederhana

更新时间:Jul 02, 2025

Layanan Log Sederhana menyediakan fitur konfigurasi event yang memungkinkan Anda mengasosiasikan log dengan ID jejak. Jika terjadi kesalahan dalam aplikasi, Anda dapat menggunakan ID jejak yang ditulis ke log aplikasi untuk mengidentifikasi jejak dan menyelesaikan kesalahan tersebut secepat mungkin. Topik ini menjelaskan cara mengasosiasikan log aplikasi dengan ID jejak di Layanan Log Sederhana.

Prasyarat

Langkah 1: Ekstrak ID jejak

  • Jika ID jejak disimpan di bidang terpisah dalam log, lewati langkah ini.

  • Jika ID jejak terdapat di salah satu bidang log seperti bidang konten, ekstrak ID jejak dari bidang konten dan tampilkan di bidang terpisah.

  1. Masuk ke Konsol Layanan Log Sederhana.

  2. Pilih proyek dan penyimpanan log tempat log aplikasi disimpan.

  3. Gunakan Prosesor Logtail untuk mengekstrak ID jejak dari log dalam mode regex dan tampilkan ID jejak di bidang terpisah.

    1. Di panel Logstores di sisi kiri, pilih Data Collection > Logtail Configurations. Di halaman Konfigurasi Logtail, temukan konfigurasi Logtail yang ingin Anda kelola dan klik Kelola Konfigurasi Logtail di kolom Aksi.

      image

    2. Klik Edit untuk mulai mengedit. Di bagian Konfigurasi Prosesor pada tab Detail Konfigurasi, klik Tambah Prosesor dan pilih Ekstrak Bidang (Mode Regex) dari daftar drop-down Jenis Prosesor.

      Dalam contoh ini, ID jejak atau ID rentang terdapat di bidang konten log. Contoh kode berikut menunjukkan bidang konten log:

      2024-05-06 12:12:49.685 [http-nio-9190-exec-3] DEBUG io.lettuce.core.protocol.DefaultEndpoint - traceId:ea1a00002d17150191696858089d0007 - [channel=0x5d069239, /10.0.0.45:49614 -> redis/192.168.216.80:6379, epid=0x1] write() done

      Di bagian Konfigurasi Dasar, atur parameter Bidang Asli ke konten, atur parameter Ekspresi Reguler ke traceId:([a-zA-Z0-9]+), dan tambahkan ID jejak atau ID rentang ke bidang Nama Bidang Baru. Untuk informasi lebih lanjut, lihat Plugin asli: Penguraian Data (Mode Regex).

      image.pngSetelah konfigurasi selesai, ID jejak akan ditampilkan di bidang terpisah dalam log, seperti yang ditunjukkan pada gambar berikut.

      image

Langkah 2: Konfigurasikan sebuah event

  1. Klik ID jejak atau ID rentang di log lalu klik Pergi ke konfigurasi.

  2. Di kotak dialog Pengaturan Event Lanjutan, tambahkan event untuk bidang traceId atau spanId dan klik OK. Bagian berikut menjelaskan parameter dari event tersebut.

    image

    • Nama Konfigurasi: Masukkan nama kustom. Contoh: Mulai Analisis Jejak.

    • Tindakan Event: Pilih Buat URL HTTP Kustom.

    • Protokol: Pilih Kustom dan masukkan https di kotak input.

    • Masukkan URL:

      • Untuk menggunakan ID jejak untuk menyaring jejak, tentukan URL dalam format trace.console.aliyun.com/#/${regionId}/tracing-explorer?source=XTRACE&filters=traceId="${traceId}". Ganti ${regionId} dengan ID wilayah tempat aplikasi Anda terhubung ke Managed Service for OpenTelemetry.

        Sebagai contoh, jika aplikasi Anda terhubung ke Managed Service for OpenTelemetry di wilayah China (Hangzhou), ganti ${regionId} dengan cn-hangzhou. Dalam hal ini, URL lengkapnya adalah trace.console.aliyun.com/#/cn-hangzhou/tracing-explorer?source=XTRACE&filters=traceId="${traceId}".

      • Untuk menggunakan ID rentang untuk menyaring jejak, ekstrak ID rentang untuk menampilkannya di bidang terpisah, dan ganti ${traceId} di URL dengan ${spanId}. Untuk menggunakan ID jejak dan ID rentang untuk menyaring jejak, gunakan URL berikut: trace.console.aliyun.com/#/cn-hangzhou/tracing-explorer?source=XTRACE&filters=traceId="${traceId}" AND spanId="${spanId}".

      • Untuk menggunakan atribut kustom termasuk informasi Atribut dan Sumber Daya untuk menyaring jejak, tentukan URL dalam format berikut: trace.console.aliyun.com/#/cn-hangzhou/tracing-explorer?source=XTRACE&filters=${Nama atribut kustom di jejak}="${Nama bidang di log}".

        Sebagai contoh, jika Anda ingin menyaring jejak namespace, log berisi bidang namespace, dan atribut k8s.namespace.name ditambahkan ke jejak. Dalam hal ini, URL lengkapnya adalah trace.console.aliyun.com/#/cn-hangzhou/tracing-explorer?source=XTRACE&filters=resources.k8s.namespace.name="${namespace}".

  3. Setelah event dikonfigurasi, klik lagi ID jejak atau ID rentang di log, dan klik Mulai Analisis Jejak untuk pergi ke halaman Penjelajah Jejak dari Managed Service for OpenTelemetry.

    image

    Di halaman Penjelajah Jejak, Anda dapat mencari jejak berdasarkan ID jejak. Untuk informasi lebih lanjut, lihat Penjelajah Jejak.

    image