zabbix_get
Retrieve data from Zabbix agents
TLDR
SYNOPSIS
zabbix_get -s host -k key [options]
DESCRIPTION
zabbix_get retrieves data from Zabbix agents for testing and troubleshooting. It performs passive checks, querying agents for specific item values using the same protocol as Zabbix server.The tool helps verify agent configuration and connectivity before adding hosts to monitoring. The requesting host must be listed in the agent's Server configuration parameter.Common use cases include testing new item keys, verifying agent responses, and debugging collection issues without accessing the Zabbix frontend.
PARAMETERS
-s, --host host
Host name or IP address of Zabbix agent.-p, --port port
Port number (default: 10050).-k, --key key
Item key to retrieve.-I, --source-address ip
Source IP address for connection.-t, --timeout seconds
Timeout (1-600, default: 30).--tls-connect mode
Connection type: unencrypted, psk, or cert.--tls-psk-identity id
PSK identity string.--tls-psk-file file
File containing pre-shared key.-P, --protocol value
Communication protocol: auto (default, JSON with plaintext fallback), json, or plaintext (for agents 6.4.x and older).--tls-ca-file file
Full path to file containing top-level CA certificates for peer certificate verification.--tls-cert-file file
Full path to file containing the client certificate.--tls-key-file file
Full path to file containing the private key.-h, --help
Display help information.-V, --version
Display version.
EXIT STATUS
Returns 0 on success, 1 on error or if value retrieval failed.
CAVEATS
Requesting host must be in agent's Server parameter. Only works with Zabbix agents, not other monitoring protocols. TLS requires matching configuration on both ends.
HISTORY
zabbix_get is part of the Zabbix monitoring system, created by Alexei Vladishev in 2001. Zabbix has grown into one of the most popular enterprise monitoring solutions, with zabbix_get remaining essential for agent troubleshooting.
SEE ALSO
zabbix_agentd(8), zabbix_server(8), zabbix_proxy(8)
