Application Real-Time Monitoring Service：Konfigurasi kustom untuk aplikasi Golang

Prasyarat

Probe telah dipasang untuk aplikasi. Untuk informasi selengkapnya, lihat Application Monitoring Onboarding Overview.

Titik masuk fitur

1. Masuk ke ARMS console. Pada panel navigasi kiri, pilih Application Monitoring > Application List.

3. Pada bilah navigasi atas, pilih Application Settings > Custom Configuration.

4. Atur parameter konfigurasi kustom, lalu klik Save.

Sampling settings

Pada bagian Sampling settings, Anda dapat mengatur kebijakan sampling untuk rantai panggilan (call chains). Aplikasi Golang mendukung sampling dengan laju tetap. Anda juga dapat mengonfigurasi full sampling berdasarkan nama antarmuka, awalan (prefix), atau akhiran (suffix).

Probe switch settings

Pada bagian Probe switch settings, Anda dapat memulai atau menghentikan Application Monitoring serta mengaktifkan atau menonaktifkan setiap plugin.

Runtime switch settings

Pada bagian Runtime switch settings, Anda dapat mengaktifkan atau menonaktifkan fitur pemantauan Runtime. Untuk informasi selengkapnya, lihat Runtime monitoring.

Application log association configuration

Pada bagian Application log association configuration, Anda dapat mengonfigurasi sumber log yang akan dikaitkan dengan aplikasi. Hal ini memungkinkan Anda mencetak SpanId dan TraceId ke log yang sesuai. Untuk informasi selengkapnya, lihat Associate business logs of a Golang application with a TraceId.

URL convergence settings

Pada bagian URL convergence settings, Anda dapat mengaktifkan atau menonaktifkan fitur konvergensi serta mengatur ambang batas dan aturan konvergensi. Konvergensi URL mengelompokkan URL yang serupa sehingga ditampilkan sebagai satu item. Misalnya, rangkaian URL yang semuanya diawali dengan /service/demo/ akan ditampilkan bersama. Ambang batas konvergensi adalah jumlah minimum URL yang diperlukan agar terjadi konvergensi. Sebagai contoh, jika ambang batasnya 100, URL yang sesuai dengan ekspresi reguler hanya akan dikonvergensikan ketika jumlah URL yang cocok mencapai 100. Untuk informasi selengkapnya, lihat ARMS convergence mechanism.

Continuous profiling settings

Pada bagian Continuous profiling settings, Anda dapat mengaktifkan atau menonaktifkan sakelar utama, serta fitur hot spot CPU, hot spot memori, dan hot spot kode. Untuk informasi selengkapnya, lihat Continuous profiling for Golang applications.

Interface call configuration

Pada bagian Interface call configuration, Anda dapat mengatur ambang batas panggilan lambat, daftar putih kode status HTTP, dan filter panggilan antarmuka yang tidak valid.

• Slow Call Threshold: Nilai default adalah 500. Jika waktu respons suatu antarmuka melebihi ambang batas ini, antarmuka tersebut ditandai sebagai panggilan lambat.

• HTTP status code whitelist:

  Secara default, kode status HTTP yang lebih besar dari 400 menunjukkan panggilan error. Jika Anda tidak ingin kode status tertentu diklasifikasikan sebagai error, Anda dapat menambahkannya ke daftar putih.

  Pengaturan ini hanya berlaku untuk HTTP framework yang saat ini didukung oleh Application Monitoring.

  Data yang terpengaruh: Metrik jumlah error untuk sisi server/klien HTTP (arms_http_requests_error_count, arms_http_client_requests_error_count, arms_app_requests_error_count) dan status Span.

  Fitur yang terpengaruh: Jumlah error pada tab Application Overview, Provided Services, dan Dependent Services. Status Span dan alert jumlah error pada halaman Trace Analysis.

  Format: Masukkan satu kode status. Pisahkan beberapa kode status dengan koma (,). Pencocokan fuzzy tidak didukung.

  Contoh: 403,502

  Default: Kosong

• Invalid interface call filter:

  Jika Anda tidak ingin melihat panggilan tertentu pada tab Provided Services, Anda dapat memasukkan nama antarmuka yang sesuai. Probe tidak akan melaporkan data pemantauan untuk antarmuka tersebut, sehingga menyembunyikannya dari halaman panggilan antarmuka.

  Data yang terpengaruh: Semua metrik dan Span untuk antarmuka yang ditentukan akan diabaikan.

  Fitur yang terpengaruh: Semua metrik untuk antarmuka yang ditentukan pada tab Application Overview, Provided Services, dan Dependent Services. Jumlah Span, volume panggilan, jumlah error, dan alert panggilan lambat untuk antarmuka yang ditentukan pada halaman Trace Analysis.

  Format: Gunakan string atau ekspresi AntPath untuk mencocokkan nama lengkap antarmuka yang akan difilter. Pisahkan beberapa aturan dengan koma (,). (Format ekspresi AntPath pada nilai default disediakan untuk kompatibilitas dengan data historis. Jangan hapusnya. Tambahkan konfigurasi baru ke aturan yang sudah ada.)

  Contoh: /api/test/*,/api/playground/create

  Default: /**/*.jpg,/**/*.png,/**/*.js,/**/*.jpeg,/**/*.pdf,/**/*.xlsx,/**/*.txt,/**/*.docs,/**/*.gif,/**/*.csv

• Enable printing of HTTP request Body: Jika diaktifkan, bidang http.request.body ditambahkan ke HTTP Client Span untuk menyimpan badan permintaan. Panjang default adalah 1024.

• Enable printing of HTTP request Header: Jika diaktifkan, bidang http.request.header ditambahkan ke HTTP Client Span untuk menyimpan header permintaan.

• HTTP Body length: Panjang maksimum badan permintaan HTTP yang akan disimpan. Panjang default adalah 1024.

• Include TraceId in HTTP response: Jika diaktifkan, TraceId ditambahkan ke header respons. Kuncinya adalah Eagleeye-TraceId.

• Enable printing of HTTP response Body: Jika diaktifkan, bidang http.response.body ditambahkan ke HTTP Server Span untuk menyimpan badan respons.

• Enable printing of HTTP response Header: Jika diaktifkan, bidang http.response.header ditambahkan ke HTTP Server Span untuk menyimpan header respons.

• HTTP response Body length: Panjang maksimum badan respons HTTP yang akan disimpan. Panjang default adalah 1024.

• Write HTTP request Header Key to Span: Masukkan kunci header yang ingin Anda tulis ke Span. Pisahkan beberapa kunci dengan koma. Setelah dikonfigurasi, bidang http.request.header.key ditambahkan ke HTTP Client Span.

• Write HTTP response Header Key to Span: Masukkan kunci header yang ingin Anda tulis ke Span. Pisahkan beberapa kunci dengan koma. Setelah dikonfigurasi, bidang http.response.header.key ditambahkan ke HTTP Server Span.

Database call configuration

Pada bagian Database call configuration, Anda dapat mengatur ambang batas pernyataan SQL lambat dan panjang maksimum pernyataan SQL yang dikumpulkan. Anda juga dapat mengonfigurasi apakah akan menampilkan nilai binding variabel dan nilai konstan dalam pernyataan SQL.

• Display variable binding values in SQL: Menangkap nilai variabel yang di-bind ke parameter PreparedStatement. Perubahan ini berlaku tanpa perlu restart aplikasi.

• Display constant values in SQL: Menampilkan nilai konstan dalam pernyataan SQL. Perubahan ini berlaku tanpa perlu restart aplikasi.

Call chain pass-through protocol settings

Pada bagian Call chain pass-through protocol settings, Anda dapat memilih protokol jejak (trace protocol) yang diperlukan. Protokol default adalah W3C. Anda juga dapat memilih protokol lain, seperti Zipkin, Jaeger, atau EagleEye.

Probe collection configuration

Pada bagian Probe collection configuration, Anda dapat mengatur jumlah maksimum jejak (traces) yang dikumpulkan oleh probe per detik dan tingkat log probe.

Daftar berikut menjelaskan beberapa parameter:

• Custom metric collection mengontrol apakah agen mengumpulkan metrik kustom yang didefinisikan dalam kode Anda menggunakan SDK OpenTelemetry (OTel).

• Enable Span reporting: Diaktifkan secara default. Jika dinonaktifkan, tidak ada Span yang dilaporkan.

• Span reporting name: Tentukan nama Span yang tetap dilaporkan meskipun fitur ini dinonaktifkan.

• Custom metric collection configuration: Konfigurasikan nama cakupan (scope) metrik. Jika Anda tidak mengonfigurasi parameter ini, semua metrik kustom dikumpulkan secara default.

Default metric collection filter: Memfilter pelaporan jenis metrik tertentu. Jenis berikut didukung. Anda dapat memilih beberapa jenis:

• custom_entry: Titik masuk untuk memantau metrik kustom.

• http: Metrik sisi server HTTP.

• http_client: Metrik klien HTTP.

• rpc: Metrik sisi server panggilan RPC.

• rpc_client: Metrik klien panggilan RPC.

• sql: Metrik terkait akses ke layanan database.

• nosql: Metrik terkait akses ke layanan NoSQL.

• cache: Metrik terkait akses ke layanan cache.

• producer: Metrik terkait pengiriman pesan.

• consumer: Metrik terkait konsumsi pesan.

• schedule: Metrik terkait layanan penjadwalan.

Advanced settings

Pada bagian Advanced settings, Anda dapat mengonfigurasi statistik kuantil, sampling error dan panggilan lambat, serta panjang maksimum untuk mengumpulkan tumpukan panggilan abnormal.

Copy settings to other applications

Untuk menyinkronkan pengaturan yang sama ke aplikasi lain, Anda dapat menyalin pengaturan tersebut ke aplikasi lain.

Global default configurations

Anda dapat menyimpan pengaturan saat ini sebagai konfigurasi default global. Saat Anda membuat aplikasi baru, pengaturan ini akan digunakan secara default.

1. Di bagian bawah halaman, klik Save current app settings as global default configuration.

2. Jika muncul kotak dialog Current settings not saved, klik OK untuk menyimpan pengaturan untuk aplikasi saat ini, lalu klik Save current app settings as global default configuration.

3. Pada kotak dialog yang muncul, klik Confirm.