7. Get

Обзор

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, при неудаче переключиться и повторить попытку с протоколом plaintext (по умолчанию)
                                            json - подключиться с использованием протокола JSON
                                            plaintext - подключиться с использованием протокола 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]