Gestion des agents hôte

Si vous remplissez les conditions préalables, vous pouvez lancer la gestion de la configuration.

Si aucune gestion de configuration n'est active, lancez la gestion de configuration basée sur Git en cliquant Initialize sur dans la section Gestion de configuration.

Ensuite, saisissez les informations suivantes dans la boîte de dialogue « Gestion de la configuration » :

• Nom de la commande à distance : nom de la commande à distance « Git ».
• Branche distante : nom de la branche à utiliser pour les mises à jour.
• URI distant : l'URI du référentiel Git.

Cliquez sur « Initialiser et redémarrer » pour configurer l'agent selon les paramètres définis, puis redémarrez pour récupérer la dernière configuration.

Si la gestion de la configuration est déjà activée, vous pouvez consulter les détails dans la section « Gestion de la configuration ». Ces détails comprennent des informations sur la branche distante configurée, telles que le nom de la branche et son URI, ainsi que des informations sur le commit actuellement utilisé, telles que son hachage et son message.

Pour mettre à jour la configuration, cliquez sur « Mettre à jour » et saisissez les informations requises dans la boîte de dialogue « Gestion de la configuration ».

Cliquez sur « Mettre à jour et redémarrer » pour configurer l'agent selon les paramètres définis, puis redémarrez pour récupérer la dernière configuration.

Pour créer un vidage de mémoire pour l'agent hôte sur un système Linux, exécutez la commande suivante dans un shell Linux :

TS=`date +%s` && /opt/instana/agent/jvm/bin/jmap -dump:file=/tmp/agent-dump-$TS.hprof `cat /opt/instana/agent/agent.pid` && gzip /tmp/agent-dump-$TS.hprof

La commande génère un vidage de la mémoire et enregistre le fichier compressé dans /tmp/agent-dump-<timestamp>.hprof.zip.

Pour créer un vidage de mémoire pour l'agent hôte sur un système Windows, exécutez la commande suivante dans une fenêtre d' PowerShell:

$TS = [int][double]::Parse((Get-Date -UFormat %s)); C:\"Program Files"\Instana\instana-agent\jvm\bin\jmap -dump:file="$env:TEMP\agent-dump-$TS.hprof" (Get-Content "C:\Program Files\Instana\instana-agent\agent.pid"); Compress-Archive -Path "$env:TEMP\agent-dump-$TS.hprof" -DestinationPath "$env:TEMP\agent-dump-$TS.hprof.zip" -Force; Remove-Item "$env:TEMP\agent-dump-$TS.hprof"

La commande génère un vidage de la mémoire et enregistre le fichier compressé dans $TEMP\agent-dump-<timestamp>.hprof.zip.

Pour créer un vidage de mémoire pour l'agent hôte sur un système Linux, procédez comme suit :

Un vidage de mémoire ad hoc ne peut être créé que lorsque l'agent s'exécute avec ce -Dcom.ibm.tools.attach.enable=yes paramètre. Pour vérifier ce paramètre, ouvrez le tableau de bord de gestion des agents dans l'interface utilisateur d' Instana, accédez à l'entité de processus « Instana » située à gauche du tableau de bord des processus, puis recherchez com.ibm.tools.attach.enable dans la liste des arguments du processus.

Les étapes suivantes partent du principe que l'agent Instana est installé à l'emplacement par défaut et /opt/instana/agent qu'il s'exécute en tant que service Systemd. Vous devez modifier les chemins d'accès si vous avez installé l'agent d' Instana ation dans un autre emplacement.

1. Connectez-vous à l'hôte Linux en tant root qu'utilisateur ou basculez votre session shell vers root l'utilisateur.
2. Ouvrez le /opt/instana/agent/bin/setenv fichier pour le modifier.
3. Repérez la ligne qui commence par EXTRA_JAVA_OPTS= et remplacez la propriété -Dcom.ibm.tools.attach.enable=no par -Dcom.ibm.tools.attach.enable=yes.
4. Redémarrez l'agent à l'aide de systemctl restart instana-agent.
5. Laissez l'agent s'exécuter jusqu'à ce que la situation nécessitant la création d'un vidage de la mémoire soit atteinte.
6. Pour générer un vidage de mémoire pour l'agent hôte sur un système Linux, exécutez la commande suivante :

   TS=`date +%s` && /opt/instana/agent/jvm/bin/jcmd `cat /opt/instana/agent/agent.pid` Heap.dump /tmp/agent-dump-$TS.phd  && gzip /tmp/agent-dump-$TS.phd

   La commande génère un vidage de la mémoire et enregistre le fichier compressé dans /tmp/agent-dump-<timestamp>.phd.zip.

Pour créer un vidage de mémoire de l'agent hôte sur un système Windows, procédez comme suit :

Un vidage de mémoire ad hoc ne peut être créé que lorsque l'agent s'exécute avec ce -Dcom.ibm.tools.attach.enable=yes paramètre. Pour vérifier ce paramètre, ouvrez le tableau de bord de gestion des agents dans l'interface utilisateur d' Instana, accédez à l'entité de processus « Instana » située à gauche du tableau de bord des processus, puis recherchez com.ibm.tools.attach.enable dans la liste des arguments du processus.

Les étapes suivantes partent du principe que l'agent Instana est installé à l'emplacement par défaut et C:\Program Files\Instana\instana-agent qu'il s'exécute en tant que service Systemd. Vous devez modifier les chemins d'accès si vous avez installé l'agent d' Instana ation dans un autre emplacement.

1. Connectez-vous à l'hôte Windows en tant que Administrator.
2. Ouvrir C:\Program Files\Instana\instana-agent\bin\setenv.bat le fichier pour le modifier.
3. Repérez la ligne qui commence par SET EXTRA_JAVA_OPTS= et remplacez la propriété -Dcom.ibm.tools.attach.enable=no par -Dcom.ibm.tools.attach.enable=yes.
4. Dans la console Microsoft Management Console, sous « Services », recherchez le « Service Instana » et redémarrez-le.
5. Laissez l'agent s'exécuter jusqu'à ce que la situation nécessitant la création d'un vidage de la mémoire soit atteinte.
6. Créez le fichier C:\Users\Administrator\agent-dump.ps1 avec le contenu suivant :

   $TS = [int][double]::Parse((Get-Date -UFormat %s))
   $AGENT_PID = (Get-Content "C:\Program Files\Instana\instana-agent\agent.pid")
   C:\"Program Files"\Instana\instana-agent\jvm\bin\jcmd $AGENT_PID Dump.heap C:\Windows\Temp\agent-dump-$TS.phd
   Compress-Archive -Path C:\Windows\Temp\agent-dump-$TS.phd -DestinationPath C:\Windows\Temp\agent-dump-$TS.phd.zip -Force
   Remove-Item C:\Windows\Temp\agent-dump-$TS.phd

7. Ouvrez une fenêtre d' PowerShell s avec les privilèges d'administrateur.
8. Exécutez les commandes suivantes pour créer et lancer un script ScheduledTask qui effectue le vidage de la mémoire sous le SYSTEM compte :

   $SchedScript = New-ScheduledTaskAction -Execute "PowerShell.exe" -Argument '-ExecutionPolicy Bypass -file C:\Users\Administrator\agent-dump.ps1'
   Register-ScheduledTask -User SYSTEM -taskname !_AgentDump -Action $SchedScript | Out-Null
   Start-ScheduledTask -TaskName "!_AgentDump" 
   Unregister-ScheduledTask -TaskName "!_AgentDump" -Confirm:$false

   La commande génère un vidage de la mémoire et enregistre le fichier compressé dans C:\Windows\Temp\agent-dump-<timestamp>.phd.zip.

Vous pouvez analyser les indicateurs de performance de l'agent hôte d' Instana s en utilisant la fonctionnalité d'auto-profilage de l'agent.

L'outil d'auto-profilage n'est pris en charge que sur les systèmes Linux dotés d'une architecture x86_64-bit. {: note} Pour procéder à l'auto-profilage de l'agent hôte, procédez comme suit :

1. Dans la section Assistance du tableau de bord de l'agent, cliquez sur Profil de l'agent. Le profileur fonctionne pendant 10 minutes. Vous pouvez consulter les journaux de l'agent pour vérifier que le profileur est bien lancé. Voir l'exemple suivant :

   2025-03-19T14:21:48.077+00:00 | INFO  | instana-executor-thread-2-1      | ndRequestHandler | com.instana.agent-self-profiling - 1.0.0 | Starting Agent profiler for 10 minutes
   2025-03-19T14:21:52.998+00:00 | INFO  | instana-scheduler-thread-3-4     | Profiler         | com.instana.agent-self-profiling - 1.0.0 | Profiler installed
    

2. Une fois le profileur lancé, attendez deux minutes, puis actualisez le tableau de bord. Un nouveau bouton, « Analyser les profils », apparaît dans le tableau de bord de l'agent.

3. Cliquez sur le bouton « Analyser les profils » pour ouvrir la page « Analyser les profils ».

4. Sur la page « Analyser les profils », cliquez sur « Tout afficher ». Vous pouvez transmettre le graphique Flame ainsi que toute information complémentaire demandée par le service d'assistance d' IBM, dans le cadre de l'analyse des performances des agents.

Type de problème de surveillance : agent_tmp_directory_missing

L'agent hôte d' Instana crée des fichiers JAR temporaires dans le $TMP/.instana répertoire. Ces fichiers JAR sont nécessaires pour la surveillance d' JVM. Cet avertissement indique que soit les fichiers JAR nécessaires sont manquants, soit le répertoire tmp Instana n'est pas accessible, ce qui peut entraîner des problèmes avec les pièces jointes d' Java. L'agent « Instana » surveille régulièrement l'état du répertoire tmp Instana et de ses fichiers JAR associés afin d'éviter tout échec lors de l'ajout de pièces jointes dans l' Java.

Pour éviter ce problème, assurez-vous que tmp l'emplacement dispose des droits de lecture et d'écriture, et évitez tout nettoyage inutile de cet /tmp emplacement.

Type de problème de surveillance : insufficient-disk-space-for-tmp-directory

Lors de l'exécution, le conteneur de l'agent d' Instana crée des fichiers JAR temporaires dans le $TMP/.instana répertoire. Ces fichiers JAR sont nécessaires pour la surveillance d' JVM. Cet avertissement indique que l'espace disponible à tmp l'emplacement est insuffisant pour stocker les fichiers temporaires, ce qui peut entraîner un échec de l'ajout d'une pièce jointe dans Java. Pour résoudre ce problème, augmentez l'espace alloué pour tmp dans le déploiement de conteneur.

Type de problème de surveillance : pax_url_mvn_leak

La version Pax 2.6.16URL d' OPS4J présente une fuite de mémoire qui est réinitialisée toutes les 24 heures dans le cadre de la mise à jour de l'agent. Selon le nombre de capteurs arrêtés et redémarrés pendant cette période, l'agent pourrait rencontrer une OutOfMemoryError erreur. Pour résoudre ce problème, un correctif a été intégré aux assemblages d'agent publiés après le 18 juin 2025. Si vous constatez ce problème de surveillance, mettez à jour votre assemblage d'agent d' Instana. vers une version publiée à partir du 18 juin 2025.

Pour plus d'informations sur ce ticket, consultez le ticket et la pull request correspondante dans le dépôt pax-urlGitHub.

Type de problème de surveillance : agent_jvm_tls_1_3_missing

L'agent « Instana » doit TLSv1.3 être pris en charge sur l'hôte sur lequel il est installé. Si cette TLSv1.3 fonctionnalité n'est pas prise en charge, les capacités de surveillance sont réduites.

Pour résoudre ce problème, mettez à jour votre agent Instana TLS vers la version TLSv1.3. Les versions suivantes d' TLS s sont activées : TLSv1, TLSv1.1, TLSv1.2, TLSv1.3. Pour plus d'informations, consultez la section « Configuration du chiffrement d' TLS pour le point de terminaison de l'agent ».

Type de problème de surveillance : solaris_jspawnhelper_executable_issue

Ce problème de surveillance indique que le fichier jspawnhelper JVM sur l'hôte Solaris ne dispose pas des droits d'exécution.

Pour résoudre le problème d'autorisation du fichier « Solaris » situé dans le répertoire « JVM », attribuez les droits d'exécution au jspawnhelper fichier « JVM » situé dans le chemin « JVM » à l'aide de la commande suivante :

chmod +x <jvm-path>/jspawnhelper
 

Pour l' Java e 9 ou une version ultérieure, indiquez le chemin d'accès à JVM comme suit *instanaAgentDir*/jvm/jre/lib/jspawnhelper: Pour les versions antérieures d' Java, indiquez le chemin d'accès à l' JVM*instanaAgentDir*/jvm/jre/lib/sparcv9/jspawnhelper.