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
       }

Source

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

Documentation