zabbix_get - Zabbix get utility
NAME SYNOPSIS DESCRIPTION OPTIONS auto unencrypted EXIT STATUS EXAMPLES SEE ALSONAME
zabbix_get − Zabbix get utility
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−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
DESCRIPTION
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
SEE ALSO
zabbix_agentd(8), zabbix_proxy(8), zabbix_sender(1), zabbix_server(8), zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8)