ru:manual:api:reference:service:object

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

ru:manual:api:reference:service:object [2018/06/27 09:37] (current)
Line 1: Line 1:
 +===== > Объект услуги =====
  
 +Следующие объекты напрямую связаны с ''​service''​ API.
 +
 +==== Услуга ====
 +
 +Объект услуги имеет следующие свойства.
 +
 +^  Свойство ​ ^  Тип ​ ^  Описание ​ ^
 +| 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, атрибут используется только для создания ядра дерева услуг. Дополнительные родительские услуги можно добавлять как нежесткие зависимости,​ которые формируют граф. \\ \\ Услугу нельзя удалить,​ если она имеет дочернюю услугу с жесткой зависимостью. |
 +
 +==== Тревога услуги ====
 +
 +<​note>​Тревоги услуг нельзя напрямую создавать,​ обновлять или удалять через Zabbix API.</​note>​
 +
 +Объект тревоги услуг представляет собой изменение состояния услуги. Этот объект имеет следующие свойства.
 +
 +^  Свойство ​ ^  Тип ​ ^  Описание ​ ^
 +| servicealarmid | строка | ID тревоги услуги. |
 +| serviceid | строка | ID услуги. |
 +| clock | штамп времени | Время, когда произошло изменение состояния услуги. |
 +| value | целое число | Состояние услуги. \\ \\ Обратитесь к [[object#​услуга|свойству состояния услуги]] для получения списка возможных значений. |