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

Documentation