Documentation
Table of Contents
4. Узлы сети
Обзор
Узлы сети экспортируются со многими связанными объектами и отношениями между объектами.
Экспорт узла сети содержит:
- Связанные группы узов сети
- Данные узла сети
- Связи с шаблонами
- Связи с группами узлов сети
- Интерфейсы узла сети
- Напрямую присоединённые элементы данных
- Напрямую присоединённые триггеры
- Напрямую присоединённые правила обнаружения со всеми прототипами
- Напрямую присоединённые веб-сценарии
- Макросы узла сети
- Данные инвентаризации узла сети
- Преобразования значений
- Присоединённые графики
Экспорт
Чтобы экспортировать узел сети, сделайте следующее:
- Перейдите к: Сбор данных → Узлы сети (Data collection → Hosts).
- Отметьте флажками узлы сети для экспорта.
- Нажмите Экспорт (Export) ниже списка.
В зависимости от выбранного формата узлы сети экспортируются в локальный файл с именем по умолчанию:
zabbix_export_hosts.yaml— при экспорте в YAML (опция по умолчанию для экспорта);zabbix_export_hosts.xml— при экспорте в XML;zabbix_export_hosts.json— при экспорте в JSON.
Импорт
Чтобы импортировать узлы сети, выполните следующие действия:
- Перейдите в раздел Сбор данных → Узлы сети (Data collection → Hosts).
- Нажмите Импорт (Import) в правом верхнем углу.
- Выберите файл импорта.
- Нажмите Импорт (Import) в правом нижнем углу диалога настроек.
Если вы установите флажок Расширенные опции (Advanced options), будет отображён подробный список всех импортируемых элементов — отметьте или снимите отметку с каждого правила импорта по мере необходимости.
Если вы установите флажок в строке Все (All), все элементы под ним будут отмечены/сняты с отметки.
Правила импорта:
| Правило | Описание |
|---|---|
| Обновить существующее (Update existing) |
Существующие элементы будут обновлены, используя данные из файла импорта. В противном случае они не будут обновлены. |
| Создать новое (Create new) |
Новые элементы будут созданы, используя данные из файла импорта. В противном случае они не будут созданы. |
| Удалить отсутствующее (Delete missing) |
Существующие элементы, отсутствующие в файле импорта, будут удалены. В противном случае они не будут удалены. Если для параметра Присоединение шаблонов (Template linkage) выбрано значение Удалить отсутствующее, то существующие присоединения шаблонов, не присутствующие в файле импорта, будут отсоединены. Объекты (элементы данных, триггеры, графики и т. д.), унаследованные от отсоединяемых шаблонов, не будут удалены (если только опция Удалить отсутствующее не выбрана также и для каждого из объектов). |
В веб-интерфейсе отобразится сообщение об успехе или об ошибке импорта.
Формат экспорта
Формат экспорта в YAML:
zabbix_export:
version: '7.0'
host_groups:
- uuid: f2481361f99448eea617b7b1d4765566
name: 'Discovered hosts'
- uuid: 6f6799aa69e844b4b3918f779f2abf08
name: 'Zabbix servers'
hosts:
- host: 'Zabbix server 1'
name: 'Main Zabbix server'
monitored_by: 'SERVER'
templates:
- name: 'Linux by Zabbix agent'
- name: 'Zabbix server health'
groups:
- name: 'Discovered hosts'
- name: 'Zabbix servers'
interfaces:
- ip: 192.168.1.1
interface_ref: if1
items:
- name: 'Zabbix trap'
type: TRAP
key: trap
delay: '0'
history: 1w
preprocessing:
- type: MULTIPLIER
parameters:
- '8'
tags:
- tag: component
value: 'raw'
triggers:
- expression: 'last(/Zabbix server 1/trap)=0'
name: 'Last value is zero'
priority: WARNING
tags:
- tag: scope
value: 'availability'
tags:
- tag: service
value: zabbix-server
macros:
- macro: '{$HOST.MACRO}'
value: '123'
- macro: '{$PASSWORD1}'
type: SECRET_TEXT
inventory:
type: 'Zabbix server'
name: yyyyyy-HP-Pro-3010-Small-Form-Factor-PC
os: 'Linux yyyyyy-HP-Pro-3010-Small-Form-Factor-PC 4.4.0-165-generic #193-Ubuntu SMP Tue Sep 17 17:42:52 UTC 2019 x86_64'
inventory_mode: AUTOMATIC
graphs:
- name: 'CPU utilization server'
show_work_period: 'NO'
show_triggers: 'NO'
graph_items:
- drawtype: FILLED_REGION
color: FF5555
item:
host: 'Zabbix server 1'
key: 'system.cpu.util[,steal]'
- sortorder: '1'
drawtype: FILLED_REGION
color: 55FF55
item:
host: 'Zabbix server 1'
key: 'system.cpu.util[,softirq]'
- sortorder: '2'
drawtype: FILLED_REGION
color: '009999'
item:
host: 'Zabbix server 1'
key: 'system.cpu.util[,interrupt]'
- sortorder: '3'
drawtype: FILLED_REGION
color: '990099'
item:
host: 'Zabbix server 1'
key: 'system.cpu.util[,nice]'
- sortorder: '4'
drawtype: FILLED_REGION
color: '999900'
item:
host: 'Zabbix server 1'
key: 'system.cpu.util[,iowait]'
- sortorder: '5'
drawtype: FILLED_REGION
color: '990000'
item:
host: 'Zabbix server 1'
key: 'system.cpu.util[,system]'
- sortorder: '6'
drawtype: FILLED_REGION
color: '000099'
calc_fnc: MIN
item:
host: 'Zabbix server 1'
key: 'system.cpu.util[,user]'
- sortorder: '7'
drawtype: FILLED_REGION
color: '009900'
item:
host: 'Zabbix server 1'
key: 'system.cpu.util[,idle]'Экспортируемые элементы
Экспортируемые элементы описаны в таблицах ниже.
| Элемент | Тип | Описание | |
|---|---|---|---|
| version | строка | (обязательный) Версия Zabbix. | |
| host_groups | (обязательный) Корневой элемент для групп узлов сети. | ||
| uuid | строка | (обязательный) Уникальный идентификатор для этой группы узлов сети. | |
| name | строка | (обязательный) Имя группы узлов сети. | |
| hosts | Корневой элемент для узлов сети. | ||
Узлы сети
| Элемент | Тип | Описание | |
|---|---|---|---|
| host | строка | (обязательный) Уникальное имя узла сети. | |
| name | строка | Видимое имя узла сети. | |
| description | текст | Описание узла сети. | |
| monitored_by | строка | Наблюдение через: SERVER (сервер), PROXY (прокси) или PROXY_GROUP (группа прокси). | |
| proxy | Корневой элемент для прокси. | ||
| name | строка | (обязательный) Имя прокси (если имеется), через который наблюдается данный узел сети. | |
| proxy_group | Корневой элемент для группы прокси. | ||
| name | строка | (обязательный) Имя группы прокси (если имеется), используемой для наблюдения за данным узлом сети. | |
| status | строка | Состояние узла сети. Возможные значения:1 ENABLED (0, по умолчанию), DISABLED (1). |
|
| ipmi_authtype | строка | Тип аутентификации сессии IPMI. Возможные значения:1 DEFAULT (-1, по умолчанию), NONE (0), MD2 (1), MD5 (2), STRAIGHT (4), OEM (5), RMCP_PLUS (6). |
|
| ipmi_privilege | строка | Уровень привилегий сессии IPMI. Возможные значения:1 CALLBACK (1), USER (2, по умолчанию), OPERATOR (3), ADMIN (4), OEM (5). |
|
| ipmi_username | строка | Имя пользователя для IPMI проверок. | |
| ipmi_password | строка | Пароль для IPMI проверок. | |
| templates | Корневой элемент для присоединённых шаблонов. | ||
| name | строка | (обязательный) Имя шаблона. | |
| groups | Корневой элемент для групп узлов сети, к которым относится данный узел сети. | ||
| name | строка | (обязательный) Имя группы узлов сети. | |
| interfaces | Корневой элемент для интерфейсов узла сети. | ||
| items | Корневой элемент для элементов данных узла сети. | ||
| discovery_rules | Корневой элемент для правил низкоуровневого обнаружения узла сети. | ||
| http_tests | Корневой элемент для веб-сценариев узла сети. | ||
| tags | Корневой элемент для тегов узла сети. | ||
| tag | строка | (обязательный) Имя тега. | |
| value | строка | Значение тега. | |
| macros | Корневой элемент для макросов узла сети. | ||
| macro | строка | (обязательный) Имя пользовательского макроса. | |
| type | строка | Тип пользовательского макроса. Возможные значения:1 TEXT (0, по умолчанию), SECRET_TEXT (1), VAULT (2). |
|
| value | строка | Значение пользовательского макроса. | |
| description | строка | Описание пользовательского макроса. | |
| inventory | Корневой элемент для инвентарных данных узла сети. | ||
| <inventory_property> | строка | Свойство инвентарных данных. Для каждого свойства имеется свой соответствующий элемент (type, name, os и т.д.; например, смотрите Формат экспорта). |
|
| inventory_mode | строка | Режим инвентаризации. Возможные значения:1 DISABLED (-1), MANUAL (0, по умолчанию), AUTOMATIC (1). |
|
| valuemaps | Корневой элемент для преобразований значений узла сети. | ||
Смотрите также: объект узла сети (смотрите соответствующее свойство с совпадающим именем).
Интерфейсы узла сети
| Элемент | Тип | Описание | |
|---|---|---|---|
| default | строка | Является ли данный интерфейс узла сети основным. Обратите внимание, что у узла сети может быть только один основной интерфейс каждого типа. Возможные значения:1 NO (0), YES (1, по умолчанию). |
|
| type | строка | Interface type. Возможные значения:1 ZABBIX (1, по умолчанию), SNMP (2), IPMI (3), JMX (4). |
|
| useip | строка | Использовать ли IP в качестве интерфейса для подключения к узлу сети (если нет, будет использоваться DNS). Возможные значения:1 NO (0), YES (1, по умолчанию). |
|
| ip | строка | (обязательный для IP connections) IP адрес (IPv4 или IPv6). | |
| dns | строка | (обязательный для DNS connections) DNS имя. | |
| port | строка | Номер порта. | |
| details | Корневой элемент для подробностей интерфейса. | ||
| version | строка | Использовать эту версию SNMP. Возможные значения:1 SNMPV1 (1), SNMP_V2C (2, по умолчанию), SNMP_V3 (3). |
|
| community | строка | (обязательный для SNMPv1 и SNMPv2 items) SNMP community. | |
| max_repetitions | строка | Значение поля «Макс. количество повторений» для «родных» запросов SNMP bulk (GetBulkRequest-PDUs). Поддерживается для элементов данных SNMPv2 и SNMPv3 (элементы данных discovery[] и walk[]).По умолчанию: 10. |
|
| contextname | строка | Имя контекста SNMPv3. Поддерживается для элементов данных SNMPv3. |
|
| securityname | строка | Имя безопасности SNMPv3. Поддерживается для элементов данных SNMPv3. |
|
| securitylevel | строка | Уровень безопасности SNMPv3. Поддерживается для элементов данных SNMPv3. Возможные значения:1 NOAUTHNOPRIV (0, по умолчанию), AUTHNOPRIV (1), AUTHPRIV (2). |
|
| authprotocol | строка | Протокол аутентификации SNMPv3. Поддерживается для элементов данных SNMPv3. Возможные значения:1 MD5 (0, по умолчанию), SHA1 (1), SHA224 (2), SHA256 (3), SHA384 (4), SHA512 (5). |
|
| authpassphrase | строка | Пароль аутентификации SNMPv3. Поддерживается для элементов данных SNMPv3. |
|
| privprotocol | строка | Протокол безопасности SNMPv3. Поддерживается для элементов данных SNMPv3. Возможные значения:1 DES (0, по умолчанию), AES128 (1), AES192 (2), AES256 (3), AES192C (4), AES256C (5). |
|
| privpassphrase | строка | Ключевая фраза безопасности SNMPv3. Поддерживается для элементов данных SNMPv3. |
|
| bulk | строка | Использовать ли массовые запросы SNMP. Возможные значения:1 NO (0), YES (1, по умолчанию). |
|
| interface_ref | строка | Имя ссылки на интерфейс, которое используется в элементах данных (формат: if<N>). |
|
Смотрите также: объект интерфейса узла сети (смотрите соответствующее свойство с совпадающим именем).
Элементы данных узла сети
| Элемент | Тип | Описание | |
|---|---|---|---|
| name | строка | (обязательный) Имя элемента данных. | |
| type | строка | Тип элемента данных. Возможные значения:1 ZABBIX_PASSIVE (0, по умолчанию), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), CALCULATED (15), JMX (16), SNMP_TRAP (17), DEPENDENT (18), HTTP_AGENT (19), SNMP_AGENT (20), ITEM_TYPE_SCRIPT (21), ITEM_TYPE_BROWSER (22). |
|
| snmp_oid | строка | (обязательный для элементов данных SNMP_AGENT) Идентификатор объекта SNMP. | |
| key | строка | (обязательный) Ключ элемента данных. | |
| delay | строка | Интервал обновления элемента данных. По умолчанию: 1m. Значение всегда будет «0» для элементов данных типа траппер. |
|
| history | строка | Период времени (используя суффиксы времени, пользовательские макросы или LLD макросы), как долго хранить данные истории. По умолчанию: 31d. |
|
| trends | строка | Период времени (используя суффиксы времени, пользовательские макросы или LLD макросы), как долго хранить данные динамики изменений. По умолчанию: 365d. |
|
| status | строка | Состояние элемента данных. Возможные значения:1 ENABLED (0, по умолчанию), DISABLED (1). |
|
| value_type | строка | Тип получаемого значения. Возможные значения:1 FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, по умолчанию), TEXT (4), BINARY (5). |
|
| allowed_hosts | строка | Список IP адресов (через запятую) узлов сети, с которых разрешена отправка данных на элемент данных. Поддерживается для элементов данных «траппер» и «HTTP агент». |
|
| units | строка | Единицы измерения получаемых значений (bps, B и т.п.). | |
| params | текст | Дополнительные параметры в зависимости от типа элемента данных (выполняемый скрипт для элементов данных SSH и Telnet; SQL запрос для элементов данных Монитор баз данных; формула для вычисляемых элементов данных; скрипт для элементов данных Скрипт и Браузер). | |
| ipmi_sensor | строка | Датчик IPMI. Поддерживается для элементов данных IPMI. |
|
| authtype | строка | Тип аутентификации. Поддерживается для элементов данных SSH и HTTP агент. Возможные значения для элементов данных SSH:1 PASSWORD (0, по умолчанию), PUBLIC_KEY (1). Возможные значения для элементов данных HTTP агент:1 NONE (0, по умолчанию), BASIC (1), NTLM (2). |
|
| username | строка | (обязательный для элементов данных SSH и Telnet) Имя пользователя для аутентификации. Поддерживается для элементов данных типов простая проверка, монитор баз данных, JMX и HTTP агент. При использовании с элементами данных JMX, также должен быть указано поле password (см. ниже), либо оба свойства оставлены пустыми. |
|
| password | строка | (обязательный для элементов данных SSH и Telnet) Пароль для аутентификации. Поддерживается для элементов данных типов простая проверка, монитор баз данных, JMX и HTTP агент. При использовании с элементами данных JMX, также должен быть указано поле username (см. выше), либо оба свойства оставлены пустыми. |
|
| publickey | строка | (обязательный для элементов данных SSH) Имя файла открытого ключа (public key). | |
| privatekey | строка | (обязательный для элементов данных SSH) Имя файла закрытого ключа (private key). | |
| description | текст | Описание элемента данных. | |
| inventory_link | строка | Поле инвентарных данных узла сети, заполняемое этим элементом данных. Возможные значения:1 NONE (0), ALIAS (4) и т.д. (обратитесь к странице инвентарных данных узла сети для списка поддерживаемых полей). |
|
| valuemap | Корневой элемент для преобразований значений элемента данных. | ||
| name | строка | (обязательный) Имя преобразования значений, которое используется элементом данных. | |
| logtimefmt | строка | Формат времени в записях в журнале. Поддерживается для элементов данных с типом журнал (лог). |
|
| preprocessing | Корневой элемент для предобработки значения элемента данных. | ||
| step | Корневой элемент для шагов предобработки значения элемента данных узла сети. | ||
| interface_ref | строка | Ссылка на интерфейс узла сети (формат: if<N>). |
|
| jmx_endpoint | строка | JMX endpoint. Поддерживается для элементов данных типа JMX агент. |
|
| master_item | (обязательный для зависимых элементов данных) Корневой элемент для основного элемента данных, относящегося к этому зависимому элементу данных. | ||
| key | строка | (обязательный) Ключ основного элемента данных, относящегося к этому зависимому элементу данных. | |
| timeout | строка | Время ожидания при выполнении запроса данных элемента данных. Поддерживается для типов элементов данных, перечисленных в разделе Время ожидания. |
|
| url | строка | (обязательный для элементов данных HTTP агент) Строка URL. | |
| query_fields | Корневой элемент для параметров запроса. Поддерживается для элементов данных HTTP агент. |
||
| name | строка | (обязательный для элементов данных HTTP агент) Имя параметра запроса. | |
| value | строка | Значение параметра запроса. Поддерживается для элементов данных HTTP агент. |
|
| parameters | Корневой элемент для параметров, определяемых пользователем. Поддерживается для элементов данных Скрипт и Браузер. |
||
| name | строка | (обязательный для элементов данных Скрипт и Браузер) Имя параметра, определяемого пользователем. | |
| value | строка | Значение параметра, определяемого пользователем. Поддерживается для элементов данных Скрипт и Браузер. |
|
| posts | строка | Данные тела запроса HTTP(S). Поддерживается для элементов данных HTTP агент. |
|
| status_codes | строка | Диапазоны требуемых кодов состояний HTTP, разделённые запятыми. Поддерживается для элементов данных HTTP агент. |
|
| follow_redirects | строка | Следовать ответам перенаправлений HTTP при опросе данных. Поддерживается для элементов данных HTTP агент. Возможные значения:1 NO (0), YES (1, по умолчанию). |
|
| post_type | строка | Тип отсылаемых в теле запроса данных. Поддерживается для элементов данных HTTP агент. Возможные значения:1 RAW (0, по умолчанию), JSON (2), XML (3). |
|
| http_proxy | строка | Строка подключения к HTTP(S) прокси. Поддерживается для элементов данных HTTP агент. |
|
| headers | Корневой элемент для заголовков запросов HTTP(S). Поддерживается для элементов данных HTTP агент. |
||
| name | строка | (обязательный для элементов данных HTTP агент) Имя заголовка. | |
| value | строка | (обязательный для элементов данных HTTP агент) Значение заголовка. | |
| retrieve_mode | строка | Какую часть ответа надо сохранить. Поддерживается для элементов данных HTTP агент. Возможные значения:1 BODY (0, по умолчанию), HEADERS (1), BOTH (2). |
|
| request_method | строка | Тип метода запроса. Поддерживается для элементов данных HTTP агент. Возможные значения:1 GET (0, по умолчанию), POST (1), PUT (2), HEAD (3). |
|
| output_format | строка | Как обрабатывать ответ. Поддерживается для элементов данных HTTP агент. Возможные значения:1 RAW (0, по умолчанию), JSON (1). |
|
| allow_traps | строка | Позволяет отправку данных на элемент данных аналогично типу траппер. Поддерживается для элементов данных HTTP агент. Возможные значения:1 NO (0, по умолчанию), YES (1). |
|
| ssl_cert_file | строка | Путь к файлу открытого ключа (public key) SSL. Поддерживается для элементов данных HTTP агент. |
|
| ssl_key_file | строка | Путь к файлу закрытого ключа (private key) SSL. Поддерживается для элементов данных HTTP агент. |
|
| ssl_key_password | строка | Пароль к файлу ключа SSL. Поддерживается для элементов данных HTTP агент. |
|
| verify_peer | строка | Проверять ли подлинность сертификата хоста. Поддерживается для элементов данных HTTP агент. Возможные значения:1 NO (0, по умолчанию), YES (1). |
|
| verify_host | строка | Проверять, содержится ли имя узла в URL в полях Common Name или Subject Alternate Name сертификата хоста. Поддерживается для элементов данных HTTP агент. Возможные значения:1 NO (0, по умолчанию), YES (1). |
|
| tags | Корневой элемент для тегов элемента данных. | ||
| tag | строка | (обязательный) Имя тега. | |
| value | строка | Значение тега. | |
| triggers | Корневой элемент для триггеров элемента данных узла сети. | ||
Смотрите также: объект элемента данных (смотрите соответствующее свойство с совпадающим именем).
Шаги предобработки значения элемента данных узла сети
| Элемент | Тип | Описание | |
|---|---|---|---|
| type | строка | (обязательный) Тип шага предварительной обработки значений элемента данных. Возможные значения:1 MULTIPLIER (1), RTRIM (2), LTRIM (3), TRIM (4), REGEX (5), BOOL_TO_DECIMAL (6), OCTAL_TO_DECIMAL (7), HEX_TO_DECIMAL (8), SIMPLE_CHANGE (9, вычисляется как: полученное_значение - предыдущее_значение), CHANGE_PER_SECOND (10, вычисляется как: (полученное_значение - предыдущее_значение)/(текущее_время - время_предыдущей_проверки)), XMLPATH (11), JSONPATH (12), IN_RANGE (13), MATCHES_REGEX (14), NOT_MATCHES_REGEX (15), CHECK_JSON_ERROR (16), CHECK_XML_ERROR (17), CHECK_REGEX_ERROR (18), DISCARD_UNCHANGED (19), DISCARD_UNCHANGED_HEARTBEAT (20), JAVASCRIPT (21), PROMETHEUS_PATTERN (22), PROMETHEUS_TO_JSON (23), CSV_TO_JSON (24), STR_REPLACE (25), CHECK_NOT_SUPPORTED (26), XML_TO_JSON (27), SNMP_WALK_VALUE (28), SNMP_WALK_TO_JSON (29), SNMP_GET_VALUE (30). |
|
| parameters | (обязательный) Корневой элемент для параметров шага предобработки значения элемента данных. | ||
| parameter | строка | Отдельный параметр шага предобработки значения элемента данных. | |
| error_handler | строка | Тип действия, используемого в случае ошибки шага предобработки. Возможные значения:1 ORIGINAL_ERROR (0, по умолчанию), DISCARD_VALUE (1), CUSTOM_VALUE (2), CUSTOM_ERROR (3). |
|
| error_handler_params | строка | Параметры обработчика ошибок. | |
Смотрите также: объект предобработки элемента данных (смотрите соответствующее свойство с совпадающим именем).
Триггеры элемента данных узла сети
| Элемент | Тип | Описание | |
|---|---|---|---|
| uuid | строка | (обязательный) Уникальный идентификатор этого триггера. | |
| expression | строка | (обязательный) Выражение триггера. | |
| recovery_mode | строка | Основа генерации событий OK. Возможные значения:1 EXPRESSION (0, по умолчанию), RECOVERY_EXPRESSION (1), NONE (2). |
|
| recovery_expression | строка | Выражение восстановления триггера. | |
| correlation_mode | строка | Режим корреляции (без корреляции событий или корреляция событий по тегу). Возможные значения:1 DISABLED (0, по умолчанию), TAG_VALUE (1). |
|
| correlation_tag | строка | Имя тега, используемого для корреляции событий. | |
| name | строка | (обязательный) Имя триггера. | |
| event_name | строка | Имя события. | |
| opdata | строка | Оперативные данные. | |
| url_name | строка | Подпись для URL, связанного с триггером. | |
| url | строка | URL, связанный с триггером. | |
| status | строка | Состояние триггера. Возможные значения:1 ENABLED (0, по умолчанию), DISABLED (1). |
|
| priority | строка | Важность триггера. Возможные значения:1 NOT_CLASSIFIED (0, по умолчанию), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5). |
|
| description | текст | Описание триггера. | |
| type | строка | Тип генерации событий (одно событие о проблеме или множественные события о проблемах). Возможные значения:1 SINGLE (0, по умолчанию), MULTIPLE (1). |
|
| manual_close | строка | Закрытие вручную событий о проблемах. Возможные значения:1 NO (0, по умолчанию), YES (1). |
|
| dependencies | Корневой элемент для зависимостей. | ||
| name | строка | (обязательный) Имя зависимого триггера. | |
| expression | строка | (обязательный) Выражение зависимого триггера. | |
| recovery_expression | строка | Выражение восстановления зависимого триггера. | |
| tags | Корневой элемент для тегов триггера. | ||
| tag | строка | (обязательный) Имя тега. | |
| value | строка | Значение тега. | |
Смотрите также: объект триггера (смотрите соответствующее свойство с совпадающим именем).
Правила низкоуровневого обнаружения узла сети
Большинство элементов правил низкоуровневого обнаружения узла сети такие же, как и для элементов данных узла сети. В таблице ниже описываются те элементы, которые отличаются от элементов данных узла сети.
| Элемент | Тип | Описание | |
|---|---|---|---|
| type | строка | Тип элемента данных. Возможные значения:1 ZABBIX_PASSIVE (0, по умолчанию), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), JMX (16), DEPENDENT (18), HTTP_AGENT (19), SNMP_AGENT (20), ITEM_TYPE_SCRIPT (21), ITEM_TYPE_BROWSER (22). |
|
| key | строка | (обязательный) Ключ правила низкоуровневого обнаружения. | |
| filter | Корневой элемент для фильтра правила низкоуровневого обнаружения узла сети. | ||
| lifetime | строка | Период времени (используя секунды, суффиксы времени или пользовательские макросы), после которого ресурсы, которые более не обнаруживаются, будут удалены. По умолчанию: 7d. |
|
| lifetime_type | строка | Сценарий для удаления потерянных ресурсов LLD. Возможные значения: DELETE_NEVER, DELETE_IMMEDIATELY, DELETE_AFTER. |
|
| enabled_lifetime | строка | Период времени (используя секунды, суффиксы времени или пользовательские макросы), после которого ресурсы, которые более не обнаруживаются, будут деактивированы. | |
| enabled_lifetime_type | строка | Сценарий для деактивации потерянных ресурсов LLD. Возможные значения: DISABLE_NEVER, DISABLE_IMMEDIATELY, DISABLE_AFTER. |
|
| item_prototypes | Корневой элемент для элементов прототипов элементов данных узла сети, которые такие же, как и для элементов данных узла сети. | ||
| trigger_prototypes | Корневой элемент для элементов прототипов триггеров узла сети, которые такие же, как и для триггеров узла сети. | ||
| graph_prototypes | Корневой элемент для прототипов графиков узла сети, которые такие же, как и для графиков узла сети. | ||
| host_prototypes | Корневой элемент для прототипов узлов сети, которые такие же, как и для узлов сети. | ||
| master_item | строка | (обязательный зависимых правил) Корневой элемент для основного элемента данных зависимых правил. | |
| lld_macro_paths | Корневой элемент для путей макросов низкоуровневого обнаружения. | ||
| lld_macro | строка | (обязательный) Имя макроса правила низкоуровневого обнаружения. | |
| path | строка | (обязательный) Селектор для значения, которое будет назначено соответствующему макросу. | |
| preprocessing | Корневой элемент для предобработки значения правила низкоуровневого обнаружения. | ||
| step | Корневой элемент для элементов шага предобработки значения правила низкоуровневого обнаружения, которые такие же, как и для шагов предобработки значения элемена данных узла сети, за исключением меньшего набора возможных значений. Смотрите также: объект предобработки правила LLD. | ||
| overrides | Корневой элемент для правил замещения правила низкоуровневого обнаружения. | ||
| name | строка | (обязательный) Уникальное имя замещения. | |
| step | строка | (обязательный) Уникальный порядковый номер замещения. | |
| stop | строка | Остановить обработку последующих замещений при совпадении. | |
| filter | Корневой элемент для элементов фильтра правил замещения правила низкоуровневого обнаружения, которые такие же, как и для фильтров правила низкоуровневого обнаружения узла сети. | ||
| operations | Корневой элемент для операций замещения правила низкоуровневого обнаружения. | ||
Смотрите также: объект правила низкоуровневого обнаружения (смотрите соответствующее свойство с совпадающим именем).
Фильтры правила низкоуровневого обнаружения узла сети
| Элемент | Тип | Описание | |
|---|---|---|---|
| evaltype | строка | Способ проверки условий фильтра замещений. Возможные значения:1 AND_OR (0, по умолчанию), AND (1), OR (2), FORMULA (3). |
|
| formula | строка | Пользовательская формула вычисления условий фильтра. | |
| conditions | Корневой элемент для условий фильтров. | ||
| macro | строка | (обязательный) Имя макроса низкоуровневого обнаружения, используемого при выполнении проверки. | |
| value | строка | Значение для сравнения. | |
| operator | строка | Оператор условия. Возможные значения:1 MATCHES_REGEX (8, по умолчанию), NOT_MATCHES_REGEX (9). |
|
| formulaid | строка | (обязательный) Произвольный уникальный идентификатор, используемый для ссылки на условие из пользовательского выражения. Может содержать только заглавные буквы. Идентификатор должен быть задан пользователем при модификации условий фильтра, но будет сгенерирован заново при последующем запросе. | |
Смотрите также: объект фильтра правила LLD (смотрите соответствующее свойство с совпадающим именем).
Операции замещения правила низкоуровневого обнаружения узла сети
| Элемент | Тип | Описание | |
|---|---|---|---|
| operationobject | строка | Объект, к которому применяется операция. Возможные значения:1 ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3). |
|
| operator | строка | Оператор условия замещения. Возможные значения:1 EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5), NOT_REGEXP (6). |
|
| value | строка | Регулярное выражение или строка для оператора условия замещения. | |
| status | строка | Состояние объекта при операции замещения. | |
| discover | строка | Добавляется ли объект в результате обнаружения. | |
| delay | строка | Интервал обновления, заданный для прототипа элемента данных при операции замещения. | |
| history | строка | Период хранения истории, заданный для прототипа элемента данных при операции замещения. | |
| trends | строка | Период хранения динамики изменений, заданный для прототипа элемента данных при операции замещения. | |
| severity | строка | Важность прототипа триггера, заданная при операции замещения. | |
| tags | Корневой элемент для тегов, заданных для объекта при операции замещения. | ||
| tag | строка | (обязательный) Имя тега. | |
| value | строка | Значение тега. | |
| templates | Корневой элемент для шблонов, присоединённых к прототипу узла сети при операции замещения. | ||
| name | строка | (обязательный) Имя шаблона. | |
| inventory_mode | строка | Режим инвентаризации прототипа узла сети, заданный при операции замещения. | |
Смотрите также: объект операции замещения правила LLD (смотрите соответствующее свойство с совпадающим именем).
Веб-сценарии узла сети
| Элемент | Тип | Описание | |
|---|---|---|---|
| uuid | строка | (обязательный) Уникальный идентификатор для этого веб-сценария. | |
| name | строка | (обязательный) Имя веб-сценария. | |
| delay | строка | Частота (используя секунды, суффиксы времени или пользовательские макросы) выполнения веб-сценария. По умолчанию: 1m. |
|
| attempts | целое число | Количество попыток выполнения шагов веб-сценария. Возможные значения: 1-10 (по умолчанию: 1). |
|
| agent | строка | Агент клиента. Zabbix будет притворяться выбранным браузером. Эта опция полезна, когда веб-сайт возвращает разное содержимое для разных браузеров. По умолчанию: Zabbix. |
|
| http_proxy | строка | Прокси, который будет использоваться этим веб-сценарием, в формате: http://[имя_пользователя[:пароль]@]прокси.моякомпания.com[:порт] |
|
| variables | Корневой элемент переменных на уровне сценария, которые могут быть использованы в шагах сценария. | ||
| name | строка | (обязательный) Имя переменной. | |
| value | текст | (обязательный) Значение переменной. | |
| headers | Корневой элемент заголовков HTTP, которые будут отосланы при выполнении запроса. Заголовки должны быть перечислены, используя такой же синтаксис, как если бы они появлялись в протоколе HTTP. |
||
| name | строка | (обязательный) Имя заголовка. | |
| value | текст | (обязательный) Значение заголовка. | |
| status | строка | Состояние веб-сценария. Возможные значения:1 ENABLED (0, по умолчанию), DISABLED (1). |
|
| authentication | строка | Метод аутентификации. Возможные значения:1 NONE (0, по умолчанию), BASIC (1), NTLM (2). |
|
| http_user | строка | Имя пользователя для basic (HTTP) или NTLM аутентификации. | |
| http_password | строка | Пароль, используемый для basic (HTTP) или NTLM аутентификации. | |
| verify_peer | строка | Проверка SSL сертификата веб-сервера. Возможные значения:1 NO (0, по умолчанию), YES (1). |
|
| verify_host | строка | Проверка того, что поле Общее Имя (Common Name) или поле Дополнительное Имя Субъекта (Subject Alternate Name) сертификата веб-сервера совпадают. Возможные значения:1 NO (0, по умолчанию), YES (1). |
|
| ssl_cert_file | строка | Имя файла SSL сертификата, используемого для аутентификации клиента (должен быть в формате PEM). | |
| ssl_key_file | строка | Имя файла закрытого ключа SSL, используемого для аутентификации клиента (должен быть в формате PEM). | |
| ssl_key_password | строка | Пароль к файлу закрытого ключа SSL. | |
| steps | (обязательный) Корневой элемент для шагов веб-сценария. | ||
| tags | Корневой элемент для тегов веб-сценария. | ||
| tag | строка | (обязательный) Имя тега. | |
| value | строка | Значение тега. | |
Смотрите также: объект веб-сценария (смотрите соответствующее свойство с совпадающим именем).
Шаги веб-сценария узла сети
| Элемент | Тип | Описание | |
|---|---|---|---|
| name | строка | (обязательный) Имя шага веб-сценария. | |
| url | строка | (обязательный) Наблюдаемый URL. | |
| query_fields | Корневой элемент для параметров запроса (массив полей HTTP, которые будут добавлены к URL при выполнении запроса). | ||
| name | строка | (обязательный) Имя параметра запроса. | |
| value | строка | Значение параметра запроса. | |
| posts | Корневой элемент для переменных HTTP POST как строка (сырые post данные) или как массив полей HTTP (данные полей формы). | ||
| name | строка | (обязательный) Имя поля post. | |
| value | строка | (обязательный) Значение поля post. | |
| variables | Корневой элемент для переменных (макросов) уровня шага, которые могут применяться после этого шага. Если значение переменной имеет префикс «regex:», тогда её значение извлекается из данных, которые получены на этом шаге, в соответствии с шаблоном регулярного выражения, следующим за префиксом «regex:». |
||
| name | строка | (обязательный) Имя переменной. | |
| value | текст | (обязательный) Значение переменной. | |
| headers | Корневой элемент HTTP заголовков, которые будут отправлены при выполнении запроса. | ||
| name | строка | (обязательный) Имя заголовка. | |
| value | текст | (обязательный) Значение заголовка. | |
| follow_redirects | строка | Следование HTTP перенаправлениям. Возможные значения:1 NO (0), YES (1, по умолчанию). |
|
| retrieve_mode | строка | Режим получения HTTP ответа. Возможные значения:1 BODY (0, по умолчанию), HEADERS (1), BOTH (2). |
|
| timeout | строка | Время ожидания (используя секунды, суффиксы времени или пользовательские макросы) выполнения шага. По умолчанию: 15s. |
|
| required | строка | Текст, который должен присутствовать в ответе (игнорируется, если пусто). | |
| status_codes | строка | Список допустимых кодов состояний, разделённых запятыми (например: 200-201,210-299; игнорируется, если пустой). | |
Смотрите также: объект шага веб-сценария (смотрите соответствующее свойство с совпадающим именем).
Графики узла сети
| Элемент | Тип | Описание | |
|---|---|---|---|
| uuid | строка | Уникальный идентификатор графика. | |
| name | строка | (обязательный) Имя графика. | |
| width | целое число | Ширина графика, в пикселях. Используется для предпросмотра и в круговом/расширенном графиках. Возможные значения:1 20-65535 (по умолчанию: 900). |
|
| height | целое число | Высота графика, в пикселях. Используется для предпросмотра и в круговом/расширенном графиках. Возможные значения:1 20-65535 (по умолчанию: 900). |
|
| yaxismin | дробное число | Минимальное значение оси Y. Поддерживается, если «ymin_type_1» равен FIXED. По умолчанию: 0. |
|
| yaxismax | дробное число | Максимальное значение оси Y. Поддерживается, если «ymin_type_1» равен FIXED. По умолчанию: 0. |
|
| show_work_period | строка | Подсветка нерабочих часов. Поддерживается для обычных и стэкируемых графиков. Возможные значения:1 NO (0), YES (1, по умолчанию). |
|
| show_triggers | строка | Отображение значений простых триггеров в виде линии. Поддерживается для обычных и стэкируемых графиков. Возможные значения:1 NO (0), YES (1, по умолчанию). |
|
| type | строка | Тип графика. Возможные значения:1 NORMAL (0, по умолчанию), STACKED (1), PIE (2), EXPLODED (3). |
|
| show_legend | строка | Отображение легенды графика. Возможные значения:1 NO (0), YES (1, по умолчанию). |
|
| show_3d | строка | Активация 3D стиля. Поддерживается для обычных и стэкируемых графиков. Возможные значения:1 NO (0, по умолчанию), YES (1). |
|
| percent_left | дробное число | Отображение линии перцентиля для левой оси. Поддерживается для обычных графиков. По умолчанию: 0. |
|
| percent_right | дробное число | Отображение линии перцентиля для правой оси. Поддерживается для обычных графиков. По умолчанию: 0. |
|
| ymin_type_1 | строка | Минимальное значение оси Y. Поддерживается для обычных и стэкируемых графиков. Возможные значения:1 CALCULATED (0, по умолчанию), FIXED (1), ITEM (2). |
|
| ymin_item_1 | (обязательный, если ymin_type_1 равен ITEM) Корневой элемент для подробностей отдельного элемента данных. |
||
| host | строка | (обязательный) Узел сети элемента данных. | |
| key | строка | (обязательный) Ключ элемента данных. | |
| ymax_type_1 | строка | Максимальное значение оси Y. Поддерживается для обычных и стэкируемых графиков. Возможные значения:1 CALCULATED (0, по умолчанию), FIXED (1), ITEM (2). |
|
| ymax_item_1 | (обязательный, если ymax_type_1 равен ITEM) Корневой элемент для подробностей отдельного элемента данных. |
||
| host | строка | (обязательный) Узел сети элемента данных. | |
| key | строка | (обязательный) Ключ элемента данных. | |
| graph_items | (обязательный) Корневой элемент для элементов данных графика узла сети. | ||
Смотрите также: объект графика (смотрите соответствующее свойство с совпадающим именем).
Элементы данных графика узла сети
| Элемент | Тип | Описание | |
|---|---|---|---|
| sortorder | целое число | Порядок отрисовки. Меньшее значение отрисовывается первым. Можно использовать для отрисовки линий или регионов позади (или поверх) других. | |
| drawtype | строка | Стиль отрисовки элемента данных графика. Поддерживается для обычных графиков. Возможные значения:1 SINGLE_LINE (0, по умолчанию), FILLED_REGION (1), BOLD_LINE (2), DOTTED_LINE (3), DASHED_LINE (4), GRADIENT_LINE (5). |
|
| color | строка | Цвет элемента (6 символов, hex). | |
| yaxisside | строка | Позиция оси Y (слева или справа) для отрисовки элемента данных. Поддерживается для обычных и стэкируемых графиков. |
|
| calc_fnc | строка | Данные для отрисовки, если существует более одного значения по элементу данных. Возможные значения:1 MIN (1), AVG (2, по умолчанию), MAX (4), ALL (7; минимум, среднее и максимум; поддерживается только для простых графиков), LAST (9, поддерживается только для круговых/расширенных графиков). |
|
| type | строка | Тип элемента данных графика. Возможные значения:1 SIMPLE (0, по умолчанию), GRAPH_SUM (2; значение элемента данных представляется целым кругом; поддерживается только для круговых/расширенных графиков). |
|
| item | (обязательный) Отдельный элемент данных. | ||
| host | строка | (обязательный) Узел сети элемента данных. | |
| key | строка | (обязательный) Ключ элемента данных. | |
Смотрите также: объект элемента данных графика (смотрите соответствующее свойство с совпадающим именем).
Преобразования значений узла сети
| Элемент | Тип | Описание | |
|---|---|---|---|
| uuid | строка | (обязательный) Уникальный идентификатор для преобразования значений. | |
| name | строка | (обязательный) Имя преобразования значений. | |
| mapping | Корневой элемент для преобразования значений. | ||
| type | строка | Тип сопоставления преобразования. Возможные значения:1 EQUAL (0, по умолчанию), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6). |
|
| value | строка | Исходное значение. | |
| newvalue | строка | (обязательный) Новое значение, в которое преобразуется исходное значение. | |
Смотрите также: объект преобразований значений (смотрите соответствующее свойство с совпадающим именем).
Примечания
1 Целочисленные значения API в скобках, например, ENABLED (0), приведены только для справки. Подробнее смотрите на странице объекта API, указанной в таблице или в конце каждого раздела.