Documentation
Table of Contents
> Objeto de servicio
Los siguientes objetos están directamente relacionados con la API de service.
Service
The service object has the following properties.
| Property | Type | Description |
|---|---|---|
| serviceid | string | (readonly) ID of the service. |
| algorithm (required) |
integer | Status calculation rule. Only applicable if child services exist. Possible values: 0 - set status to OK; 1 - most critical if all children have problems; 2 - most critical of child services. |
| name (required) |
string | Name of the service. |
| showsla (required) |
integer | Whether SLA should be calculated. Possible values: 0 - do not calculate; 1 - calculate. |
| sortorder (required) |
integer | Position of the service used for sorting. Possible values: 0-999. |
| goodsla | float | Minimum acceptable SLA value. If the SLA drops lower, the service is considered to be in problem state. Possible values: 0-100. Default: 99.9. |
| weight | integer | Service weight. Possible values: 0-1000000. Default: 0. |
| propagation_rule | integer | Status propagation rule. Must be set together with propagation_value.Possible values: 0 - (default) propagate service status as is - without any changes; 1 - increase the propagated status by a given propagation_value (by 1 to 5 severities);2 - decrease the propagated status by a given propagation_value (by 1 to 5 severities);3 - ignore this service - the status is not propagated to the parent service at all; 4 - set fixed service status using a given propagation_value. |
| propagation_value | integer | Status propagation value. Must be set together with propagation_rule.Possible values for propagation_rule with values 0 and 3: 0.Possible values for propagation_rule with values 1 and 2: 1-5.Possible values for propagation_rule with value 4:-1 - OK; 0 - Not classified; 1 - Information; 2 - Warning; 3 - Average; 4 - High; 5 - Disaster. |
| status | integer | (readonly) Whether the service is in OK or problem state. If the service is in problem state, status is equal either to:- the severity of the most critical problem; - the highest status of a child service in problem state. If the service is in OK state, status is equal to -1. |
| readonly | boolean | (readonly) Access to the service. Possible values: 0 - Read-write; 1 - Read-only. |
Status rule
The status rule object has the following properties.
| Property | Type | Description |
|---|---|---|
| type (required) |
integer | Condition for setting (New status) status. Possible values: 0 - if at least (N) child services have (Status) status or above; 1 - if at least (N%) of child services have (Status) status or above; 2 - if less than (N) child services have (Status) status or below; 3 - if less than (N%) of child services have (Status) status or below; 4 - if weight of child services with (Status) status or above is at least (W); 5 - if weight of child services with (Status) status or above is at least (N%); 6 - if weight of child services with (Status) status or below is less than (W); 7 - if weight of child services with (Status) status or below is less than (N%). Where: - N (W) is limit_value;- (Status) is limit_status;- (New status) is new_status. |
| limit_value (required) |
integer | Limit value. Possible values: - for N and W: 1-100000; - for N%: 1-100. |
| limit_status (required) |
integer | Limit status. Possible values: -1 - OK; 0 - Not classified; 1 - Information; 2 - Warning; 3 - Average; 4 - High; 5 - Disaster. |
| new_status (required) |
integer | New status value. Possible values: 0 - Not classified; 1 - Information; 2 - Warning; 3 - Average; 4 - High; 5 - Disaster. |
Etiqueta de servicio
El objeto de etiqueta de servicio tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| tag (obligatorio) |
cadena | Nombre de la etiqueta de servicio. |
| value | cadena | Valor de la etiqueta de servicio. |
Alarma de servicio
Las alarmas de servicio no se pueden crear, actualizar ni eliminar a través de la API de Zabbix.
Los objetos de alarma de servicio representan el cambio de estado de un servicio. Tienen las siguientes propiedades.
Propiedad | Tipo | Descripción |
|----------|-------------------------------------- ---------------|---------------------------------- -------------------------------------------------- ---------------------------------| | 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 objecto de etiqueta del problema tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| tag (obligatorio) |
cadena | Nombre de la etiqueta del problema. |
| operator | entero | Operador de condición de mapeo. Valores posibles: 0 - (predeterminado) es igual; 2 - similar. |
| value | cadena | Valor de etiqueta de problema. |