zabbix_sender
Abschnitt: Benutzerbefehle (1)
Aktualisiert: 2021-06-01
Index Zurück zum Hauptinhalt
[ ]{#lbAB}
NAME
zabbix_sender – Zabbix-Sender-Dienstprogramm [ ]{#lbAC}
ÜBERSICHT
zabbix_sender [-v] -z server [-p port] [-I
IP-address] [-t timeout] -s host -k key -o
value
zabbix_sender [-v] -z server [-p port] [-I
IP-address] [-t timeout] [-s host] [-T]
[-N] [-r] [-g] -i input-file
zabbix_sender [-v] -c config-file [-z server]
[-p port] [-I IP-address] [-t timeout] [-s
host] -k key -o value
zabbix_sender [-v] -c config-file [-z server]
[-p port] [-I IP-address] [-t timeout] [-s
host] [-T] [-N] [-r] [-g] -i input-file
zabbix_sender [-v] -z server [-p port] [-I
IP-address] [-t timeout] -s host --tls-connect
cert --tls-ca-file CA-file [--tls-crl-file CRL-file]
[--tls-server-cert-issuer cert-issuer]
[--tls-server-cert-subject cert-subject] --tls-cert-file
cert-file --tls-key-file key-file [--tls-cipher13
cipher-string] [--tls-cipher cipher-string] -k key
-o value
zabbix_sender [-v] -z server [-p port] [-I
IP-address] [-t timeout] [-s host] --tls-connect
cert --tls-ca-file CA-file [--tls-crl-file CRL-file]
[--tls-server-cert-issuer cert-issuer]
[--tls-server-cert-subject cert-subject] --tls-cert-file
cert-file --tls-key-file key-file [--tls-cipher13
cipher-string] [--tls-cipher cipher-string] [-T]
[-N] [-r] [-g] -i input-file
zabbix_sender [-v] -c config-file [-z server]
[-p port] [-I IP-address] [-t timeout] [-s
host] --tls-connect cert --tls-ca-file CA-file
[--tls-crl-file CRL-file] [--tls-server-cert-issuer
cert-issuer] [--tls-server-cert-subject cert-subject]
--tls-cert-file cert-file --tls-key-file key-file
[--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] -k key -o value
zabbix_sender [-v] -c config-file [-z server]
[-p port] [-I IP-address] [-t timeout] [-s
host] --tls-connect cert --tls-ca-file CA-file
[--tls-crl-file CRL-file] [--tls-server-cert-issuer
cert-issuer] [--tls-server-cert-subject cert-subject]
--tls-cert-file cert-file --tls-key-file key-file
[--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] [-T] [-N] [-r] [-g] -i input-file
zabbix_sender [-v] -z server [-p port] [-I
IP-address] [-t timeout] -s host --tls-connect
psk --tls-psk-identity PSK-identity --tls-psk-file
PSK-file [--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] -k key -o value
zabbix_sender [-v] -z server [-p port] [-I
IP-address] [-t timeout] [-s host] --tls-connect
psk --tls-psk-identity PSK-identity --tls-psk-file
PSK-file [--tls-cipher13 cipher-string] [--tls-cipher
cipher-string] [-T] [-N] [-r] [-g] -i input-file
zabbix_sender [-v] -c config-file [-z server]
[-p port] [-I IP-address] [-t timeout] [-s
host] --tls-connect psk --tls-psk-identity PSK-identity
--tls-psk-file PSK-file [--tls-cipher13 cipher-string]
[--tls-cipher cipher-string] -k key -o value
zabbix_sender [-v] -c config-file [-z server]
[-p port] [-I IP-address] [-t timeout] [-s
host] --tls-connect psk --tls-psk-identity PSK-identity
--tls-psk-file PSK-file [--tls-cipher13 cipher-string]
[--tls-cipher cipher-string] [-T] [-N] [-r] [-g]
-i input-file
zabbix_sender -h
zabbix_sender -V [ ]{#lbAD}
BESCHREIBUNG
zabbix_sender ist ein Befehlszeilenprogramm zum Senden von Überwachungsdaten an den Zabbix-Server oder -Proxy. Auf dem Zabbix-Server sollte ein Element vom Typ Zabbix-trapper mit entsprechendem Schlüssel erstellt werden. Beachten Sie, dass eingehende Werte nur von Hosts akzeptiert werden, die im Feld Zulässige Hosts für dieses Element angegeben sind. []{#lbAE}
OPTIONEN
-c, --config config-file
Verwende config-file. Zabbix sender liest Server-Details aus der
agentd-Konfigurationsdatei. Standardmäßig liest Zabbix sender keine
Konfigurationsdatei. Nur die Parameter Hostname, ServerActive,
SourceIP, TLSConnect, TLSCAFile, TLSCRLFile,
TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile,
TLSKeyFile, TLSPSKIdentity und TLSPSKFile werden unterstützt.
Ein über den Parameter HostnameItem definierter Hostname wird nicht übernommen; in diesem Fall sollte der Hostname über die Befehlszeile angegeben werden (siehe Option -s).
Alle im Agent-Konfigurationsparameter ServerActive definierten Adressen
werden zum Senden von Daten verwendet. Wenn das Senden von Stapeldaten an
eine Adresse fehlschlägt, werden die folgenden Stapel nicht an diese Adresse gesendet.
-z, --zabbix-server server
Hostname oder IP-Adresse des Zabbix-Servers. Wenn ein Host von einem
Proxy überwacht wird, sollte stattdessen der Hostname oder die IP-Adresse
des Proxys verwendet werden. Bei gemeinsamer Verwendung mit --config
überschreibt diese Option die im Parameter ServerActive der
agentd-Konfigurationsdatei angegebenen Einträge.
-p, --port port
Gibt die Portnummer des auf dem Server laufenden Zabbix-Server-Trappers an.
Standard ist 10051. Bei gemeinsamer Verwendung mit --config
überschreibt diese Option die Port-Einträge des Parameters ServerActive
in der agentd-Konfigurationsdatei.
-I, --source-address IP-address
Gibt die Quell-IP-Adresse an. Bei gemeinsamer Verwendung mit --config
überschreibt diese Option den in der agentd-Konfigurationsdatei angegebenen
Parameter SourceIP.
-t, --timeout seconds
Gibt das Timeout an. Gültiger Bereich: 1–300 Sekunden (Standard: 60)
-s, --host host
Gibt den Hostnamen an, zu dem der Datenpunkt gehört (wie im Zabbix
Frontend registriert). Die Host-IP-Adresse und der DNS-Name funktionieren
nicht. Bei gemeinsamer Verwendung mit --config überschreibt diese
Option den in der agentd-Konfigurationsdatei angegebenen Parameter
Hostname.
-k, --key key
Gibt den Schlüssel des Datenpunkts an, an den der Wert gesendet werden soll.
-o, --value value
Gibt den Wert des Datenpunkts an.
-i, --input-file input-file
Lädt Werte aus einer Eingabedatei. Gib - als <input-file> an, um
Werte von der Standardeingabe zu lesen. Jede Zeile der Datei enthält durch
Leerraum getrennt: <hostname> <key> <value>. Jeder Wert
muss in einer eigenen Zeile angegeben werden. Jede Zeile muss 3 durch
Leerraum getrennte Einträge enthalten: <hostname> <key> <value>, wobei
„hostname“ der Name des überwachten Hosts ist, wie er im Zabbix
Frontend registriert ist, „key“ der Schlüssel des Zieldatenpunkts und „value“ der zu sendende Wert.
Gib - als <hostname> an, um den Hostnamen aus der Agent-
Konfigurationsdatei oder aus dem Argument --host zu verwenden.
Ein Beispiel für eine Zeile in einer Eingabedatei:
"Linux DB3" db.connections 43
Der Werttyp muss in der Datenpunkt-Konfiguration des Zabbix Frontends korrekt gesetzt sein. Zabbix sender sendet bis zu 250 Werte in einer Verbindung. Das Größenlimit für das Senden von Werten aus einer Eingabedatei hängt von der im Zabbix-Kommunikationsprotokoll beschriebenen Größe ab. Der Inhalt der Eingabedatei muss in UTF-8-Kodierung vorliegen. Alle Werte aus der Eingabedatei werden in sequentieller Reihenfolge von oben nach unten gesendet. Einträge müssen nach den folgenden Regeln formatiert werden:
- Einträge in Anführungszeichen und ohne Anführungszeichen werden unterstützt.
- Das doppelte Anführungszeichen ist das Zeichen zum Maskieren.
- Einträge mit Leerraum müssen in Anführungszeichen gesetzt werden.
- Doppelte Anführungszeichen und Backslash-Zeichen innerhalb eines in Anführungszeichen gesetzten Eintrags müssen mit einem Backslash maskiert werden.
- Escaping wird in nicht in Anführungszeichen gesetzten Einträgen nicht unterstützt.
- Escape-Sequenzen für Zeilenumbrüche (\n) werden in Zeichenketten in Anführungszeichen unterstützt.
- Escape-Sequenzen für Zeilenumbrüche werden am Ende eines Eintrags abgeschnitten.
-T, --with-timestamps
Diese Option kann nur zusammen mit der Option --input-file verwendet werden.
Jede Zeile der Eingabedatei muss 4 durch Leerraum getrennte Einträge enthalten: <hostname> <key> <timestamp> <value>. Der Zeitstempel sollte im Unix-Zeitstempelformat angegeben werden. Wenn der Zieldatenpunkt Auslöser hat, die auf ihn verweisen, müssen alle Zeitstempel in aufsteigender Reihenfolge vorliegen, andernfalls ist die Ereignisberechnung nicht korrekt.
Ein Beispiel für eine Zeile in der Eingabedatei:
"Linux DB3" db.connections 1429533600 43
Weitere Details siehe Option --input-file.
Wenn ein Wert mit Zeitstempel für einen Host gesendet wird, der sich in einer Wartung vom Typ „keine Daten“ befindet, wird dieser Wert verworfen; es ist jedoch möglich, einen Wert mit Zeitstempel für einen abgelaufenen Wartungszeitraum zu senden, und dieser wird akzeptiert.
-N, --with-ns
Diese Option kann nur zusammen mit der Option --with-timestamps verwendet werden.
Jede Zeile der Eingabedatei muss 5 durch Leerraum getrennte Einträge enthalten: <hostname> <key> <timestamp> <ns> <value>.
Ein Beispiel für eine Zeile in der Eingabedatei:
"Linux DB3" db.connections 1429533600 7402561 43
Weitere Details siehe Option --input-file.
-r, --real-time
Sendet Werte einzeln, sobald sie empfangen werden. Dies kann beim Lesen
von der Standardeingabe verwendet werden.
-g, --group
Gruppiert Werte nach Hosts und sendet sie für jeden Host in einem separaten Stapel.
--tls-connect value
Wie die Verbindung zum Server oder Proxy hergestellt wird. Werte:
[ ]{#lbAF}
unverschlüsselt
connect without encryption (default)
<!-- -->
psk
eine Verbindung mit TLS und einem vorab freigegebenen Schlüssel herstellen
<!-- -->
cert
eine Verbindung mit TLS und einem Zertifikat herstellen
<!-- -->
--tls-ca-file CA-file
Vollständiger Pfadname einer Datei, welche die Zertifikate der obersten CA(s)
für die Überprüfung von Peer-Zertifikaten enthält.
--tls-crl-file CRL-file
Vollständiger Pfadname einer Datei, die widerrufene Zertifikate enthält.
--tls-server-cert-issuer cert-issuer
Erlaubter Aussteller des Serverzertifikats.
--tls-server-cert-subject cert-subject
Erlaubter Betreff des Serverzertifikats.
--tls-cert-file cert-file
Vollständiger Pfadname einer Datei, die das Zertifikat oder die Zertifikatskette enthält.
--tls-key-file key-file
Vollständiger Pfadname einer Datei, die den privaten Schlüssel enthält.
--tls-psk-identity PSK-identity
PSK-Kennzeichenfolge.
--tls-psk-file PSK-file
Vollständiger Pfadname einer Datei, die den Pre-Shared Key enthält.
--tls-cipher13 cipher-string
Chiffrierzeichenfolge für OpenSSL 1.1.1 oder neuer für TLS 1.3.
Überschreibt die Standardkriterien für die Auswahl der Ciphersuite.
Diese Option ist nicht verfügbar, wenn die OpenSSL-Version kleiner als 1.1.1 ist.
--tls-cipher cipher-string
GnuTLS-Prioritätszeichenfolge (für TLS 1.2 und höher) oder OpenSSL-Verschlüsselungszeichenfolge (nur für TLS 1.2).
Überschreiben Sie die Standardkriterien für die Auswahl der Chiffriersuite.
-v, --verbose
Verbose Modus, -vv für weitere Einzelheiten.
-h, --help
Diese Hilfe anzeigen und beenden.
-V, --version
Versionsinformationen ausgeben und beenden.
[ ]{#lbAG}
EXIT-STATUS
Der Exit-Status ist 0, wenn die Werte erfolgreich gesendet und vom Server vollständig verarbeitet wurden. Wurden Daten gesendet, aber mindestens einer der Werte konnte nicht verarbeitet werden, ist der Exit-Status 2. Wenn das Senden der Daten fehlschlägt, beträgt der Exit-Status 1.
[ ]{#lbAH}
BEISPIELE
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k mysql.queries -o 342.45\
Sendet 342.45 als Wert für das Element mysql.queries des überwachten Host. Verwenden Sie den überwachten Host und den Zabbix-Server, die in der Agenten Konfigurationsdatei definiert sind.
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s „Überwachter Host“ -k mysql.queries -o 342.45\
Senden Sie 342.45 als Wert für den Eintrag mysql.queries des Überwachten Host über den in der Konfigurationsdatei des Agenten definierten Zabbix-Server.
zabbix_sender -z 192.168.1.113 -i data_values.txt
Werte aus der Datei data_values.txt an den Zabbix-Server mit der IP senden
192.168.1.113. Hostnamen und Schlüssel sind in der Datei definiert.
echo „- hw.serial.number 1287872261 SQ4321ASDF“ | zabbix_sender -c
/usr/local/etc/zabbix_agentd.conf -T -i -\
Sendet einen Wert mit Zeitstempel von der Kommandozeile an den Zabbix-Server, der in der Konfigurationsdatei des Agenten angegeben ist. Bindestrich in den Eingabedaten zeigt an, dass auch der Hostname aus derselben Konfigurationsdatei verwendet werden soll. Datei stammt.
echo '„Zabbix server“ trapper.item „“' | zabbix_sender -z
192.168.1.113 -p 10000 -i -\
Leeren Wert eines Items an den Zabbix-Server mit IP-Adresse senden 192.168.1.113 an Port 10000 über die Kommandozeile. Leere Werte müssen durch leere doppelte Anführungszeichen gekennzeichnet werden.
zabbix_sender -z 192.168.1.113 -s „Überwachter Host“ -k mysql.queries -o 342.45 --tls-connect cert --tls-ca-file /home/zabbix/zabbix_ca_file --tls-cert-datei /home/zabbix/zabbix_agentd.crt --tls-key-datei /home/zabbix/zabbix_agentd.key\
Senden Sie 342.45 als Wert für den Eintrag mysql.queries in Monitored Host an den Server mit der IP 192.168.1.113 unter Verwendung von TLS mit Zertifikat.
zabbix_sender -z 192.168.1.113 -s „Überwachter Host“ -k mysql.queries -o 342.45 --tls-connect psk --tls-psk-identity „PSK ID Zabbix agentd“ --tls-psk-datei /home/zabbix/zabbix_agentd.psk\
Senden Sie 342.45 als Wert für den Eintrag mysql.queries in Monitored Host an den Server mit der IP 192.168.1.113 unter Verwendung von TLS mit Pre-Shared Key (PSK).
[ ]{#lbAI}
SIEHE AUCH
Dokumentation https://www.zabbix.com/manuals
zabbix_agentd(8), zabbix_get(1), zabbix_proxy(8), zabbix_server(8), zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8) [ ]{#lbAJ}
Index
Dieses Dokument wurde erstellt am: 08:42:39 GMT, Juni 11, 2021