Объект service

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

Сервис

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

Property Type Description
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 - Только чтение.

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

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

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

Property Type Description
type integer Условие для установки статуса (New status).

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

Где:
- N (W) — limit_value;
- (Status) — limit_status;
- (New 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

Тег сервиса

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

Property Type Description
tag string Имя тега сервиса.

Поведение свойства:
- required
value string Значение тега сервиса.

Сигнализация сервиса

Сигнализации сервиса нельзя напрямую создавать, обновлять или удалять через Zabbix API.

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

Property Type Description
clock timestamp Время, когда произошло изменение состояния сервиса.
value integer Статус сервиса.

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

Тег проблемы

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

Property Type Description
tag string Имя тега проблемы.

Поведение свойства:
- required
operator integer Оператор условия сопоставления operator.

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