Application Real-Time Monitoring Service:Konfigurasi Kustom Aplikasi Golang

Prasyarat

Probe ARMS sudah terinstal untuk aplikasi Anda. Untuk informasi selengkapnya, lihat Application Monitoring Overview.

Akses fitur

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

2. Pada halaman Application List, pilih region di bagian atas halaman, lalu klik nama aplikasi Anda.

   Catatan

   Berikut arti ikon pada kolom Language:

   : aplikasi Java yang terintegrasi dengan Application Monitoring.

   : aplikasi Golang yang terintegrasi dengan Application Monitoring.

   : aplikasi Python yang terintegrasi dengan Application Monitoring.

   -: aplikasi yang terintegrasi dengan Managed Service for OpenTelemetry.

3. Pada navigation bar atas, pilih Application Configuration > Custom Configuration.

4. Konfigurasikan pengaturan kustom dan klik Save.

Sampling settings

Pada bagian Sampling Settings, Anda dapat menetapkan kebijakan sampling untuk trace. Aplikasi Golang hanya mendukung fixed-rate sampling. Anda juga dapat mengonfigurasi full sampling berdasarkan nama antarmuka, awalan, atau akhiran.

Probe toggle settings

Pada bagian Probe Toggle Settings, Anda dapat mengaktifkan atau menonaktifkan Application Monitoring serta mengaktifkan atau menonaktifkan plugin individual.

Runtime toggle settings

Pada bagian Runtime Toggle Settings, Anda dapat mengaktifkan atau menonaktifkan 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 Anda. Ini memungkinkan Anda menambahkan SpanId dan TraceId ke log yang sesuai. Untuk informasi selengkapnya, lihat Associate Golang Application Business Logs with TraceId.

URL convergence settings

Pada bagian URL Convergence Settings, Anda dapat mengaktifkan atau menonaktifkan konvergensi URL. Anda juga dapat menetapkan threshold dan aturan konvergensi. Konvergensi URL mengelompokkan URL yang serupa menjadi satu entri. Misalnya, semua URL yang dimulai dengan /service/demo/ akan muncul sebagai satu entri. Threshold konvergensi menentukan jumlah minimum URL yang cocok sebelum konvergensi dilakukan. Sebagai contoh, jika threshold-nya 100, ARMS hanya melakukan konvergensi ketika terdapat minimal 100 URL yang sesuai dengan ekspresi reguler yang ditentukan. Untuk informasi selengkapnya, lihat ARMS Convergence Mechanism.

Continuous profiling settings

Pada bagian Continuous Profiling Settings, Anda dapat mengaktifkan atau menonaktifkan toggle global, CPU hotspots, memory hotspots, dan code hotspots. Untuk informasi selengkapnya, lihat Continuous Profiling for Golang Applications.

API call configuration

Pada bagian API Call Configuration, Anda dapat menetapkan threshold slow-call, whitelist kode status HTTP, dan filter untuk panggilan API yang tidak valid.

• Slow Call Threshold: Nilai default adalah 500. Jika waktu respons suatu antarmuka melebihi threshold ini, antarmuka tersebut ditandai sebagai slow call.

• HTTP status code whitelist:

  Secara default, kode status HTTP yang lebih besar dari 400 diklasifikasikan sebagai error. Untuk mencegah kode status tertentu diklasifikasikan sebagai error, Anda dapat menambahkannya ke whitelist.

  Pengaturan ini hanya berlaku untuk framework HTTP yang didukung oleh Application Monitoring. Untuk informasi selengkapnya, lihat Supported HTTP Frameworks.

  Dampak pada metrik: Jumlah error untuk server dan client HTTP (arms_http_requests_error_count, arms_http_client_requests_error_count, dan arms_app_requests_error_count) serta status Span.

  Dampak pada fitur: Jumlah error pada tab Application Overview, Provided Services, dan Dependent Services. Status Span dan peringatan jumlah error pada halaman Trace Analysis.

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

  Contoh: 403,502

  Nilai default: Kosong

• Invalid API call filtering:

  Untuk menyembunyikan panggilan tertentu dari tab Provided Services, masukkan nama API yang ingin Anda abaikan. Probe tidak melaporkan data telemetri untuk API-API tersebut, sehingga tidak muncul dalam tampilan panggilan API.

  Dampak pada metrik: Semua metrik dan Span untuk API yang ditentukan diabaikan.

  Dampak pada fitur: Semua metrik untuk API yang ditentukan pada tab Application Overview, Provided Services, dan Dependent Services. Jumlah Span, jumlah panggilan, jumlah error, dan peringatan slow-call untuk API yang ditentukan pada halaman Trace Analysis.

  Format: Gunakan string atau ekspresi AntPath untuk mencocokkan nama API lengkap. Pisahkan beberapa aturan dengan koma (,). (Ekspresi AntPath default disertakan untuk kompatibilitas mundur dengan data historis. Jangan hapus ekspresi tersebut. Tambahkan aturan baru setelah yang sudah ada.)

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

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

• Enable HTTP request body logging: Ketika diaktifkan, field http.request.body muncul dalam Span client HTTP. Panjang default adalah 1024 karakter.

• Enable HTTP request header logging: Ketika diaktifkan, field http.request.header muncul dalam Span client HTTP.

• HTTP request body length: Panjang maksimum HTTP request body yang diambil. Panjang default adalah 1024 karakter.

• Include TraceId in HTTP response headers: Ketika diaktifkan, ARMS menambahkan TraceId ke header respons dengan key Eagleeye-TraceId.

• Enable HTTP response body logging: Ketika diaktifkan, field http.response.body muncul dalam Span server HTTP.

• Enable HTTP response header logging: Ketika diaktifkan, field http.response.header muncul dalam Span server HTTP.

• HTTP response body length: Panjang maksimum HTTP response body yang diambil. Panjang default adalah 1024 karakter.

• HTTP request header keys to include in Spans: Masukkan key header yang ingin disertakan, dipisahkan dengan koma (,). Setelah pengaturan ini dikonfigurasi, ARMS akan menambahkan field http.request.header.key ke Span client HTTP.

• HTTP response header keys to include in Spans: Masukkan key header yang ingin disertakan, dipisahkan dengan koma (,). Setelah pengaturan ini dikonfigurasi, ARMS akan menambahkan field http.response.header.key ke Span server HTTP.

Advanced exception filtering configuration

• Collection plugin abnormality: Menunjukkan apakah plugin pengumpulan mengalami anomali.

• Exception filter whitelist: Untuk menyembunyikan exception tertentu dari tab Exception Analysis, masukkan nama exception yang ingin Anda kecualikan dari statistik exception.

Database call configuration

Pada bagian Database Call Configuration, Anda dapat menetapkan threshold SQL lambat, panjang maksimum pernyataan SQL yang diambil, serta apakah nilai variabel terikat dan nilai konstan ditampilkan dalam pernyataan SQL.

• Display bound variable values in SQL: Mengambil nilai variabel yang terikat pada parameter PreparedStatement. Perubahan berlaku tanpa perlu restart aplikasi.

• Display constant values in SQL: Pengaturan ini hanya memotong pernyataan SQL, tidak melakukan pemrosesan tambahan, dan berlaku tanpa perlu restart aplikasi.

Trace propagation protocol settings

Pada bagian Trace Propagation Protocol Settings, Anda dapat memilih protokol pelacakan (trace protocol) yang sesuai dengan kebutuhan Anda. W3C adalah protokol default. Anda juga dapat memilih Zipkin, Jaeger, atau EagleEye.

Probe collection configuration

Pada bagian Probe Collection Configuration, Anda dapat menetapkan jumlah maksimum jejak yang dikumpulkan per detik dan tingkat log probe.

Berikut deskripsi beberapa parameter:

• Custom metric collection: Mengontrol apakah agen mengumpulkan metrik yang didefinisikan dalam kode Anda menggunakan SDK OpenTelemetry.

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

• Span Reporting Name: Menentukan nama Span yang akan dilaporkan setelah shutdown.

• Custom metric collection configuration: Konfigurasikan nama scope metrik. Jika tidak dikonfigurasi, semua metrik kustom dikumpulkan secara default.

Default metric collection filtering: Memfilter jenis metrik yang dilaporkan. Anda dapat memilih satu atau beberapa jenis berikut:

• custom_entry: Metrik kustom untuk pemantauan metode.

• http: Metrik untuk server HTTP.

• http_client: Metrik untuk client HTTP.

• rpc: Metrik untuk panggilan server RPC.

• rpc_client: Metrik untuk panggilan client RPC.

• sql: Metrik untuk akses database.

• nosql: Metrik untuk akses layanan NoSQL.

• cache: Metrik untuk akses layanan cache.

• producer: Metrik untuk penerbitan pesan.

• consumer: Metrik untuk konsumsi pesan.

• schedule: Metrik untuk layanan penjadwalan.

Advanced settings

Pada bagian Advanced Settings, Anda dapat mengonfigurasi perhitungan persentil, sampling slow call dan error, serta panjang maksimum stack trace untuk exception.

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.