Application Real-Time Monitoring Service:Collect Go pprof data with arms-obi

Integración de código

En el paquete main de su servicio de Go, importe net/http/pprof e inicie un servidor HTTP independiente:

import _ "net/http/pprof"

func main() {
    // Start the pprof server on a separate port to avoid conflicts with the business port.
    go func() {
        http.ListenAndServe(":6060", nil)
    }()
    // ... business logic
}

Variables de entorno del contenedor

En la especificación del contenedor de su Pod de aplicación, establezca la variable de entorno del puerto de pprof. El nombre de la variable es ILOGTAIL_PROFILE_PORT de forma predeterminada y se configura en values:

containers:
  - name: myapp
    env:
      - name: ILOGTAIL_PROFILE_PORT  # Must match the port_env_name configured in arms-obi
        value: "6060"

arms-obi lee esta variable de entorno para determinar el puerto de destino.

Configuración del recopilador

Las URL de recopilación de perfiles siguen este patrón: http://<podIP>:<port><pprof_path>/<profile>

Configuración de filtros

Controla de qué Pods se recopilan los datos. Todas las condiciones se combinan con AND, mientras que los elementos dentro de una lista de permitidos se combinan con OR.

Formato de LabelKV: {key: "app", value: "myservice"}. Si el valor está vacío, el agente solo comprueba la existencia de la clave.

La canalización de filtros se ejecuta en el siguiente orden:

1. Filtrado por nodo: Recopila datos únicamente de los Pods del nodo actual (automático).

2. Fase del Pod: Conserva solo los Pods en fase Running que tengan una dirección IP asignada.

3. Filtrado por expresión regular: namespace / pod_name.

4. Lista de permitidos de etiquetas → Lista de bloqueados de etiquetas.

5. Lista de permitidos de variables de entorno → Lista de bloqueados de variables de entorno.

6. Resolución de puertos: Lee el valor del puerto desde la variable de entorno del contenedor especificada por port_env_name.

Configuración de ARMS

Actualizar la configuración

1. Inicie sesión en la consola de Container Service for Kubernetes (ACK). En el panel de navegación izquierdo, seleccione Cluster List y, a continuación, haga clic en el nombre del clúster de destino.

2. En el panel de navegación izquierdo, seleccione Components, busque el componente arms-obi, haga clic en Configure y modifique la configuración del recopilador de perfiles.

Los registros del agente muestran "arms sts not ready yet"

El agente no pudo obtener una credencial STS de ARMS.

• Asegúrese de que la red del clúster pueda acceder a la API de metadatos de ARMS en <region_id>-intranet-arms.aliyuncs.com.

• Puede ejecutar kubectl logs para consultar los mensajes de error detallados.

No se detectan Pods

Compruebe su configuración de filtros:

• Compruebe que la variable de entorno especificada por port_env_name (valor predeterminado: ILOGTAIL_PROFILE_PORT) esté definida en los contenedores del Pod de su aplicación.

• Compruebe que las expresiones regulares de namespace/pod_name, así como los ajustes de listas de permitidos y bloqueados de etiquetas y variables de entorno en el selector, sean correctos.

• Revise el campo pod_count en los registros del agente para ver cuántos Pods se detectaron.

Errores en la recopilación

Causas comunes:

• El Pod de la aplicación no expone la interfaz pprof. Compruebe que importó _ "net/http/pprof" e inició el servicio HTTP.

• El puerto de pprof no coincide con el puerto configurado en la variable de entorno port_env_name.

• El valor de pprof_path no coincide con el prefijo de ruta de su servicio.

• Una directiva de red está bloqueando la conexión HTTP desde el Pod del agente hacia el Pod de la aplicación.

Errores en la carga de datos

Causas comunes:

• El endpoint privado de la VPC es inaccesible.

• La credencial STS de ARMS caducó. El agente renueva la credencial automáticamente. Revise los registros para identificar errores de renovación de STS.