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-30 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_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)