Container Service for Kubernetes:Pemantauan aplikasi Go

Prasyarat

• Anda telah membuat kluster ACK. Kluster ACK yang dikelola direkomendasikan. Untuk petunjuknya, lihat Create an ACK managed cluster.

  Pembuatan kluster khusus ACK yang baru tidak lagi tersedia, tetapi kluster khusus yang sudah ada tetap didukung. Untuk informasi selengkapnya, lihat Create an ACK dedicated cluster (discontinued).

• Aplikasi Go Anda menggunakan Go 1.18 atau versi yang lebih baru.

• Anda telah mengaktifkan ARMS.

  ARMS adalah layanan manajemen performa aplikasi (APM) dari Alibaba Cloud. Untuk informasi selengkapnya tentang ARMS, lihat Apa itu ARMS? dan Apa itu Pemantauan Aplikasi?.

Langkah 1: Instal ack-onepilot, add-on pemantauan aplikasi ARMS

1. Masuk ke Konsol ACK. Di panel navigasi sebelah kiri, klik Clusters.

2. Pada halaman Clusters, klik nama kluster Anda. Di panel navigasi sebelah kiri, klik Components and Add-ons.

Langkah 2: Kompilasi file biner Go dan buat gambar kontainer

Gunakan tool build Go yang ditingkatkan, yaitu instgo, bersama lingkungan build Go lokal (Go 1.18 atau lebih baru) untuk mengompilasi program Go Anda menjadi file biner yang melaporkan data pemantauan ke ARMS.

1. (Opsional) Jika proyek Anda menyertakan direktori vendor selama proses build, tambahkan -mod=vendor setelah go build.

2. Gunakan perintah wget untuk mengunduh tool build instgo.

   Selama proses build, instgo diperbarui secara otomatis. Simpan instgo di direktori tempat pengguna build memiliki izin menulis.

   Catatan

   instgo adalah tool build dari ARMS yang menginstrumen proyek Go Anda, sehingga ARMS dapat memantau aplikasi Anda.

   Jika lingkungan build Anda memiliki akses internet ke Object Storage Service (OSS), pilih URL unduh internet China (Hangzhou) yang sesuai dengan sistem operasi dan arsitektur lingkungan build Anda.

   Perintah unduh

   Linux (AMD64)

   wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-linux-amd64" -O instgo

   Linux (ARM64)

   wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-linux-arm64" -O instgo

   Mac (ARM64)

   wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-darwin-arm64" -O instgo

   Mac (AMD64)

   wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-darwin-amd64" -O instgo

   Windows (AMD64)

   wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-windows-amd64.exe" -O instgo.exe

3. Buat tool build tersebut dapat dieksekusi.

   Linux/Mac

   # Berikan izin eksekusi.
   chmod +x instgo

   Windows

   Anda tidak perlu memberikan izin eksekusi di Windows.

4. (Opsional) Konfigurasikan UID sebagai parameter build.

   Penting

   Jika Anda melewati langkah ini, instgo akan menginstal versi terbaru agen ARMS secara default.

   Konfigurasi UID memerlukan instgo versi 1.4.5 atau lebih baru. Gunakan perintah set untuk mengonfigurasi UID sebagai parameter build.

   # UID adalah ID akun utama Alibaba Cloud Anda.
   instgo set --uid={YourAliyunUid}

5. Tambahkan instgo sebagai awalan pada perintah build asli Anda, lalu jalankan perintah tersebut.

   instgo go build {arg1} {arg2} {arg3}

   Jika Anda menggunakan go install untuk membangun proyek, Anda juga dapat menambahkan instgo sebagai awalan pada perintah build asli Anda.

6. Gunakan file biner yang dihasilkan pada langkah sebelumnya untuk membuat gambar kontainer.

Langkah 3: Aktifkan pemantauan aplikasi ARMS untuk aplikasi Go Anda

1. Masuk ke Konsol ACK. Di panel navigasi sebelah kiri, klik Clusters.

2. Pada halaman Clusters, klik nama kluster Anda. Di panel navigasi sebelah kiri, pilih Workloads > Deployments.

3. Pada halaman Deployments, temukan aplikasi Anda dan klik Edit YAML di kolom Actions.

4. Pada file YAML, tambahkan labels berikut pada level spec.template.metadata.

   labels:
     aliyun.com/app-language: golang # Diperlukan untuk aplikasi Go. Ini menunjukkan bahwa ini adalah aplikasi Go.
     armsPilotAutoEnable: 'on'
     armsPilotCreateAppName: "<YOUR-DEPLOYMENT-NAME>"    # Ganti <YOUR-DEPLOYMENT-NAME> dengan nama aplikasi Anda.

Langkah 4: Lihat detail pemantauan

1. Setelah sekitar satu menit, buka atau Konsol ARMS. Di panel navigasi sebelah kiri, pilih Pemantauan Aplikasi > Aplikasi untuk melihat aplikasi Go dan data yang dilaporkannya.

   Aplikasi bernama otel-go-server muncul dalam daftar aplikasi. Status hijau menunjukkan bahwa aplikasi berjalan normal. Lihat metrik pemantauan seperti jumlah permintaan per detik, laju error, dan waktu respons rata-rata untuk memastikan data telah dilaporkan.

2. Pada kolom Application Name, klik nama aplikasi Anda untuk membuka halaman Pemantauan Aplikasi di Konsol ARMS dan melihat detail pemantauan. Untuk informasi selengkapnya, lihat Ringkasan Aplikasi.

(Opsional) Langkah 5: Lepaskan sumber daya

Jika Anda tidak lagi memerlukan pemantauan aplikasi, uninstall agen ARMS. Untuk informasi selengkapnya, lihat Uninstall the ARMS agent for Go.

Dokumen terkait

Untuk menghubungkan aplikasi Java atau Python dalam kluster ACK ke pemantauan aplikasi ARMS, lihat Java application monitoring dan Python application monitoring.