---
name: "zabbix_get"
section: "1"
platform: "linux"
package: "zabbix-server"
version: "7.4.16-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/zabbix_get"
---

# zabbix\_get(1)

Zabbix get utility

## NAME

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

Documentation

[**zabbix\_agentd**(8)](/zabbix_agentd/8.md), [**zabbix\_proxy**(8)](/zabbix_proxy/8.md), [**zabbix\_sender**(1)](/zabbix_sender/1.md), [**zabbix\_server**(8)](/zabbix_server/8.md), **zabbix\_js**(1), [**zabbix\_agent2**(8)](/zabbix_agent2/8.md), [**zabbix\_web\_service**(8)](/zabbix_web_service/8.md)