Получить

Обзор

Zabbix get — это утилита командной строки, которая может использоваться для взаимодействия с агентом Zabbix и получения необходимой информации от агента.

Обычно эта утилита используется для устранения неполадок в агентах Zabbix.

См. также библиотеку Python для Zabbix, в которой встроена функциональность, позволяющая работать как Zabbix get.

Запуск Zabbix get

Пример запуска Zabbix get в UNIX для получения значения загрузки процессора от агента:

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

Еще один пример запуска Zabbix get для извлечения строки с веб-сайта:

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

Обратите внимание, что ключ элемента данных здесь содержит пробел, поэтому для оболочки ключ элемента данных заключен в кавычки. Кавычки не являются частью ключа элемента данных; оболочка удалит их, и они не будут переданы агенту Zabbix.

Если ключ элемента данных не поддерживается, Zabbix get вернет код выхода 1.

Zabbix get принимает следующие параметры командной строки:

-s --host <host name or IP>             Указать имя узла сети или IP-адрес узла сети
-p --port <port number>                 Указать номер порта агента, запущенного на узле сети (по умолчанию: 10050)
-I --source-address <IP address>        Указать исходный IP-адрес
-t --timeout <seconds>                  Указать тайм-аут. Допустимый диапазон: 1-600 секунд (по умолчанию: 30 секунд)
-k --key <item key>                     Указать ключ элемента данных, значение которого нужно получить
-P --protocol <value>                   Протокол, используемый для связи с агентом. Значения:
                                            auto - подключение с использованием JSON-протокола, с переходом на текстовый протокол и повторной попыткой (по умолчанию)
                                            json - подключение с использованием JSON-протокола
                                            plaintext - подключение с использованием текстового протокола, при котором передается только ключ элемента данных (версии 6.4.x и более ранние)
-h --help                               Показать эту справку
-V --version                            Показать номер версии

--tls-connect <value>                   Способ подключения к агенту. Значения:
                                            unencrypted - подключение без шифрования (по умолчанию)
                                            psk - подключение с использованием TLS и предварительно общего ключа
                                            cert - подключение с использованием TLS и сертификата
--tls-ca-file <CA file>                 Полный путь к файлу, содержащему сертификаты корневого CA(ов) для проверки сертификата узла
--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-psk-identity <PSK-identity>       Уникальная строка с учетом регистра, используемая для идентификации предварительно общего ключа
--tls-psk-file <PSK-file>               Полный путь к файлу, содержащему предварительно общий ключ
--tls-cipher13 <cipher-string>          Строка шифров для OpenSSL 1.1.1 или новее для TLS 1.3. Переопределяет критерии выбора набора шифров по умолчанию. Этот параметр недоступен, если версия OpenSSL ниже 1.1.1
--tls-cipher <cipher-string>            Строка приоритетов GnuTLS (для TLS 1.2 и выше) или строка шифров OpenSSL (только для TLS 1.2). Переопределяет критерии выбора набора шифров по умолчанию

Дополнительные сведения см. в man-странице Zabbix get.

Zabbix get в Windows можно запускать аналогичным образом:

zabbix_get.exe [options]