Wartung#

Updates#

Automatisches Update#

Der WatchGrid-Agent verfügt über ein integriertes automatisches Update-System. Bei jedem regulären Ausführungszyklus (ohne CLI-Flags) prüft der Agent selbstständig auf unserem Release-Server, ob eine neuere Version verfügbar ist. Falls eine Aktualisierung vorliegt, wird das Binary automatisch heruntergeladen, verifiziert und ausgetauscht. Der Agent beendet sich anschließend selbst, damit das aktualisierte-Binary beim nächsten Aufruf ausgeführt wird.

Manuelles Update#

Sie können eine Aktualisierung des Agents auch jederzeit manuell anstoßen:

watchgrid -update

Grace Periods & Fehlalarmvermeidung#

Um Fehlalarme während Wartungsarbeiten oder nach Konfigurationsanpassungen zu vermeiden, verfügt WatchGrid über automatische Grace-Period-Mechanismen:

Nach Konfigurationsupdates: Bei Änderungen des Reporting-Intervalls oder der Schwellenwerte gilt eine Übergangsfrist (Grace Period), damit vorübergehende Schwankungen beim Umstellen keine Fehlalarme auslösen.
Nach Server-Releases: Nach einem Release des WatchGrid-Servers wird automatisch eine Gracetime gewährt, um Agenten Zeit zur Re-Synchronisation zu geben.

Systemd-Dienst verwalten#

Da der Agent als systemd-Dienst läuft, können Sie ihn mit den Standard-Befehlen verwalten:

# Status prüfen
systemctl status watchgrid

# Dienst neustarten
systemctl restart watchgrid

# Dienst stoppen / starten
systemctl stop watchgrid
systemctl start watchgrid

CLI-Parameter (Befehlszeilenoptionen)#

Der Agent unterstützt verschiedene Parameter zur lokalen Diagnose oder zum gezielten Ausführen von Aktionen. Die folgenden Flags können beim Aufruf übergeben werden:

Flag	Beschreibung
`-help`	Zeigt eine Hilfe-Nachricht mit allen Parametern an.
`-version`	Gibt die aktuell installierte Version des Agents aus und beendet sich.
`-info`	Erfasst die Systeminformationen (Betriebssystem, Version, Architektur, Uptime) und gibt sie auf der Konsole aus, ohne sie zu senden.
`-isend`	Erfasst die Systeminformationen und sendet diese an den Server.
`-metrics`	Erfasst die aktuellen Metriken (CPU, RAM, Disk, offene Ports und Dienste) und gibt sie auf der Konsole aus, ohne sie zu senden.
`-msend`	Erfasst die aktuellen Metriken und sendet diese an den Server.
`-update`	Führt eine manuelle Prüfung auf Updates durch und aktualisiert das Binary, falls verfügbar.

Hinweis: Wenn Sie den Agenten ohne Parameter ausführen, wird standardmäßig ein automatischer Update-Check durchgeführt und anschließend sowohl die Systeminformationen (-isend) als auch die aktuellen Metriken (-msend) erfasst und an den Server übermittelt.

API Token austauschen#

Sollten Sie Ihr API-Token im Reiter Organisation neu generiert haben oder das Token für einen bestehenden Agenten ändern müssen, können Sie das Token für einen installierten Agenten wie folgt aktualisieren:

Neu-Installation per Oneliner: Führen Sie den Installationsbefehl mit der bestehenden Agent ID und dem neuen Token erneut aus:
```
curl -sfL https://wgri.de/install | WG_AGENT="<AGENT_ID>" WG_TOKEN="<NEUES_API_TOKEN>" sh -
```
Manuelle Konfigurationsanpassung: Alternativ können Sie den Wert "api_token" direkt in der gecachten Konfigurationsdatei unter /etc/watchgrid/config.json anpassen und den Dienst anschließend neustarten:
```
systemctl restart watchgrid
```

Die genauen Schritte zur Ersteinrichtung finden Sie unter Einrichtung.

Installation

Voraussetzungen