> Objet Tâche

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

L'objet tâche a les propriétés suivantes :

Propriété Type Description
taskid string (lecture seule) ID de la tâche.
type
(obligatoire)
integer Type de la tâche.

Valeurs possibles :
1 - Informations de diagnostic ;
6 - Vérifier maintenant.
status integer (lecture seule) Statut de la tâche.

Valeurs possibles :
1 - nouvelle tâche ;
2 - tâche en cours ;
3 - la tâche est terminée ;
4 - la tâche a expiré.
clock timestamp (lecture seule) Heure à laquelle la tâche a été créée.
ttl integer (lecture seule) Le temps en secondes après lequel la tâche expire.
proxy_hostid string ID du proxy sur lequel les statistiques d'informations de diagnostic sont collectées.
Ignoré pour les tâches 'Vérifier maintenant'.
request
(obligatoire)
object Objet de requête de tâche selon le type de tâche :
L'objet de la tâche 'Vérifier maintenant' est décrit en détail ci-dessous ;
L'objet de la tâche 'Informations de diagnostic' est décrit en détail ci-dessous.
result object (lecture seule) Objet de résultat de la tâche d'informations de diagnostic. Peut contenir NULL si le résultat n'est pas encore prêt. L'objet de résultat est décrit en détail ci-dessous.

Objet de requête 'Vérifier maintenant'

L'objet de demande de tâche 'Vérifier maintenant' a les propriétés suivantes.

Propriété Type Description
itemid string ID de l'élément et règles de découverte de bas niveau.

Objet de requête 'Informations de diagnostic'

L'objet de demande de tâche d'informations de diagnostic a les propriétés suivantes. L'objet de requête statistique pour tous les types de propriétés est décrit en détail ci-dessous.

Propriété Type Description
historycache object Demande de statistiques de cache d'historique. Disponible sur serveur et proxy.
valuecache object Requête de statistiques de cache d'éléments. Disponible sur serveur.
preprocessing object Requête de statistiques du gestionnaire de prétraitement. Disponible sur serveur et proxy.
alerting object Demande de statistiques du gestionnaire d'alertes. Disponible sur serveur.
lld object Requête de statistiques du gestionnaire LLD. Disponible sur serveur.

#### Objet de demande de statistiques

L'objet de requête statistique est utilisé pour définir le type d'informations qui doivent être collectées sur les processus internes du serveur/proxy. Il a les propriétés suivantes.

Propriété Type Description
stats query Propriétés de l'objet statistique à renvoyer. La liste des champs disponibles pour chaque type de statistiques d'informations de diagnostic est [décrit en détail ci-dessous] (object#list_of_statistic_fields_available_for_each_type_of_diagnostic_information_request).

Par défaut : extend renverra tous les champs de statistiques disponibles.
top object Objet pour trier et limiter les valeurs statistiques renvoyées. La liste des champs disponibles pour chaque type de statistique d'informations de diagnostic est [décrit en détail ci-dessous] (object#list_of_sorting_fields_available_for_each_type_of_diagnostic_information_request).

Exemple :
{ "source.alerts": 10 }
Liste des champs statistiques disponibles pour chaque type de demande d'informations de diagnostic

Les champs statistiques suivants peuvent être demandés pour chaque type de propriété de demande d'informations de diagnostic.

Type de diagnostic Champs disponibles Description
historycache items Nombre d'éléments mis en cache.
values Nombre de valeurs mises en cache.
memory Statistiques de la mémoire partagée (espace libre, nombre de morceaux utilisés, nombre de morceaux libres, taille maximale du morceau libre).
memory.data Statistiques de la mémoire partagée du cache de données d'historique.
memory.index Statistiques de la mémoire partagée du cache d'index de l'historique.
valuecache items Nombre d'éléments mis en cache.
values Nombre de valeurs mises en cache.
memory Statistiques de la mémoire partagée (espace libre, nombre de morceaux utilisés, nombre de morceaux libres, taille maximale du morceau libre).
mode Mode cache de valeurs.
preprocessing values Nombre de valeurs en file d'attente.
preproc.values Nombre de valeurs en file d'attente avec étapes de prétraitement.
alerting alerts Nombre d'alertes en file d'attente.
lld rules Nombre de règles en file d'attente.
values Nombre de valeurs en file d'attente.
Liste des champs de tri disponibles pour chaque type de demande d'informations de diagnostic

Les champs statistiques suivants peuvent être utilisés pour trier et limiter les informations demandées.

Type de diagnostic Champs disponibles Type
historycache values integer
valuecache values integer
request.values integer
preprocessing values integer
alerting media.alerts integer
source.alerts integer
lld values integer

Objet de résultat statistique

L'objet de résultat statistique est récupéré dans le champ 'result' de l'objet de tâche.

Propriété Type Description
status integer (lecture seule) Statut du résultat de la tâche.

Valeurs possibles :
-1 - une erreur s'est produite lors de l'exécution de la tâche ;
0 - le résultat de la tâche est créé.
data string/object Résultats selon l'objet de requête statistique d'une tâche d'information de diagnostic particulière. Contient une chaîne de message d'erreur si une erreur s'est produite lors de l'exécution de la tâche.