2 Plugins

Übersicht

Plugins erweitern die Überwachungsfunktionen von Zabbix Agent 2. Sie sind in der Programmiersprache Go geschrieben und bieten eine Alternative zu loadable modules (in C geschrieben) sowie zu anderen Methoden zur Erweiterung der Zabbix-Funktionalität.

Diese Funktionen sind spezifisch für Agent 2 und seine Plugins:

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

Alle von Zabbix Agent 2 unterstützten Metriken werden von Plugins erfasst. Diese Seite beschreibt die Prinzipien der Plugin-Konfiguration aus Benutzersicht und listet sowohl integrierte als auch loadable Plugins auf, die von Zabbix bereitgestellt werden.

Plugins konfigurieren

Dieser Abschnitt beschreibt allgemeine Prinzipien und Best Practices für die Plugin-Konfiguration.

Alle Plugins werden mit dem Parameter Plugins.* konfiguriert, der entweder Teil der Konfigurationsdatei von Zabbix Agent 2 oder der eigenen Konfigurationsdatei eines Plugins sein kann. Wenn ein Plugin eine separate Konfigurationsdatei verwendet, sollte der Pfad zu dieser Datei im Parameter Include der Konfigurationsdatei von Zabbix Agent 2 angegeben werden.

Ein typischer Plugin-Parameter hat die folgende Struktur:

Plugins.<PluginName>.<Parameter>=<Value>

Zusätzlich gibt es zwei spezielle Gruppen von Parametern:

• Plugins.<PluginName>.Default.<Parameter>=<Value> wird zum Definieren von Standardparameterwerten verwendet.

• Plugins.<PluginName>.<SessionName>.<Parameter>=<Value> wird zum Definieren separater Parametersätze für verschiedene Überwachungsziele über benannte Sitzungen verwendet.

Alle Parameternamen sollten die folgenden Anforderungen erfüllen:

• es wird empfohlen, die Namen Ihrer Plugins großzuschreiben
• der Parameter sollte großgeschrieben werden
• Sonderzeichen sind nicht erlaubt
• die Verschachtelung ist nicht durch eine maximale Ebene begrenzt
• die Anzahl der Parameter ist nicht begrenzt

Um beispielsweise aktive Prüfungen ohne Scheduling- Aktualisierungsintervall unmittelbar nach dem Neustart des Agent nur für das Uptime-Plugin auszuführen, setzen Sie Plugins.Uptime.System.ForceActiveChecksOnStart=1 in der Konfigurationsdatei. Um auf ähnliche Weise ein benutzerdefiniertes Limit für gleichzeitige Prüfungen für das CPU-Plugin festzulegen, setzen Sie Plugins.CPU.System.Capacity=N in der Konfigurationsdatei.

Standardwerte

Sie können Standardwerte für die verbindungsbezogenen Parameter (URI, Benutzername, Passwort usw.) in der Konfigurationsdatei im folgenden Format festlegen:

Plugins.<PluginName>.Default.<Parameter>=<Value>

Zum Beispiel Plugins.Mysql.Default.Username=zabbix, Plugins.MongoDB.Default.Uri=tcp://127.0.0.1:27017 usw.

Wenn ein Wert für einen solchen Parameter weder in einem Datenpunktschlüssel noch in den Parametern der benannten Sitzung angegeben ist, verwendet das Plugin den Standardwert. Wenn auch ein Standardparameter nicht definiert ist, werden fest codierte Standardwerte verwendet.

Benannte Sitzungen

Benannte Sitzungen stellen eine zusätzliche Ebene von Plugin-Parametern dar und können verwendet werden, um für jede der überwachten Instanzen separate Sätze von Authentifizierungsparametern anzugeben. Jeder Parameter einer benannten Sitzung sollte die folgende Struktur haben:

Plugins.<PluginName>.Sessions.<SessionName>.<Parameter>=<Value>

Ein Sitzungsname kann als Parameter des Datenpunktschlüssels connString verwendet werden, anstatt URI, Benutzername und/oder Passwort separat anzugeben.

In Datenpunktschlüsseln kann der erste Parameter entweder ein connString oder eine URI sein. Wenn der erste Schlüsselparameter keinem Sitzungsnamen entspricht, wird er als URI behandelt. Beachten Sie, dass die Übergabe eingebetteter URI-Anmeldedaten im Datenpunktschlüssel nicht unterstützt wird; verwenden Sie stattdessen Parameter benannter Sitzungen.

Die Liste der verfügbaren Parameter benannter Sitzungen hängt vom Plugin ab.

Es ist möglich, Sitzungsparameter zu überschreiben, indem neue Werte in den Parametern des Datenpunktschlüssels angegeben werden (siehe Beispiel).

Wenn ein Parameter für die benannte Sitzung nicht definiert ist, verwendet Zabbix Agent 2 den im Standard-Plugin-Parameter definierten Wert.

Priorität der Parameter

Zabbix Agent 2-Plugins suchen nach Werten für verbindungsbezogene Parameter in der folgenden Reihenfolge:

1. Der erste Datenpunktschlüssel-Parameter wird mit Sitzungsnamen verglichen. Wenn keine Übereinstimmung gefunden wird, wird er als tatsächlicher Wert behandelt; in diesem Fall wird Schritt 3 übersprungen. Wird eine Übereinstimmung gefunden, muss der Parameterwert (in der Regel eine URI) in der benannten Sitzung definiert sein.
2. Andere Parameter werden aus dem Datenpunktschlüssel übernommen, falls sie definiert sind.
3. Wenn ein Datenpunktschlüssel-Parameter (zum Beispiel das Passwort) leer ist, sucht das Plugin nach dem entsprechenden Parameter der benannten Sitzung.
4. Wenn der Sitzungsparameter ebenfalls nicht angegeben ist, wird der im entsprechenden Standardparameter definierte Wert verwendet.
5. Wenn alles andere fehlschlägt, verwendet das Plugin den fest kodierten Standardwert.

Beispiel 1

Überwachung der zwei Instanzen “MySQL1” und “MySQL2”.

Konfigurationsparameter:

Plugins.Mysql.Sessions.MySQL1.Uri=tcp://127.0.0.1:3306
Plugins.Mysql.Sessions.MySQL1.User=mysql1_user
Plugins.Mysql.Sessions.MySQL1.Password=unique_password
Plugins.Mysql.Sessions.MySQL2.Uri=tcp://192.0.2.0:3306
Plugins.Mysql.Sessions.MySQL2.User=mysql2_user
Plugins.Mysql.Sessions.MySQL2.Password=different_password

Als Ergebnis dieser Konfiguration kann jeder Sitzungsname als connString in einem item key, e.g., mysql.ping[MySQL1] oder mysql.ping[MySQL2].

Beispiel 2

Bereitstellung einiger Parameter im Datenpunktschlüssel.

Konfigurationsparameter:

Plugins.PostgreSQL.Sessions.Session1.Uri=tcp://192.0.2.234:5432
Plugins.PostgreSQL.Sessions.Session1.User=old_username
Plugins.PostgreSQL.Sessions.Session1.Password=session_password

Datenpunktschlüssel: pgsql.ping[session1,new_username,,postgres]

Als Ergebnis dieser Konfiguration wird der Agent PostgreSQL mit den folgenden Parametern verbinden:

• URI aus dem Sitzungsparameter: 192.0.2.234:5432
• Benutzername aus dem Datenpunktschlüssel: new_username
• Passwort aus dem Sitzungsparameter (da es im Datenpunktschlüssel ausgelassen wird): session_password
• Datenbankname aus dem Datenpunktschlüssel: postgres

Beispiel 3

Erfassung einer Metrik mit Standard-Konfigurationsparametern.

Konfigurationsparameter:

Plugins.PostgreSQL.Default.Uri=tcp://192.0.2.234:5432
Plugins.PostgreSQL.Default.User=zabbix
Plugins.PostgreSQL.Default.Password=password

Datenpunktschlüssel: pgsql.ping[,,,postgres]

Als Ergebnis dieser Konfiguration wird der Agent eine Verbindung zu PostgreSQL unter Verwendung der folgenden Parameter herstellen:

• Standard-URI: 192.0.2.234:5432
• Standard-Benutzername: zabbix
• Standard-Passwort: password
• Datenbankname aus dem Datenpunktschlüssel: postgres

Verbindungen

Einige Plugins unterstützen das gleichzeitige Erfassen von Metriken aus mehreren Instanzen. Sowohl lokale als auch entfernte Instanzen können überwacht werden. TCP- und Unix-Socket-Verbindungen werden unterstützt.

Es wird empfohlen, Plugins so zu konfigurieren, dass Verbindungen zu Instanzen offen gehalten werden. Die Vorteile sind eine geringere Netzwerkauslastung, niedrigere Latenz sowie ein reduzierter CPU- und Speicherverbrauch aufgrund der geringeren Anzahl von Verbindungen. Die Client-Bibliothek übernimmt dies.

Integrierte Plugins

Die integrierten Plugins von Zabbix agent 2 sind sofort einsatzbereit verfügbar. Klicken Sie auf den Plugin-Namen, um zum Plugin-Repository mit zusätzlichen Informationen zu gelangen.

Ladbare Plugins

Ladbare Plugins für Zabbix Agent 2 sind nicht standardmäßig verfügbar und müssen separat installiert werden:

• Unter Linux können Sie Pakete verwenden (z. B. Ember+ unter Ubuntu mit apt install zabbix-agent2-plugin-ember-plus installieren) oder Plugins erstellen
• Unter Windows können Sie über MSI installieren oder Plugins erstellen

Klicken Sie auf den Plugin-Namen, um zum Plugin-Repository zu gelangen, das die README-Datei des Plugins mit zusätzlichen Informationen enthält.