zabbix_get1
Zabbix get utility
Usage
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-subject
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
Overview
zabbix_get is a command line utility for getting data from Zabbix agent.
Options
-
-s, --host host-name-or-IP -
Specify host name or IP address of a host.
-
-p, --port port-number -
Specify port number of agent running on the host. Default is 10050.
-
-I, --source-address IP-address -
Specify source IP address.
-
-t, --timeout seconds -
Specify timeout. Valid range: 1-600 seconds (default: 30)
-
-k, --key item-key -
Specify key of item to retrieve value for.
-
-P, --protocol value -
Protocol used to communicate with agent. Values:
auto-
connect using JSON protocol, fallback and retry with plaintext protocol (default)
json-
connect using JSON protocol
plaintext-
connect using plaintext protocol where just item key is sent (6.4.x and older releases)
-
--tls-connect value -
How to connect to agent. Values:
unencrypted-
connect without encryption (default)
psk-
connect using TLS and a pre-shared key
cert-
connect using TLS and a certificate
-
--tls-ca-file CA-file -
Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification.
-
--tls-crl-file CRL-file -
Full pathname of a file containing revoked certificates.
-
--tls-agent-cert-issuer cert-issuer -
Allowed agent certificate issuer.
-
--tls-agent-cert-subject cert-subject -
Allowed agent certificate subject.
-
--tls-cert-file cert-file -
Full pathname of a file containing the certificate or certificate chain.
-
--tls-key-file key-file -
Full pathname of a file containing the private key.
-
--tls-psk-identity PSK-identity -
PSK-identity string.
-
--tls-psk-file PSK-file -
Full pathname of a file containing the pre-shared key.
-
--tls-cipher13 cipher-string -
Cipher string for OpenSSL 1.1.1 or newer for TLS 1.3. Override the default ciphersuite selection criteria. This option is not available if OpenSSL version is less than 1.1.1.
-
--tls-cipher cipher-string -
GnuTLS priority string (for TLS 1.2 and up) or OpenSSL cipher string (only for TLS 1.2). Override the default ciphersuite selection criteria.
-
-h, --help -
Display this help and exit.
-
-V, --version -
Output version information and exit.
Exit status
The exit status is 0 if zabbix_get successfully retrieves a value from the Zabbix agent. If value retrieval failed, the exit status is 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 operations,O=Example Corp,DC=example,DC=com" --tls-cert-file /home/zabbix/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
Releases
7 releases since Debian 8 (Jessie); the text changed 5 times.
--host since Debian 9 (Stretch);
--key since Debian 9 (Stretch);
--port since Debian 9 (Stretch);
--protocol since Debian 13 (Trixie);
--source-address since Debian 9 (Stretch);
--timeout since Debian 12 (Bookworm);
--tls-agent-cert-issuer since Debian 9 (Stretch);
--tls-agent-cert-subject since Debian 9 (Stretch);
--tls-ca-file since Debian 9 (Stretch);
--tls-cert-file since Debian 9 (Stretch);
--tls-cipher since Debian 11 (Bullseye);
--tls-cipher13 since Debian 11 (Bullseye);
--tls-connect since Debian 9 (Stretch);
--tls-crl-file since Debian 9 (Stretch);
--tls-key-file since Debian 9 (Stretch);
--tls-psk-file since Debian 9 (Stretch);
--tls-psk-identity since Debian 9 (Stretch);
-I since Debian 9 (Stretch);
-P since Debian 13 (Trixie);
-k since Debian 9 (Stretch);
-p since Debian 9 (Stretch);
-s since Debian 9 (Stretch);
-t since Debian 12 (Bookworm).