Objeto de servicio

Los siguientes objetos están directamente relacionados con la API de service.

Servicio

El objeto service tiene las siguientes propiedades.

Property Type Description
serviceid ID ID del service.

Property behavior:
- read-only
- required for update operations
algorithm integer Regla de cálculo del estado. Solo aplica si existen servicios hijos.

Valores posibles:
0 - establecer el estado en OK;
1 - el más crítico si todos los hijos tienen problemas;
2 - el más crítico de los servicios hijos.

Property behavior:
- required for create operations
name string Nombre del service.

Property behavior:
- required for create operations
sortorder integer Posición del service utilizada para la ordenación.

Valores posibles: 0-999.

Property behavior:
- required for create operations
weight integer Peso del service.

Valores posibles: 0-1000000.

Predeterminado: 0.
propagation_rule integer Regla de propagación del estado.

Valores posibles:
0 - (predeterminado) propagar el estado del service tal cual, sin cambios;
1 - aumentar el estado propagado en un valor dado de propagation_value (de 1 a 5 severidades);
2 - disminuir el estado propagado en un valor dado de propagation_value (de 1 a 5 severidades);
3 - ignorar este service: el estado no se propaga al service padre en absoluto;
4 - establecer un estado fijo del service usando un valor dado de propagation_value.

Property behavior:
- required if propagation_value is set
propagation_value integer Valor de propagación del estado.

Valores posibles si propagation_rule está establecido 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;
3 - Promedio;
4 - Alto;
5 - Desastre.

Property behavior:
- required if propagation_rule is set
status integer Indica si el service está en estado OK o en estado de problema.

Si el service está en estado de problema, status es igual a la severidad del problema más crítico o al estado más alto de un service hijo en estado de problema.

Si el service está en estado OK, status es igual a: -1.

Property behavior:
- read-only
description string Descripción del service.
uuid string Identificador único universal, usado para vincular los services importados con los ya existentes. Se genera automáticamente si no se proporciona.
created_at integer Marca de tiempo Unix cuando se creó el service.
readonly integer Acceso al service.

Valores posibles:
0 - Lectura y escritura;
1 - Solo lectura.

Property behavior:
- read-only

Regla de estado

El objeto de regla de estado tiene las siguientes propiedades.

Propiedad Tipo Descripción
type integer Condición para establecer el estado (Nuevo estado).

Valores posibles:
0 - si al menos (N) servicios hijos tienen el estado (Estado) o superior;
1 - si al menos (N%) de los servicios hijos tienen el estado (Estado) o superior;
2 - si menos de (N) servicios hijos tienen el estado (Estado) o inferior;
3 - si menos de (N%) de los servicios hijos tienen el estado (Estado) o inferior;
4 - si el peso de los servicios hijos con el estado (Estado) o superior es al menos (W);
5 - si el peso de los servicios hijos con el estado (Estado) o superior es al menos (N%);
6 - si el peso de los servicios hijos con el estado (Estado) o inferior es menor que (W);
7 - si el peso de los servicios hijos con el estado (Estado) o inferior es menor que (N%).

Donde:
- N (W) es limit_value;
- (Estado) es limit_status;
- (Nuevo estado) es new_status.

Comportamiento de la propiedad:
- requerido
limit_value integer Valor límite.

Valores posibles:
- para N y W: 1-100000;
- para N%: 1-100.

Comportamiento de la propiedad:
- requerido
limit_status integer Estado límite.

Valores posibles:
-1 - OK;
0 - No clasificado;
1 - Información;
2 - Advertencia;
3 - Media;
4 - Alta;
5 - Desastre.

Comportamiento de la propiedad:
- requerido
new_status integer Valor del nuevo estado.

Valores posibles:
0 - No clasificado;
1 - Información;
2 - Advertencia;
3 - Media;
4 - Alta;
5 - Desastre.

Comportamiento de la propiedad:
- requerido

Etiqueta de servicio

El objeto de etiqueta de servicio tiene las siguientes propiedades.

Propiedad Tipo Descripción
tag string Nombre de la etiqueta de servicio.

Comportamiento de la propiedad:
- requerido
value string Valor de la etiqueta de servicio.

Alarma de servicio

Las alarmas de servicio no se pueden crear, actualizar ni eliminar directamente a través de la API de Zabbix.

Los objetos de alarma de servicio representan un cambio de estado de un servicio. Tiene las siguientes propiedades.

Property Type Description
clock timestamp Momento en que se produjo el cambio de estado del servicio.
value integer Estado del servicio.

Consulte la propiedad status del servicio para obtener una lista de los valores posibles.

Etiqueta de problema

Las etiquetas de problema permiten vincular servicios con eventos de problema. El objeto de etiqueta de problema tiene las siguientes propiedades.

Property Type Description
tag string Nombre de la etiqueta de problema.

Property behavior:
- required
operator integer Operador de la condición de mapeo operator.

Valores posibles:
0 - (default) Igual a;
2 - Contiene.
value string Valor de la etiqueta de problema.