Documentation
Table of Contents
Objeto de servicio
Los siguientes objetos est¨¢n directamente relacionados con la API de service.
Servicio
El objeto de servicio tiene las siguientes propiedades.
| Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| serviceid | ID | ID del servicio. Comportamiento de la propiedad: - solo lectura - obligatorio para operaciones de actualizaci¨®n |
| algoritmo | entero | Regla de c¨¢lculo de estado. Solo se aplica si existen servicios para ni?os. Valores posibles: 0: establece el estado en OK; 1: m¨¢s cr¨ªtico si todos los ni?os tienen problemas; 2: m¨¢s cr¨ªtico con los servicios para ni?os. Comportamiento de la propiedad: - obligatorio para operaciones de creaci¨®n |
| nombre | cadena | Nombre del servicio. Comportamiento de la propiedad: - obligatorio para operaciones de creaci¨®n |
| sortorder | integer | Posici¨®n del servicio utilizado para ordenar. Valores posibles: 0-999. Comportamiento de la propiedad:< br>- obligatorio para operaciones de creaci¨®n |
| peso | entero | Peso del servicio. Valores posibles: 0-1000000. Predeterminado: 0. |
| propagation_rule | integer | Regla de propagaci¨®n de estado. Valores posibles: 0 - (predeterminado) propaga el estado del servicio tal cual, sin ning¨²n cambio; 1 - aumenta el estado propagado en un ±¹²¹±ô´Ç°ù³å»å±ð³å±è°ù´Ç±è²¹²µ²¹³¦¾±¨®²Ô determinado (de 1 a 5 niveles de gravedad);2: disminuye el estado propagado en un ±¹²¹±ô´Ç°ù³å»å±ð³å±è°ù´Ç±è²¹²µ²¹³¦¾±¨®²Ô determinado (de 1 a 5 niveles de gravedad);3: ignora este servicio: el estado no se propaga al servicio principal; 4 - establece el estado del servicio fijo usando un ±¹²¹±ô´Ç°ù³å»å±ð³å±è°ù´Ç±è²¹²µ²¹³¦¾±¨®²Ô dado.Comportamiento de la propiedad: - obligatorio si se establece ±¹²¹±ô´Ç°ù³å±è°ù´Ç±è²¹²µ²¹³¦¾±¨®²Ô |
| propagation_value | integer | Valor de propagaci¨®n de estado. Valores posibles si propagation_rule se establece en "0" o "3":0 - No clasificado. Valores posibles si propagation_rule est¨¢ establecido en "1" o "2":1 - Informaci¨®n; 2 - Advertencia; 3 - Promedio; 4 - Alto; 5 - Desastre. Valores posibles si propagation_rule est¨¢ establecido en "4":-1 - OK; 0 - No clasificado; 1 - Informaci¨®n; 2 - Advertencia;< br>3 - Promedio; 4 - Alto; 5 - Desastre. Comportamiento de la propiedad: - obligatorio si se establece propagation_rule |
| status | integer | Si el servicio est¨¢ en estado correcto o problem¨¢tico. Si el servicio est¨¢ en estado problem¨¢tico, status es igual a:- la gravedad del problema m¨¢s cr¨ªtico;< br>- el estado m¨¢s alto de un servicio secundario en estado problem¨¢tico. Si el servicio est¨¢ en estado correcto, status es igual a: -1.Comportamiento de propiedad: - solo lectura |
| »å±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô | cadena | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô del servicio. |
| uuid | cadena | Identificador ¨²nico universal, utilizado para vincular servicios importados con los ya existentes. Generado autom¨¢ticamente, si no se proporciona. |
| created_at | integer | Marca de tiempo de Unix cuando se cre¨® el servicio. |
| solo lectura | booleano | Acceso al servicio. Valores posibles: 0 - Lectura-escritura; 1 - S¨®lo lectura. Comportamiento de la propiedad: - solo lectura |
Regla de estado
El objeto de regla de estado tiene las siguientes propiedades.
| Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| type | entero | Condici¨®n para establecer el estado (Nuevo estado). Valores posibles: 0 - si al menos (N) servicios secundarios tienen el estado (Estado) o superior; 1 - si al menos (N%) de los servicios para ni?os tienen el estado (Estado) o superior; 2 - si menos de (N) los servicios para ni?os tienen el estado (Estado) o inferior; 3 - si menos del (N%) de los servicios para ni?os tienen el estado (Estado) o inferior; 4 - si el peso de los servicios para ni?os con el estado (Estado) o superior es al menos (W); 5 - si el peso de los servicios para ni?os con el estado (Estado) o superior es al menos (N%); 6 - si el peso de los servicios para ni?os con estado (Estado) o inferior es menor que (W); 7 - si el peso de los servicios para ni?os con estado (Estado) o a continuaci¨®n es menor que (N%). Donde: - N (W) es limit_value;- (Estado) es limit_status;- (Nuevo estado) es new_status.Comportamiento de la propiedad: - obligatorio |
| limit_value | entero | Valor l¨ªmite. Valores posibles: - para N y W: 1-100000; - para N%: 1-100. Comportamiento de la propiedad: - obligatorio |
| limit_status | entero | Estado del l¨ªmite. Valores posibles: -1 - OK; 0 - No clasificado; 1 - Informaci¨®n; 2 - Advertencia;< br>3 - Promedio; 4 - Alto; 5 - Desastre. Comportamiento de la propiedad: - obligatorio |
| new_status | entero | Nuevo valor de estado. Valores posibles: 0 - No clasificado; 1 - Informaci¨®n; 2 - Advertencia; 3 - Promedio;< br>4 - Alto; 5 - Desastre. Comportamiento de la propiedad: - obligatorio |
Etiqueta de servicio
El objeto de etiqueta de servicio tiene las siguientes propiedades.
| Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| tag | cadena | Nombre de etiqueta de servicio. Comportamiento de la propiedad: - obligatorio |
| value | cadena | Valor de etiqueta de servicio. |
Alarma de servicio
Las alarmas de servicio no se pueden crear, actualizar ni eliminar a trav¨¦s de la API de Áú»¢¶Ä²©.
Los objetos de alarma de servicio representan el cambio de estado de un servicio. Tiene las siguientes propiedades.
| Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| clock | marca de tiempo | Hora en la que se produjo el cambio de estado del servicio. |
| value | entero | Estado del servicio. Consulte la propiedad de estado del servicio para obtener una lista de valores posibles. |
Etiqueta de problema
Las etiquetas de problemas permiten vincular servicios con eventos de problemas. El objeto de etiqueta del problema tiene las siguientes propiedades.
| Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| tag | cadena | Nombre de etiqueta del problema. Comportamiento de la propiedad: - obligatorio |
| operator | entero | Operador de condici¨®n de mapeo. Valores posibles: 0 - (predeterminado) es igual; 2 - similar. |
| value | cadena | Valor de etiqueta de problema. |