Objet service

Les objets suivants sont directement liés à l'API service.

Service

L'objet service possède les propriétés suivantes.

Property Type Description
serviceid ID ID du service.

Property behavior:
- read-only
- required for update operations
algorithm integer Règle de calcul de l'état. Applicable uniquement si des services enfants existent.

Valeurs possibles :
0 - définir l'état sur OK;
1 - le plus critique si tous les enfants ont des problèmes;
2 - le plus critique des services enfants.

Property behavior:
- required for create operations
name string Nom du service.

Property behavior:
- required for create operations
sortorder integer Position du service utilisée pour le tri.

Valeurs possibles : 0-999.

Property behavior:
- required for create operations
weight integer Poids du service.

Valeurs possibles : 0-1000000.

Par défaut : 0.
propagation_rule integer Règle de propagation de l'état.

Valeurs possibles :
0 - (default) propager l'état du service tel quel - sans aucune modification;
1 - augmenter l'état propagé d'une valeur propagation_value donnée (de 1 à 5 niveaux de gravité);
2 - diminuer l'état propagé d'une valeur propagation_value donnée (de 1 à 5 niveaux de gravité);
3 - ignorer ce service - l'état n'est pas du tout propagé au service parent;
4 - définir un état de service fixe à l'aide d'une valeur propagation_value donnée.

Property behavior:
- required if propagation_value is set
propagation_value integer Valeur de propagation de l'état.

Valeurs possibles si propagation_rule est défini sur "0" ou "3" :
0 - Non classé.

Valeurs possibles si propagation_rule est défini sur "1" ou "2" :
1 - Information;
2 - Avertissement;
3 - Moyen;
4 - Élevé;
5 - Désastre.

Valeurs possibles si propagation_rule est défini sur "4" :
-1 - OK;
0 - Non classé;
1 - Information;
2 - Avertissement;
3 - Moyen;
4 - Élevé;
5 - Désastre.

Property behavior:
- required if propagation_rule is set
status integer Indique si le service est dans un état OK ou en problème.

Si le service est dans un état de problème, status est égal soit à la gravité du problème le plus critique, soit à l'état le plus élevé d'un service enfant en état de problème.

Si le service est dans un état OK, status est égal à : -1.

Property behavior:
- read-only
description string Description du service.
uuid string Identifiant unique universel, utilisé pour lier les services importés à ceux déjà existants. Généré automatiquement s'il n'est pas fourni.
created_at integer Horodatage Unix de la création du service.
readonly integer Accès au service.

Valeurs possibles :
0 - Lecture-écriture;
1 - Lecture seule.

Property behavior:
- read-only

Règle de statut

L'objet de règle de statut possède les propriétés suivantes.

Propriété Type Description
type integer Condition pour définir le statut (Nouveau statut).

Valeurs possibles :
0 - si au moins (N) services enfants ont le statut (Statut) ou supérieur ;
1 - si au moins (N%) des services enfants ont le statut (Statut) ou supérieur ;
2 - si moins de (N) services enfants ont le statut (Statut) ou inférieur ;
3 - si moins de (N%) des services enfants ont le statut (Statut) ou inférieur ;
4 - si le poids des services enfants ayant le statut (Statut) ou supérieur est au moins égal à (W) ;
5 - si le poids des services enfants ayant le statut (Statut) ou supérieur est au moins égal à (N%) ;
6 - si le poids des services enfants ayant le statut (Statut) ou inférieur est inférieur à (W) ;
7 - si le poids des services enfants ayant le statut (Statut) ou inférieur est inférieur à (N%).

Où :
- N (W) correspond à limit_value ;
- (Statut) correspond à limit_status ;
- (Nouveau statut) correspond à new_status.

Comportement des propriétés :
- obligatoire
limit_value integer Valeur limite.

Valeurs possibles :
- pour N et W : 1-100000 ;
- pour N% : 1-100.

Comportement des propriétés :
- obligatoire
limit_status integer Statut limite.

Valeurs possibles :
-1 - OK ;
0 - Non classé ;
1 - Information ;
2 - Avertissement ;
3 - Moyen ;
4 - Élevé ;
5 - Désastre.

Comportement des propriétés :
- obligatoire
new_status integer Valeur du nouveau statut.

Valeurs possibles :
0 - Non classé ;
1 - Information ;
2 - Avertissement ;
3 - Moyen ;
4 - Élevé ;
5 - Désastre.

Comportement des propriétés :
- obligatoire

Balise de service

L'objet de balise de service possède les propriétés suivantes.

Propriété Type Description
tag string Nom de la balise de service.

Comportement de la propriété :
- obligatoire
value string Valeur de la balise de service.

Alarme de service

Les alarmes de service ne peuvent pas être créées, mises à jour ou supprimées directement via l'API Zabbix.

Les objets d'alarme de service représentent un changement d'état d'un service. Il possède les propriétés suivantes.

Property Type Description
clock timestamp Heure à laquelle le changement d'état du service s'est produit.
value integer Statut du service.

Reportez-vous à la propriété status du service pour obtenir la liste des valeurs possibles.

Balise de problème

Les balises de problème permettent de lier des services avec des événements de problème. L'objet balise de problème possède les propriétés suivantes.

Property Type Description
tag string Nom de la balise de problème.

Comportement de la propriété:
- required
operator integer Opérateur de la condition de mappage.

Valeurs possibles :
0 - (par défaut) Égal à;
2 - Contient.
value string Valeur de la balise de problème.