Dépannage de l'agent hôte sous Linux

Modifier en ligne

Voir les solutions aux problèmes courants observés sur l'agent hôte sous Linux:

Les agents sont installés à l'aide du script automatisé (one-liner)

Modifier en ligne

Si vous installez l'agent hôte à l'aide du script automatisé (en une seule ligne), vous pourriez rencontrer les problèmes suivants :

Basé sur Debian

Modifier en ligne

Incident :

Avec les dérivés Debian, vous pouvez voir la sortie suivante :

  Setting up Instana APT repository
  Importing Instana GPG key
  Updating apt metadata ...
  E: The method driver /usr/lib/apt/methods/https could not be found.
  APT repository metadata update failed

Solution : Dans ce cas, installez le paquet apt-transport-https car Apt n'extrait pas actuellement les polices des serveurs HTTPS.

SUSE et SLES

Modifier en ligne

Problème : pour SUSE Linux Enterprise Server 12, la sortie suivante peut s'afficher :

  Setting up Instana agent for GNU/Linux
  Setting up Instana zypper repository
  Updating zypper metadata ...
  Installing Instana agent ...
  Error building the cache:
  [instana-agent|https://_@packages.instana.io/agent/generic/x86_64] Valid metadata not found at specified URL
  Some of the repositories have not been refreshed because of an error.
  No provider of 'instana-agent-static' found.
  Instana agent package install failed

Solution : Vous devez mettre à jour votre openssl pour recevoir correctement les artefacts via des connexions HTTPS modernes. Pour connaître la configuration réseau requise pour les agents hôtes, consultez la section « Configuration réseau requise pour l'agent Instana ».

CentOS

Modifier en ligne

Problème : Pour les systèmes basés sur CentOS-6, vous pouvez voir la sortie suivante :

Setting up Instana agent for GNU/Linux
Setting up Instana YUM repository
Updating YUM metadata ...
YUM repository metadata update failed

Solution : Mettez à jour les versions de libcurl.

RHEL

Modifier en ligne

Avec les systèmes d' RHEL, vous pourriez rencontrer les problèmes suivants :

  • Problème : Vous pouvez obtenir le résultat suivant :

    Error unpacking rpm package instana-agent-dynamic-20210630-0948.x86_64
Error: Transaction failed

    Solution : L'activation de Federal Information Processing Standard (FIPS) ou SELinux peut entraîner l'erreur suivante lors de l'installation de one-liner. Désactivez FIPS et SELinux lorsque vous installez l'agent hôte.

  • Problème : l'installation manuelle des paquets " instana-agent échoue dans la configuration suivante :

    sudo rpm -ivh instana-agent-dynamic-20210713-1352.x86_64.rpm
...
error: unpacking of archive failed on file /etc/init.d/instana-agent;60eda3b3: cpio: Digest mismatch
error: instana-agent-dynamic-20210713-1352.x86_64: install failed

    Solution : Une solution de contournement possible pour l'installation manuelle consiste à ignorer la vérification à l'aide de la commande suivante :

    sudo rpm -ivh --nodigest --nofiledigest instana-agent-dynamic-20210713-1352.x86_64.rpm

Agents installés à l'aide d'un gestionnaire de paquets ou manuellement (DEB, RPM)

Modifier en ligne

Si vous installez l'agent hôte à l'aide de via un gestionnaire de paquets ou manuellement (DEB, RPM), vous pourriez rencontrer les problèmes suivants :

Basé sur Debian

Modifier en ligne

Pour les produits dérivés Debian, vous pouvez rencontrer les problèmes suivants :

  • Problème : Il se peut que le message d'erreur de connexion suivant s'affiche :

    GnuTLS recv error (-9): A TLS packet with unexpected length was received

    Solution : Ce bogue est présent dans les programmes GnuTLS-depending comme Curl, Git ou apt.

  • Problème : il se peut que vous obteniez le résultat suivant lorsque vous lancez l'installation.

    E: The method driver /usr/lib/apt/methods/https could not be found.` `APT repository metadata update failed

    Solution : Dans ce cas, installez le paquet apt-transport-https car Apt n'extrait pas actuellement les polices des serveurs HTTPS.

SUSE et SLES

Modifier en ligne

Pour SUSE Linux Enterprise Server 12, vous pouvez rencontrer les problèmes suivants :

  • Problème : Vous pouvez obtenir le résultat suivant :

    Error building the cache:
[instana-agent|https://_@packages.instana.io/agent/generic/x86_64] Valid metadata not found at specified URL
Some of the repositories have not been refreshed because of an error.
No provider of 'instana-agent-static' found.
Instana agent package install failed

    Solution : Vous devez mettre à jour vos bibliothèques GnuTLS, OpenSSL, et NSS ainsi que les programmes qui en dépendent (par exemple Curl). Cette mise à jour est importante pour recevoir correctement les artefacts via des connexions HTTPS modernes.

  • Problème : Si vous essayez d'activer le instana-agent Si vous utilisez systemd pour ce service, vous pourriez rencontrer le message d'erreur suivant sous SUSE Enterprise Linux :

    systemctl enable instana-agent

Synchronizing state of instana-agent.service with SysV service script with /usr/lib/systemd/systemd-sysv-install.
Executing: /usr/lib/systemd/systemd-sysv-install enable instana-agent
ln -sf ../instana-agent /etc/init.d/rc2.d/S50instana-agent
ln: failed to create symbolic link '/etc/init.d/rc2.d/S50instana-agent': No such file or directory

    Solution :

    1. Supprimez le fichier '/etc/init.d/instana-agent.

    2. Exécutez la commande suivante.

      systemctl enable instana-agent

      Vous pouvez alors constater que le lien symbolique est créé correctement :

      systemctl enable instana-agent

Created symlink /etc/systemd/system/multi-user.target.wants/instana-agent.service → /lib/systemd/system/instana-agent.service.`

CentOS

Modifier en ligne

Sur les systèmes basés sur CentOS 6, vous pouvez rencontrer le problème suivant :

Problème : Vous pouvez voir la sortie de journal suivante :

Updating YUM metadata ...
YUM repository metadata update failed

Solution : Mettez à jour les versions de libcurl.

Agents installés et exécutés en tant qu'utilisateur non root

Modifier en ligne

Lorsque vous lancez l'agent « Instana » en tant qu'utilisateur non root, vous pouvez rencontrer les problèmes suivants :

  • Problème : Vous pouvez obtenir le résultat suivant :

    java.nio.file.AccessDeniedException: /var/lib/instana

    Solution : Créez un répertoire avec les droits d'administrateur, puis attribuez-le à un utilisateur de l' Instana.

    sudo mkdir /var/lib/instana
sudo chown instana: /var/lib/instana
sudo chmod 700 /var/lib/instana

  • Problème : Vous pouvez obtenir le résultat suivant :

    Skipping the memory calculator: cannot retrieve the maximum amount of memory to be used by the agent from /sys/fs/cgroup/memory/memory.limit
The memory calculator has not been used, and neither the 'JAVA_MAX_MEM' nor 'JAVA_OPTS' environment variables specify a maximum heap setting

    Solution : Cette erreur ne doit pas avoir d'impact sur l'agent lui-même. Le calculateur de mémoire est un petit binaire utilisé par systemd ou les conteneurs pour déterminer la taille du tas de mémoire « Java » à allouer à l'agent, en fonction des limites définies. Vous pouvez résoudre ce problème en définissant la variable JAVA_OPTS d'environnement.

  • Problème : Vous pouvez rencontrer un problème de demande de mot de passe, qui est dû au fait que l'agent essaie de lire le lien symbolique du processus détenu par root.

    Solution :

    1. Ajoutez l'entrée suivante dans le fichier " sudoers:

      instana ALL=(root)    NOPASSWD:/usr/bin/readlink

      Cette entrée permet à l'agent d'accéder à la commande " readlink pour le processus racine.

    2. Facultatif : Déboguer le problème en activant les journaux sudo :

      Defaults logfile=/var/log/sudo.log

      L'extrait suivant affiche un journal indiquant que le script de l'agent tente de lire la readlink commande :

      Nov 12 06:03:19 : instana : command not allowed ; TTY=pts/2 ;
    PWD=/home/tester/instana-agent ; USER=root ; COMMAND=/usr/bin/readlink
    /proc/21025/exe
Nov 12 06:03:19 : instana : command not allowed ; TTY=pts/2 ;
    PWD=/home/tester/instana-agent ; USER=root ; COMMAND=/usr/bin/readlink
    /proc/21025/cwd
Nov 12 06:03:19 : instana : command not allowed ; TTY=pts/2 ;
    PWD=/home/tester/instana-agent ; USER=root ; COMMAND=/usr/bin/readlink
    /proc/12152/exe
Nov 12 06:03:19 : instana : command not allowed ; TTY=pts/2 ;
    PWD=/home/tester/instana-agent ; USER=root ; COMMAND=/usr/bin/readlink
    /proc/12152/cwd

Pour obtenir des informations de dépannage générales à tous les agents hôte, voir Gestion des agents hôte : Dépannage.