Fehlerbehebung des Host-Agenten auf Linux

Online bearbeiten

Die Lösungen für die häufigsten Probleme, die auf dem Host-Agenten beobachtet werden, finden Sie unter Linux :

Agenten werden mit dem automatischen (Einzeiler-)Skript installiert

Online bearbeiten

Wenn Sie den Host-Agenten mithilfe des automatisierten Skripts (Einzeiler) installieren, können die folgenden Probleme auftreten:

Debian-basiert

Online bearbeiten

Problem:

Bei Debian -basierten Derivaten sehen Sie möglicherweise die folgende Ausgabe:

  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

Lösung: Installieren Sie in diesem Fall das Paket apt-transport-https , da Apt derzeit keine Schriftarten von HTTPS Servern bezieht.

SUSE und SLES

Online bearbeiten

Problem: Für SUSE Linux Enterprise Server 12 wird möglicherweise die folgende Ausgabe angezeigt:

  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

Lösung: Sie müssen Ihr openssl aktualisieren, um Artefakte über moderne HTTPS -Verbindungen korrekt zu empfangen. Die Netzwerkanforderungen für Host-Agenten finden Sie unter Netzwerkanforderungen für Instana-Agenten.

CentOS

Online bearbeiten

Problem: Bei Systemen, die auf CentOS-6 basieren, wird möglicherweise die folgende Ausgabe angezeigt:

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

Lösung: Aktualisieren Sie die libcurl-Versionen.

RHEL

Online bearbeiten

Bei RHEL-Systemen können die folgenden Probleme auftreten:

  • Problem: Sie sehen möglicherweise die folgende Ausgabe:

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

    Lösung: Aktivierte Federal Information Processing Standard (FIPS) oder SELinux können zu dem folgenden Fehler während der Einzeleinrichtung führen. Deaktivieren Sie FIPS und SELinux, wenn Sie den Host-Agenten installieren.

  • Problem: Die manuelle Installation von instana-agent -Paketen schlägt bei der folgenden Konfiguration fehl:

    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

    Lösung: Eine mögliche Abhilfe für die manuelle Installation besteht darin, die Überprüfung mit dem folgenden Befehl zu überspringen:

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

Agenten, die mit Hilfe eines Paketmanagers oder manuell installiert werden (DEB, RPM)

Online bearbeiten

Wenn Sie den Host-Agenten mit Hilfe eines Paketmanagers oder manuell (DEB, RPM) installieren, können folgende Probleme auftreten:

Debian-basiert

Online bearbeiten

Bei Debian -basierten Derivaten können Sie auf folgende Probleme stoßen:

  • Problem: Möglicherweise wird die folgende Fehlermeldung angezeigt:

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

    Lösung: Dieser Fehler wird in GnuTLS-depending Programmen wie Curl, Git oder apt gefunden.

  • Problem: Möglicherweise sehen Sie die folgende Ausgabe, wenn Sie die Installation starten.

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

    Lösung: Installieren Sie in diesem Fall das Paket apt-transport-https , da Apt derzeit keine Schriftarten von HTTPS Servern bezieht.

SUSE und SLES

Online bearbeiten

Bei SUSE Linux Enterprise Server 12 können die folgenden Probleme auftreten:

  • Problem: Sie sehen möglicherweise die folgende Ausgabe:

    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

    Lösung: Sie müssen Ihre GnuTLS, OpenSSL, und NSS-Bibliotheken und die von ihnen abhängigen Programme (z. B. Curl) aktualisieren. Diese Aktualisierung ist wichtig für den korrekten Empfang von Artefakten über moderne HTTPS Verbindungen.

  • Problem: Wenn Sie versuchen, den Dienst instana-agent mithilfe von systemd zu aktivieren, wird möglicherweise die folgende Fehlermeldung in SUSE Enterprise Linux angezeigt:

    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

    Lösung:

    1. Löschen Sie die Datei /etc/init.d/instana-agent.

    2. Führen Sie den folgenden Befehl aus.

      systemctl enable instana-agent

      Dann können Sie sehen, dass der Symlink korrekt erstellt wurde:

      systemctl enable instana-agent

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

CentOS

Online bearbeiten

Auf CentOS 6-basierten Systemen kann das folgende Problem auftreten:

Problem: Möglicherweise sehen Sie die folgende Protokollausgabe:

Updating YUM metadata ...
YUM repository metadata update failed

Lösung: Aktualisieren Sie die libcurl-Versionen.

Agenten, die als Nicht-Root-Benutzer installiert und ausgeführt werden

Online bearbeiten

Wenn Sie den Instana-Agenten als Nicht-Root-Benutzer starten, können die folgenden Probleme auftreten:

  • Problem: Sie sehen möglicherweise die folgende Ausgabe:

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

    Lösung: Erstellen Sie ein Verzeichnis mit dem Root-Recht und ändern Sie die Eigentümerschaft auf einen Instana-Benutzer.

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

  • Problem: Sie sehen möglicherweise die folgende Ausgabe:

    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

    Lösung: Dieser Fehler darf sich nicht auf den Agenten selbst auswirken. Der Speicherrechner ist eine kleine Binärdatei, die von systemd oder Containern verwendet wird, um zu bestimmen, wie viel Java-Heap dem Agenten zugewiesen werden soll, basierend auf den festgelegten Grenzen. Sie können das Problem durch Eingabe der JAVA_OPTS umgebungsvariable.

  • Problem: Möglicherweise tritt das Problem der Passwortabfrage auf, das dadurch verursacht wird, dass der Agent versucht, den Symlink des Prozesses zu lesen, der root gehört.

    Lösung:

    1. Fügen Sie den folgenden Eintrag in die Datei sudoers ein:

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

      Dieser Eintrag ermöglicht dem Agenten den Zugriff auf den Befehl readlink für den Root-Prozess.

    2. Optional: Beheben Sie das Problem, indem Sie sudo logs aktivieren:

      Defaults logfile=/var/log/sudo.log

      Der folgende Ausschnitt zeigt ein Protokoll, in dem das Agentenskript versucht, den readlink befehl zu lesen:

      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

Informationen zur Fehlerbehebung, die allgemein für alle Host-Agenten gelten, finden Sie unter Verwalten von Host-Agenten: Fehlersuche.