Container Service for Kubernetes:Go application monitoring

Requisitos previos

• Ha creado un clúster de ACK. Se recomienda utilizar un clúster administrado de ACK. Para obtener instrucciones, consulte Create an ACK managed cluster.

  Ya no es posible crear nuevos clústeres dedicados de ACK, pero los clústeres dedicados existentes siguen siendo compatibles. Para más información, consulte Create an ACK dedicated cluster (discontinued).

• Su aplicación Go utiliza Go 1.18 o una versión posterior.

• Tiene activated ARMS.

  ARMS es un servicio de gestión del rendimiento de aplicaciones (APM) de Alibaba Cloud. Para más información sobre ARMS, consulte What is ARMS? y What is Application Monitoring?

Paso 1: Instalar ack-onepilot, el complemento de monitoreo de aplicaciones de ARMS

1. Inicie sesión en la consola de ACK. En el panel de navegación izquierdo, haga clic en Clusters.

2. En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Components and Add-ons.

Paso 2: Compilar el archivo binario de Go y construir la imagen del contenedor

Utilice la herramienta de compilación mejorada de Go, instgo, junto con un entorno de compilación local de Go (Go 1.18 o posterior) para compilar su programa Go en un archivo binario que reporte datos de monitoreo a ARMS.

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

2. Use el comando wget para descargar la herramienta de compilación instgo.

   Durante el proceso de compilación, instgo se actualiza automáticamente. Guarde 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 Go, lo que permite a ARMS monitorear su aplicación.

   Si su entorno de compilación tiene acceso a Internet hacia Object Storage Service (OSS), seleccione la URL de descarga por Internet de China (Hangzhou) que corresponda al sistema operativo y la arquitectura del entorno de compilación.

   Comandos de descarga

   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. 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.

   Para configurar un UID se requiere instgo 1.4.5 o posterior. Use el comando set para configurar un UID como parámetro de compilación.

   # The UID is the ID of your Alibaba Cloud primary account.
   instgo set --uid={YourAliyunUid}

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

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

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

6. Use el archivo binario generado en el paso anterior para construir la imagen del contenedor.

Paso 3: Habilitar el monitoreo de aplicaciones de ARMS para su aplicación Go

1. Inicie sesión en la consola de ACK. En el panel de navegación izquierdo, haga clic en Clusters.

2. En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, elija Workloads > Deployments.

3. En la página Deployments, busque su aplicación y haga clic en Edit YAML en la columna Actions.

4. En el archivo YAML, agregue las siguientes labels al nivel spec.template.metadata.

   labels:
     aliyun.com/app-language: golang # Required for Go applications. This indicates that this is a Go application.
     armsPilotAutoEnable: 'on'
     armsPilotCreateAppName: "<YOUR-DEPLOYMENT-NAME>"    # Replace <YOUR-DEPLOYMENT-NAME> with your application name.

Paso 4: Consultar los detalles de monitoreo

1. Después de aproximadamente un minuto, vaya a la consola de ARMS. En el panel de navegación izquierdo, elija Application Monitoring > Applications para ver la aplicación Go y los datos que reporta.

   Una aplicación llamada otel-go-server aparece en la lista de aplicaciones. Un estado verde indica que la aplicación se ejecuta correctamente. Consulte las métricas de monitoreo, como solicitudes por segundo, tasa de errores y tiempo promedio de respuesta, para confirmar que se están reportando datos.

2. En la columna Application Name, haga clic en el nombre de su aplicación para ir a la página de monitoreo de aplicaciones de la consola de ARMS y consultar los detalles de monitoreo. Para más información, consulte Application overview.

(Opcional) Paso 5: Liberar recursos

Si ya no necesita monitorear la aplicación, desinstale el agente de ARMS. Para más información, consulte Uninstall the ARMS agent for Go.

Documentos relacionados

Para conectar aplicaciones Java o Python en un clúster de ACK al monitoreo de aplicaciones de ARMS, consulte Java application monitoring y Python application monitoring.