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-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] -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 Befehlszeilen-Dienstprogramm 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 config-file
Verwendet config-file. Zabbix sender liest die Serverdetails aus
der agentd-Konfigurationsdatei. 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 Verwendung
zusammen mit --config werden die Einträge des Parameters
ServerActive in der agentd-Konfigurationsdatei überschrieben.
-p, --port port
Gibt die Portnummer des auf dem Server ausgeführten Zabbix-Server-
Trappers an. Der Standardwert ist 10051. Bei Verwendung zusammen
mit --config werden die Porteinträge des Parameters ServerActive
in der agentd-Konfigurationsdatei überschrieben.
-I, --source-address IP-address
Gibt die Quell-IP-Adresse an. Bei Verwendung zusammen mit
--config wird der Parameter SourceIP in der
Agent-Konfigurationsdatei überschrieben.
-t, --timeout seconds
Gibt das Timeout an. Gültiger Bereich: 1-300 Sekunden
(Standardwert: 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 Verwendung zusammen mit --config
wird der in der Agent-Konfigurationsdatei angegebene Parameter
Hostname überschrieben.
-k, --key key
Gibt den Datenpunktschlüssel an, an den der Wert gesendet werden
soll.
-o, --value value
Gibt den Datenpunktwert an.
-i, --input-file input-file
Lädt Werte aus der Eingabedatei. Geben Sie als <input-file> - an,
um Werte aus 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 drei durch Leerzeichen getrennte Einträge enthalten:
<hostname> <key> <value>, wobei „hostname“ der Name des
überwachten Hosts ist, wie er im Zabbix-Frontend registriert ist,
„key“ der Zieldatenpunktschlüssel und „value“ 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-
Frontends 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 Einträge ohne Anführungszeichen
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 Einträgen ohne Anführungszeichen nicht
unterstützt.
• Escape-Sequenzen für Zeilenumbrüche (\n) werden in
Zeichenfolgen in Anführungszeichen unterstützt.
• Escape-Sequenzen für Zeilenumbrüche 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> <key> <timestamp> <value>. 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.
Andernfalls wird die Ereignisberechnung nicht korrekt ausgeführt.
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> <key> <timestamp> <ns> <value>.
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 value
Gibt an, wie eine Verbindung zum Server oder Proxy hergestellt
wird. Werte:
unencrypted
Verbindung ohne Verschlüsselung (Standardwert)
psk Verbindung über TLS mit einem vorab gemeinsam
vereinbarten Schlüssel
cert Verbindung über TLS mit einem Zertifikat
--tls-ca-file CA-file
Vollständiger Pfadname einer Datei, die die Zertifikate der
übergeordneten Zertifizierungsstelle(n) zur Überprüfung des
Peer-Zertifikats enthält.
--tls-crl-file CRL-file
Vollständiger Pfadname einer Datei, die widerrufene Zertifikate
enthält.
--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 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-Identitätszeichenfolge.
--tls-psk-file PSK-file
Vollständiger Pfadname einer Datei, die den vorab gemeinsam
vereinbarten Schlüssel enthält.
--tls-cipher13 cipher-string
Verschlüsselungszeichenfolge für OpenSSL 1.1.1 oder höher für
TLS 1.3. Überschreibt die Kriterien für die Auswahl der
standardmäßigen Verschlüsselungssuite. Diese Option ist nicht
verfügbar, wenn die OpenSSL-Version älter 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).
Überschreibt die Kriterien für die Auswahl der standardmäßigen
Verschlüsselungssuite.
-v, --verbose
Ausführlicher Modus; -vv liefert 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 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 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" trapper.item ""' | zabbix_sender -z 192.168.1.113
-p 10000 -i -
Sendet über die Befehlszeile einen leeren Wert eines Datenpunkts
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 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 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 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 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)