Agent 2

Übersicht

Zabbix Agent 2 ist eine neue Generation des Zabbix Agent, geschrieben in Go (wobei ein Teil des C-Codes aus dem Zabbix Agent wiederverwendet wird). Er ist dafür ausgelegt:

  • die Anzahl der TCP-Verbindungen zu reduzieren;
  • eine verbesserte Parallelität von Prüfungen bereitzustellen;
  • sich mithilfe von Plugins leicht erweitern zu lassen, die einfache Prüfungen mit minimalem Code bereitstellen und komplexe Prüfungen unterstützen, die aus lang laufenden Skripten und eigenständiger Datenerfassung mit periodischer Berichterstattung bestehen;
  • als Ersatz für Zabbix Agent zu fungieren und alle bisherigen Funktionen zu unterstützen.

Alle Metriken in Zabbix Agent 2 werden von Plugins erfasst.

Diese Funktionen sind spezifisch für Plugins:

  • Geplante und flexible Intervalle für passive und aktive Prüfungen
  • Verwaltung der Aufgabenwarteschlange unter Berücksichtigung von Zeitplan und Aufgabenparallelität
  • Timeouts auf Plugin-Ebene
  • Kompatibilitätsprüfung von Zabbix Agent 2 und seinen Plugins beim Start

Es gibt zwei Arten von Plugins:

Sie können auch Ihre eigenen Plugins erstellen.

Eigenständig erstellte Plugins müssen nicht in Agent 2 eingebaut sein. Sie können sie als ladbare Plugins hinzufügen und dadurch die Erstellung von Plugins für neue Metriken vereinfachen.

Ladbare Plugins können zur Laufzeit hinzugefügt werden, ohne Zabbix Agent 2 neu zu kompilieren.

Passive und aktive Prüfungen

Zabbix Agent 2 unterstützt passive und aktive Prüfungen ähnlich wie Zabbix Agent. Zusätzlich unterstützen aktive Prüfungen von Zabbix Agent 2 flexible/planbare Intervalle und Prüfungsparallelität innerhalb eines aktiven Servers.

Standardmäßig plant Zabbix Agent 2 nach einem Neustart die erste Datenerfassung für aktive Prüfungen zu einem bedingt zufälligen Zeitpunkt innerhalb des Aktualisierungsintervalls des Datenpunkts, um Spitzen im Ressourcenverbrauch zu vermeiden. Um aktive Prüfungen, die kein Scheduling-Aktualisierungsintervall haben, unmittelbar nach dem Neustart des Agents auszuführen, setzen Sie den Parameter ForceActiveChecksOnStart (auf globaler Ebene) oder Plugins.<Plugin name>.System.ForceActiveChecksOnStart (wirkt nur auf bestimmte Plugin-Prüfungen) in der Konfigurationsdatei. Ein Parameter auf Plugin-Ebene überschreibt den globalen Parameter.

Prüfkonkurrenz

Prüfungen aus verschiedenen Plugins können gleichzeitig ausgeführt werden. Die Anzahl der gleichzeitigen Prüfungen innerhalb eines Plugins ist durch die Einstellung der Plugin-Kapazität begrenzt. Jedes Plugin kann eine fest codierte Kapazitätseinstellung haben (1000 ist standardmäßig der Wert), die mit der Einstellung Plugins.<PluginName>.System.Capacity=N im Konfigurations-Parameter Plugins verringert werden kann.

Unterstützte Plattformen

Informationen zu unterstützten Plattformen finden Sie auf der Seite Anforderungen.

Agent 2 auf Unix-ähnlichen Systemen

Zabbix Agent 2 auf Unix-ähnlichen Systemen wird auf dem überwachten Host ausgeführt.

Installation

Zabbix Agent 2 kann auf Linux-basierten Systemen mit einer der folgenden Methoden installiert werden:

  • Zabbix-Pakete - wählen Sie nach Auswahl Ihrer Zabbix-Version, der OS-Distribution und der OS-Version die Komponente Agent 2 aus und folgen Sie den Anweisungen;
  • Zabbix-Quellen - laden Sie die Quelldateien herunter und kompilieren Sie den Agent durch Konfigurieren mit der Option --enable-agent2.

Die Überwachungsfunktionen von Zabbix Agent 2 können durch ladbare Plugins erweitert werden, die separat verfügbar sind. Weitere Details finden Sie unter Loadable plugins.

Wenn als Paket installiert

Zabbix Agent 2 läuft als Vordergrundprozess und ist für die Ausführung im Hintergrund auf einen externen Dienstmanager (z. B. systemd) angewiesen. Zabbix Agent 2 verfügt unter Linux nicht über eine integrierte Unterstützung für die Daemonisierung.

Der Agent kann mit folgendem Befehl gestartet werden:

systemctl start zabbix-agent2

Zum Stoppen, Neustarten oder Prüfen des Status von Zabbix Agent 2 verwenden Sie die folgenden Befehle:

systemctl stop zabbix-agent2
systemctl restart zabbix-agent2
systemctl status zabbix-agent2
Manuell starten

Sie können den Zabbix Agent starten, indem Sie die zabbix_agent2-Binärdatei suchen und direkt ausführen; zum Beispiel:

zabbix_agent2

Agent 2 auf Windows-Systemen

Zabbix Agent 2 wird als eigenständiger Prozess ausgeführt; er kann jedoch auch als Windows-Dienst ausgeführt werden.

Installation

Zabbix Agent 2 kann unter Windows mit einer der folgenden Methoden installiert werden:

Die Überwachungsfunktionen von Zabbix Agent 2 können mit ladbaren Plugins erweitert werden, die separat verfügbar sind. Weitere Informationen finden Sie unter Ladbare Plugins.

Weitere Informationen zur Installation von Zabbix Agent 2 (aus einem ZIP-Archiv) als Windows-Dienst finden Sie auf der Seite Zabbix-Agent unter Microsoft Windows.

Optionen

Die folgenden Befehlszeilenparameter können mit Zabbix Agent 2 verwendet werden:

Parameter Beschreibung
UNIX- und Windows-Agent
-c --config <config-file> Pfad zur Konfigurationsdatei.
Sie können diese Option verwenden, um eine Konfigurationsdatei anzugeben, die nicht die Standarddatei ist.
-f --foreground Zabbix Agent im Vordergrund ausführen (Standard: true).
-p --print Bekannte Datenpunkte ausgeben und beenden.
Beachten Sie, dass Sie die Konfigurationsdatei angeben müssen (falls sie sich nicht am Standardpfad befindet), um auch Ergebnisse von Benutzerparametern zurückzugeben.
-t --test <item key> Angegebenen Datenpunkt testen und beenden.
Beachten Sie, dass Sie die Konfigurationsdatei angeben müssen (falls sie sich nicht am Standardpfad befindet), um auch Ergebnisse von Benutzerparametern zurückzugeben.
-T --test-config Konfigurationsdatei validieren und beenden.
-h --help Hilfsinformationen ausgeben und beenden.
-v --verbose Debugging-Informationen ausgeben. Verwenden Sie diese Option zusammen mit den Optionen -p und -t.
-V --version Agent-Version und Lizenzinformationen ausgeben.
-R --runtime-control <option> Administrative Funktionen ausführen. Siehe Runtime-Steuerung.
Nur Windows-Agent
-m --multiple-agents Mehrere Agent-Instanzen verwenden (mit den Optionen -i, -d, -s, -x).
Zur Unterscheidung der Dienstnamen von Instanzen enthält jeder Dienstname den Hostname-Wert aus der angegebenen Konfigurationsdatei.
-S --startup-type <value> Den Starttyp des Zabbix Windows-Agent-Dienstes festlegen. Zulässige Werte:
automatic - (Standard) den Dienst automatisch beim Windows-Start starten;
delayed - den Start des Dienstes verzögern, nachdem die automatisch gestarteten Dienste ihren Start abgeschlossen haben;
manual - den Dienst manuell starten (durch einen Benutzer oder eine Anwendung);
disabled - den Dienst deaktivieren, sodass er nicht durch einen Benutzer oder eine Anwendung gestartet werden kann.
Sie können diese Option zusammen mit der Option -i oder separat verwenden, um den Starttyp eines bereits installierten Dienstes zu ändern.
-i --install Zabbix Windows-Agent als Dienst installieren.
-d --uninstall Zabbix Windows-Agent-Dienst deinstallieren.
-s --start Zabbix Windows-Agent-Dienst starten.
-x --stop Zabbix Windows-Agent-Dienst stoppen.

Spezifische Beispiele für die Verwendung von Befehlszeilenparametern:

  • Alle integrierten Agent-Datenpunkte mit Werten ausgeben.
  • Einen Benutzerparameter mit dem Schlüssel mysql.ping testen, der in der angegebenen Konfigurationsdatei definiert ist.
  • Einen Zabbix Agent-Dienst für Windows unter Verwendung des Standardpfads zur Konfigurationsdatei C:\\Program Files\\Zabbix Agent 2\\zabbix_agent2.conf installieren.
  • Den Starttyp eines installierten Zabbix Agent-Dienstes für Windows mithilfe der Konfigurationsdatei zabbix_agent2.conf ändern, die sich im selben Ordner wie die Agent-Executable befindet.
zabbix_agent2 --print
zabbix_agent2 -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf
zabbix_agent2.exe -i
zabbix_agent2.exe -c zabbix_agent2.conf -S delayed
Runtime-Steuerung

Die Runtime-Steuerung bietet einige Optionen für die Fernsteuerung.

Option Beschreibung
log_level_increase Erhöht den Log-Level.
log_level_decrease Verringert den Log-Level.
metrics Listet verfügbare Metriken auf.
version Zeigt die Agent-Version an.
userparameter_reload Lädt die Werte der Optionen UserParameter und Include aus der aktuellen Konfigurationsdatei neu.
help Zeigt Hilfeinformationen zur Runtime-Steuerung an.

Beispiele:

  • Erhöhung des Log-Levels für Agent 2.
  • Ausgabe der Optionen der Runtime-Steuerung.
zabbix_agent2 -R log_level_increase
zabbix_agent2 -R help

Konfigurationsdatei

Der Standardpfad zur Konfigurationsdatei ist:

  • Unter UNIX ist der Standard /usr/local/etc/zabbix_agent2.conf oder der durch die Variablen zur Kompilierzeit --sysconfdir oder --prefix festgelegte Pfad.
  • Unter Windows ist der Standard C:\\Program Files\\Zabbix Agent 2\\zabbix_agent2.conf.

Wenn auf einem Host eine einzelne Instanz des Agent ausgeführt wird, kann sie die Standardkonfigurationsdatei oder eine in der Befehlszeile angegebene Konfigurationsdatei verwenden. Bei mehreren Instanzen muss jede Agent-Instanz über eine eigene Konfigurationsdatei verfügen (eine der Instanzen kann die Standardkonfigurationsdatei verwenden).

Die Konfigurationsparameter von Zabbix agent 2 entsprechen größtenteils denen von Zabbix agent, mit einigen Ausnahmen:

Parameters Description
Zabbix agent 2-spezifische Konfigurationsparameter
ControlSocket Der Pfad zum Laufzeit-Steuerungssocket. Zabbix agent 2 verwendet einen Steuerungssocket für Laufzeitbefehle.
EnablePersistentBuffer,
PersistentBufferFile,
PersistentBufferPeriod		 Diese Parameter werden verwendet, um den persistenten Speicher auf Zabbix agent 2 für aktive Datenpunkte zu konfigurieren.
ForceActiveChecksOnStart Legt fest, ob der Agent aktive Prüfungen unmittelbar nach dem Neustart ausführen oder gleichmäßig über die Zeit verteilen soll.
Plugins Plugins können eigene Parameter im Format Plugins.<Plugin name>.<Parameter>=<value> haben. Ein gängiger Plugin-Parameter ist System.Capacity, der das Limit für gleichzeitig ausführbare Prüfungen festlegt.
StatusPort Der Port, auf dem Zabbix agent 2 auf HTTP-Statusanfragen wartet und eine Liste der konfigurierten Plugins sowie einiger interner Parameter anzeigt.
Zabbix agent-spezifische Konfigurationsparameter, die von Zabbix agent 2 nicht unterstützt werden
AllowRoot,
User		 Wird von Zabbix agent 2 nicht unterstützt, da keine Daemonisierung unterstützt wird.
EnableRemoteCommands Veraltet; stattdessen werden in beiden Agenten die Parameter AllowKey und DenyKey verwendet.
ListenBacklog Wird in Zabbix agent verwendet, um die maximale Anzahl ausstehender Verbindungen in der TCP-Warteschlange festzulegen. Wird von Zabbix agent 2 nicht unterstützt.
LoadModule,
LoadModulePath		 Ladbare Module werden von Zabbix agent 2 nicht unterstützt.
MaxLinesPerSecond,
LogRemoteCommands		 In Zabbix agent 2 werden stattdessen Plugins.Log.MaxLinesPerSecond und Plugins.SystemRun.LogRemoteCommands verwendet.
StartAgents Dieser Parameter wird in Zabbix agent verwendet, um die Parallelität passiver Prüfungen zu erhöhen oder sie zu deaktivieren. In Zabbix agent 2 wird die Parallelität auf Plugin-Ebene konfiguriert und kann durch eine Kapazitätseinstellung begrenzt werden. Passive Prüfungen sind in Zabbix Agent 2 deaktiviert, wenn der Parameter Server nicht angegeben ist.

Weitere Informationen finden Sie in den Optionen der Konfigurationsdatei für Zabbix agent2.

Exit-Codes

Zabbix Agent 2 kann auch mit älteren OpenSSL-Versionen (1.0.1, 1.0.2) kompiliert werden.

In diesem Fall stellt Zabbix Mutexes für das Locking in OpenSSL bereit. Wenn das Sperren oder Entsperren eines Mutex fehlschlägt, wird eine Fehlermeldung in den Standardfehlerstrom (STDERR) ausgegeben, und Agent 2 beendet sich mit dem Rückgabecode 2 bzw. 3.