Zabbix Documentation 3.0

3.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.22.43.23.4

User Tools

Site Tools


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 [2017/01/05 08:44] (current)
dotneft created
Line 1: Line 1:
 +===== > Объект услуги IT =====
  
 +Следующие объекты напрямую связаны с ''​service''​ API.
 +
 +==== Услуга IT ====
 +
 +Объект услуги IT имеет следующие свойства.
 +
 +^  Свойство ​ ^  Тип ​ ^  Описание ​ ^
 +| serviceid ​ | строка ​ | //​(только чтение)//​ ID услуги IT.  |
 +| **algorithm** \\ (требуется) | целое число | Алгоритм,​ который используется для вычисления состояния услуги IT. \\ \\ Возможные значения:​ \\ 0 - без вычисления;​ \\ 1 - Проблема,​ если хотя бы одна дочерняя услуга в состоянии проблема;​ \\ 2 - Проблема,​ если все дочерние услуги в состоянии проблем. |
 +| **name** \\ (требуется) | строка | Имя услуги IT. |
 +| **showsla** \\ (требуется) | целое число | Необходимо ли вычислять SLA. \\ \\ Возможные значения:​ \\ 0 - не вычислять;​ \\ 1 - вычислять. |
 +| **sortorder** \\ (требуется) | целое число | Позиция услуги IT, которая используется для сортировки. |
 +| goodsla | дробное число | Минимально допустимое значение SLA. Если SLA опускается ниже, услуга IT считается как в состоянии проблемы. \\ \\ По умолчанию:​ 99.9. |
 +| status | целое число | //​(только чтение)//​ Находится ли IT услуга в состоянии ОК или проблема. \\ \\ Если услуга IT в состоянии проблема,​ значение ''​status''​ идентично:​ \\ - приоритету присоединенного триггера,​ если значением является 2, "​Средняя"​ или выше (приоритеты 0, "Не классифицировано"​ и 1, "​Информация"​ игнорируются);​ \\ - наивысшему состоянию дочерней услуги IT в состоянии проблема. \\ \\ Если услуга IT в состоянии ОК, ''​status''​ равен 0. |
 +| triggerid | строка | Триггер связанный с услугой IT. Триггер можно задвать только тем услугам IT, которые не имеют дочерних услуг. \\ \\ По умолчанию:​ 0 |
 +==== Время услуги ====
 +
 +Объект времени услуги задает периоды,​ когда услуга IT запланирована быть доступной или недоступной. Этот объект имеет следующие свойства.
 +
 +^  Свойство ​ ^  Тип ​ ^  Описание ​ ^
 +| timeid ​ | строка | //​(только чтение)//​ ID времени услуги. |
 +| **serviceid** \\ (требуется) ​ | строка | ID услуги IT. \\ \\ Нельзя обновлять. |
 +| **ts_from** \\ (требуется) | целое число | Время, когда время услуги вступает в действие. \\ \\ Для однократных недоступностей ''​ts_from''​ должен быть штампом времени (Unix штамп времени),​ для остальных типов - необходимо указать определенное время в течении недели,​ в секундах,​ например,​ 90000 для Вт, 2:00. |
 +| **ts_to** \\ (требуется) | целое число | Время, когда время услуги заканчивается. \\ \\ Для однократных доступностей ''​ts_to''​ должен быть штампом времени (Unix штамп времени),​ для остальных типов - необходимо указать определенное время в течении недели,​ в секундах,​ 90000 для Вт, 2:00. |
 +| **type** \\ (требуется) | целое число | Тип времени услуги. \\ \\ Возможные значения:​ \\ 0 - запланированная доступность,​ повторяемая каждую неделю;​ \\ 1 - запланированная недоступность,​ повторяемая каждую неделю;​ \\ 2 - однократная недоступность. |
 +| note | строка | Дополнительная информация о времени услуги. |
 +==== Зависимость услуги ====
 +
 +Объект зависимости услуги представляет собой зависимость между услугами IT. Этот объект имеет следующие свойства.
 +
 +^  Свойство ​ ^  Тип ​ ^  Описание ​ ^
 +| linkid | строка | //​(только чтение)//​ ID зависимости услуги. |
 +| **servicedownid** \\ (требуется) | строка ​ | ID услуги IT, от которой зависит услуга,​ то есть дочерняя услуга. Услуга IT может иметь несколько дочерних услуг. |
 +| **serviceupid** \\ (требуется) | строка ​ | ID услуги IT, которая зависит от услуги,​ то есть родительская услуга. Услуга IT может иметь несколько родительских услуг, которые образуют направленный граф. |
 +| **soft** \\ (требуется) | целое число | Тип зависимости между услугами IT. \\ \\ Возможные значения:​ \\ 0 - жесткая зависимость;​ \\ 1 - нежесткая зависимость. \\ \\ Услуга IT может иметь только одну родительскую услугу с жесткой зависимостью. Этот атрибут не влияет на состояние или вычисление SLA, атрибут используется только для создания ядра дерева услуг IT. Дополнительные родительские услуги можно добавлять как нежесткие зависимости,​ которые формируют граф. \\ \\ Услугу IT нельзя удалить,​ если она имеет дочернюю услугу с жесткой зависимостью. |
 +
 +==== Тревога услуги ====
 +
 +<​note>​Тревоги услуг нельзя напрямую создавать,​ обновлять или удалять через Zabbix API.</​note>​
 +
 +Объект тревоги услуг представляет собой изменение состояния услуги IT. Этот объект имеет следующие свойства.
 +
 +^  Свойство ​ ^  Тип ​ ^  Описание ​ ^
 +| servicealarmid | строка | ID тревоги услуги. |
 +| serviceid | строка | ID услуги IT. |
 +| clock | штамп времени | Время, когда произошло изменение состояния услуги IT. |
 +| value | целое число | Состояние услуги IT. \\ \\ Обратитесь к [[object#​услуга_it|свойству состояния услуги IT]] для получения списка возможных значений. |