Dépannage du suivi d'.NET s sur Linux ou Alpine Linux

Symptômes : l'application affiche des métriques mais pas de traces; certains services génèrent des rapports, mais pas d'autres; ou encore, le traçage s'arrête après un déploiement ou une mise à jour.

Procédure de résolution des incidents :

1. Vérifiez que la version de l'application disponible sur .NET est prise en charge :

   • .NET Core Environnement d'exécution : 5.0 ou version ultérieure
2. Vérifiez que la fonction de traçage est activée dans le fichier de l'agent configuration.yaml .
3. Récupérez les journaux de trace à l'aide de Log Collector ou en les récupérant manuellement.

4. Consultez les journaux de traçage de l' Instana :

   • Si les journaux sont vides ou si aucune trace n'apparaît, cela signifie que l'application ne génère pas de segments.
   • Si des traces apparaissent dans les journaux mais que certaines informations (par exemple, l'hôte) manquent, le problème provient de la couche de traçage d'.NET.
   • Si des traces apparaissent dans les journaux et contiennent des informations qui ne figurent pas dans l'interface utilisateur, le problème s'est produit soit au niveau du backend d' Instana, soit au niveau de l'agent.

Symptôme : l'application plante au démarrage lorsque l'agent d' Instana s est en cours d'exécution.

Procédure de résolution des incidents :

1. Vérifiez que la version de l'application disponible sur .NET Core est prise en charge :

   • .NET Core Environnement d'exécution : 5.0 ou version ultérieure
2. Récupérez les journaux à l'aide de Log Collector ou en les récupérant manuellement.
3. Récupérer le fichier de vidage mémoire de l'application.

Symptôme : l'application « .NET » n'est pas surveillée par l'agent « Instana » et n'apparaît pas dans l'interface utilisateur.

Procédure de résolution des incidents :

1. Récupérez les journaux des agents d' Instana s à l'aide de Log Collector ou en les collectant manuellement.
2. Vérifiez que l'agent d' Instana ation est exécuté en tant qu'administrateur.
3. Vérifiez que l'agent d' Instana s dispose des autorisations nécessaires pour surveiller l'application.

4. Vérifiez que les capteurs ont bien été activés dans les journaux de l'agent.

   com.instana.sensor-clr - <version> |  | Activated Sensor

5. Vérifiez que le processus « .NET » est lancé après l'agent « Instana ».

Symptôme : l'application «.NET » affiche une utilisation du processeur anormalement élevée une fois le traçage activé.

Procédure de résolution des incidents :

1. Identifiez la source : vérifiez le moniteur système pour déterminer si le problème est lié à l'application.

2. En cas de pic de mémoire au niveau d'une application :

   • Vérifiez /var/log les fichiers journaux `.NET ` pour détecter les exceptions liées à la mémoire.
   • Vérifiez si le problème est dû à l'instrumentation d' Instana.
   • Demandez un fichier de vidage de la mémoire «.NET » pour une analyse plus approfondie.

Log Collector est une application autonome permettant de collecter les journaux d' Instana. Vous pouvez lancer le collecteur de journaux à partir des emplacements suivants :

• Instana Interface utilisateur
• Console

Le collecteur de journaux recueille les journaux suivants :

• Journaux de suivi des applications
• Journaux de débogage CLR
• Instana journaux de débogage de l'agent
• Instana l'agent enregistre les journaux

Vous pouvez également récupérer les journaux manuellement, sans passer par l'outil de collecte des journaux. Procédez comme suit :

1. Activer les journaux de débogage : définissez manuellement les variables d'environnement suivantes au niveau du système, puis redémarrez l'application :

   export INSTANA_NET_LOG_PATH="<Log_path>"
   export INSTANA_NET_LOG_LEVEL=DEBUG
   export INSTANA_NET_CORE_LOG_LEVEL=DEBUG
   export INSTANA_TRACER_ENTEREXIT_LOGGING=1
   export INSTANA_EXTENDED_DEBUG=1
   export INSTANA_CLRLOG_PATH=/var/tmp/clr_

2. Collecter les journaux de l'agent d' Instana :

   1. Arrêtez l'agent :

      sudo systemctl stop instana-agent.service

   2. Effacez les journaux : supprimez tous les fichiers du logs répertoire pour repartir de zéro :

      sudo rm -rf <instana_install_dir>/data/logs/*

   3. Définissez le niveau de journalisation sur « debug » : modifiez le niveau de gravité de la journalisation dans le fichier de configuration :

      Modifier le niveau de journalisation dans <instanaAgentDir>/etc/org.ops4j.pax.logging.cfg le fichier de configuration, en le faisant passer de log4j2.logger.instana.level=INFO à log4j2.logger.instana.level=DEBUG.

      Important : assurez-vous qu'il n'y a pas d'espaces à la fin de la ligne.

   4. Démarrez l'agent :

      sudo systemctl start instana-agent.service

   5. Vérifiez les fichiers journaux dans le dossier « log » et récupérez-les : Compressez le logs répertoire avant de l'envoyer :

      cd <instana_install_dir>/data/logs/
      zip -r instana_agent_debug_logs.zip *