Объект 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.

Property behavior:
- required
limit_value integer Предельное значение.

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

Property behavior:
- required
limit_status integer Предельный статус.

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

Property behavior:
- required
new_status integer Новое значение статуса.

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

Property behavior:
- required

Тег сервиса

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

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

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

Сигнал тревоги службы

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

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

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

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

Тег проблемы

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

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

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

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