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-ијевима корисника који су извршили акције ажурирања проблематичног догађаја .
symptom boolean true - враћа само потиснуте проблеме;
false - враћа проблеме у нормално стање.
symptom boolean true - враћа само догађаје проблема са симптомима;
false - врати само узрок проблема.
severities integer/array Врати само проблеме са датим озбиљностима догађаја. Примењује се само ако је објекат окидач.
evaltype integer Правила за претрагу ознака.

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

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

Објекат ажурирања проблема има следећа својства:
acknowledgeid - (ID) ID ажурирања;
кориснички id - (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.
selectSuppressionData query Врати својство suppression_data са листом активних одржавања и ручне супресије:
maintenanceid - (ID) ID одржавања;
userid - (ID) ID корисника који је потиснуо проблем;
suppress_until - (integer) време док проблем не буде потиснут.
filter object Врати само оне резултате који се тачно подударају са датим филтером.

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

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

Могуће вредности: eventid.
countOutput boolean Ови параметри који су заједнички за све методе get су детаљно описани на страници референтном коментару.
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.