> 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.

'Refresh proxy configuration' request object

The 'Refresh proxy configuration' task request object has the following properties.

Property	Type	Description
proxy_hostids	array	Proxy IDs.

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.
preprocessing	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.
lld	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
valuecache	request.values	integer
preprocessing	values	integer
alerting	media.alerts	integer
alerting	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.

Documentation