[comment]: # translation:outdated

[comment]: # ({14379c17-14379c17})
# 7. Get

[comment]: # ({/14379c17-14379c17})

[comment]: # ({867a400b-f50cbd4e})
#### Обзор

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

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

Смотрите также [библиотеку Python для Zabbix](/devel/python), которая имеет встроенный функционал для действий, аналогичных утилите Zabbix get.

[comment]: # ({/867a400b-f50cbd4e})

[comment]: # ({dd9cd6fb-c625ea25})
#### Выполнение Zabbix get

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

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

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

```bash
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 принимает следующие параметры командной строки:

```ini
-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](/manpages/zabbix_get) для получения более подробной информации.

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

```bash
zabbix_get.exe [опции]
```

[comment]: # ({/dd9cd6fb-c625ea25})