Setelah menginstal agen untuk aplikasi Go, Application Real-Time Monitoring Service (ARMS) dapat mulai memantaunya. Anda dapat melihat data pemantauan seperti topologi aplikasi, tumpukan panggilan, dan analisis SQL. Topik ini menjelaskan cara menginstal agen secara manual untuk aplikasi Go.
Untuk aplikasi yang diterapkan di lingkungan Kubernetes, jangan menginstal agen secara manual. Sebagai gantinya, instal komponen untuk terhubung ke ARMS. Untuk informasi selengkapnya, lihat Instal agen Go untuk Container Service for Kubernetes (ACK) dan Container Compute Service (ACS) menggunakan komponen ack-onepilot.
Jika Anda memiliki pertanyaan tentang penggunaan agen Go, hubungi kami melalui grup DingTalk kami (ID: 159215000379).
Prasyarat
Pastikan lingkungan waktu kompilasi Anda dapat terhubung ke internet atau jaringan internal Alibaba Cloud. Grup keamanan untuk lingkungan tersebut harus mengizinkan lalu lintas TCP arah keluar pada Port 8080, 9990, 80, dan 443.
Periksa lingkungan jaringan Anda. Untuk informasi selengkapnya, lihat Konfigurasi jaringan untuk pemantauan aplikasi Go.
Periksa sistem operasi, arsitektur, versi Go, dan versi framework dari lingkungan waktu kompilasi Anda. Untuk informasi selengkapnya, lihat Komponen dan framework Go yang didukung oleh Pemantauan Aplikasi ARMS.
Langkah 1: Kompilasi citra aplikasi Golang
(Opsional) Jika proyek Anda menggunakan mode vendor untuk kompilasi atau parameter waktu kompilasi mencakup
-mod=vendor, periksa hal berikut:Periksa apakah file go.mod berisi dependensi `google.golang.org/protobuf`, baik secara langsung maupun tidak langsung. Jika tidak, ikuti petunjuk berikut:
Periksa apakah parameter waktu kompilasi mencakup
-mod=vendor. Jika tidak, tambahkan-mod=vendorsetelahgo build.
Gunakan perintah
wgetuntuk mengunduh alat waktu kompilasi instgo. Pilih alamat unduhan berdasarkan lingkungan waktu kompilasi dan wilayah mesin Anda.Perhatikan bahwa instgo diperbarui secara otomatis saat waktu kompilasi. Simpan instgo di folder tempat Anda memiliki izin modifikasi.
CatatanInstgo adalah alat waktu kompilasi yang disediakan oleh ARMS untuk aplikasi Go. Setelah Anda mengompilasi proyek Go dengan instgo, ARMS dapat memantau aplikasi Anda.
Alat waktu kompilasi ini sama untuk semua wilayah. Jika lingkungan Anda dapat mengakses Object Storage Service (OSS) melalui internet, Anda dapat menggunakan alamat unduhan internet untuk Tiongkok (Hangzhou) sesuai sistem operasi dan arsitektur Anda.
Berikan izin eksekusi kepada alat waktu kompilasi.
Linux/Mac
# Berikan izin eksekusi chmod +x instgoWindows
Tidak diperlukan izin eksekusi untuk Windows.
Peroleh LicenseKey dan konfigurasikan parameter waktu kompilasi.
PentingJika Anda melewatkan langkah ini, instgo akan masuk ke mode dev dan menginstal versi terbaru agen ARMS secara default. Untuk menerapkan aplikasi Anda di lingkungan produksi, Anda harus mengonfigurasi parameter berikut.
Peroleh LicenseKey dengan memanggil operasi OpenAPI DescribeTraceLicenseKey.
Pada halaman DescribeTraceLicenseKey, klik Debug. Pilih wilayah dan klik Mulai Panggilan untuk memperoleh LicenseKey.
Setelah memperoleh LicenseKey, gunakan perintah
setuntuk mengonfigurasi parameter waktu kompilasi.instgo set --licenseKey=${YourLicenseKey}
Tambahkan `instgo` sebagai awalan ke perintah kompilasi asli Anda dan jalankan perintah tersebut.
instgo go build {arg1} {arg2} {arg3}Jika Anda menggunakan `go install` untuk mengompilasi proyek, Anda juga dapat menambahkan `instgo` sebagai awalan ke perintah tersebut.
Buat citra menggunakan file biner yang dikompilasi pada langkah sebelumnya.
Langkah 2: Konfigurasikan variabel lingkungan
Setelah kompilasi, tambahkan secara manual variabel lingkungan berikut untuk aplikasi Go Anda:
export ARMS_ENABLE=true export ARMS_APP_NAME=xxx # Nama aplikasi. export ARMS_REGION_ID=xxx # ID wilayah Akun Alibaba Cloud Anda. export ARMS_LICENSE_KEY=xxx # LicenseKey yang diperoleh di Langkah 1.Atau, alih-alih menggunakan `export` untuk mengekspos variabel lingkungan, Anda dapat menentukannya saat waktu kompilasi menggunakan `ldflags`.
Ganti
moduledengan nama modul dari file go.mod Anda. Parameter lainnya sesuai dengan variabel lingkungan yang tercantum di atas.instgo go build -ldflags " -X 'github.com/alibaba/loongsuite-go-agent/pkg/exporters.ArmsApmName=${appName}' -X 'github.com/alibaba/loongsuite-go-agent/pkg/exporters.ArmsEnable=true' -X 'github.com/alibaba/loongsuite-go-agent/pkg/exporters.LicenseKey=${licenseKey}' -X 'github.com/alibaba/loongsuite-go-agent/pkg/exporters.RegionId=${regionId}'"
(Opsional) Referensi instalasi Docker
Jika Anda menggunakan lingkungan Docker, Anda dapat memodifikasi Dockerfile berdasarkan contoh berikut.
### .....
ENV ARMS_ENABLE=true
ENV ARMS_APP_NAME={AppName}
ENV ARMS_REGION_ID={regionId}
ENV ARMS_LICENSE_KEY={licenseKey}
### Tambahkan logika Dockerfile kustom Anda di bawah ini.
### ......Verifikasi hasil
Setelah sekitar satu menit, buka halaman di Konsol ARMS. Jika aplikasi Go Anda ditampilkan di halaman tersebut dan data pemantauan dilaporkan, berarti agen berhasil diinstal.
