Topik ini menjelaskan cara mengonfigurasi Tracing Analysis di Konsol API Gateway untuk mengunggah log ke platform Alibaba Cloud Tracing Analysis. Tracing Analysis menyediakan fitur seperti pemulihan jejak panggilan, statistik volume permintaan, peta topologi, dan analisis ketergantungan aplikasi guna meningkatkan efisiensi pengembangan dan diagnosis. Fitur ini hanya tersedia untuk instans khusus.
Prasyarat
Menggunakan instans khusus API Gateway.
Mengaktifkan Tracing Analysis.
Mengaktifkan Simple Log Service.
Berikan izin kepada Tracing Analysis
Masuk ke Konsol Tracing Analysis.
Pada halaman Overview, klik Authorize Now untuk memberikan izin kepada Tracing Analysis agar dapat membaca dan menulis data Simple Log Service Anda.
Pada halaman Cloud Resource Access Authorization, pilih izin yang diperlukan lalu klik Confirm Authorization Policy.
Setelah otorisasi, buka halaman Overview dari panel navigasi di sebelah kiri. Di bagian Access Process, klik View Access Point Information. Di halaman Access Point Information, aktifkan Show Token dan pilih Jaeger sebagai Client-side Collection Tool. Anda kemudian dapat menemukan dan menyimpan alamat titik akhir di bagian Report Data over HTTP.
Konfigurasi analisis jejak di API Gateway
Masuk ke Konsol API Gateway.
Pada panel navigasi di sebelah kiri, pilih API Management > API Groups. Pada daftar API Groups, klik grup API untuk membuka halaman Group Details. Pada halaman Group Details, konfigurasikan parameter berikut.
Trace Field Position: Tentukan lokasi bidang jejak. Nilai yang valid adalah Header dan Query.
Tracing Field Name: Tentukan nama bidang yang dilacak.
Bidang yang dilacak dihasilkan oleh client. API Gateway meneruskan bidang tersebut ke layanan backend dan mencatatnya dalam bidang CustomTraceId. API Gateway menggunakan nilai bidang tersebut sebagai trace ID untuk melaporkan log ke Tracing Analysis. Nilai bidang tersebut harus dalam format TraceId standar, yaitu angka heksadesimal 16-bit atau 32-bit.
Jika client tidak menghasilkan bidang tersebut atau nilainya tidak dalam format yang valid, API Gateway akan menghasilkan trace ID acak untuk melaporkan log ke Tracing Analysis.
Pass through or generate EagleEye-related headers (Eagleeye-Rpcid, Eagleeye-Traceid, Eagleeye-Sampled): Jika Anda memilih opsi ini, API Gateway akan meneruskan header terkait EagleEye dari client ke layanan backend. Jika client tidak mengirim header tersebut, API Gateway akan menghasilkan dan meneruskannya ke layanan backend. (Fitur ini tersedia untuk instans Serverless dan instans khusus.)
Pass through or generate B3-related headers (X-B3-traceid, X-B3-Parentspanid, X-B3-Spanid, X-B3-Sampled): Jika Anda memilih opsi ini, API Gateway akan meneruskan header terkait B3 dari client ke layanan backend. Jika client tidak mengirim header tersebut, API Gateway akan menghasilkan dan meneruskannya ke layanan backend. (Fitur ini tersedia untuk instans Serverless dan instans khusus.)
Upload Trace Logs to Alibaba Cloud Tracing Analysis (For dedicated instances only):
App Name: Tentukan nama aplikasi yang ingin Anda konfigurasikan untuk analisis jejak.
Endpoint: Masukkan alamat endpoint dari Langkah 4 di Berikan izin kepada Tracing Analysis. Jika layanan Anda berada di wilayah yang sama, gunakan endpoint jaringan internal untuk performa yang lebih baik.
Log Sampling Strategy: Pilih opsi sesuai kebutuhan Anda. Nilai yang valid: Upload all, Percentage upload, dan Fixed number of uploads per second.
Setelah Anda mengonfigurasi Tracing Analysis di Konsol API Gateway, Anda dapat melihat jejak permintaan di Konsol Tracing Analysis. Untuk informasi selengkapnya tentang cara menggunakan Tracing Analysis, lihat Lihat detail panggilan API.