Documentation
Table of Contents
> Объект услуги
Следующие объекты напрямую связаны с API услуги (service).
Услуга
Объект услуги имеет следующие свойства.
| Свойство | Тип | Описание |
|---|---|---|
| serviceid | строка | (только чтение) ID услуги. |
| algorithm (требуется) |
целое число | Алгоритм, который используется для вычисления состояния услуги. Возможные значения: 0 - без вычисления; 1 - Проблема, если хотя бы одна дочерняя услуга в состоянии проблема; 2 - Проблема, если все дочерние услуги в состоянии проблем. |
| name (требуется) |
строка | Имя услуги. |
| showsla (требуется) |
целое число | Необходимо ли вычислять SLA. Возможные значения: 0 - не вычислять; 1 - вычислять. |
| sortorder (требуется) |
целое число | Позиция услуги, которая используется для сортировки. |
| goodsla | дробное число | Минимально допустимое значение SLA. Если SLA опускается ниже, услуга считается как в состоянии проблемы. По умолчанию: 99.9. |
| status | целое число | (только чтение) Находится ли услуга в состоянии ОК или проблема. Если услуга в состоянии проблема, значение status идентично:- приоритету присоединенного триггера, если значением является 2, "Средняя" или выше (приоритеты 0, "Не классифицировано" и 1, "Информация" игнорируются); - наивысшему состоянию дочерней услуги в состоянии проблема. Если услуга в состоянии ОК, status равен 0. |
| triggerid | строка | Триггер связанный с услугой. Триггер можно задвать только тем услугам, которые не имеют дочерних услуг. По умолчанию: 0 |
Время услуги
Объект времени услуги задает периоды, когда услуга запланирована быть доступной или недоступной. Этот объект имеет следующие свойства.
| Свойство | Тип | Описание |
|---|---|---|
| timeid | строка | (только чтение) ID времени услуги. |
| serviceid (требуется) |
строка | ID услуги. Нельзя обновлять. |
| ts_from (требуется) |
целое число | Время, когда время услуги вступает в действие. Для однократных недоступностей ts_from должен быть штампом времени (Unix штамп времени), для остальных типов - необходимо указать определенное время в течении недели, в секундах, например, 90000 для Вт, 2:00. |
| ts_to (требуется) |
целое число | Время, когда время услуги заканчивается. Для однократных доступностей ts_to должен быть штампом времени (Unix штамп времени), для остальных типов - необходимо указать определенное время в течении недели, в секундах, 90000 для Вт, 2:00. |
| type (требуется) |
целое число | Тип времени услуги. Возможные значения: 0 - запланированная доступность, повторяемая каждую неделю; 1 - запланированная недоступность, повторяемая каждую неделю; 2 - однократная недоступность. |
| note | строка | Дополнительная информация о времени услуги. |
Зависимость услуги
Объект зависимости услуги представляет собой зависимость между услугами. Этот объект имеет следующие свойства.
| Свойство | Тип | Описание |
|---|---|---|
| linkid | строка | (только чтение) ID зависимости услуги. |
| servicedownid (требуется) |
строка | ID услуги, от которой зависит услуга, то есть дочерняя услуга. Услуга может иметь несколько дочерних услуг. |
| serviceupid (требуется) |
строка | ID услуги, которая зависит от услуги, то есть родительская услуга. Услуга может иметь несколько родительских услуг, которые образуют направленный граф. |
| soft (требуется) |
целое число | Тип зависимости между услугами. Возможные значения: 0 - жесткая зависимость; 1 - нежесткая зависимость. Услуга может иметь только одну родительскую услугу с жесткой зависимостью. Этот атрибут не влияет на состояние или вычисление SLA, атрибут используется только для создания ядра дерева услуг. Дополнительные родительские услуги можно добавлять как нежесткие зависимости, которые формируют граф. Услугу нельзя удалить, если она имеет дочернюю услугу с жесткой зависимостью. |
Service alarm
Service alarms cannot be directly created, updated or deleted via the Zabbix API.
The service alarm objects represents an service's state change. It has the following properties.
| Property | Type | Description |
|---|---|---|
| clock | timestamp | Time when the service state change has happened. |
| value | integer | Status of the service. Refer to the service status property for a list of possible values. |
Problem tag
Problem tags allow linking services with problem events. The problem tag object has the following properties.
| Property | Type | Description |
|---|---|---|
| tag (required) |
string | Problem tag name. |
| operator | integer | Mapping condition operator. Possible values: 0 - (default) equals; 2 - like. |
| value | string | Problem tag value. |