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

Intégration du code

Dans le package main de votre service Go, importez net/http/pprof et démarrez un serveur HTTP distinct :

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 d'environnement du conteneur

Dans la spécification du conteneur de votre Pod d'application, définissez la variable d'environnement du port pprof. Le nom de la variable est par défaut ILOGTAIL_PROFILE_PORT et est configurable dans les valeurs :

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

arms-obi lit cette variable d'environnement pour déterminer le port cible.

Configuration du collecteur

Les URLs de collecte de profils suivent ce modèle : http://<podIP>:<port><pprof_path>/<profile>

Configuration des filtres

Contrôle les Pods à partir desquels effectuer la collecte. Toutes les conditions sont combinées avec ET ; les éléments au sein d'une liste d'autorisation sont combinés avec OU.

Format LabelKV : {key: "app", value: "myservice"}. Si la valeur est vide, l'agent vérifie uniquement l'existence de la clé.

Le pipeline de filtrage s'exécute dans cet ordre :

1. Filtrage des nœuds : collecte uniquement depuis les Pods sur le nœud actuel (automatique).

2. Phase du Pod : conserve uniquement les Pods en phase Running avec une adresse IP attribuée.

3. Filtrage par expression régulière : namespace / pod_name.

4. Liste d'autorisation de libellés → Liste de blocage de libellés.

5. Liste d'autorisation de variables d'environnement → Liste de blocage de variables d'environnement.

6. Résolution du port : lit la valeur du port à partir de la variable d'environnement du conteneur spécifiée par port_env_name.

Configuration ARMS

Mettre à jour la configuration

1. Connectez-vous à la console Container Service for Kubernetes (ACK). Dans le volet de navigation de gauche, sélectionnez Cluster List, puis cliquez sur le nom du cluster cible.

2. Dans le volet de navigation de gauche, sélectionnez Components, recherchez le composant arms-obi, cliquez sur Configure, puis modifiez la configuration du collecteur de profiling.

Les journaux de l'agent indiquent « arms sts not ready yet »

L'agent n'a pas pu obtenir d'identifiants ARMS STS.

• Assurez-vous que le réseau du cluster peut accéder à l'API de métadonnées ARMS à l'adresse <region_id>-intranet-arms.aliyuncs.com.

• Vous pouvez exécuter kubectl logs pour afficher les messages d'erreur détaillés.

Aucun Pod n'est découvert

Vérifiez votre configuration de filtre :

• Confirmez que la variable d'environnement spécifiée par port_env_name (par défaut : ILOGTAIL_PROFILE_PORT) est définie dans les conteneurs du Pod de votre application.

• Confirmez que les expressions régulières pour namespace/pod_name, ainsi que les paramètres de liste d'autorisation et de liste de blocage des libellés et des variables d'environnement dans le sélecteur, sont corrects.

• Consultez le champ pod_count dans les journaux de l'agent pour voir combien de Pods ont été découverts.

Échec de la collecte

Causes courantes :

• Le Pod de l'application n'expose pas l'interface pprof. Confirmez que vous avez importé _ "net/http/pprof" et démarré le service HTTP.

• Le port pprof ne correspond pas au port configuré dans la variable d'environnement port_env_name.

• Le pprof_path ne correspond pas au préfixe de chemin de votre service.

• Une politique réseau bloque la connexion HTTP depuis le Pod de l'agent vers le Pod de l'application.

Échec du téléchargement

Causes courantes :

• L'endpoint privé VPC est inaccessible.

• Les identifiants ARMS STS ont expiré. L'agent actualise automatiquement les identifiants. Vérifiez les journaux pour détecter les erreurs d'actualisation STS.