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)