Installation des Agenten auf Linux

Das Einzeilerskript akzeptiert die folgenden Parameter:

Um ein Instana-Agentenpaket herunterzuladen, führen Sie die folgenden Schritte aus:

1. Klicken Sie auf der Startseite der Instana-Benutzeroberfläche auf Datenquelle einrichten. Wählen Sie auf der Registerkarte Instana-Agenten die Option Agenten installieren.

   Wenn Sie eine neue Testinstanz von Instana starten, wird der Agentenkatalog mit einer Aufforderung zur Auswahl eines zu installierenden Host-Agenten angezeigt.

2. Klicken Sie auf der Seite des Agentenverteilungskatalogs auf die Kachel Linux - Pakete (DEB, RPM).

3. Wählen Sie die Agentenkonfigurationen aus.

   • Wählen Sie im Abschnitt Paketierung den Agententyp (Dynamic oder Static), den Sie bereitstellen möchten. Um die Unterschiede zwischen statischen und dynamischen Agenten zu verstehen, siehe Host-Agententypen.

   • Wählen Sie im Abschnitt Laufzeit Azul Zulu 11 oder Eclipse OpenJ9 11 Runtime.

   • Wählen Sie im Abschnitt Modus den gewünschten Paketmodus (RPM oder DEM).

4. Wählen Sie im Abschnitt Plattformarchitektur die Architektur des Linux Rechners aus, auf dem Sie den Host-Agenten installieren möchten.

5. Klicken Sie auf das Download-Symbol, um das Host-Agent-Paket (DEB oder RPM) über Ihren Webbrowser herunterzuladen.

Nun wird das Agentenpaket heruntergeladen. Fahren Sie mit dem nächsten Abschnitt fort, um das Agentenpaket zu installieren.

Weisen Sie Ihren Paketmanager an, das Agentenpaket zu installieren, oder installieren Sie das Agentenpaket manuell.

Um das Agentenpaket mit Hilfe eines Paketmanagers zu installieren, verwenden Sie eine der folgenden Möglichkeiten, abhängig von Ihrer Linux Distribution:

• Debian-Ableitungen (Paketmanager apt)

  1. Bereiten Sie den apt Paketmanager mit Ressourcen für das Instana-Agentenpaket vor, indem Sie die folgenden Dateien erstellen:

     # /etc/apt/sources.list.d/instana-agent.list
     deb [arch=amd64] https://packages.instana.io/agent generic main
      

     # /etc/apt/auth.conf.d/instana-packages.conf
     machine packages.instana.io
     login _
     password <your_agent_key>
      

     Hinweis: Alternativ können Sie die Authentifizierung in der URL in /etc/apt/sources.list.d/instana-agent.list fest codieren. Diese Methode stellt jedoch ein geringes Sicherheitsrisiko dar und apt gibt Warnungen aus, die angezeigt werden, wenn Sie Instana-Pakete installieren oder aktualisieren.

  2. Fügen Sie den Instana GPG-Schlüssel zum apt Paketmanager hinzu, indem Sie den folgenden Befehl ausführen:

     wget -qO - https://packages.instana.io/Instana.gpg | sudo apt-key add -
      

• RPM-basierte Distributionen (yum package manager)

  1. Kopieren Sie den folgenden Codeschnipsel in Ihre yum-Quellen (/etc/yum.repos.d/Instana-Agent.repo):

     [instana-agent]
     name=Instana
     baseurl=https://_:<your_agent_key>@packages.instana.io/agent/generic/x86_64
     enabled=1
     gpgcheck=1
     repo_gpgcheck=1
     gpgkey=https://packages.instana.io/Instana.gpg
     priority=5
     sslverify=1
      

     Ersetzen Sie <Ihr_agent_key> durch Ihren Agentenschlüssel.

  2. Wenn Sie die GPG-Paketüberprüfung aktivieren wollen, müssen Sie bei einigen Distributionen den Schlüssel zuvor in den Schlüsselring des Paketmanagers importieren.

     Um den Schlüssel zu importieren, führen Sie den folgenden Befehl aus:

     rpm --import https://packages.instana.io/Instana.gpg
      

• openSUSE/SLES (zypp Paketmanager)

  Für openSUSE und SUSE Linux Enterprise Server lautet der Pfad /etc/zypp/yum.repos.d/Instana-Agent.repo, aber der Inhalt kann derselbe bleiben wie bei der RPM-basierten Distribution.

Jetzt ist das Agentenpaket installiert. Nachdem Sie die Quellen des Paketmanagers aktualisiert haben, fahren Sie mit dem nächsten Abschnitt fort.

1. Konfigurieren Sie den Endpunkt des Host-Agenten und den Schlüssel des Agenten.

   Um die Endpunkt-, Port- und Agentenschlüsselwerte zu finden, gehen Sie zur Startseite der Instana-Benutzeroberfläche und klicken Sie auf Agentenbereitstellung. Klicken Sie auf der Seite des Agentenverteilungskatalogs auf die Kachel Linux - Automatic Installation (One-liner). Dann können Sie die Werte für Endpunkt, Port und Agentenschlüssel im Verteilungsskript sehen.

   Siehe das folgende Skriptbeispiel:

   curl -o setup_agent.sh https://setup.instana.io/agent && chmod 700 ./setup_agent.sh && sudo ./setup_agent.sh -a aGeNTKEY0vaLuO0Eu1ABc -d n3asffgkg -t dynamic -e ingress-green-saas.instana.io:443  
    

2. Setzen Sie Umgebungsvariablen, bevor Sie den Host-Agenten installieren.

   export INSTANA_AGENT_KEY=$agentkey
   export INSTANA_AGENT_ENDPOINT=$endpoint
   export INSTANA_AGENT_ENDPOINT_PORT=$endpoint_port
    

   Hinweis: Die Verwendung der Umgebungsvariablen INSTANA_AGENT_HOST und INSTANA_AGENT_PORT für die Agentenkonfiguration ist veraltet. Diese Umgebungsvariablen sind für die Konfiguration von Instana-Tracern zur Verbindung mit dem Agenten reserviert. Wenn sie global eingestellt sind, können die Instana-Tracer keine Verbindung zum Agenten herstellen. Die Unterstützung für die Verwendung dieser Umgebungsvariablen zur Konfiguration des Agenten wird in zukünftigen Versionen von Instana entfernt werden.

   Zusammenfassung der Optionen zum Setzen von Umgebungsvariablen:

   • Git -basierte Konfigurationsverwaltung: Das Ablegen von Umgebungsvariablen in einer Datei ist ein guter Ansatz. Weitere Informationen finden Sie unter Git -basierte Konfigurationsverwaltung.

   • Systemd: Ein Drop-in ist der einfachste Weg, um Umgebungsspezifika für Dienste zu überschreiben.

   • SysVinit: Legen Sie die Dateien entweder in /etc/sysconfig ( Red Hat Derivate) oder /etc/default ( Debian Derivate).

   Weitere Informationen zu den Optionen für Umgebungsvariablen finden Sie unter Setzen und Überschreiben von Umgebungsvariablen.

Damit sind die Vorbereitungsarbeiten für die Agenteninstallation abgeschlossen. Fahren Sie mit dem Abschnitt Installieren des Agenten fort.

Aktualisieren Sie die Quellen des Paketmanagers, und führen Sie dann einen der folgenden Befehle aus, um den Agenten auf der von Ihnen gewählten Architektur zu installieren:

• Debian-Ableitungen

  • Um einen statischen Agenten zu installieren, führen Sie den folgenden Befehl aus:

    apt-get install instana-agent-static
     

  • Um einen dynamischen Agenten zu installieren, führen Sie den folgenden Befehl aus:

    apt-get install instana-agent-dynamic
     

• Red Hat derivate

  • Um einen statischen Agenten zu installieren, führen Sie den folgenden Befehl aus:

    yum install instana-agent-static
     

  • Um einen dynamischen Agenten zu installieren, führen Sie den folgenden Befehl aus:

    yum install instana-agent-dynamic
     

• Eclipse OpenJ9 11, gebündelte Pakete

  Installieren Sie den Host-Agenten mit einem der folgenden Paketnamen: instana-agent-static-j9 oder instana-agent-dynamic-j9.

Jetzt ist der Host-Agent installiert. Was Sie nach der Installation tun können, erfahren Sie im Abschnitt Was Sie als Nächstes tun können.

Bevor Sie den Host-Agenten installieren, sollten Sie sicherstellen, dass die folgenden Voraussetzungen erfüllt sind:

• Ein Java-Entwicklungskit (JDK) muss für den Agenten verfügbar sein, indem eine der folgenden Optionen verwendet wird:

  • Platzieren oder verlinken Sie das JDK in <instana-agent-install-dir>/jvm (so dass <instana-agent-install-dir>/jvm/bin/java existiert).

  • Der anpassbare Weg besteht darin, eine Umgebungsvariable JAVA_HOME zu exportieren, die auf dieses JDK verweist (diese Umgebungsvariable kann auch auf instana-agent-install-dir>/bin/setenv gesetzt werden).

  Die folgenden JDKs werden für die Ausführung des Agenten unterstützt:

  • IBM OpenJ9 JDK 11 (bevorzugt)
  • Azul Zulu JDK 11
  • OpenJDK JDK 11
  • Oracle Hotspot JDK 11
  • Amazon hat JDK 11 korrigiert
  • J9IBM 11

  Die JVM muss für alle Benutzer des Systems ausführbar sein. Es wird empfohlen, die letzte verfügbare Patch-Version der Java-Distribution Ihrer Wahl zu verwenden. Der Agent benötigt ein JDK, das TLSv1.3 unterstützt (verfügbar in allen aktuellen JDK 11-Builds). Abhängig von Ihrer Betriebssystemdistribution enthalten die vom Betriebssystemvertreiber bereitgestellten Pakete aufgrund von Exportkontrollen möglicherweise keine Unterstützung für starke Verschlüsselung. Wenn Sie ein solches Paket verwenden, könnten Sie auf Fehler wie java.lang.RuntimeException: Could not generate DH key pair stoßen.

• Um den Ressourcenverbrauch des Agenten bei Änderungen am Dateisystem zu reduzieren, müssen Sie das Paket inotify-tools auf Ihrer Linux Distribution installieren.

• Stellen Sie sicher, dass der Benutzer, unter dem der Agent ausgeführt wird, im Verzeichnis des Agenten und in allen Unterverzeichnissen schreiben kann. Der Agent lädt die erforderlichen Sensoren gemäß der automatischen Erkennung herunter und erstellt Protokolldateien in seinem Unterverzeichnis data .

• Vergewissern Sie sich, dass Sie über etwa 100 MB freien Speicherplatz verfügen.

• Der Agent lädt Updates und Sensoren vom folgenden Host herunter. Vergewissern Sie sich, dass auf die folgenden Hosts und Ports zugegriffen werden kann:

  • DNS-Name : artifact-public.instana.io
  • Zielhafen : tcp/80 und tcp/443

• Derzeit wird der Instana-Dienst in zwei verschiedenen Regionen angeboten. Ihre individuelle Instanz befindet sich geografisch am nächsten zu den meisten Ihrer Agenten und Benutzer. Die Agenten sind beim Download vorkonfiguriert, aber einige Installationsmethoden erfordern eine Instana-Backend-Konfiguration. Wenden Sie sich an den Abschnitt Agent Management im Produkt oder an Ihren technischen Ansprechpartner unter IBM, um sich über die Region zu informieren, in der sich Ihre Instanz befindet.

• Wenn Sie das selbst gehostete (lokale) Instana verwenden, verwenden Sie die Endpunkte, die während der Installation des Instana-Backends definiert wurden. Sie können den Endpunkt, an den der Agent berichtet, auch in der Instana-Benutzeroberfläche sehen. Klicken Sie auf der Startseite der Instana-Benutzeroberfläche auf Datenquelle einrichten. Wählen Sie auf der Registerkarte Instana-Agenten die Option Agenten installieren, und überprüfen Sie den Bereitstellungscode oder die YAML-Konfiguration.

• Wenn Sie Instana SaaS, verwenden, benutzen Sie die Endpunkte, die unter Host-Agent-Endpunkte beschrieben sind.

Sie können den Host-Agenten auf eine der folgenden Arten herunterladen:

• Laden Sie den Agenten von der Instana-Benutzeroberfläche herunter, indem Sie die folgenden Schritte ausführen：

  1. Klicken Sie auf der Startseite der Instana-Benutzeroberfläche auf Datenquelle einrichten. Wählen Sie auf der Registerkarte Instana-Agenten die Option Agenten installieren.

     Wenn Sie eine neue Testinstanz von Instana starten, wird der Agentenkatalog mit einer Aufforderung zur Auswahl eines zu installierenden Host-Agenten angezeigt.

  2. Klicken Sie auf der Seite des Agenteneinsatzkatalogs auf die Kachel Linux - Archiv ( tar.gz ).

  3. Wählen Sie im Abschnitt Paketierung den Agententyp (Dynamic oder Static), den Sie bereitstellen möchten. Um die Unterschiede zwischen statischen und dynamischen Agenten zu verstehen, siehe Host-Agententypen.

  4. Wählen Sie in der Dropdown-Liste die Plattformarchitektur (Betriebssystem) aus.

     Die Archivdatei ist automatisch mit den Einstellungen Ihres Instana-Kontos vorkonfiguriert, so dass Sie den Agenten nur noch entpacken und starten müssen.

  5. Klicken Sie auf das Download-Symbol, um die Host-Agent-Paketdatei ( tar.gz ) von Ihrem Webbrowser herunterzuladen, und extrahieren Sie dann die Datei.

• Laden Sie den Agenten mit wget herunter, indem Sie die folgenden Befehle ausführen:

  wget --save-cookies {{agent_folder_name}}/instana-cookies.txt --post-data 'email={{instana_username}}&password={{instana_password}}' https://{{instana_tenant_unit}}-{{instana_tenant}}.instana.io/auth/signIn
   

  wget --content-disposition --load-cookies {{agent_folder_name}}/instana-cookies.txt --post-data 'type=linux64' https://instana.io/ump/{{instana_tenant}}/{{instana_tenant_unit}}/agent/download -O {{opt_folder}}/{{name_of_agent_archive.tar.gz}}
   

Jetzt wird der Host-Agent heruntergeladen. Fahren Sie mit dem nächsten Abschnitt fort, um den Agenten zu starten.

Legen Sie die extrahierte Agent-Paketdatei an einem systemweit zugänglichen Ort ab und führen Sie den Agent als Root-Benutzer aus.

Führen Sie den folgenden Befehl aus, um den Agenten zu starten:

INSTANA_AGENT_FOLDER/bin/start
 

Nun ist der Host-Agent installiert und gestartet. Was Sie nach der Installation tun können, erfahren Sie unter Was Sie als nächstes tun können.

Der Instana-Agent, der als Nicht-Root-Benutzer ausgeführt wird, unterstützt die folgenden Funktionen: