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 Agent-Konfigurationsdatei. 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 der
Agent-Konfiguration im Parameter 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 werden die
Einträge des Parameters ServerActive in der Agent-Konfigurationsdatei
überschrieben.
-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 werden die Porteinträge des Parameters ServerActive in der
Agent-Konfigurationsdatei überschrieben.
-I, --source-address IP-Adresse
Gibt die Quell-IP-Adresse an. Bei gemeinsamer Verwendung mit --config wird
der Parameter SourceIP in der Agent-Konfigurationsdatei überschrieben.
-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 Host-IP-Adresse und der DNS-Name funktionieren nicht. Bei
gemeinsamer Verwendung mit --config wird der in der Agent-Konfigurationsdatei
angegebene Parameter Hostname überschrieben.
-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-codiert sein. Alle Werte aus der
Eingabedatei werden sequenziell von oben nach unten gesendet. Die Einträge
müssen nach folgenden Regeln formatiert sein:
• Anführungszeichen 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 bei 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 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 zeitgestempelter Wert für einen Host gesendet wird, der sich in
einer Wartung des Typs „no data“ befindet, wird dieser Wert verworfen. Es
ist jedoch möglich, einen zeitgestempelten Wert für eine abgelaufene
Wartungsperiode zu senden; dieser wird akzeptiert.
-N, --with-ns
Diese Option kann nur 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 eine Verbindung zum Server oder Proxy hergestellt wird. Werte:
unencrypted
Verbindung ohne Verschlüsselung (Standard)
psk Verbindung über TLS mit einem Pre-Shared Key
cert Verbindung über TLS mit einem Zertifikat
--tls-ca-file CA-Datei
Vollständiger Pfadname einer Datei, die die Zertifikate der übergeordneten
Zertifizierungsstelle(n) zur Ü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 Pre-Shared Key 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 Standardkriterien für die 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 Standardkriterien
für die 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“ und verwendet den in der Agent-Konfigurationsdatei
definierten Zabbix Server.
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 zeitgestempelten Wert ü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 und
verwendet 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 und
verwendet TLS mit einem Pre-Shared Key (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)