Table of Contents

7 获取

概述

Zabbix get 是一个命令行工具,可用于与 Zabbix agent 通信,并从 agent 中检索所需的信息。

该工具通常用于 Zabbix agents 的故障排除。

另请参阅 zabbix_utils — 一个 Python 库,具有内置功能,可以模拟 Zabbix get 的行为。

运行Zabbix get

一个在UNIX系统下运行Zabbix get来get处理器负载的示例 来自 agent 的值:

cd bin
       ./zabbix_get -s 127.0.0.1 -p 10050 -k system.cpu.load[all,avg1]

运行Zabbix get捕获string的另一个示例 网站

cd bin
       ./zabbix_get -s 192.168.1.1 -p 10050 -k "web.page.regexp[www.example.com,,,\"美国: ([a-zA-Z0-9.-]+)\",,\1]"

请注意,此处的 监控项 键包含空格,因此使用引号进行标记 将 监控项 密钥输入到 shell 中。引号不属于 监控项 密钥的一部分;它们 将被shell截断,不会传递给Zabbix agent。

如果 监控项 键不受支持,Zabbix get 将返回退出代码 1。

Zabbix get 接受以下命令行参数:

-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: 10050)
       -I --source-address <IP address>        Specify source IP address
       -t --timeout <seconds>                  Specify timeout. Valid range: 1-30 seconds (default: 30 seconds)
       -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)
       -h --help                               Display this help message
       -V --version                            Display version number
       
       --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>       Unique, case sensitive string used to identify the pre-shared key
       --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

另请参阅Zabbix get manpage获取更多信息 信息

Zabbix在Windows上的get功能可以run类似地实现:

zabbix_get.exe [选项]