Todos los productos
Search

Este producto

    Application Real-Time Monitoring Service:Instalación manual del agente de Go

    Centro de documentos

    Application Real-Time Monitoring Service:Instalación manual del agente de Go

    Última actualización: Sep 04, 2026

    La instalación del agente de Go permite que Application Real-Time Monitoring Service (ARMS) supervise su aplicación de Go y proporcione datos sobre la topología de la aplicación, trazas y análisis de SQL.

    Nota

    Requisitos previos

    Paso 1: Compilar la imagen de la aplicación de Go

    Para utilizar el monitoreo de aplicaciones de Go de ARMS, solo necesita usar la herramienta instgo durante la compilación; para ello, agregue instgo como prefijo a su comando original go build. No es necesario modificar ningún código de negocio ni integrar el SDK de OpenTelemetry. El agente instgo implementa la instrumentación automática basada en el estándar OpenTelemetry e inserta el código de monitoreo automáticamente durante la fase de análisis AST en tiempo de compilación.

    1. (Opcional) Si su proyecto incluye un directorio vendor durante la compilación, agregue -mod=vendor después de go build.

    2. Utilice el comando wget para descargar la herramienta de compilación instgo. Seleccione una URL de descarga según el sistema operativo y la arquitectura de su entorno de compilación.

      Tenga en cuenta que instgo se actualiza automáticamente durante el proceso de compilación. Asegúrese de guardar instgo en un directorio donde el usuario de compilación tenga permisos de escritura.

      Nota

      • instgo es una herramienta de compilación de ARMS que instrumenta su proyecto de Go y permite que ARMS supervise su aplicación.

      • Si tiene acceso a Internet hacia Object Storage Service (OSS), utilice la URL de descarga de China (Hangzhou) que corresponda a su sistema operativo y arquitectura.

      Download commands

      Linux (AMD64)

      Internet address

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

      Linux (ARM64)

      Internet address

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

      Mac (ARM64)

      Internet address

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

      Mac (AMD64)

      Internet address

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

      Windows (AMD64)

      Internet address

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

    3. Conceda permisos de ejecución a la herramienta de compilación.

      Linux/Mac

      # Grant the executable permission.
chmod +x instgo

      Windows

      No es necesario conceder permisos de ejecución en Windows.

    4. (Opcional) Configure un UID como parámetro de compilación.

      Importante

      Si omite este paso, instgo instala la versión más reciente del agente de ARMS de forma predeterminada.

      Utilice el comando set para configurar un UID como parámetro de compilación.

      instgo set --uid={YourAliyunUid} // instgo 1.4.5 or later is required. The UID is the ID of your Alibaba Cloud primary account.

    5. Agregue instgo como prefijo a su comando de compilación original y ejecute el comando.

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

      Si utiliza go install para compilar el proyecto, también puede agregar instgo como prefijo a su comando de compilación original.

    6. Utilice el archivo binario generado en el paso anterior para construir una imagen.

    Paso 2: Configurar variables de entorno

    • Después de la compilación, agregue las siguientes variables de entorno a su aplicación de Go:

      export ARMS_ENABLE=true
export ARMS_APP_NAME=xxx   # The name of your application.
export ARMS_REGION_ID=xxx   # The region ID of your Alibaba Cloud account.
export ARMS_LICENSE_KEY=xxx   # The license key from the ARMS console.
      Nota

      Si desea reportar datos a través de Internet de forma predeterminada, establezca la variable de entorno ARMS_NETWORK_STRATEGY=public.

    • En lugar de exportar variables de entorno, puede usar la bandera -ldflags para especificarlas durante el proceso de compilación.

      Reemplace module con el nombre del módulo configurado en go mod. Para otros parámetros, consulte las variables de entorno.

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

    • Si utiliza systemctl para iniciar su aplicación, puede usar los siguientes comandos para establecer las variables de entorno:

      systemctl set-environment ARMS_ENABLE=true
systemctl set-environment ARMS_APP_NAME=xxx # The name of your application.
systemctl set-environment ARMS_REGION_ID=xxx   # The region ID of your Alibaba Cloud account.
systemctl set-environment ARMS_LICENSE_KEY=xxx # The license key from the ARMS console.

    (Opcional) Configuración de Dockerfile

    Si utiliza un entorno de Docker, modifique su Dockerfile según el siguiente ejemplo.

    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"]

    Verificar los resultados

    Después de aproximadamente un minuto, compruebe la página Application Monitoring > Applications en la consola de ARMS. Si su aplicación aparece y está reportando datos, la instalación del agente se completó correctamente.