На странице

Объект прокси

Следующие объекты напрямую связаны с API proxy.

Прокси

Объект прокси имеет следующие свойства.

Свойство Тип Описание
proxyid ID ID прокси.

Поведение свойства:
- только для чтения
- обязательно для операций обновления
name string Имя прокси.

Поведение свойства:
- обязательно для операций создания
proxy_groupid ID ID группы прокси.

0 — прокси не назначен ни одной группе прокси.
local_address string Адрес для активных агентов. IP-адрес или DNS-имя для подключения.

Поведение свойства:
- обязательно, если proxy_groupid не равен 0
local_port string Номер локального порта прокси для подключения.

Поддерживаются пользовательские макросы.

По умолчанию: 10051.

Поведение свойства:
- поддерживается, если proxy_groupid не равен 0
operating_mode integer Тип прокси.

Возможные значения:
0 — активный прокси;
1 — пассивный прокси.

Поведение свойства:
- обязательно для операций создания
description text Описание прокси.
lastaccess timestamp Время, когда прокси в последний раз подключался к серверу.

Поведение свойства:
- только для чтения
address string IP-адрес или DNS-имя для подключения.

Поддерживаются пользовательские макросы.

Поведение свойства:
- обязательно, если режим работы Zabbix proxy — пассивный
port string Номер порта для подключения.

Поддерживаются пользовательские макросы.

По умолчанию: 10051.

Поведение свойства:
- поддерживается, если режим работы Zabbix proxy — пассивный
allowed_addresses string IP-адреса или DNS-имена активного Zabbix proxy, разделённые запятыми.
tls_connect integer Подключения к узлу сети.

Возможные значения:
1 — (по умолчанию) Без шифрования;
2 — PSK;
4 — сертификат.
tls_accept integer Подключения от узла сети.

Возможные значения битовой маски:
1 — (по умолчанию) Без шифрования;
2 — PSK;
4 — сертификат.

Это поле битовой маски; допустима любая сумма возможных значений битовой маски (например, 6 для PSK и сертификата).
tls_issuer string Издатель сертификата.
tls_subject string Субъект сертификата.
tls_psk_identity string Идентификатор PSK; должен быть связан только с одним PSK (среди autoregistration, hosts и proxies).

Не включайте конфиденциальную информацию в идентификатор PSK, так как он передаётся по сети в незашифрованном виде, чтобы сообщить получателю, какой PSK использовать.

Поведение свойства:
- только для записи
- обязательно, если tls_connect установлено в "PSK" или tls_accept содержит бит "PSK"
tls_psk string Предварительно общий ключ (PSK); должен содержать не менее 32 шестнадцатеричных цифр.

Поведение свойства:
- только для записи
- обязательно, если tls_connect установлено в "PSK" или tls_accept содержит бит "PSK"
custom_timeouts integer Следует ли переопределять глобальные тайм-ауты элементов данных на уровне прокси.

Возможные значения:
0 — (по умолчанию) использовать глобальные настройки;
1 — переопределять тайм-ауты.
timeout_zabbix_agent string Тратить на обработку не более timeout_* секунд.
Допускаются секунды или единица времени с суффиксом (например, 30s, 1m). Также допускаются пользовательские макросы.

Диапазон возможных значений: 1-600s.

По умолчанию: "".

Поведение свойства:
- обязательно, если custom_timeouts установлено в 1.
timeout_simple_check
timeout_snmp_agent
timeout_external_check
timeout_db_monitor
timeout_http_agent
timeout_ssh_agent
timeout_telnet_agent
timeout_script
timeout_browser
version integer Версия прокси.

Трёхчастный номер версии Zabbix, где для каждой части используются две десятичные цифры, например, 60401 для версии 6.4.1, 70002 для версии 7.0.2 и т. д.
0 — Неизвестная версия прокси.

Поведение свойства:
- только для чтения
compatibility integer Версия прокси по сравнению с версией Zabbix server.

Возможные значения:
0 — Не определено;
1 — Текущая версия (прокси и сервер имеют одинаковую мажорную версию);
2 — Устаревшая версия (версия прокси старше версии сервера, но частично поддерживается);
3 — Неподдерживаемая версия (версия прокси старше версии предыдущего LTS-релиза сервера или мажорная версия сервера старше мажорной версии прокси).

Поведение свойства:
- только для чтения
state integer Состояние прокси.

Возможные значения:
0 — Неизвестно;
1 — Не в сети;
2 — В сети.

Поведение свойства:
- только для чтения