problem.get

Description

integer/array problem.get(object parameters)

La méthode permet de récupérer des problèmes en fonction des paramètres donnés.

Cette méthode permet de récupérer des problèmes non résolus. Il est également possible, si spécifié, de récupérer en plus les problèmes récemment résolus. La période qui détermine la période pour "récemment" est définie dans Administration[Général]'/manual/web_interface/frontend_sections/administration/general#trigger_displaying_options). Les problèmes résolus avant cette période ne sont pas conservés dans la table des problèmes. Pour récupérer les problèmes résolus dans le passé, utilisez la méthode event.get

Cette méthode peut renvoyer des problèmes d'une entité supprimée si ces problèmes n'ont pas encore été supprimés par la maintenance.

Cette méthode est disponible à tous les types d'utilisateurs. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres du le rôle d'utilisateur. Voir Rôles Utilisateur pour plus d'informations.

Paramètres

(object) Paramètres définissant la sortie souhaitée.

La méthode prend en charge les paramètres suivants.

Paramètre Type Description
eventids string/array Renvoie uniquement les problèmes avec les ID donnés.
groupids string/array Renvoie uniquement les problèmes créés par des objets appartenant aux groupes d'hôtes donnés.
hostids string/array Renvoie uniquement les problèmes créés par des objets appartenant aux hôtes donnés.
objectids string/array Renvoie uniquement les problèmes créés par les objets donnés.
source integer Renvoie uniquement les problèmes avec le type donné.

Reportez-vous à la page d'objet d'événement de problème pour une liste des types d'événements pris en charge.

Par défaut : 0 - problème créé par un déclencheur.
object integer Renvoie uniquement les problèmes créés par des objets du type donné.

Reportez-vous à la page d'objet d'événement de problème pour obtenir une liste des types d'objet pris en charge.

Par défaut : 0 - déclencheur .
acknowledged boolean true - renvoie uniquement les problèmes acquittés ;
false - uniquement les problèmes non acquittés.
suppressed boolean true - renvoie uniquement les problèmes supprimés ;
false - renvoie les problèmes à l'état normal.
severities integer/array Renvoie uniquement les problèmes avec des gravités d'événement données. S'applique uniquement si l'objet est déclencheur.
evaltype integer Règles de recherche de tags.

Valeurs possibles :
0 - (par défaut) Et/Ou ;
2 - Ou.
tags array of objects Renvoie uniquement les problèmes avec les balises données. Correspondance exacte par tag et recherche insensible à la casse par valeur et opérateur.
Format : [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...].
Un tableau vide renvoie tous les problèmes.

Types d'opérateurs possibles :
0 - (par défaut) Comme ;
1 - Égal ;
2 - Pas comme ;
3 - Pas égal< br>4 - Existe ;
5 - N'existe pas.
recent boolean true - renvoie le PROBLEM et les problèmes récemment RESOLVED (dépend de l'affichage des déclencheurs OK pendant N secondes)
Par défaut : false - problèmes UNRESOLVED uniquement
eventid_from string Renvoie uniquement les problèmes avec des ID supérieurs ou égaux à l'ID donné.
eventid_till string Renvoie uniquement les problèmes avec des ID inférieurs ou égaux à l'ID donné.
time_from timestamp Renvoie uniquement les problèmes qui ont été créés après ou au moment donné.
time_till timestamp Renvoie uniquement les problèmes qui ont été créés avant ou à l'instant donné.
selectAcknowledges query Renvoie une propriété acknowledges avec les mises à jour du problème. Les mises à jour de problème sont triées dans l'ordre chronologique inverse.

L'objet de mise à jour de problème a les propriétés suivantes :
acknowledgeid - (string) ID de la mise à jour ;
userid - (string) ID de l'utilisateur qui a mis à jour l'événement ;
eventid - (string) ID de l'événement mis à jour ;
clock - (timestamp) heure à laquelle l'événement a été mis à jour ;
message - (string) texte du message ;
action - (integer)type d'action de mise à jour (voir event.acknowledge) ;
old_severity - gravité de l'événement (integer) avant cette action de mise à jour ;
new_severity - gravité de l'événement (integer) après cette action de mise à jour ;

Prend en charge count.
selectTags query Renvoie une propriété tags avec les tags du problème. Format de sortie:[{"tag": "<tag>", "value": "<value>"}, ...].
selectSuppressionData query Renvoie une propriété suppression_data avec la liste des maintenances :
maintenanceid - (string) ID de la maintenance ;
suppress_until - (integer) temps jusqu'à ce que le problème soit supprimé.
sortfield string/array Trie le résultat en fonction des propriétés données.

Les valeurs possibles sont : eventid.
countOutput boolean Ces paramètres communs à toutes les méthodes get sont décrits en détail dans la page de commentaire de référence.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Valeurs retournées

(integer/array) Retourne soit :

  • un tableau d'objets ;
  • le nombre d'objets récupérés, si le paramètre countOutput a été utilisé.

Exemples

#### Récupération des événements problème via les déclencheurs

Récupérez les événements récents du déclencheur "15112".

Requête :

{
           "jsonrpc": "2.0",
           "method": "problem.get",
           "params": {
               "output": "extend",
               "selectAcknowledges": "extend",
               "selectTags": "extend",
               "selectSuppressionData": "extend",
               "objectids": "15112",
               "recent": "true",
               "sortfield": ["eventid"],
               "sortorder": "DESC"
           },
           "auth": "67f45d3eb1173338e1b1647c4bdc1916",
           "id": 1
       }

Réponse :

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "eventid": "1245463",
                   "source": "0",
                   "object": "0",
                   "objectid": "15112",
                   "clock": "1472457242",
                   "ns": "209442442",
                   "r_eventid": "1245468",
                   "r_clock": "1472457285",
                   "r_ns": "125644870",
                   "correlationid": "0",
                   "userid": "1",
                   "name": "Zabbix agent on localhost is unreachable for 5 minutes",
                   "acknowledged": "1",
                   "severity": "3",
                   "opdata": "",
                   "acknowledges": [
                       {
                           "acknowledgeid": "14443",
                           "userid": "1",
                           "eventid": "1245463",
                           "clock": "1472457281",
                           "message": "problem solved",
                           "action": "6",
                           "old_severity": "0",
                           "new_severity": "0"
                       }
                   ],
                   "suppression_data": [
                       {
                           "maintenanceid": "15",
                           "suppress_until": "1472511600"
                       }
                   ],
                   "suppressed": "1",
                   "tags": [
                       {
                           "tag": "test tag",
                           "value": "test value"
                       }
                   ]
               }
           ],
           "id": 1
       }

See also

Source

CEvent::get() dans ui/include/classes/api/services/CProblem.php.