Den Serveragenten installieren, Schritt für Schritt

Installieren Sie den InfraNest-Agenten auf einem Server, um Daten zu Arbeitsspeicher, Speicherplatz und Systemlast zu erhalten. Dies richtet sich an alle, die Monitoring auf einem von ihnen verwalteten Server einrichten möchten, und dauert etwa zwei Minuten pro Server.

NoteMöchten Sie zuerst wissen, warum Sie ihn installieren sollten und was er erfasst? Lesen Sie Arbeitsspeicher, Speicherplatz und Systemlast mit dem Agenten erhalten — dieser Artikel setzt voraus, dass Sie sich bereits entschieden haben, fortzufahren.

Überblick

• Der Agent ist ein kleines Programm, das Sie einmalig auf dem Server selbst installieren, mithilfe eines Einmal-Tokens von InfraNest.
• Er sendet Daten ausschließlich über Port 443 ins Internet — nichts muss zum Server hin geöffnet werden, und keine Firewall-Regel muss geändert werden.
• Sobald er läuft, erscheinen die Werte für Arbeitsspeicher, Speicherplatz und Systemlast des Servers in InfraNest, und Alarmregeln, die den Agenten benötigten, werden verfügbar.

Bevor Sie beginnen

Sie benötigen drei Dinge:

• Einen Server in InfraNest. Falls noch nicht vorhanden, fügen Sie ihn unter Infrastruktur → Server hinzu.
• Administratorzugriff auf diesen Server — sudo unter Linux, eine PowerShell als Administrator unter Windows. Sie benötigen dies einmalig, zur Installation. Der Agent selbst läuft anschließend nicht als Administrator.
• Der Server muss das Internet über Port 443 erreichen können. Nur ausgehend.

Sie müssen keinen Port öffnen, kein Paketmanager-Repository installieren oder InfraNest weiteren Zugriff auf die Maschine geben.

Den Installationsbefehl abrufen

1. Wählen Sie Install the agent — Sie finden dies in der Zeile des Servers unter Monitoring → Server, im Aktionsmenü des Servers, oder neben einer Alarmregel, die ausgegraut ist, weil sie den Agenten benötigt. Alle drei öffnen dasselbe Fenster.
2. Es wird nichts abgefragt: Das Token wird sofort erstellt. In der anschließenden Token-Liste wird jedes Token danach identifiziert, wer es hinzugefügt hat, wann, und wann es zuletzt verwendet wurde.
3. Das Token wird einmalig angezeigt. Darunter befindet sich ein fertiger Installationsbefehl mit bereits eingefügtem Token.
4. Wählen Sie den Tab für Ihr System und kopieren Sie den Befehl.

WarningVerwenden Sie das Token nur für einen Server. Es identifiziert, welcher Server berichtet. Wenn sich zwei Maschinen ein Token teilen, schreiben sie in denselben Satz von Graphen, und nichts erkennt dies — die Werte vermischen sich, und der Alarm „Server hat sich nicht mehr gemeldet“ kann niemals ausgelöst werden, weil die noch laufende Maschine für beide weiter meldet.

Den Installationsbefehl ausführen

Ubuntu und Debian

Fügen Sie den Befehl in ein Terminal auf diesem Server ein. Er sieht so aus:

curl -fsSL https://github.com/InfraNest-Infrastructure-Organized/infranest-agent/releases/latest/download/install.sh \
  | sudo sh -s -- --token sat_YOUR_TOKEN

Getestet auf Ubuntu 20.04, 22.04 und 24.04 sowie Debian 11 und 12.

RHEL, Rocky, AlmaLinux, CentOS Stream, Fedora

Exakt derselbe Befehl. Das Installationsprogramm lädt eine einzelne Binärdatei herunter und richtet einen systemd-Dienst ein; es verwendet keinen Paketmanager, daher spielt die Distribution keine Rolle, solange sie systemd verwendet.

Falls curl fehlt, installieren Sie es zunächst mit sudo dnf install curl.

Windows Server

Öffnen Sie PowerShell als Administrator und führen Sie aus:

irm https://github.com/InfraNest-Infrastructure-Organized/infranest-agent/releases/latest/download/install.ps1 -OutFile install.ps1
.\install.ps1 -Token sat_YOUR_TOKEN

Getestet auf Windows Server 2019 und 2022. Er wird nach C:\Program Files\InfraNest installiert und läuft als geplante Aufgabe namens InfraNest agent.

Ein Server ohne systemd

Alpine, ein Container oder etwas, das OpenRC oder runit verwendet: Das Installationsprogramm legt die Binärdatei und die Konfigurationsdatei ab und teilt Ihnen dann mit, dass es keinen Dienst einrichten konnte. Führen Sie infranest-agent run unter dem jeweiligen Supervisor dieses Systems aus. Der Agent erwartet, dauerhaft zu laufen; er ist kein einmaliger Job.

Prüfen, ob es funktioniert hat

1. In InfraNest: Warten Sie etwa eine Minute und laden Sie die Seite des Servers neu. Arbeitsspeicher, Speicherplatz und Systemlast-Durchschnitt beginnen sich zu füllen, das Abdeckungs-Badge ändert sich zu Agent, und zuvor ausgegraute Alarmregeln werden verfügbar.
2. Auf dem Server, wenn Sie lieber lokal prüfen möchten, führen Sie aus:

sudo infranest-agent status

& "C:\Program Files\InfraNest\infranest-agent.exe" status

Es zeigt an, ob Messwerte übermittelt werden, und wenn nicht, warum nicht. Es antwortet nur anhand dessen, was auf der Maschine vorhanden ist, und kontaktiert nichts anderes.

Notesudo ist erforderlich, weil die Konfigurationsdatei eine Anmeldeinformation enthält und nur vom eigenen Benutzer des Agenten lesbar ist. Ohne sudo erhalten Sie eine Fehlermeldung über ein fehlendes Token statt über Berechtigungen.

Das Skript vor der Ausführung lesen

Wenn Sie das Skript lieber zuerst überprüfen möchten, bietet das Installationsfenster diesen Weg mit derselben Priorität wie den Einzeiler:

curl -fsSLO https://github.com/InfraNest-Infrastructure-Organized/infranest-agent/releases/latest/download/install.sh
sha256sum install.sh        # mit der in InfraNest angezeigten Prüfsumme vergleichen
less install.sh             # etwa 200 Zeilen
sudo sh install.sh --token sat_YOUR_TOKEN

Die neben dem Befehl in InfraNest angezeigte Prüfsumme ist diejenige, die mit dem Release veröffentlicht wurde, sodass der Vergleich eine echte Kontrolle darstellt. Das Skript selbst ist nicht der Agent — es lädt eine versionierte Binärdatei herunter und überprüft sie anhand ihrer eigenen veröffentlichten Prüfsumme, bevor es sie installiert.

Das Token aus Ihrer Shell-Historie fernhalten

Ein Befehlszeilenaufruf landet in Ihrer Shell-Historie und ist während der Ausführung sichtbar. Verwenden Sie auf einer gemeinsam genutzten Maschine stattdessen eine Token-Datei:

printf '%s' 'sat_YOUR_TOKEN' | sudo tee /root/token >/dev/null
sudo sh install.sh --token-file /root/token && sudo shred -u /root/token

Den Agenten aktualisieren

1. Führen Sie denselben Installationsbefehl erneut aus. Er ersetzt die Binärdatei und behält Ihre Konfiguration und Ihr Token bei.

InfraNest teilt Ihnen mit, wenn ein Update verfügbar ist: Die System-Karte des Servers zeigt die Agent-Version an, und die Flottentabelle markiert Server, die eine ältere Version verwenden.

Den Agenten entfernen

1. Führen Sie den Deinstallationsbefehl für Ihr System aus:

sudo sh install.sh --uninstall

.\install.ps1 -Uninstall

Dies entfernt den Dienst, den Benutzer, die Binärdatei, die Konfiguration und die gespeicherten Messwerte.

WarningDas Löschen des Tokens in InfraNest deinstalliert nichts — es stoppt lediglich die Annahme der Messwerte. Der Agent läuft weiter und versucht es auf der Maschine erneut, bis Sie ihn dort entfernen.

Fehlerbehebung

Wenn nichts davon passt, führen Sie aus:

sudo infranest-agent flare

Es gibt alles aus, was für ein Support-Gespräch benötigt wird — Version, Konfiguration, Status, was nicht gelesen werden konnte — mit entferntem Token. Fügen Sie das in ein Support-Ticket ein statt Ihre Konfigurationsdatei.