zabbix_sender

ZABBIX_SENDER(1)            Allgemeines Befehlshandbuch           ZABBIX_SENDER(1)

NAME
       zabbix_sender - Zabbix-Sendeprogramm

ÜBERSICHT
       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

BESCHREIBUNG
       zabbix_sender ist ein Befehlszeilenprogramm zum Senden von Monitoring-
       Daten 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.

OPTIONEN
       -c, --config config-file
              Verwenden Sie config-file. Zabbix sender liest Server-Details aus
              der agentd-Konfigurationsdatei. Standardmäßig liest Zabbix
              sender keine Konfigurationsdatei. Nur die Parameter Hostname,
              ServerActive, SourceIP, TLSConnect, TLSCAFile, TLSCRLFile,
              TLSServerCertIssuer, TLSServerCertSubject, TLSCertFile, TLSKey‐
              File, TLSPSKIdentity und TLSPSKFile werden unterstützt. Ein über
              den Parameter HostnameItem definierter Hostname wird nicht
              übernommen; in diesem Fall sollte der Hostname über die
              Befehlszeile angegeben werden (siehe Option -s). Alle im
              Konfigurationsparameter ServerActive des Agent 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 durch
              einen Proxy überwacht wird, sollte stattdessen der Proxy-
              Hostname oder die Proxy-IP-Adresse verwendet werden. Bei
              gemeinsamer Verwendung mit --config werden die Einträge des
              Parameters ServerActive aus der agentd-Konfigurationsdatei
              überschrieben.

       -p, --port port
              Geben Sie die Portnummer des auf dem Server laufenden Zabbix
              server trapper an. Standard ist 10051. Bei gemeinsamer
              Verwendung mit --config werden die Porteinträge des Parameters
              ServerActive aus der agentd-Konfigurationsdatei überschrieben.

       -I, --source-address IP-address
              Geben Sie die Quell-IP-Adresse an. Bei gemeinsamer Verwendung
              mit --config wird der in der agentd-Konfigurationsdatei
              angegebene Parameter SourceIP überschrieben.

       -t, --timeout seconds
              Geben Sie das Timeout an. Gültiger Bereich: 1-300 Sekunden
              (Standard: 60)

       -s, --host host
              Geben Sie 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 agentd-Konfigurationsdatei angegebene
              Parameter Hostname überschrieben.

       -k, --key key
              Geben Sie den Schlüssel des Datenpunkts an, an den der Wert
              gesendet werden soll.

       -o, --value value
              Geben Sie den Wert des Datenpunkts an.

       -i, --input-file input-file
              Laden Sie Werte aus einer Eingabedatei. Geben Sie - als
              <input-file> an, um Werte von der Standardeingabe zu lesen. Jede
              Zeile der Datei enthält durch Leerraum getrennt:
              <hostname> <key> <value>. Jeder Wert muss in einer eigenen Zeile
              angegeben werden. Jede Zeile muss 3 durch Leerraum getrennte
              Einträge enthalten: <hostname> <key> <value>, wobei "hostname"
              der Name des überwachten Hosts ist, wie er im Zabbix Frontend
              registriert ist, "key" der Schlüssel des Ziel-Datenpunkts 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.

              Ein Beispiel für eine Zeile in einer Eingabedatei:

               "Linux DB3" db.connections 43

              Der Werttyp muss in der Datenpunkt-Konfiguration des 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
              sequentieller Reihenfolge von oben nach unten gesendet. Die
              Einträge müssen nach den folgenden Regeln formatiert sein:

                     • Einträge mit und ohne Anführungszeichen werden
                       unterstützt.

                     • Das doppelte Anführungszeichen ist das
                       Maskierungszeichen.

                     • Einträge mit Leerraum 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.

                     • In nicht in Anführungszeichen gesetzten Einträgen wird
                       keine Maskierung unterstützt.

                     • Escape-Sequenzen für Zeilenumbrüche (\n) werden in
                       Zeichenketten in Anführungszeichen unterstützt.

                     • Escape-Sequenzen für Zeilenumbrüche werden am Ende
                       eines Eintrags abgeschnitten.

       -T, --with-timestamps
              Diese Option kann nur zusammen mit der Option --input-file
              verwendet werden.

              Jede Zeile der Eingabedatei muss 4 durch Leerraum getrennte
              Einträge enthalten: <hostname> <key> <timestamp> <value>. Der
              Zeitstempel sollte im Unix-Zeitstempelformat angegeben werden.
              Wenn der Ziel-Datenpunkt Auslöser hat, die auf ihn verweisen,
              müssen alle Zeitstempel in aufsteigender Reihenfolge angegeben
              werden, andernfalls ist die Ereignisberechnung nicht korrekt.

              Ein Beispiel für eine Zeile in der Eingabedatei:

               "Linux DB3" db.connections 1429533600 43

              Weitere Details finden Sie bei der Option --input-file.

              Wenn ein Wert mit Zeitstempel für einen Host gesendet wird, der
              sich in einer Wartung vom Typ „keine Daten“ befindet, wird
              dieser Wert verworfen; es ist jedoch möglich, einen Wert mit
              Zeitstempel für einen abgelaufenen Wartungszeitraum zu senden,
              und dieser wird akzeptiert.

       -N, --with-ns
              Diese Option kann nur zusammen mit der Option --with-timestamps
              verwendet werden.

              Jede Zeile der Eingabedatei muss 5 durch Leerraum getrennte
              Einträge enthalten: <hostname> <key> <timestamp> <ns> <value>.

              Ein Beispiel für eine Zeile in der Eingabedatei:

               "Linux DB3" db.connections 1429533600 7402561 43

              Weitere Details finden Sie bei der Option --input-file.

       -r, --real-time
              Senden Sie Werte einzeln, sobald sie empfangen werden. Dies kann
              beim Lesen von der Standardeingabe verwendet werden.

       --tls-connect value
              Wie die Verbindung zum Server oder Proxy hergestellt wird. Werte:

                   unencrypted
                               Verbindung ohne Verschlüsselung herstellen
                               (Standard)

                   psk         Verbindung mit TLS und einem Pre-Shared Key
                               herstellen

                   cert        Verbindung mit TLS und einem Zertifikat
                               herstellen

       --tls-ca-file CA-file
              Vollständiger Pfadname einer Datei, die die Zertifikate der
              obersten CA(s) zur Verifizierung des Zertifikats der Gegenstelle
              enthält.

       --tls-crl-file CRL-file
              Vollständiger Pfadname einer Datei, die gesperrte Zertifikate
              enthält.

       --tls-server-cert-issuer cert-issuer
              Zulässiger Aussteller des Server-Zertifikats.

       --tls-server-cert-subject cert-subject
              Zulässiger Betreff des Server-Zertifikats.

       --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ätszeichenkette.

       --tls-psk-file PSK-file
              Vollständiger Pfadname einer Datei, die den Pre-Shared Key
              enthält.

       --tls-cipher13 cipher-string
              Chiffre-Zeichenkette für OpenSSL 1.1.1 oder neuer für TLS 1.3.
              Überschreibt die Standardkriterien für die Auswahl der
              Cipher-Suite. Diese Option ist nicht verfügbar, wenn die
              OpenSSL-Version kleiner als 1.1.1 ist.

       --tls-cipher cipher-string
              GnuTLS-Prioritätszeichenkette (für TLS 1.2 und höher) oder
              OpenSSL-Chiffre-Zeichenkette (nur für TLS 1.2). Überschreibt die
              Standardkriterien für die Auswahl der Cipher-Suite.

       -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 fehlschlug, ist der
       Exit-Status 2. Wenn das Senden der Daten fehlschlug, ist der
       Exit-Status 1.

BEISPIELE
       zabbix_sender -c  /etc/zabbix/zabbix_agentd.conf  -k  mysql.queries  -o
       342.45
              Senden Sie 342.45 als Wert für den Datenpunkt mysql.queries des
              überwachten Hosts. Verwenden Sie 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
              Senden Sie 342.45 als Wert für den Datenpunkt mysql.queries des
              Hosts Monitored Host unter Verwendung des in der Agent-
              Konfigurationsdatei definierten Zabbix Server.

       zabbix_sender -z 192.168.1.113 -i data_values.txt
              Senden Sie 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 -
              Senden Sie 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 -
              Senden Sie einen leeren Wert eines Datenpunkts von der
              Befehlszeile an den Zabbix Server mit der IP-Adresse
              192.168.1.113 auf 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
              Senden Sie 342.45 als Wert für den Datenpunkt mysql.queries des
              Hosts 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
              Senden Sie 342.45 als Wert für den Datenpunkt mysql.queries des
              Hosts Monitored Host an den Server mit der IP 192.168.1.113
              unter Verwendung von TLS mit Pre-Shared Key (PSK).

SIEHE AUCH
       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)