Объект service

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

Сервис

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

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

Поведение свойства:
- только для чтения
- обязательно для операций обновления
algorithm integer Правило вычисления статуса. Применяется только при наличии дочерних сервисов.

Возможные значения:
0 - установить статус в OK;
1 - наиболее критичный, если у всех дочерних сервисов есть проблемы;
2 - наиболее критичный из дочерних сервисов.

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

Поведение свойства:
- обязательно для операций создания
sortorder integer Позиция сервиса, используемая для сортировки.

Возможные значения: 0-999.

Поведение свойства:
- обязательно для операций создания
weight integer Вес сервиса.

Возможные значения: 0-1000000.

По умолчанию: 0.
propagation_rule integer Правило распространения статуса.

Возможные значения:
0 - (по умолчанию) распространять статус сервиса как есть, без каких-либо изменений;
1 - увеличить распространяемый статус на заданное значение propagation_value (на 1–5 уровней серьезности);
2 - уменьшить распространяемый статус на заданное значение propagation_value (на 1–5 уровней серьезности);
3 - игнорировать этот сервис — статус вообще не распространяется на родительский сервис;
4 - установить фиксированный статус сервиса, используя заданное значение propagation_value.

Поведение свойства:
- обязательно, если задан propagation_value
propagation_value integer Значение распространения статуса.

Возможные значения, если propagation_rule установлено в "0" или "3":
0 - Не классифицировано.

Возможные значения, если propagation_rule установлено в "1" или "2":
1 - Информация;
2 - Предупреждение;
3 - Средняя;
4 - Высокая;
5 - Катастрофа.

Возможные значения, если propagation_rule установлено в "4":
-1 - OK;
0 - Не классифицировано;
1 - Информация;
2 - Предупреждение;
3 - Средняя;
4 - Высокая;
5 - Катастрофа.

Поведение свойства:
- обязательно, если задано propagation_rule
status integer Находится ли сервис в состоянии OK или в состоянии проблемы.

Если сервис находится в состоянии проблемы, status равен одному из следующих значений:
- серьезности наиболее критичной проблемы;
- наивысшему статусу дочернего сервиса, находящегося в состоянии проблемы.

Если сервис находится в состоянии OK, status равен: -1.

Поведение свойства:
- только для чтения
description string Описание сервиса.
uuid string Универсальный уникальный идентификатор, используемый для связывания импортированных сервисов с уже существующими. Генерируется автоматически, если не указан.
created_at integer Unix timestamp, когда сервис был создан.
readonly integer Доступ к сервису.

Возможные значения:
0 - Чтение-запись;
1 - Только чтение.

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

Правило статуса

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

Свойство Type Описание
type integer Условие для установки статуса (Новый статус).

Возможные значения:
0 - если как минимум (N) дочерних сервисов имеют статус (Статус) или выше;
1 - если как минимум (N%) дочерних сервисов имеют статус (Статус) или выше;
2 - если менее (N) дочерних сервисов имеют статус (Статус) или ниже;
3 - если менее (N%) дочерних сервисов имеют статус (Статус) или ниже;
4 - если вес дочерних сервисов со статусом (Статус) или выше составляет как минимум (W);
5 - если вес дочерних сервисов со статусом (Статус) или выше составляет как минимум (N%);
6 - если вес дочерних сервисов со статусом (Статус) или ниже меньше (W);
7 - если вес дочерних сервисов со статусом (Статус) или ниже меньше (N%).

Где:
- N (W) — это limit_value;
- (Статус) — это limit_status;
- (Новый статус) — это new_status.

Поведение свойства:
- required
limit_value integer Предельное значение.

Возможные значения:
- для N и W: 1-100000;
- для N%: 1-100.

Поведение свойства:
- required
limit_status integer Предельный статус.

Возможные значения:
-1 - OK;
0 - Не классифицирован;
1 - Информация;
2 - Предупреждение;
3 - Средний;
4 - Высокий;
5 - Катастрофа.

Поведение свойства:
- required
new_status integer Значение нового статуса.

Возможные значения:
0 - Не классифицирован;
1 - Информация;
2 - Предупреждение;
3 - Средний;
4 - Высокий;
5 - Катастрофа.

Поведение свойства:
- required

Тег сервиса

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

Свойство Type Описание
tag string Имя тега сервиса.

Поведение свойства:
- обязательно
value string Значение тега сервиса.

Аварийное сообщение сервиса

Аварийные сообщения сервиса нельзя напрямую создавать, обновлять или удалять через Zabbix API.

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

Свойство Тип Описание
clock timestamp Время, когда произошло изменение состояния сервиса.
value integer Состояние сервиса.

Список возможных значений см. в свойстве status сервиса.

Тег проблемы

Теги проблем позволяют связывать сервисы с событиями проблем. Объект тега проблемы имеет следующие свойства.

Свойство Type Описание
tag string Имя тега проблемы.

Поведение свойства:
- обязательно
operator integer Условие сопоставления оператор.

Возможные значения:
0 - (по умолчанию) Равно;
2 - Содержит.
value string Значение тега проблемы.