Verwalten des Host-Agenten unter Linux

Wenn Sie den Host-Agenten installieren, wird er beim Systemstart automatisch gestartet. Sie können dieses Verhalten abschalten, indem Sie bei der Installation des Agenten die Umgebungsvariable ' INSTANA_AGENT_AUTOSTART=false setzen.

• Um den Host-Agenten zu starten, führen Sie den folgenden Befehl aus:

  /opt/instana/agent/bin/start
   

• Wenn Ihr Betriebssystem " systemd als Init-System verwendet, führen Sie den folgenden Befehl aus:

  systemctl start instana-agent.service
   

• Wenn Ihr Betriebssystem " SysVinit als Init-System verwendet, führen Sie den folgenden Befehl aus:

  service instana-agent start
   

Um den Agenten zu stoppen, führen Sie den folgenden Befehl aus:

 /opt/instana/agent/bin/stop
 

• Wenn Ihr Betriebssystem " systemd als Init-System verwendet, führen Sie den folgenden Befehl aus:

  systemctl stop instana-agent.service
   

• Wenn Ihr Betriebssystem " SysVinit als Init-System verwendet, führen Sie den folgenden Befehl aus:

  service instana-agent stop
   

Sie können den Paketmanager Ihres Betriebssystems verwenden, um ein Agentenpaket auf Ihrem Rechner zu aktualisieren. Um die Pakete und Patches Ihres Systems zu aktualisieren und zu verwalten, führen Sie den folgenden Befehl aus:

yum update // apt-get upgrade
 

Die Pakete instana-agent-static oder instana-agent-dynamic werden aktualisiert.

Wenn Ihr Betriebssystem ' SysVinit als Init-System verwendet, ruft der Host-Agent die entsprechenden Shell-Skripte im Verzeichnis ' /etc/default/Debian und Derivate) oder ' /etc/sysconfig/Red Hat und Derivate) ab.

Wenn der Name des Dienstes nicht geändert wird, verwendet das SysVinit die Datei " /etc/default/instana-agent oder " /etc/sysconfig/instana-agent.

Beispielsweise können Sie in „ Debian “ die Variablen „ Instana “ und aktualisieren PATH , indem Sie verwenden /etc/default/instana-agent (sofern diese Datei lesbar ist):

INSTANA_AGENT_KEY=$agentkey
INSTANA_AGENT_ENDPOINT=$endpoint
INSTANA_AGENT_ENDPOINT_PORT=$endpoint_port
PATH=/usr/local/bin:${PATH}
 

Um die Werte für Endpunkt, Port und Agentenschlüssel zu ermitteln, rufen Sie die Startseite der Benutzeroberfläche von „ Instana “ auf und klicken Sie auf „Agentenbereitstellung “. Klicken Sie auf der Seite „Agenten-Bereitstellungskatalog“ auf die Kachel „ Linux – Automatische Installation (One-Liner) “. Dann können Sie die Werte für Endpunkt, Port und Agentenschlüssel im Verteilungsskript sehen.

Wenn Ihr Betriebssystem " Systemd als Init-System verwendet, können Sie Umgebungsvariablen setzen und überschreiben, indem Sie die folgenden verfügbaren Optionen verwenden. Die Drop-in-Units-Methode ist der empfohlene Ansatz, da Sie die Datei der Service-Units nicht ändern müssen, während Sie bei den anderen Methoden Änderungen an der Datei vornehmen müssen. Diese Änderungen können bei den Aktualisierungen auch wieder entfernt werden. Die Drop-in-Units-Methode stellt sicher, dass die Änderungen und eingestellten Umgebungsvariablen auch nach Updates erhalten bleiben.

• Drop-in-Einheiten
• EnvironmentFile-Anweisungen
• Globale Umgebungseinstellungen

Auf ' system.d-basierten Systemen kann der ' systemd-tmpfiles -Daemon Dateien löschen, die vom Host-Agenten im ' /tmp/.instana benötigt werden, was zu Aktualisierungsfehlern führt, die schwer zu beheben sind.

Seit Version 181 installieren DEB- und RPM-Agentenpakete automatisch das folgende Konfigurationsskript, /usr/lib/tmpfiles.d das das Verhalten so anpasst, dass die erforderlichen Dateien nicht gelöscht werden und die Funktionen des Host-Agenten von „ Instana “ nicht beeinträchtigt werden.

# Instana files in /tmp cannot be deleted when the agent is running,
# or it may lead to issues on agent update
R! /tmp/.java_pid*
R! /tmp/.instana/*
 

Mit dieser Konfiguration können tmpdfiles.d die Dateien, die vom Instana -Agenten benötigt werden, erst nach einem Neustart des Hosts gelöscht werden. Der neu gestartete Host-Agent von „ Instana “ erstellt die Dateien beim Start neu.

Red Hat Enterprise Linux und CentOS, in den Versionen 6 und 7 enthalten standardmäßig " tmpdfiles.d, die das gesamte " /tmp alle 10 Tage löschen, unabhängig davon, welche Richtlinien ein Paket angeben kann. Das bedeutet, dass ein Paket wie „ Instana “ benutzerdefinierte Richtlinien festlegen kann, um das Verhalten des Systems oder des Pakets selbst zu steuern.

#  This file is part of systemd.
#
#  systemd is free software; you can redistribute it and/or modify it
#  under the terms of the GNU Lesser General Public License as published by
#  the Free Software Foundation; either version 2.1 of the License, or
#  (at your option) any later version.

# See tmpfiles.d(5) for details
# Clear tmp directories separately, to make them easier to override
v /tmp 1777 root root 10d
v /var/tmp 1777 root root 30d

...
 

Abgesehen von der Bearbeitung der standardmäßigen " tmpfiles.d gibt es keine bekannte Abhilfemaßnahme. Die Richtlinie tmpfiles.d befindet sich in der Datei /usr/lib/tmpfiles.d/tmp.conf.

Viele Derivate von „ Debian “, darunter „ Ubuntu “, enthalten tmpdfiles.d Standardrichtlinien, die das gesamte /tmp Verzeichnis löschen, unabhängig davon, welche Richtlinien ein Paket wie „ Instana “ festlegen kann. Bei der Installation führen die DEB- und RPM-Pakete einen Test durch, um das Verhalten der temporären Dateien " tmpfiles.d zu überprüfen, indem sie den Befehl " systemd-tmpfiles --remove ausführen.

Auf Systemen, auf denen Richtlinien das von den „ Instana “-Agentenpaketen festgelegte erforderliche Verhalten überschreiben, wird möglicherweise die folgende Warnung angezeigt:

WARNING: The tmpfiles.d policies of this system may cause the Instana agent to malfunction by deleting the /tmp/.instana directory; refer https://www.instana.com/docs/setup_and_manage/host_agent/on/linux#tmpfiles.d for more information.
 

Sie können dieses Problem lösen, indem Sie die Standardrichtlinien " tmpfiles.d bearbeiten. Die Richtlinie tmpfiles.d befindet sich in der Datei /usr/lib/tmpfiles.d/tmp.conf.

Red Hat Enterprise Linux 6 und CentOS 6 enthalten das Tool tmpwatch, das dafür bekannt ist, dass es unnötige Dateien im Verzeichnis " /tmp/.instana löscht. Die Verwendung von tmpwatch in diesen Distributionen kann jedoch gelegentlich Aktualisierungsprobleme mit dem Host-Agenten verursachen. Weitere Informationen finden Sie unter Löschen von temporären Dateien.

# Deal with tmpwatch, found in RHEL 6 and CentOS 6.
# It is a cronjob, installed in /etc/cron.d/daily, with pretty much hardcoded
# configurations to wipe data the Instana agent needs.
readonly TMPWATCH_CRONJOB='/etc/cron.d/daily/tmpwatch'
if [ -f "${TMPWATCH_CRONJOB}" ]; then
  # Let's check if we already touched the file and, if not, add our excludes
  if ! grep "${TMPWATCH_CRONJOB}" Instana 2&>1 > /dev/null; then
    echo "tmpwatch discovered in '${TMPWATCH_CRONJOB}': adding the exclude flags for Instana"
    # Edit in place with `sed`
    sed -i '/^flags=/a flags="${flags} -x /tmp/instana -x /tmp/.javapid* # Added by Instana"' "${TMPWATCH_CRONJOB}"
  fi
fi