1ZABBIX_GET(1)               General Commands Manual              ZABBIX_GET(1)
2
3
4

NAME

6       zabbix_get - Zabbix get utility
7

SYNOPSIS

9       zabbix_get  -s  host-name-or-IP  [-p  port-number]  [-I IP-address] [-t
10       timeout] -k item-key
11       zabbix_get -s host-name-or-IP  [-p  port-number]  [-I  IP-address]  [-t
12       timeout]   --tls-connect  cert  --tls-ca-file  CA-file  [--tls-crl-file
13       CRL-file] [--tls-agent-cert-issuer cert-issuer]  [--tls-agent-cert-sub‐
14       ject  cert-subject]  --tls-cert-file  cert-file --tls-key-file key-file
15       [--tls-cipher13 cipher-string] [--tls-cipher cipher-string] -k item-key
16       zabbix_get -s host-name-or-IP  [-p  port-number]  [-I  IP-address]  [-t
17       timeout]     --tls-connect    psk    --tls-psk-identity    PSK-identity
18       --tls-psk-file PSK-file  [--tls-cipher13  cipher-string]  [--tls-cipher
19       cipher-string] -k item-key
20       zabbix_get -h
21       zabbix_get -V
22

DESCRIPTION

24       zabbix_get  is  a  command  line  utility  for getting data from Zabbix
25       agent.
26

OPTIONS

28       -s, --host host-name-or-IP
29              Specify host name or IP address of a host.
30
31       -p, --port port-number
32              Specify port number of agent running on the  host.   Default  is
33              10050.
34
35       -I, --source-address IP-address
36              Specify source IP address.
37
38       -t, --timeout seconds
39              Specify timeout. Valid range: 1-30 seconds (default: 30)
40
41       -k, --key item-key
42              Specify key of item to retrieve value for.
43
44       --tls-connect value
45              How to connect to agent. Values:
46
47
48                   unencrypted connect without encryption (default)
49
50                   psk         connect using TLS and a pre-shared key
51
52                   cert        connect using TLS and a certificate
53
54       --tls-ca-file CA-file
55              Full  pathname of a file containing the top-level CA(s) certifi‐
56              cates for peer certificate verification.
57
58       --tls-crl-file CRL-file
59              Full pathname of a file containing revoked certificates.
60
61       --tls-agent-cert-issuer cert-issuer
62              Allowed agent certificate issuer.
63
64       --tls-agent-cert-subject cert-subject
65              Allowed agent certificate subject.
66
67       --tls-cert-file cert-file
68              Full pathname of a file containing the certificate  or  certifi‐
69              cate chain.
70
71       --tls-key-file key-file
72              Full pathname of a file containing the private key.
73
74       --tls-psk-identity PSK-identity
75              PSK-identity string.
76
77       --tls-psk-file PSK-file
78              Full pathname of a file containing the pre-shared key.
79
80       --tls-cipher13 cipher-string
81              Cipher  string  for OpenSSL 1.1.1 or newer for TLS 1.3. Override
82              the default ciphersuite selection criteria. This option  is  not
83              available if OpenSSL version is less than 1.1.1.
84
85       --tls-cipher cipher-string
86              GnuTLS  priority  string  (for TLS 1.2 and up) or OpenSSL cipher
87              string (only for TLS 1.2). Override the default ciphersuite  se‐
88              lection criteria.
89
90       -h, --help
91              Display this help and exit.
92
93       -V, --version
94              Output version information and exit.
95

EXAMPLES

97       zabbix_get -s 127.0.0.1 -p 10050 -k "system.cpu.load[all,avg1]"
98       zabbix_get   -s   127.0.0.1  -p  10050  -k  "system.cpu.load[all,avg1]"
99       --tls-connect    cert     --tls-ca-file     /home/zabbix/zabbix_ca_file
100       --tls-agent-cert-issuer   "CN=Signing   CA,OU=IT   operations,O=Example
101       Corp,DC=example,DC=com" --tls-agent-cert-subject "CN=server1,OU=IT  op‐
102       erations,O=Example  Corp,DC=example,DC=com"  --tls-cert-file /home/zab‐
103       bix/zabbix_get.crt --tls-key-file /home/zabbix/zabbix_get.key
104       zabbix_get  -s  127.0.0.1  -p  10050   -k   "system.cpu.load[all,avg1]"
105       --tls-connect   psk   --tls-psk-identity   "PSK   ID   Zabbix   agentd"
106       --tls-psk-file /home/zabbix/zabbix_agentd.psk
107

SEE ALSO

109       Documentation ⟨https://www.zabbix.com/manuals
110
111       zabbix_agentd(8), zabbix_proxy(8), zabbix_sender(1),  zabbix_server(8),
112       zabbix_js(1), zabbix_agent2(8), zabbix_web_service(8)
113
114
115
116Zabbix                            2022-01-06                     ZABBIX_GET(1)
Impressum