problem.get

Опис

integer/array problem.get(object parameters)

Метода омогућава преузимање проблема према датим параметрима.

Овај метод је за проналажење нерешених проблема. Такође је могуће, ако је наведено, додатно повратити недавно решене проблеме. Период који одређује колико је година "недавно" дефинисан је у АдминистрацијаОпште. Проблеми који су решени пре тог периода се не чувају у табели проблема . Да бисте повратили проблеме који су решени раније у прошлости, користите метод event.get.

Овај метод може вратити проблеме брисања идентитета ако ове проблеме није уклонио домаћина.

Ова метода је доступна корисницима било ког типа. Дозволе за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте Улоге корисника за више информација.

Параметри

(object) Параметри који дефинишу жељени излаз.

Метод подржава следеће параметре.

Parameter Type Description
eventids ID/array Враћа само проблеме са датим ID-ијевима.
groupids ID/array Враћа само проблеме креиране од објеката који припадају датим групама домаћина.
hostids ID/array Враћа само проблеме креиране према објектима који припадају датим домаћинима.
objectids ID/array Враћа само проблеме креиране од датих објеката.
source integer Враћа само проблеме са датим типом.

Погледајте страница са објектом догађаја проблема за листу подржаних типова догађаја.

Подразумевано: 0 - проблем креиран окидачем.
object integer Враћа само проблеме креиране од објеката датог типа .

Погледајте страницу објекта догађаја проблема за листу подржаних типова објеката.

Подразумевано: 0 - окидач.
acknowledged boolean true - враћа само потврђене проблеме;
false - само непотврђено.
action integer Враћа само проблеме за које су дате акције ажурирања догађаја изведена. За више акција, користите збир свих прихватљивих битмап вредности као битмаску (на пример, 34 за потврду и сузбијање догађаја).
action_userids ID/array Враћа само проблеме са датим ID-ијевима корисника који су извршили акције ажурирања проблематичног догађаја .
suppressed boolean true - враћа само потиснуте проблеме;
false - враћа проблеме у нормалном стању.
symptom boolean true - враћа само догађаје проблема са симптомима;
false - враћа само узрок проблема.
severities integer/array Враћа само проблеме са датим озбиљностима догађаја. Примењује се само ако је објекат окидач.
evaltype integer Правила за претрагу ознака.

Могуће вредности:
0 - (подразумевано) И/Или;
2 - Или.
tags array Враћа само проблеме са датим ознакама. Тачно подударање по ознаци и претрага без обзира на велика и мала слова по вредности и оператору.
Формат: [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...].
Празан низ враћа све проблеме.

Могући типови оператора:
0 - (подразумевано) Као;
1 - Једнако;
2 - Није као;
3 - Није једнако
4 - Постоји;
5 - Не постоји.
recent boolean true - враћа ПРОБЛЕМ и недавно РЕШЕНЕ проблеме (зависи од окидача Приказа ОК за N секунди)
Подразумевано: false - само НЕРЕШЕНИ проблеми
eventid_from string Врати само проблеме са ID-ијевима који су већи или једнаки датом ID-ију.
eventid_till string Враћа само проблеме са ID-ијевима мањим или једнаким датом ID-ију.
time_from timestamp Враћа само проблеме који су креирани после или у датом тренутку.
time_till timestamp Враћа само проблеме који су креирани пре или у датом тренутку.
selectAcknowledges query Враћа својство acknowledges са ажурирањима проблема. Ажурирања проблема су сортирана у обрнутом хронолошком редоследу.

Објекат ажурирања проблема има следећа својства:
acknowledgeid - (ID) ID ажурирања;
userid - (ID) ID корисника који је ажурирао догађај;
eventid - (ID) ID ажурираног догађаја;
clock - (timestamp) време када је догађај ажуриран;
message - (string) текст поруке;
action - (integer)тип акције ажурирања (погледајте event.acknowledge);
old_severity - (integer) озбиљност догађаја пре ове акције ажурирања;
new_severity - (integer) озбиљност догађаја након ове акције ажурирања;
suppress_until - (timestamp) време до догађаја ће бити потиснуто;
taskid - (ID) ID задатка ако тренутни догађај пролази кроз промену ранга.

Подржава count.
selectTags query Враћа својство tags са ознакама проблема. Формат излаза: [{"tag": "<tag>", "value": "<value>"}, ...].
selectSuppressionData query Враћа својство suppression_data са листом активних одржавања и ручне супресије:
maintenanceid - (ID) ID одржавања;
userid - (ID) ID корисника који је потиснуо проблем;
suppress_until - (integer) време док проблем не буде потиснут.
filter object Враћа само оне резултате који се тачно подударају са датим филтером.

Прихвата објекат, где су кључеви имена својстава, а вредности су или једна вредност или низ вредности за подударање.

Не подржава својства text тип података.
sortfield string/array Сортира резултат према датим својствима.

Могуће вредности: eventid.
countOutput boolean Ови параметри који су описани у референтном коментару.
editable boolean
excludeSearch boolean
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Повратне вредности

(integer/array) Враћа било:

  • низ објеката;
  • број преузетих објеката, ако је параметар countOutput коришћен.

Примери

Преузимање проблема са окидачем

Преузми недавне догађаје са окидача „15112“.

Захтев:

{
            "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
       }

Одговор:

{
            "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
       }

Преузимање проблема које је потврдио одређени корисник

Преузимање проблема које је корисник потврдио са ID=10

Захтев:

{
            "jsonrpc": "2.0",
            "method": "problem.get",
            "params": {
            "output": "extend",
            "action": 2,
            "action_userids": [10],
            "selectAcknowledges": ["userid", "action"],
            "sortfield": ["eventid"],
            "sortorder": "DESC"
            },
            "id": 1
       }

Одговор:

{
            "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
       }

Види такође

Извор

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