[comment]: # ({48cd3524-48cd3524}) # problem.get [comment]: # ({/48cd3524-48cd3524}) [comment]: # ({c91e55ea-a18b2713}) ### Descripció `integer/array problem.get(object parameters)` El mètode recupera problemes en funció dels paràmetres donats. Aquest mètode ajuda a recuperar problemes no resolts. També és possible, si s'especifica, recuperar els problemes acabats de resoldre. El període que determina el període per "recentment" es defineix a *Administració* → *[General](/manual/web_interface/frontend_sections/administration/general#trigger-displaying-options)*. Els problemes resolts abans d'aquesta hora no es conserven a la taula de problemes. Per recuperar problemes resolts en el passat, empreu el mètode [`event.get`](/manual/api/reference/event/get). :::noteimportant Aquest mètode pot retornar problemes d'una entitat esborrada si el manteniment encara no ha esborrat aquests problemes. ::: :::noteclassic Aquest mètode és disponible per a tot tipus d'usuaris. Els permisos per invocar el mètode es poden revocar a la configuració del rol d'usuari. Consulteu els [rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles) per obtindre més informació. ::: [comment]: # ({/c91e55ea-a18b2713}) [comment]: # ({ec05f91b-98f39c6a}) ### Paràmetres `(object)` Paràmetres que defineixen la sortida esperada. El mètode admet els paràmetres següents. |Paràmetre|[Tipus](/manual/api/reference_commentary#data-types)|Descripció| |--|--|------| |eventids|ID/array|Retorna només problemes amb els ID donats.| |groupids|ID/array|Retorna només problemes creats per objectes que pertanyen als grups d'equips donats.| |hostids|ID/array|Retorna només problemes creats per objectes propietat dels equips donats.| |objectids|ID/array|Retorna només els problemes creats pels objectes donats.| |source|integer|Només retorna problemes amb el tipus donat.

Consulteu la [pàgina de l'objecte d'esdeveniment del problema](object#problem) per obtindre una llista dels tipus d'esdeveniments admesos.

Per defecte: 0 - problema creat per un trigger.| |object|integer|Només retorna problemes creats per objectes del tipus donat.

Consulteu la [pàgina d'objectes d'esdeveniment de problema](object#problema) per obtindre una llista dels tipus d'objectes admesos.

Per defecte: 0 - trigger.| |acknowledged|boolean|`true` - només retorna problemes reconeguts;
`false` - només problemes no reconeguts.| |action|integer|Retorna només problemes per als que les [accions d'actualització d'esdeveniments](/manual/api/reference/event/acknowledge#parameters) donada s'ha fet. Per accions múltiples, empreu una combinació de qualsevol valor acceptable de bitmaps com a bitmask (per exemple, 34 per reconèixer i esborrar un esdeveniment).| |action_userids|ID/array|Retorna només els problemes amb els IDs d'usuaris que han executat l'acció d'actualització d'esdeveniment problemàtic.| |suppressed|boolean|`true` - només retorna problemes esborrats;
`false` - retorna problemes en estat normal.| |symptom|boolean|`true` - només retorna esdeveniments de símptomes;
`false` - retorna només esdeveniments de causes.| |severities|integer/array|Retorna només problemes amb la gravetat dels esdeveniments determinada. S'aplica només si l'objecte és un trigger.| |evaltype|integer|[Mètode d'avaluació](/manual/web_interface/frontend_sections/monitoring/problems#using-filter) d'etiquetes.

Valors possibles:
0 - (per defecte) I/O;
2 - O.| |tags|matriu|Retorna només els esdeveniments amb les etiquetes donades. Coincidència exacta per etiqueta i cerca que distingeix entre majúscules i minúscules o no per valor d'etiqueta segons el valor de l'operador.
Format: `[{"etiqueta": "", "valor": "", "operador": ""}, ...]`.
Una matriu buida retorna tots els esdeveniments.

Tipus d'operador possibles:
0 - (per defecte) Conté (coincidència de subcadena, distingeix entre majúscules i minúscules);
1 - Igual a (distingeix entre majúscules i minúscules);
2 - No conté (coincidència de subcadena, distingeix entre majúscules i minúscules);
3 - No és igual a (distingeix entre majúscules i minúscules);
4 - Existeix;
5 - No existeix.| |recent|boolean|Si s'estableix a `true`, retornar problemes recents, inclosos els resolts dins de la [`ok_period`]/manual/api/reference/settings/object) i qualsevol problema no resolt.
Si s'estableix en `fals`, retorna només problemes no resolts.| |eventid\_from|string|Retorna només problemes amb ID superiors o iguals a l'ID donat.| |eventid\_till|string|Retorna només problemes amb ID inferiors o iguals a l'ID donat.| |time\_from|timestamp|Retorna només els problemes que es van crear després o en el moment donat.| |time\_till|timestamp|Retorna només els problemes que s'han creat abans o en el moment donat.| |selectAcknowledges|query|Retorna una propietat "acknowledges" amb actualitzacions de problemes. Les actualitzacions de problemes s'ordenen en ordre cronològic invers.

L'objecte d'actualització de problemes té les propietats següents:
`acknowledgeid` - `(cadena)` ID de l'actualització;
`identificador d'usuari` - `( string)` ID de l'usuari que ha actualitzat l'esdeveniment;
`eventid` - `(cadena)` ID de l'esdeveniment actualitzat;
`clock` - `(timestamp)` hora en què s'ha actualitzat l'esdeveniment;
`missatge` - `(cadena)` text del missatge;
`acció` - `(enter)`actualitza el tipus d'acció (vegeu [event.acknowledge](/manual/api/reference/event/acknowledge));< br>`old_severity`: gravetat de l'esdeveniment `(integer)` abans d'aquesta acció d'actualització;
`new_severity` - gravetat de l'esdeveniment `(integer)` després d'aquesta acció d'actualització;

Admet `count`.| |selectTags|query|Retorna una propietat [etiquetes](/manual/api/reference/problem/object#problem_tag) amb les etiquetes del problema. Format de sortida:`[{"tag": "", "value": ""}, ...]`.| |selectSuppressionData|query|Retorna una propietat `suppression_data` amb la llista de manteniments:
`maintenanceid` - `(cadena)` ID de manteniment;
`suppress_until` - `(integer)` temps fins que s'esborra el problema.| |filter|object|Retorna només aquells resultats que coincideixen exactament amb el filtre donat.

Accepta un objecte, on les claus són noms de la propietat, i els valors són bé un valor senzill o una taula de valors amb els que comparar.

No admet peropietats de [tipus d'informació](/manual/api/reference_commentary#data-types) `text`.| |sortfield|string/array|Ordena el resultat segons les propietats donades.

Els valors possibles són: `eventid`.| |countOutput|boolean|Aquests paràmetres es descriuen en detall a la pàgina [comentaris de referència](/manual/api/reference_commentary#common-get-method-parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| [comment]: # ({/ec05f91b-98f39c6a}) [comment]: # ({7223bab1-7223bab1}) ### Valors de retorn `(integer/array)` Retorna un d'entre: - una taula d'objectes; - el recompte d'objectes recuperats, si s'empra el paràmetre `countOutput`. [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Exemples [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({9d82627b-4d83529d}) #### Recuperar esdeveniments de problemes via trigger Recuperar els esdeveniments més propers del trigger "15112." [Petició](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "problem.get", "params": { "output": "extend", "selectAcknowledges": "extend", "selectTags": "extend", "selectSuppressionData": "extend", "objectids": "15112", "recent": true, "sortfield": ["eventid"], "sortorder": "DESC" }, "id": 1 } ``` Resposta: ```json { "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", "cause_eventid": "0", "opdata": "", "acknowledges": [ { "acknowledgeid": "14443", "userid": "1", "eventid": "1245463", "clock": "1472457281", "message": "problem solved", "action": "6", "old_severity": "0", "new_severity": "0", "suppress_until": "1472511600", "taskid": "0" } ], "suppression_data": [ { "maintenanceid": "15", "suppress_until": "1472511600", "userid": "0" } ], "suppressed": "1", "tags": [ { "tag": "test-tag", "value": "test-value" } ] } ], "id": 1 } ``` [comment]: # ({/9d82627b-4d83529d}) [comment]: # ({36151502-by}) #### Recuperar problemes reconeguts per un usuari concret Recupera els problemes reconeguts per l'usuari amb ID=10 [Petició](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "problem.get", "params": { "output": "extend", "action": 2, "action_userids": [10], "selectAcknowledges": ["userid", "action"], "sortfield": ["eventid"], "sortorder": "DESC" }, "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": [ { "eventid": "1248566", "source": "0", "object": "0", "objectid": "15142", "clock": "1472457242", "ns": "209442442", "r_eventid": "1245468", "r_clock": "1472457285", "r_ns": "125644870", "correlationid": "0", "userid": "10", "name": "Zabbix agent on localhost is unreachable for 5 minutes", "acknowledged": "1", "severity": "3", "cause_eventid": "0", "opdata": "", "acknowledges": [ { "userid": "10", "action": "2" } ], "suppressed": "0" } ], "id": 1 } ``` [comment]: # ({/36151502-by}) [comment]: # ({f5742bff-c6eb3ba0}) ### Veieu també - [Alerta](/manual/api/reference/alert/object) - [Element](/manual/api/reference/item/object) - [Equip](/manual/api/reference/host/object) - [Regla LLD](/manual/api/reference/discoveryrule/object#lld-rule) - [Trigger](/manual/api/reference/trigger/object) [comment]: # ({/f5742bff-c6eb3ba0}) [comment]: # ({15f9267d-15f9267d}) ### Font CEvent::get() in *ui/include/classes/api/services/CProblem.php*. [comment]: # ({/15f9267d-15f9267d})