Documentation
Table of Contents
trigger.get
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
integer/array trigger.get(object parameters)
El m¨¨tode permet recuperar triggers segons els par¨¤metres prove?ts.
Aquest m¨¨tode ¨¦s disponible per a usuaris de qualsevol mena. Els permisos per cridar al m¨¨tode es poden revocar a les configuracions de rols d'usuari. Per a m¨¦s informaci¨®, veieu Rols d'usuari.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ
(object) ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ definint la sortida esperada.
El m¨¨tode admet els par¨¤metres seg¨¹ents.
| ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| triggerids | ID/array | Retorna nom¨¦s triggers amb els identificadors donats. |
| groupids | ID/array | Retorna nom¨¦s triggers que pertanyen als equips dels grups d'equips donats. |
| templateids | ID/array | Retorna nom¨¦s triggers que pertanyen a les plantilles donades. |
| hostids | ID/array | Retorna nom¨¦s triggers que pertanyen als equips donats. |
| itemids | ID/array | Retorna nom¨¦s triggers que contenen els elements donats. |
| functions | string/array | Retorna nom¨¦s triggers que empren les funcions donades. Consulteu la p¨¤gina funcions de triggers admeses per obtindre una llista de funcions admeses. |
| group | string | Retorna nom¨¦s triggers que pertanyen als equips del grup d'equips amb el nom donat. |
| host | string | Retorna nom¨¦s triggers pertanyents a l'equip amb el nom t¨¨cnic donat. |
| inherited | boolean | Si es defineix com a true, nom¨¦s retorna triggers heretats d'una plantilla. |
| template | boolean | Si s'estableix a true, nom¨¦s retorna triggers que pertanyen a plantilles. |
| dependent | boolean | Si s'estableix a true, nom¨¦s retorna triggers que tenen depend¨¨ncies. Si s'estableix a fals', nom¨¦s retorna triggers que no tenen depend¨¨ncies.| |monitored|flag|Retorna nom¨¦s triggers activats que pertanyen als equips monitorats i que nom¨¦s contenen elements activats.| |active|flag|Retorna nom¨¦s triggers activats que pertanyen als equips monitorats.| |maintenance|boolean|Si s'estableix atrue, nom¨¦s retorna triggers activats que pertanyen als equips en manteniment.| |withUnacknowledgedEvents|flag|Retorna nom¨¦s triggers que tenen esdeveniments no reconeguts.| |withAcknowledgedEvents|flag|Retorna nom¨¦s triggers amb tots els esdeveniments reconeguts.| |withLastEventUnacknowledged|flag|Retorna nom¨¦s triggers amb el darrer esdeveniment no reconegut.| |skipDependent|flag|Omet els triggers en un estat problem¨¤tic que depenen d'altres triggers. Tingueu en compte que altres triggers s'ignoren si s¨®n desactivats, tenen elements desactivats o tenen equips d'elements desactivats.| |lastChangeSince|timestamp|Retorna nom¨¦s els triggers que han canviat d'estat despr¨¦s del temps d'espera.| |lastChangeTill|timestamp|Retorna nom¨¦s els triggers que han canviat d'estat abans de l'hora especificada.| |nom¨¦s\_true|flag|Retorna nom¨¦s els triggers que han tingut un problema recentment.| |min\_severity|enteger|Retorna nom¨¦s triggers amb una gravetat superior o igual a la gravetat donada.| |evaltype|integer|Regles per a la cerca d'etiquetes.[{"tag": "<etiqueta>", "valor": "< valor>", "operador". ": "<operador>"}, ...].functions.functionid-(ID)ID de la funci¨®;itemid-(ID)ID de l'element emprat a la funci¨®;function-(string)nom de la funci¨®; parameter-(string)par¨¤metre passat a la funci¨®. El par¨¤metre de consulta es substitueix pel s¨ªmbol$a la cadena retornada.| |selectDependencies|query|Retorna els triggers dels quals dep¨¨n el trigger a la propietatdependencies.| |selectDiscoveryRule|query|Retorna la [regla de descobriment de baix nivell](/manual/api/reference/discoveryrule/object#discovery_rule) que ha creat el trigger.| |selectLastEvent|query|Retorna el darrer esdeveniment de trigger significatiu a la propietat [lastEvent](/manual/api/reference/event/objecte).| |selectTags|query|Retorna les etiquetes de trigger a la propietat [etiquetes](/manual/api/reference/trigger/object#Trigger_tag).| |selectTemplateGroups|query|Retorna els grups de plantilles als quals pertany el trigger a la propietat [templategrups](/manual/api/reference/templategroup/object).| |selectTriggerDiscovery|query|Retorna l'objecte de descoberta del trigger a la propietattriggerDiscovery. Els objectes de descobriment del trigger emlla?en el trigger a un prototip de trigger a partir del qual s'ha creat.parent_triggerid-(cadena)ID del prototip de trigger des del qual s'ha creat el trigger.| |filter|object|Nom¨¦s retorna resultats que coincideixen exactament amb el filtre donat.host- nom t¨¨cnic de l'equip al qual pertany el trigger;hostid- ID de l'equip al qual pertany el trigger.| |limitSelects|integer|Limita el nombre de registres retornats per les subconsultes.selectHosts: els resultats s'ordenaran perhost.| |sortfield|string/array|[Ordena](/fr/manual/api/reference_commentary#Common_parameters_of_the_get_method) el resultat per les propietats donades.triggerid,description,status,priority,lastchangeihostname.| |countOutput|boolean|Aquests par¨¤metres es descriuen als [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|^| |selectGroupsselectHostGroupsoselectTemplateGroupsen el seu lloc.groups`. |
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.
Exemples
Recuperar informaci¨® per ID de trigger
Recupera tota la informaci¨® i les funcions que empra el trigger "14062".
{
"jsonrpc": "2.0",
"method": "trigger.get",
"params": {
"triggerids": "14062",
"output": "extend",
"selectFunctions": "extend"
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": [
{
"triggerid": "14062",
"expression": "{13513}<10m",
"description": "L'equip {HOST.NAME} s'ha hagut de reiniciar (temps d'activitat < 10m)",
"url": "",
"status": "0",
"value": "0",
"priority": "2",
"lastchange": "0",
"comments": "El temps d'activitat de l'equip ¨¦s inferior a 10 minuts",
"error": "",
"templateid": "10016",
"type": "0",
"state": "0",
"flags": "0",
"recovery_mode": "0",
"recovery_expression": "",
"correlation_mode": "0",
"correlation_tag": "",
"manual_close": "0",
"opdata": "",
"functions": [
{
"functionid": "13513",
"itemid": "24350",
"triggerid": "14062",
"parameter": "$",
"function": "last"
}
]
}
],
"id": 1
}Recuperar els triggers amb estat problem¨¤tic
Recupera l'ID, nom i gravetat de tots els triggers en estat problem¨¤tic, i ordenar-los per gravetat en ordre decreixent.
{
"jsonrpc": "2.0",
"method": "trigger.get",
"params": {
"output": [
"triggerid",
"description",
"priority"
],
"filter": {
"value": 1
},
"sortfield": "priority",
"sortorder": "DESC"
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": [
{
"triggerid": "13907",
"description": "Áú»¢¶Ä²© self-monitoring processes < 100% busy",
"priority": "4"
},
{
"triggerid": "13824",
"description": "Áú»¢¶Ä²© discoverer processes more than 75% busy",
"priority": "3"
}
],
"id": 1
}Recuperar un trigger espec¨ªfic amb etiquetes
Recuperar un trigger espec¨ªfic amb etiquetes.
{
"jsonrpc": "2.0",
"method": "trigger.get",
"params": {
"output": [
"triggerid",
"description"
],
"selectTags": "extend",
"triggerids": [
"17578"
]
},
"id": 1
}Resposta:
{
"jsonrpc": "2.0",
"result": [
{
"triggerid": "17370",
"description": "Service status",
"tags": [
{
"tag": "service",
"value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}"
},
{
"tag": "error",
"value": ""
}
]
}
],
"id": 1
}Veieu tamb¨¦
Font
CTrigger::get() in ui/include/classes/api/services/CTrigger.php.