All Products
Search

This Product

    Application Real-Time Monitoring Service:Instalasi manual agen Go

    Document Center

    Application Real-Time Monitoring Service:Instalasi manual agen Go

    Last Updated:Aug 18, 2026

    Instalasi agen Go memungkinkan Application Real-Time Monitoring Service (ARMS) memantau aplikasi Go Anda serta menyediakan data mengenai topologi aplikasi, jejak (traces), dan analisis SQL.

    Catatan

    Prasyarat

    Langkah 1: Kompilasi gambar aplikasi Go

    Untuk menggunakan pemantauan aplikasi Go ARMS, cukup gunakan tool instgo saat proses build dengan menambahkan instgo sebagai awalan pada perintah go build asli Anda. Tidak diperlukan modifikasi kode bisnis atau integrasi SDK OpenTelemetry. Agen instgo menerapkan instrumentasi otomatis berdasarkan standar OpenTelemetry, dengan menyisipkan kode pemantauan secara otomatis selama tahap analisis AST pada waktu kompilasi.

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

    2. Unduh tool build instgo menggunakan perintah wget. Pilih URL unduhan sesuai dengan sistem operasi dan arsitektur lingkungan build Anda.

      Perhatikan bahwa instgo diperbarui secara otomatis selama proses build. Pastikan Anda menyimpan instgo di direktori tempat pengguna build memiliki izin menulis.

      Catatan

      • instgo adalah tool build dari ARMS yang melakukan instrumentasi pada proyek Go Anda sehingga ARMS dapat memantau aplikasi tersebut.

      • Jika Anda memiliki akses Internet ke Object Storage Service (OSS), gunakan URL unduhan China (Hangzhou) yang sesuai dengan sistem operasi dan arsitektur Anda.

      Perintah unduh

      Linux (AMD64)

      Alamat Internet

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

      Linux (ARM64)

      Alamat Internet

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

      Mac (ARM64)

      Alamat Internet

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

      Mac (AMD64)

      Alamat Internet

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

      Windows (AMD64)

      Alamat Internet

      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 langkah ini dilewati, instgo akan menginstal versi terbaru agen ARMS secara default.

      Gunakan perintah set untuk mengonfigurasi UID sebagai parameter build.

      instgo set --uid={YourAliyunUid} // Diperlukan instgo versi 1.4.5 atau lebih baru. UID adalah ID akun primary Akun Alibaba Cloud Anda.

    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 mem-build proyek, Anda juga dapat menambahkan instgo sebagai awalan pada perintah build asli Anda.

    6. Gunakan file biner yang dihasilkan pada langkah sebelumnya untuk mem-build gambar.

    Langkah 2: Konfigurasi variabel lingkungan

    • Setelah proses build, tambahkan variabel lingkungan berikut ke aplikasi Go Anda:

      export ARMS_ENABLE=true
export ARMS_APP_NAME=xxx   # Nama aplikasi Anda.
export ARMS_REGION_ID=xxx   # ID wilayah Akun Alibaba Cloud Anda.
export ARMS_LICENSE_KEY=xxx   # Kunci lisensi dari konsol ARMS.
      Catatan

      Jika Anda ingin melaporkan data melalui Internet secara default, atur variabel lingkungan ARMS_NETWORK_STRATEGY=public.

    • Alih-alih mengekspor variabel lingkungan, Anda dapat menggunakan flag -ldflags untuk menentukannya selama proses build.

      Ganti module dengan nama modul yang dikonfigurasi di go mod. Untuk parameter lainnya, rujuk ke variabel lingkungan.

      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}'"

    • Jika Anda menggunakan systemctl untuk menjalankan aplikasi, gunakan perintah berikut untuk mengatur variabel lingkungan:

      systemctl set-environment ARMS_ENABLE=true
systemctl set-environment ARMS_APP_NAME=xxx # Nama aplikasi Anda.
systemctl set-environment ARMS_REGION_ID=xxx   # ID wilayah Akun Alibaba Cloud Anda.
systemctl set-environment ARMS_LICENSE_KEY=xxx # Kunci lisensi dari konsol ARMS.

    (Opsional) Konfigurasi Dockerfile

    Jika Anda menggunakan lingkungan Docker, modifikasi Dockerfile Anda sesuai contoh berikut.

    FROM golang:1.21 AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/instgo/instgo-linux-amd64" -O instgo
RUN chmod +x instgo
RUN ./instgo go build -o myapp .

FROM debian:bookworm-slim
WORKDIR /app
COPY --from=builder /app/myapp .
ENV ARMS_ENABLE=true
ENV ARMS_APP_NAME=AppName
ENV ARMS_REGION_ID=regionId
ENV ARMS_LICENSE_KEY=licenseKey
EXPOSE 8080
CMD ["./myapp"]

    Verifikasi hasil

    Sekitar satu menit kemudian, periksa halaman Application Monitoring > Applications di Konsol ARMS. Jika aplikasi Anda muncul dan melaporkan data, instalasi agen berhasil.