Application Real-Time Monitoring Service：Hubungkan ID jejak dengan log untuk aplikasi Python

Prasyarat

• Aplikasi Python telah diintegrasikan dengan ARMS. Untuk informasi lebih lanjut, lihat Pantau aplikasi Python.

• Log dikumpulkan menggunakan Simple Log Service. Untuk informasi lebih lanjut, lihat Ikhtisar pengumpulan data.

Informasi latar belakang

Kemampuan menghubungkan ID jejak dengan log Python di ARMS bergantung pada instrumentasi kerangka kerja log. Saat ini, hanya Logging, kerangka kerja resmi Python, yang didukung.

Prosedur

1. Masuk ke Konsol ARMS. Di panel navigasi di sebelah kiri, pilih Application Monitoring > Application List.

2. Pilih wilayah di bilah navigasi atas dan klik aplikasi.

   Catatan

   Ikon di kolom Language menunjukkan bahasa pemrograman aplikasi:

   • : Java

   • : Go

   • : Python

   • - (Tanda hubung): aplikasi yang dipantau di Managed Service for OpenTelemetry.

3. Di bilah navigasi atas, pilih Configuration > Custom Configurations.

4. Di bagian Application log Association configuration dari tab Custom Configurations, atur Log Source ke Log service SLS. Pilih wilayah tempat Simple Log Service diterapkan, dan ikat proyek dan penyimpanan log.

   

5. Konfigurasikan agen ARMS untuk Python.

   1. Atur variabel lingkungan OTEL_PYTHON_LOG_CORRELATION ke true untuk mengaktifkan fitur menghubungkan log bisnis dengan ID jejak di agen.

      • Nilai default dari OTEL_PYTHON_LOG_CORRELATION adalah false.

      • Jika Anda mengatur OTEL_PYTHON_LOG_CORRELATION ke false atau meninggalkan variabel ini kosong, fitur ini dinonaktifkan.

   2. Atur variabel lingkungan OTEL_PYTHON_LOG_LEVEL ke warning, debug, info, atau error berdasarkan kebutuhan bisnis Anda. Variabel ini menentukan tingkat log bisnis yang akan dihubungkan dengan ID jejak.

   3. Atur variabel lingkungan OTEL_PYTHON_LOG_FORMAT. Contoh nilainya adalah %(asctime)s %(levelname)s [%(name)s] [%(filename)s:%(lineno)d] [trace_id=%(otelTraceID)s span_id=%(otelSpanID)s resource.service.name=%(otelServiceName)s trace_sampled=%(otelTraceSampled)s] - %(message)s. Anda dapat menyesuaikan nilai ini berdasarkan kebutuhan bisnis Anda.

      Berikut ini mendefinisikan beberapa bidang:

      • otelTraceID: ID jejak.

      • otelSpanID: ID rentang yang dihasilkan oleh log saat ini.

      • otelTraceSampled: Pengenal pengambilan sampel.

      • otelServiceName: Nama aplikasi.

   4. Log secara otomatis dihubungkan dengan ID jejak hanya untuk logger utama. Untuk mengaktifkan ini untuk penanganan kustom, konfigurasikan formatter secara manual.

      formatter = logging.Formatter(os.getenv('OTEL_PYTHON_LOG_FORMAT'))
      my_handler.setFormatter(formatter)

   Setelah Anda mengonfigurasi variabel lingkungan di atas, log berikut akan dikembalikan:

   

6. (Opsional) Konfigurasikan pengumpulan log dan unggah log aplikasi ke proyek dan penyimpanan log.

   Secara default, agen ARMS untuk Python tidak mengumpulkan log aplikasi.