Documentation
Table of Contents
7. Get
Обзор
Zabbix get — это утилита командной строки, которая может использоваться для подключения к Zabbix агенту и получения от него запрашиваемой информации.
Утилита обычно используется для диагностики Zabbix агентов.
Смотрите также библиотеку Python для Zabbix, которая имеет встроенный функционал для действий, аналогичных утилите Zabbix get.
Выполнение Zabbix get
Пример выполнения Zabbix get в UNIX для получения значения загрузки процессора с агента:
Ещё один пример выполнения утилиты 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 <имя хоста или IP> Укажите имя хоста или IP адрес хоста.
-p --port <номер порта> Укажите номер порта агента, запущенного на хосте (по умолчанию: 10050).
-I --source-address <IP адрес> Укажите IP адрес для исходящего подключения.
-t --timeout <секунды> Укажите время ожидания. Допустимый диапазон: 1-600 секунд (по умолчанию: 30 секунд).
-k -key <ключ элемента данных> Укажите ключ элемента данных, значение которого необходимо получить.
-P --protocol <значение> Протокол, используемый для коммуникации с агентом. Значения:
auto — подключаться с использованием протокола JSON, при неудаче повторить попытку, откатившись на протокол с простым текстом (по умолчанию);
json — подключаться с использованием протокола JSON;
plaintext — подключаться с использованием протокола с простым текстом, где отсылается только ключ элемента данных (релизы 6.4.x и более старые)
-h --help Вывод этого сообщения помощи.
-V --version Вывод номера версии.
--tls-connect <значение> Как подключаться к агенту. Значения:
unencrypted — подключаться без шифрования (по умолчанию);
psk — подключаться с использованием TLS и общего ключа (pre-shared key, PSK);
cert — подключаться с использованием TLS и сертификата;
--tls-ca-file <CA-файл> Полный путь к файлу, содержащему сертификаты CA верхнего уровня для проверки сертификата партнёра.
--tls-crl-file <CRL-файл> Полный путь к файлу, содержащему отозванные сертификаты.
--tls-agent-cert-issuer <эмитент> Разрешённый эмитент сертификата агента.
--tls-agent-cert-subject <субъект> Разрешённый субъект сертификата агента.
--tls-cert-file <cert-файл> Полный путь к файлу, содержащему сертификат или цепочку сертификатов.
--tls-key-file <key-файл> Полный путь к файлу, содержащему закрытый ключ (private key).
--tls-psk-identity <идентификатор-PSK> Уникальная (с учётом регистра букв) строка, используемая для идентификации PSK.
--tls-psk-file <PSK-файл> Полный путь к файлу, содержащему общий ключ (pre-shared key).
--tls-cipher13 <строка-шифра> Строка шифра для OpenSSL 1.1.1 или новее для TLS 1.3. Переопределить критерии выбора набора шифров по умолчанию. Эта опция недоступна, если версия OpenSSL ниже 1.1.1.
--tls-cipher <строка-шифра> Строка приоритета GnuTLS (для TLS 1.2 и выше) или строка шифра OpenSSL (только для TLS 1.2). Переопределить критерии выбора набора шифров по умолчанию.Смотрите также страницу помощи по Zabbix get для получения более подробной информации.
Zabbix get в Windows можно запустить аналогичным образом: