On this page

zabbix_get

ZABBIX_GET(1)               Allgemeines Befehls-Handbuch              ZABBIX_GET(1)

NAME
       zabbix_get - Zabbix-Dienstprogramm zum Abrufen von Daten

SYNOPSIS
       zabbix_get  -s  host-name-or-IP  [-p  port-number]  [-I IP-address] [-t
       timeout] -k item-key
       zabbix_get -s host-name-or-IP  [-p  port-number]  [-I  IP-address]  [-t
       timeout]   --tls-connect  cert  --tls-ca-file  CA-file  [--tls-crl-file
       CRL-file] [--tls-agent-cert-issuer cert-issuer]  [--tls-agent-cert-sub‐
       ject  cert-subject]  --tls-cert-file  cert-file --tls-key-file key-file
       [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k item-key
       zabbix_get -s host-name-or-IP  [-p  port-number]  [-I  IP-address]  [-t
       timeout]     --tls-connect    psk    --tls-psk-identity    PSK-identity
       --tls-psk-file PSK-file  [--tls-cipher13  cipher-string]  [--tls-cipher
       cipher-string] -k item-key
       zabbix_get -h
       zabbix_get -V

DESCRIPTION
       zabbix_get  ist  ein  Befehlszeilen-Dienstprogramm zum Abrufen von Daten
       vom Zabbix-Agent.

OPTIONS
       -s, --host host-name-or-IP
              Gibt den Hostnamen oder die IP-Adresse eines Hosts an.

       -p, --port port-number
              Gibt die Portnummer des auf dem Host laufenden Agent an. Standard
              ist 10050.

       -I, --source-address IP-address
              Gibt die Quell-IP-Adresse an.

       -t, --timeout seconds
              Gibt das Zeitlimit an. Gültiger Bereich: 1-600 Sekunden (Standard:
              30)

       -k, --key item-key
              Gibt den Schlüssel des Datenpunkts an, für den der Wert abgerufen
              werden soll.

       -P, --protocol value
              Protokoll für die Kommunikation mit dem Agent. Werte:

                   auto        Verbindung über JSON-Protokoll, bei Fehler Fallback
                               und erneuter Versuch mit Klartextprotokoll (Standard)

                   json        Verbindung über JSON-Protokoll

                   plaintext   Verbindung über Klartextprotokoll, bei dem nur der
                               Datenpunktschlüssel gesendet wird (Version 6.4.x
                               und älter)

       --tls-connect value
              Art der Verbindung zum Agent. Werte:

                   unencrypted
                               Verbindung ohne Verschlüsselung (Standard)

                   psk         Verbindung über TLS und einen vorab gemeinsam
                               genutzten Schlüssel

                   cert        Verbindung über TLS und ein Zertifikat

       --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-agent-cert-issuer cert-issuer
              Zulässiger Aussteller des Agent-Zertifikats.

       --tls-agent-cert-subject cert-subject
              Zulässiger Betreff des Agent-Zertifikats.

       --tls-cert-file cert-file
              Vollständiger Pfad zu einer Datei mit dem Zertifikat oder der
              Zertifikatskette.

       --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 Kriterien 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ätszeichenfolge (für TLS 1.2 und höher) oder OpenSSL-
              Cipher-String (nur für TLS 1.2). Überschreibt die standardmäßigen
              Kriterien für die Auswahl der Cipher Suite.

       -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 zabbix_get erfolgreich einen Wert vom Zabbix-
       Agent abruft. Wenn das Abrufen des Werts fehlgeschlagen ist, ist der Exit-
       Status 1.

EXAMPLES
       zabbix_get -s 127.0.0.1 -p 10050 -k "system.cpu.load[all,avg1]"
       zabbix_get   -s   127.0.0.1  -p  10050  -k  "system.cpu.load[all,avg1]"
       --tls-connect    cert     --tls-ca-file     /home/zabbix/zabbix_ca_file
       --tls-agent-cert-issuer   "CN=Signing   CA,OU=IT   operations,O=Example
       Corp,DC=example,DC=com" --tls-agent-cert-subject "CN=server1,OU=IT  op‐
       erations,O=Example  Corp,DC=example,DC=com"  --tls-cert-file /home/zab‐
       bix/zabbix_get.crt --tls-key-file /home/zabbix/zabbix_get.key
       zabbix_get  -s  127.0.0.1  -p  10050   -k   "system.cpu.load[all,avg1]"
       --tls-connect   psk   --tls-psk-identity   "PSK   ID   Zabbix   agentd"
       --tls-psk-file /home/zabbix/zabbix_agentd.psk

SEE ALSO
       Dokumentation

       zabbix_agentd(8), zabbix_proxy(8), zabbix_sender(1),  zabbix_server(8),
       zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8)

Zabbix                            2022-01-06                     ZABBIX_GET(1)