Documentation
Table of Contents
7. Get
Обзор
Zabbix get — это утилита командной строки, которая может использоваться для подключения к Zabbix агенту и получения от него запрашиваемой информации.
Утилита обычно используется для диагностики Zabbix агентов.
Смотрите также zabbix_utils [en] — библиотека Python, имеющая встроенный функционал для действий, аналогичных 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-30 секунд (по умолчанию: 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 можно запустить аналогичным образом: