On this page
zabbix_sender
ZABBIX_SENDER(1) Allgemeines Befehls-Handbuch ZABBIX_SENDER(1)
NAME
zabbix_sender - Zabbix-Sendeprogramm
SYNOPSIS
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] -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] -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] -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] -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] -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] -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-iden‐
tity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-ci‐
pher 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-iden‐
tity --tls-psk-file PSK-file [--tls-cipher13 cipher-string] [--tls-ci‐
pher cipher-string] [-T] [-N] [-r] -i input-file
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
für diesen Datenpunkt angegeben sind.
OPTIONS
-c, --config config-file
config-file verwenden. Zabbix sender liest Serverdetails aus der
agentd-Konfigurationsdatei. Standardmäßig liest Zabbix sender
keine Konfigurationsdatei. Unterstützt werden nur die Parameter Hostname, Server‐
Active, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile,
TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKey‐
File, TLSPSKIdentity und TLSPSKFile. Der über Hostname de‐
finierte Hostname über den Parameter HostnameItem wird nicht übernommen; in
diesem Fall sollte der Hostname über die Befehlszeile angegeben werden (siehe
Option -s). Alle in der agent ServerActive
Konfigurationsparameter definierten Adressen werden zum Senden von Daten verwendet.
Wenn das Senden von
Batch-Daten an eine Adresse fehlschlägt, werden die folgenden Batches
nicht an diese Adresse gesendet.
-z, --zabbix-server server
Hostname oder IP-Adresse des Zabbix Server. Wenn ein Host über einen Proxy überwacht
wird, sollte stattdessen der Hostname oder die IP-Adresse des Proxy verwendet werden.
Bei Verwendung zusammen mit --config werden die Einträge des
Parameters ServerActive überschrieben, die in der agentd-Konfigurationsdatei angegeben sind.
-p, --port port
Portnummer des Zabbix Server trapper angeben, der auf dem
Server läuft. Standard ist 10051. Bei Verwendung zusammen
mit --config werden die Port-Einträge des Parameters ServerActive überschrieben,
die in der agentd-Konfigurationsdatei angegeben sind.
-I, --source-address IP-address
Quell-IP-Adresse angeben. Bei Verwendung zusammen
mit --config wird der in der agentd-Konfigurationsdatei angegebene
Parameter SourceIP überschrieben.
-t, --timeout seconds
Timeout angeben. Gültiger Bereich: 1-300 Sekunden (Standard: 60)
-s, --host host
Hostnamen angeben, zu dem der Datenpunkt gehört (wie in Zabbix
Frontend registriert). Host-IP-Adresse und DNS-Name funktionieren nicht. Bei
Verwendung zusammen mit --config wird der in der agentd-Konfigurationsdatei angegebene
Parameter Hostname überschrieben.
-k, --key key
Schlüssel des Datenpunkts angeben, an den der Wert gesendet werden soll.
-o, --value value
Wert des Datenpunkts angeben.
-i, --input-file input-file
Werte aus einer Eingabedatei laden. Geben Sie - als <input-file> an, um
Werte von der Standardeingabe zu lesen. Jede Zeile der Datei enthält durch
Leerzeichen getrennt: <hostname> <key> <value>. Jeder Wert
muss in einer eigenen Zeile angegeben werden. Jede Zeile muss 3 durch Leerzeichen
getrennte Einträge enthalten: <hostname> <key> <value>, wobei "hostname" der
Name des überwachten Hosts ist, wie in Zabbix Frontend
registriert, "key" der Zielschlüssel des Datenpunkts und "value" der zu sendende
Wert ist. Geben Sie - als <hostname> an, um den Hostnamen aus der
agent-Konfigurationsdatei oder aus dem Argument --host zu verwenden.
Ein Beispiel für eine Zeile einer Eingabedatei:
"Linux DB3" db.connections 43
Der Werttyp muss in der Konfiguration des Datenpunkts in
Zabbix Frontend korrekt gesetzt sein. Zabbix sender sendet bis zu
250 Werte in einer Verbindung. Der Inhalt der Eingabedatei muss in UTF-8
kodiert sein. Alle Werte aus der Eingabedatei werden in
sequenzieller Reihenfolge von oben nach unten gesendet. Einträge müssen nach
den folgenden Regeln formatiert werden:
• Anführungszeichen und nicht in Anführungszeichen gesetzte Einträge werden unterstützt.
• Das doppelte Anführungszeichen ist das Anführungszeichen-Zeichen.
• Einträge mit Leerzeichen 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.
• Maskierung wird in nicht in Anführungszeichen gesetzten Einträgen nicht unterstützt.
• Zeilenumbruch-Escape-Sequenzen (\n) werden in in Anführungszeichen
gesetzten Zeichenfolgen 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 4 durch Leerzeichen getrennte
Einträge enthalten: <hostname> <key> <timestamp> <value>. Der Zeitstempel sollte
im Unix-Zeitstempelformat angegeben werden. Wenn der Ziel-Datenpunkt
Auslöser hat, die darauf verweisen, müssen alle Zeitstempel in aufsteigender
Reihenfolge vorliegen, andernfalls ist die Ereignisberechnung nicht korrekt.
Ein Beispiel für eine Zeile der 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 Wartung vom Typ
"no data" befindet, wird dieser Wert verworfen; es ist jedoch möglich,
einen Wert mit Zeitstempel für einen abgelaufenen Wartungszeitraum zu senden, und er wird akzeptiert.
-N, --with-ns
Diese Option kann nur zusammen mit der Option --with-timestamps verwendet werden.
Jede Zeile der Eingabedatei muss 5 durch Leerzeichen getrennte
Einträge enthalten: <hostname> <key> <timestamp> <ns> <value>.
Ein Beispiel für eine Zeile der Eingabedatei:
"Linux DB3" db.connections 1429533600 7402561 43
Weitere Informationen finden Sie unter der Option --input-file.
-r, --real-time
Werte einzeln senden, sobald sie empfangen werden. Dies kann
verwendet werden, wenn von der Standardeingabe gelesen wird.
--tls-connect value
Wie eine Verbindung zu Server oder Proxy hergestellt wird. Werte:
unencrypted
Verbindung ohne Verschlüsselung herstellen (Standard)
psk Verbindung mit TLS und einem vorab gemeinsam genutzten Schlüssel herstellen
cert Verbindung mit TLS und einem Zertifikat herstellen
--tls-ca-file CA-file
Vollständiger Pfad zu einer Datei mit den Zertifikaten der obersten CA(s)
zur Überprüfung des Peer-Zertifikats.
--tls-crl-file CRL-file
Vollständiger Pfad zu einer Datei mit widerrufenen Zertifikaten.
--tls-server-cert-issuer cert-issuer
Zulässiger Aussteller des Serverzertifikats.
--tls-server-cert-subject cert-subject
Zulässiger Betreff des Serverzertifikats.
--tls-cert-file cert-file
Vollständiger Pfad zu einer Datei mit dem Zertifikat oder dem
Zertifikats-Chain.
--tls-key-file key-file
Vollständiger Pfad zu einer Datei mit dem privaten Schlüssel.
--tls-psk-identity PSK-identity
PSK-Identitätszeichenfolge.
--tls-psk-file PSK-file
Vollständiger Pfad zu einer Datei mit dem vorab gemeinsam genutzten Schlüssel.
--tls-cipher13 cipher-string
Cipher-String für OpenSSL 1.1.1 oder neuer für TLS 1.3. Überschreibt
die standardmäßigen Auswahlkriterien für Cipher Suites. 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-Cipher-
String (nur für TLS 1.2). Überschreibt die standardmäßigen Auswahlkriterien
für Cipher Suites.
-v, --verbose
Ausführlicher Modus, -vv für mehr Details.
-h, --help
Diese Hilfe anzeigen und beenden.
-V, --version
Versionsinformationen ausgeben und beenden.
EXIT STATUS
Der Exit-Status ist 0, wenn die Werte gesendet wurden und alle vom Server erfolgreich verarbeitet
wurden. Wenn Daten gesendet wurden, aber die Verarbeitung von mindestens
einem der Werte fehlgeschlagen ist, ist der Exit-Status 2. Wenn das Senden
der Daten fehlgeschlagen ist, ist der Exit-Status 1.
EXAMPLES
zabbix_sender -c /etc/zabbix/zabbix_agentd.conf -k mysql.queries -o
342.45
Sendet 342.45 als Wert für den Datenpunkt mysql.queries 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
mysql.queries -o 342.45
Sendet 342.45 als Wert für den Datenpunkt mysql.queries des Hosts Monitored
Host unter Verwendung des Zabbix Server, der in der
agent-Konfigurationsdatei definiert ist.
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
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 Befehlszeile an den Zabbix Server,
der in der agent-Konfigurationsdatei angegeben ist. Der Bindestrich in den Eingabedaten
zeigt an, dass der Hostname ebenfalls aus derselben
Konfigurationsdatei verwendet werden soll.
echo '"Zabbix server" trapper.item ""' | zabbix_sender -z 192.168.1.113
-p 10000 -i -
Sendet einen leeren Wert eines Datenpunkts an den Zabbix Server mit der IP-Adresse
192.168.1.113 auf Port 10000 von der Befehlszeile aus. Leere
Werte müssen durch leere doppelte Anführungszeichen angegeben werden.
zabbix_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -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 mysql.queries im Host 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 "Monitored Host" -k mysql.queries -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 mysql.queries im Host Monitored
Host an den Server mit der IP 192.168.1.113 unter Verwendung von TLS mit vorab
gemeinsam genutztem Schlüssel (PSK).
SEE ALSO
Documentation
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)