Dépannage du suivi d'.NET s sur Windows

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 qu'il manque des informations (par exemple, l'hôte), 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, cela signifie que 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 est prise en charge :

   • .NET Core Environnement d'exécution : 5.0 ou version ultérieure
2. Récupérez les journaux de l'Observateur d'événements à l'aide de Log Collector ou en les collectant manuellement.

3. Consultez les journaux de l'Observateur d'événements d' Instana :

   • Vérifiez si une erreur ou un avertissement apparaît dans les journaux. Un événement contient des informations détaillées, notamment des horodatages et des codes d'erreur, qui peuvent aider à diagnostiquer les problèmes.
   • Si une erreur indiquant InstanaPCP.exe apparaît, cela signifie que la commande « InstanaPCP » a échoué. Vérifiez les événements qui ont précédé et examinez la question plus en détail.
4. Récupérez un fichier de vidage mémoire pour l'application en question.

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. Vérifiez que l'agent d' Instana ation s'exécute en tant qu'administrateur.
2. Vérifiez que l'agent d' Instana s dispose des autorisations nécessaires pour accéder à l'application.

3. Vérifiez que le PCP d' Instana est en cours d'exécution :

   • InstanaPCPOuvrez le Gestionnaire des tâches sur Windows et recherchez.

4. Récupérez les journaux des agents d' Instana s à l'aide de Log Collector ou en les collectant manuellement.

   • Dans les journaux de l'agent d' Instana, la ligne suivante devrait apparaître :

     com.instana.agent-process-handling - 1.0.35 |  | InstanaPCP.exe passed early window; marked RUNNING

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

   com.instana.sensor-clr - 1.1.141 |  | Activated Sensor

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

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

Procédure de résolution des incidents :

1. Vérifiez dans le Gestionnaire des tâches si le problème est lié à l'application ou à l' InstanaPCP.

2. Si le problème concerne InstanaPCP:

   • Activer les journaux de débogage pour InstanaPCP. Voir la section « Collecte des journaux ».
   • Vérifiez les journaux pour repérer les messages récurrents signalant des compteurs de performances manquants ou des exceptions.

3. Si le problème est lié à un pic de mémoire de l'application :

   • Récupérez les journaux d'événements et les journaux d'.NET s à l'aide de Log Collector ou en les récupérant manuellement.
   • Vérifiez les journaux d'événements et les journaux d'.NET s pour détecter d'éventuelles exceptions liées à la mémoire.
   • Vérifiez si le problème est dû à l'instrumentation d' Instana.
   • Récupérez un fichier de vidage de la mémoire (.NET ) en vue d'une analyse plus approfondie. Go Accédez au Gestionnaire des tâches, cliquez avec le bouton droit sur le processus, puis créez un fichier de vidage.

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 traçage des applications
• Instana Journaux PCP
• Journaux de débogage CLR
• Journaux de l'Observateur d'événements
• Instana journaux de débogage de l'agent
• Instana l'agent enregistre les journaux

Vous pouvez également récupérer les journaux manuellement. Procédez comme suit :

1. Activez les journaux de débogage :

   1. Ajoutez des variables d'environnement à l'aide de l'une des options suivantes :

      Remarque : assurez-vous que les chemins d'accès sont valides, accessibles par le processus ou l'application, et corrects.

      • Définissez manuellement les variables d'environnement suivantes au niveau du système :

        INSTANA_NET_LOG_PATH: "C:\dc_net_log"
        INSTANA_NET_LOG_LEVEL: DEBUG
        INSTANA_NET_CORE_LOG_LEVEL: DEBUG
        INSTANA_NET_FF_LOG_LEVEL: DEBUG
        INSTANA_NET_PCP_LOG_LEVEL: DEBUG
        INSTANA_TRACER_ENTEREXIT_LOGGING: 1
        INSTANA_EXTENDED_DEBUG: 1

      • Ouvrez l'invite de commande en tant qu'administrateur et exécutez la commande suivante pour ajouter les variables d'environnement :

        setx INSTANA_NET_LOG_PATH "C:\dc_net_log" /M
        setx INSTANA_NET_LOG_LEVEL "DEBUG" /M
        setx INSTANA_NET_CORE_LOG_LEVEL "DEBUG" /M
        setx INSTANA_NET_FF_LOG_LEVEL "DEBUG" /M
        setx INSTANA_NET_PCP_LOG_LEVEL "DEBUG" /M
        setx INSTANA_TRACER_ENTEREXIT_LOGGING "1" /M
        setx INSTANA_EXTENDED_DEBUG "1" /M

   2. Configurez la clé de registre suivante : Windows

      CLRDebugLog: "C:\dc_clr_debug_log\clr_"

   3. Redémarrez l'application.

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

   1. Arrêtez l'agent <instana_install_dir>/bin/stop.sh ou, si celui-ci est exécuté en tant que service, arrêtez le service.

   2. Supprimer les fichiers journaux : supprimez tous les fichiers du répertoire des journaux pour repartir de zéro en exécutant la commande suivante :

      rm -rf <instana_install_dir>/data/log/*

   3. Définissez le niveau de journalisation sur « Debug » : modifiez le niveau de gravité de la journalisation dans le fichier de l'agent configuration.yaml . Pour plus d'informations, consultez la section « Configuration du fichier de configuration de l'agent ».
   4. Lancez l'agent <instana_install_dir>/bin/start.sh ou lancez le service.
   5. Reproduire le problème : laissez le problème se produire et laissez l'agent fonctionner pendant environ 15 minutes.

   6. Récupérez les fichiers journaux : compressez le répertoire des fichiers journaux en vue de son envoi en exécutant la commande suivante :

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

3. Collecter les journaux de trace d' Instana :

   1. com.instana.agent.main.sender.File.cfgGo pour [agent-dir]\etc\instana et ouvrir le fichier.

   2. Ajoutez les lignes suivantes dans le fichier :

      prefix=instanaTraces
      type=traces

      Cette configuration génère un fichier journal contenant toutes les traces commençant [agent-dir]/data/log par le instanaTraces préfixe.

   3. Redémarrez l'agent d' Instana.
   4. Laissez le produit agir pendant environ 15 minutes.

   5. Récupérez les fichiers journaux dans les chemins d'accès suivants :

      • Chemin indiqué par la variable INSTANA_NET_LOG_PATH
      • instana-agent-installation-folder/data/log

4. Récupérer les journaux de débogage CLR :

   1. Ouvrez l'Éditeur du Registre.
   2. Naviguer vers Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Instana\
   3. C:\temp\clr_Ajoutez la clé CLRDebugLog de registre sous forme de chaîne de caractères avec une valeur, par exemple.

   4. Vous pouvez également ouvrir l'invite de commande en tant qu'administrateur et exécuter la commande suivante :

      reg add "HKLM\SOFTWARE\Instana" /v CLRDebugLog /t REG_SZ /d "C:\temp\clr_" /f