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)