zabbix_get - Zabbix get utility
Contents
Description
zabbix_get is a command line utility for getting data from Zabbix agent.
Examples
zabbix_get-s127.0.0.1-p10050-k"system.cpu.load[all,avg1]"zabbix_get-s127.0.0.1-p10050-k"system.cpu.load[all,avg1]"--tls-connectcert--tls-ca-file/home/zabbix/zabbix_ca_file--tls-agent-cert-issuer"CN=SigningCA,OU=IToperations,O=ExampleCorp,DC=example,DC=com"--tls-agent-cert-subject"CN=server1,OU=IToperations,O=ExampleCorp,DC=example,DC=com"--tls-cert-file/home/zabbix/zabbix_get.crt--tls-key-file/home/zabbix/zabbix_get.keyzabbix_get-s127.0.0.1-p10050-k"system.cpu.load[all,avg1]"--tls-connectpsk--tls-psk-identity"PSKIDZabbixagentd"--tls-psk-file/home/zabbix/zabbix_agentd.psk
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.
Name
zabbix_get - Zabbix get utility
Options
-s, --hosthost-name-or-IP
Specify host name or IP address of a host.
-p, --portport-number
Specify port number of agent running on the host. Default is 10050.
-I, --source-addressIP-address
Specify source IP address.
-t, --timeoutseconds
Specify timeout. Valid range: 1-30 seconds (default: 30)
-k, --keyitem-key
Specify key of item to retrieve value for.
-P, --protocolvalue
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-connectvalue
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-fileCA-file
Full pathname of a file containing the top-level CA(s) certificates for peer certificate
verification.
--tls-crl-fileCRL-file
Full pathname of a file containing revoked certificates.
--tls-agent-cert-issuercert-issuer
Allowed agent certificate issuer.
--tls-agent-cert-subjectcert-subject
Allowed agent certificate subject.
--tls-cert-filecert-file
Full pathname of a file containing the certificate or certificate chain.
--tls-key-filekey-file
Full pathname of a file containing the private key.
--tls-psk-identityPSK-identity
PSK-identity string.
--tls-psk-filePSK-file
Full pathname of a file containing the pre-shared key.
--tls-cipher13cipher-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-ciphercipher-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.
See Also
Documentation
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)
Synopsis
zabbix_get-shost-name-or-IP [-pport-number] [-IIP-address] [-ttimeout] -kitem-keyzabbix_get-shost-name-or-IP [-pport-number] [-IIP-address] [-ttimeout] --tls-connectcert--tls-ca-fileCA-file [--tls-crl-fileCRL-file] [--tls-agent-cert-issuercert-issuer]
[--tls-agent-cert-subjectcert-subject] --tls-cert-filecert-file--tls-key-filekey-file [--tls-cipher13cipher-string] [--tls-ciphercipher-string] -kitem-keyzabbix_get-shost-name-or-IP [-pport-number] [-IIP-address] [-ttimeout] --tls-connectpsk--tls-psk-identityPSK-identity--tls-psk-filePSK-file [--tls-cipher13cipher-string] [--tls-ciphercipher-string] -kitem-keyzabbix_get-hzabbix_get-V