Auf dieser Seite
zabbix_sender
ZABBIX_SENDER(1) Allgemeine Befehle ZABBIX_SENDER(1)
NAME
zabbix_sender - Zabbix-Sender-Dienstprogramm
SYNOPSIS
zabbix_sender [-v] -z Server [-p Port] [-I IP-Adresse] [-t Timeout] -s
Host -k Schlüssel -o Wert
zabbix_sender [-v] -z Server [-p Port] [-I IP-Adresse] [-t Timeout] [-s
Host] [-T] [-N] [-r] -i Eingabedatei
zabbix_sender [-v] -c Konfigurationsdatei [-z Server] [-p Port] [-I IP-Adresse]
[-t Timeout] [-s Host] -k Schlüssel -o Wert
zabbix_sender [-v] -c Konfigurationsdatei [-z Server] [-p Port] [-I IP-Adresse]
[-t Timeout] [-s Host] [-T] [-N] [-r] -i Eingabedatei
zabbix_sender [-v] -z Server [-p Port] [-I IP-Adresse] [-t Timeout] -s
Host --tls-connect cert --tls-ca-file CA-Datei [--tls-crl-file CRL-Datei]
[--tls-server-cert-issuer Zertifikatsaussteller] [--tls-server-cert-subject
Zertifikatssubjekt] --tls-cert-file Zertifikatsdatei --tls-key-file Schlüsseldatei
[--tls-cipher13 Chiffre-Zeichenfolge] [--tls-cipher Chiffre-Zeichenfolge] -k Schlüssel -o
Wert
zabbix_sender [-v] -z Server [-p Port] [-I IP-Adresse] [-t Timeout] [-s
Host] --tls-connect cert --tls-ca-file CA-Datei [--tls-crl-file
CRL-Datei] [--tls-server-cert-issuer Zertifikatsaussteller]
[--tls-server-cert-subject Zertifikatssubjekt] --tls-cert-file Zertifikatsdatei
--tls-key-file Schlüsseldatei [--tls-cipher13 Chiffre-Zeichenfolge] [--tls-cipher
Chiffre-Zeichenfolge] [-T] [-N] [-r] -i Eingabedatei
zabbix_sender [-v] -c Konfigurationsdatei [-z Server] [-p Port] [-I IP-Adresse]
[-t Timeout] [-s Host] --tls-connect cert --tls-ca-file CA-Datei
[--tls-crl-file CRL-Datei] [--tls-server-cert-issuer Zertifikatsaussteller]
[--tls-server-cert-subject Zertifikatssubjekt] --tls-cert-file Zertifikatsdatei
--tls-key-file Schlüsseldatei [--tls-cipher13 Chiffre-Zeichenfolge] [--tls-cipher
Chiffre-Zeichenfolge] -k Schlüssel -o Wert
zabbix_sender [-v] -c Konfigurationsdatei [-z Server] [-p Port] [-I IP-Adresse]
[-t Timeout] [-s Host] --tls-connect cert --tls-ca-file CA-Datei
[--tls-crl-file CRL-Datei] [--tls-server-cert-issuer Zertifikatsaussteller]
[--tls-server-cert-subject Zertifikatssubjekt] --tls-cert-file Zertifikatsdatei
--tls-key-file Schlüsseldatei [--tls-cipher13 Chiffre-Zeichenfolge] [--tls-cipher
Chiffre-Zeichenfolge] [-T] [-N] [-r] -i Eingabedatei
zabbix_sender [-v] -z Server [-p Port] [-I IP-Adresse] [-t Timeout] -s
Host --tls-connect psk --tls-psk-identity PSK-Identität --tls-psk-file
PSK-Datei [--tls-cipher13 Chiffre-Zeichenfolge] [--tls-cipher Chiffre-Zeichenfolge] -k
Schlüssel -o Wert
zabbix_sender [-v] -z Server [-p Port] [-I IP-Adresse] [-t Timeout] [-s
Host] --tls-connect psk --tls-psk-identity PSK-Identität --tls-psk-file
PSK-Datei [--tls-cipher13 Chiffre-Zeichenfolge] [--tls-cipher Chiffre-Zeichenfolge]
[-T] [-N] [-r] -i Eingabedatei
zabbix_sender [-v] -c Konfigurationsdatei [-z Server] [-p Port] [-I IP-Adresse]
[-t Timeout] [-s Host] --tls-connect psk --tls-psk-identity PSK-Identität
--tls-psk-file PSK-Datei [--tls-cipher13 Chiffre-Zeichenfolge] [--tls-cipher
Chiffre-Zeichenfolge] -k Schlüssel -o Wert
zabbix_sender [-v] -c Konfigurationsdatei [-z Server] [-p Port] [-I IP-Adresse]
[-t Timeout] [-s Host] --tls-connect psk --tls-psk-identity PSK-Identität
--tls-psk-file PSK-Datei [--tls-cipher13 Chiffre-Zeichenfolge] [--tls-cipher
Chiffre-Zeichenfolge] [-T] [-N] [-r] -i Eingabedatei
zabbix_sender -h
zabbix_sender -V
DESCRIPTION
zabbix_sender ist ein Befehlszeilenprogramm zum Senden von Überwachungsdaten an
den Zabbix Server oder Proxy. Auf dem Zabbix Server sollte ein Datenpunkt vom
Typ Zabbix trapper mit dem entsprechenden Schlüssel erstellt werden. Beachten
Sie, dass eingehende Werte nur von Hosts akzeptiert werden, die im Feld
„Allowed hosts“ dieses Datenpunkts angegeben sind.
OPTIONS
-c, --config Konfigurationsdatei
Verwendet die Konfigurationsdatei. Zabbix sender liest die Serverdetails
aus der Konfigurationsdatei des Agent. Der Agent muss nicht ausgeführt
werden, damit zabbix_sender Daten senden kann. Standardmäßig liest Zabbix
sender keine Konfigurationsdatei. Unterstützt werden nur die Parameter
Hostname, ServerActive, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile,
TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKeyFile,
TLSPSKIdentity und TLSPSKFile. Ein über den Parameter HostnameItem
definierter Hostname wird nicht übernommen. In diesem Fall muss der
Hostname über die Befehlszeile angegeben werden (siehe Option -s).
Alle in dem Agent-Konfigurationsparameter ServerActive definierten
Adressen werden zum Senden von Daten verwendet. Wenn das Senden von
Batchdaten an eine Adresse fehlschlägt, werden die folgenden Batches
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 Proxy verwendet werden. Bei gemeinsamer Verwendung mit --config
überschreibt diese Option die Einträge des Parameters ServerActive in der
Agent-Konfigurationsdatei.
-p, --port Port
Gibt die Portnummer an, unter der der Zabbix-Server-Trapper auf dem
Server ausgeführt wird. Der Standardwert ist 10051. Bei gemeinsamer
Verwendung mit --config überschreibt diese Option die Porteinträge des
Parameters ServerActive in der Agent-Konfigurationsdatei.
-I, --source-address IP-Adresse
Gibt die Quell-IP-Adresse an. Bei gemeinsamer Verwendung mit --config
überschreibt diese Option den Parameter SourceIP in der
Agent-Konfigurationsdatei.
-t, --timeout Sekunden
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 IP-Adresse und der DNS-Name des Hosts
funktionieren nicht. Bei gemeinsamer Verwendung mit --config überschreibt
diese Option den Parameter Hostname in der Agent-Konfigurationsdatei.
-k, --key Schlüssel
Gibt den Datenpunktschlüssel an, an den der Wert gesendet werden soll.
-o, --value Wert
Gibt den Datenpunktwert an.
-i, --input-file Eingabedatei
Lädt Werte aus einer Eingabedatei. Geben Sie als <Eingabedatei> - an,
um Werte aus der Standardeingabe zu lesen. Jede Zeile der Datei enthält
durch Leerzeichen getrennt: <Hostname> <Schlüssel> <Wert>. Jeder Wert
muss in einer eigenen Zeile angegeben werden. Jede Zeile muss drei durch
Leerzeichen getrennte Einträge enthalten: <Hostname> <Schlüssel> <Wert>,
wobei „Hostname“ der Name des überwachten Hosts ist, wie er im Zabbix
Frontend registriert ist, „Schlüssel“ der Zieldatenpunktschlüssel und
„Wert“ der zu sendende Wert. Geben Sie als <Hostname> - an, um den
Hostnamen aus der Agent-Konfigurationsdatei oder aus dem Argument
--host zu verwenden.
Beispiel für eine Zeile einer Eingabedatei:
"Linux DB3" db.connections 43
Der Werttyp muss in der Datenpunktkonfiguration des Zabbix Frontend
korrekt festgelegt sein. Zabbix sender sendet bis zu 250 Werte über
eine Verbindung. Der Inhalt der Eingabedatei muss UTF-8-kodiert sein.
Alle Werte aus der Eingabedatei werden sequenziell von oben nach unten
gesendet. Die Einträge müssen nach folgenden Regeln formatiert sein:
• In Anführungszeichen gesetzte und nicht in Anführungszeichen
gesetzte Einträge werden unterstützt.
• Das doppelte Anführungszeichen ist das Anführungszeichen.
• Einträge mit Leerzeichen müssen in Anführungszeichen gesetzt werden.
• Doppelte Anführungszeichen und umgekehrte Schrägstriche innerhalb
eines in Anführungszeichen gesetzten Eintrags müssen mit einem
umgekehrten Schrägstrich maskiert werden.
• Maskierung wird in nicht in Anführungszeichen gesetzten Einträgen
nicht unterstützt.
• Zeilenumbruch-Escape-Sequenzen (\n) werden in Zeichenfolgen in
Anführungszeichen unterstützt.
• Zeilenumbruch-Escape-Sequenzen werden am Ende eines Eintrags
entfernt.
-T, --with-timestamps
Diese Option kann nur zusammen mit der Option --input-file verwendet
werden.
Jede Zeile der Eingabedatei muss vier durch Leerzeichen getrennte Einträge
enthalten: <Hostname> <Schlüssel> <Zeitstempel> <Wert>. Der Zeitstempel
muss im Unix-Zeitstempelformat angegeben werden. Wenn der Zieldatenpunkt
Auslöser enthält, die auf ihn verweisen, müssen alle Zeitstempel in
aufsteigender Reihenfolge angegeben werden, da andernfalls die
Ereignisberechnung nicht korrekt ist.
Beispiel für eine Zeile einer Eingabedatei:
"Linux DB3" db.connections 1429533600 43
Weitere Informationen finden Sie unter der Option --input-file.
Wenn ein Wert mit Zeitstempel für einen Host gesendet wird, der sich in
einer Wartungsperiode vom Typ „no data“ befindet, wird dieser Wert
verworfen. Es ist jedoch möglich, einen Wert mit Zeitstempel für eine
abgelaufene Wartungsperiode zu senden; dieser wird akzeptiert.
-N, --with-ns
Diese Option kann nur zusammen mit der Option --with-timestamps verwendet
werden.
Jede Zeile der Eingabedatei muss fünf durch Leerzeichen getrennte Einträge
enthalten: <Hostname> <Schlüssel> <Zeitstempel> <ns> <Wert>.
Beispiel für eine Zeile einer Eingabedatei:
"Linux DB3" db.connections 1429533600 7402561 43
Weitere Informationen finden Sie unter der Option --input-file.
-r, --real-time
Sendet Werte einzeln, sobald sie empfangen werden. Dies kann beim Lesen
aus der Standardeingabe verwendet werden.
--tls-connect Wert
Gibt an, wie die Verbindung zum Server oder Proxy hergestellt wird.
Werte:
unencrypted
Verbindung ohne Verschlüsselung (Standard)
psk Verbindung über TLS mit einem vorab gemeinsam
vereinbarten Schlüssel
cert Verbindung über TLS mit einem Zertifikat
--tls-ca-file CA-Datei
Vollständiger Pfadname einer Datei, die die Zertifikate der obersten
Zertifizierungsstellen für die Überprüfung des Peer-Zertifikats enthält.
--tls-crl-file CRL-Datei
Vollständiger Pfadname einer Datei, die widerrufene Zertifikate enthält.
--tls-server-cert-issuer Zertifikatsaussteller
Zulässiger Aussteller des Serverzertifikats.
--tls-server-cert-subject Zertifikatssubjekt
Zulässiges Subjekt des Serverzertifikats.
--tls-cert-file Zertifikatsdatei
Vollständiger Pfadname einer Datei, die das Zertifikat oder die
Zertifikatskette enthält.
--tls-key-file Schlüsseldatei
Vollständiger Pfadname einer Datei, die den privaten Schlüssel enthält.
--tls-psk-identity PSK-Identität
Zeichenfolge der PSK-Identität. Muss mit der für den Host im Zabbix
Frontend festgelegten PSK-Identität übereinstimmen.
--tls-psk-file PSK-Datei
Vollständiger Pfadname einer Datei, die den vorab gemeinsam vereinbarten
Schlüssel enthält. Der Schlüssel in dieser Datei muss mit dem für den
Host im Zabbix Frontend festgelegten PSK-Wert übereinstimmen.
--tls-cipher13 Chiffre-Zeichenfolge
Chiffre-Zeichenfolge für OpenSSL 1.1.1 oder höher für TLS 1.3.
Überschreibt die Kriterien für die standardmäßige Auswahl der
Chiffresuite. Diese Option ist nicht verfügbar, wenn die OpenSSL-Version
niedriger als 1.1.1 ist.
--tls-cipher Chiffre-Zeichenfolge
GnuTLS-Prioritätszeichenfolge (für TLS 1.2 und höher) oder
OpenSSL-Chiffre-Zeichenfolge (nur für TLS 1.2). Überschreibt die
Kriterien für die standardmäßige Auswahl der Chiffresuite.
-v, --verbose
Ausführlicher Modus, -vv für weitere Details.
-h, --help
Zeigt diese Hilfe an und beendet das Programm.
-V, --version
Gibt Versionsinformationen aus und beendet das Programm.
EXIT STATUS
Der Exit-Status ist 0, wenn die Werte gesendet und alle erfolgreich
vom Server verarbeitet wurden. Wenn Daten gesendet wurden, die Verarbeitung
mindestens eines Werts jedoch fehlgeschlagen ist, lautet der Exit-Status 2.
Wenn das Senden der Daten fehlgeschlagen ist, lautet der Exit-Status 1.
EXAMPLES
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k zabbix.trapper -o
342.45
Sendet 342.45 als Wert für den Datenpunkt zabbix.trapper des überwachten
Hosts. Verwendet den überwachten Host und den Zabbix Server, die in der
Agent-Konfigurationsdatei definiert sind.
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -s "Monitored Host" -k
zabbix.trapper -o 342.45
Sendet 342.45 als Wert für den Datenpunkt zabbix.trapper des Hosts
„Monitored Host“ unter Verwendung des in der Agent-Konfigurationsdatei
definierten Zabbix Servers.
zabbix_sender -z 192.168.1.113 -i data_values.txt
Sendet Werte aus der Datei data_values.txt an den Zabbix Server mit der
IP-Adresse 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 über die Befehlszeile an den in der
Agent-Konfigurationsdatei angegebenen Zabbix Server. Der Bindestrich in
den Eingabedaten gibt an, dass der Hostname ebenfalls aus derselben
Konfigurationsdatei verwendet werden soll.
echo '"Zabbix server" zabbix.trapper ""' | zabbix_sender -z 192.168.1.113
-p 10000 -i -
Sendet einen leeren Wert eines Datenpunkts über die Befehlszeile an den
Zabbix Server mit der IP-Adresse 192.168.1.113 am Port 10000. Leere
Werte müssen durch leere doppelte Anführungszeichen angegeben werden.
zabbix_sender -z 192.168.1.113 -s "Monitored Host" -k zabbix.trapper -o
342.45 --tls-connect cert --tls-ca-file /home/zabbix/zabbix_ca_file
--tls-cert-file /home/zabbix/zabbix_agentd.crt --tls-key-file
/home/zabbix/zabbix_agentd.key
Sendet 342.45 als Wert für den Datenpunkt zabbix.trapper des Hosts
„Monitored Host“ an den Server mit der IP-Adresse 192.168.1.113 unter
Verwendung von TLS mit einem Zertifikat.
zabbix_sender -z 192.168.1.113 -s "Monitored Host" -k zabbix.trapper -o
342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd"
--tls-psk-file /home/zabbix/zabbix_agentd.psk
Sendet 342.45 als Wert für den Datenpunkt zabbix.trapper des Hosts
„Monitored Host“ an den Server mit der IP-Adresse 192.168.1.113 unter
Verwendung von TLS mit einem vorab gemeinsam vereinbarten Schlüssel
(PSK).
SEE ALSO
Dokumentation
zabbix_agentd(8), zabbix_get(1), zabbix_proxy(8), zabbix_server(8),
zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8)
Zabbix 2022-01-06 ZABBIX_SENDER(1)