Sidebar

Zabbix Summit 2022
View presentations

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 AdministrationGénéral. 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.

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 identifiants 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.
applicationids string/array Renvoie uniquement les problèmes créés par des objets appartenant aux applications données. S'applique uniquement si l'objet est un déclencheur ou un élément.
source integer Renvoie uniquement les problèmes avec le type donné.

Se référer à la page d'objet d'événement problématique 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é.

Se référer à la page d'objet d'événement problématique pour une liste des types d'objets pris en charge.

Par défaut : 0 - déclencheur.
acknowledged boolean true - renvoie tous problèmes acquittés uniquement ;
false - renvoie tous problèmes non acquittés uniquement.
suppressed boolean true - renvoie seulement les problèmes supprimés ;
false - renvoie les problème à l'état normal.
severities integer/array Renvoie uniquement les problèmes ayant une sévérité d'événement donnée. S'applique uniquement si l'objet est un déclencheur.
evaltype integer Règles pour la recherche de tag.

Valeurs possibles :
0 - (par défaut) Et/Ou ;
2 - Ou.
tags array of objects Renvoie uniquement les problèmes liés à des tags. Correspondance exacte par tag et recherche non sensible à 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) Like ;
1 - Egal.
recent boolean true - Renvoie les problèmes et les problèmes récemment résolus (dépend de l'affichage des déclencheurs OK pour N secondes).
Par défaut : false - problèmes non résolus uniquement.
eventid_from string Renvoie uniquement les problèmes dont l'identifiant est supérieur ou égal à l'identifiant donné.
eventid_till string Renvoie uniquement les problèmes dont l'identifiant est inférieur ou égal à l'identifiant donné.
time_from timestamp Renvoie uniquement les problèmes créés après ou à l'heure indiquée.
time_till timestamp Renvoie uniquement les problèmes créés avant ou à l'heure indiquée.
selectAcknowledges query Renvoie les mises à jour du problème dans la propriété acknowledges. Les mises à jour des problèmes sont triées dans l'ordre chronologique inverse.

L'objet de mise à jour du problème a les propriétés suivantes :
acknowledgeid - (string) ID de la mise à jour ;
userid - (string) ID de l'utilisateur ayant mis à jour l’événement ;
eventid - (string) ID de l'événement mis à jour ;
clock - (timestamp) heure de mise à jour de l'événement ;
message - (string) test du message ;
action - (integer) action de mise à jour effectuée, voir event.acknowledge ;
old_severity - (integer) la sévérité de l'événement avant cette action de mise à jour ;
new_severity - (integer) la sévérité de l'événement après cette action de mise à jour ;

Supporte count.
selectTags query Renvoie les tags du problème. Format de sortie : [{"tag": "<tag>", "value": "<value>"}, ...].
selectSuppressionData query Renvoie la liste des maintenances dans la propriété suppression_data :
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 par les propriétés données.

Les valeurs possibles sont : eventid.
countOutput boolean Ces paramètres, communs à toutes les méthodes "get", sont décrits dans les commentaires 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 d'événements de problème de déclencheur

Récupérer 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",
                   "acknowledges": [
                       {
                           "acknowledgeid": "14443",
                           "userid": "1",
                           "eventid": "1245463",
                           "clock": "1472457281",
                           "message": "problem solved",
                           "action": "6",
                           "old_severity": "0",
                           "new_severity": "0"
                       }
                   ],
                   "tags": [
                       {
                           "tag": "test tag",
                           "value": "test value"
                       }
               ],
               "suppression_data": [
               {
                   "maintenanceid": "15",
                   "suppress_until": "1472511600"
                       }
                   ]
               }
           ],
           "id": 1
       }

Voir également

Source

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