trigger.get

Descrizione

integer/array trigger.get(object parameters)

Il metodo consente di recuperare i trigger in base ai parametri specificati.

Questo metodo è disponibile per utenti di qualsiasi tipo. Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente. Per ulteriori informazioni, vedere User roles.

Parametri

(object) Parametri che definiscono l'output desiderato.

Il metodo supporta i seguenti parametri.

Parametro Type Descrizione
triggerids ID/array Restituisce solo i trigger con gli ID specificati.
groupids ID/array Restituisce solo i trigger che appartengono a host o template dei gruppi host o gruppi template specificati.
templateids ID/array Restituisce solo i trigger che appartengono ai template specificati.
hostids ID/array Restituisce solo i trigger che appartengono agli host specificati.
itemids ID/array Restituisce solo i trigger che contengono gli item specificati.
functions string/array Restituisce solo i trigger che utilizzano le funzioni specificate.

Fare riferimento alla pagina delle funzioni supportate per un elenco delle funzioni supportate.
group string Restituisce solo i trigger che appartengono a host o template del gruppo host o gruppo template con il nome specificato.
host string Restituisce solo i trigger che appartengono all'host con il nome tecnico specificato.
inherited boolean Se impostato su true, restituisce solo i trigger ereditati da un template.
templated boolean Se impostato su true, restituisce solo i trigger che appartengono ai template.
dependent boolean Se impostato su true, restituisce solo i trigger che hanno dipendenze. Se impostato su false, restituisce solo i trigger che non hanno dipendenze.
monitored flag Restituisce solo i trigger abilitati che appartengono a host monitorati e contengono solo item abilitati.
active flag Restituisce solo i trigger abilitati che appartengono a host monitorati.
maintenance boolean Se impostato su true, restituisce solo i trigger abilitati che appartengono a host in manutenzione.
withUnacknowledgedEvents flag Restituisce solo i trigger che hanno eventi non riconosciuti.
withAcknowledgedEvents flag Restituisce solo i trigger con tutti gli eventi riconosciuti.
withLastEventUnacknowledged flag Restituisce solo i trigger con l'ultimo evento non riconosciuto.
skipDependent flag Salta i trigger in stato di problema che dipendono da altri trigger. Si noti che gli altri trigger vengono ignorati se disabilitati, se hanno item disabilitati o host degli item disabilitati.
lastChangeSince timestamp Restituisce solo i trigger che hanno cambiato stato dopo il momento specificato.
lastChangeTill timestamp Restituisce solo i trigger che hanno cambiato stato prima del momento specificato.
only_true flag Restituisce solo i trigger che recentemente sono stati in stato di problema.
min_severity integer Restituisce solo i trigger con severità maggiore o uguale a quella specificata.
evaltype integer Metodo di valutazione dei tag.

Valori possibili:
0 - (predefinito) And/Or;
2 - Or.
tags array Restituisce solo i trigger con i tag specificati.
Formato: [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...].
Un array vuoto restituisce tutti i trigger.

Valori possibili di operator:
0 - (predefinito) Contiene;
1 - Uguale;
2 - Non contiene;
3 - Diverso da;
4 - Esiste;
5 - Non esiste.
expandComment flag Espande le macro nella descrizione del trigger.
expandDescription flag Espande le macro nel nome del trigger.
expandExpression flag Espande funzioni e macro nell'espressione del trigger.
selectHostGroups query Restituisce i gruppi host a cui appartiene il trigger nella proprietà hostgroups.
selectHosts query Restituisce gli host a cui appartiene il trigger nella proprietà hosts.
selectItems query Restituisce gli item contenuti nel trigger nella proprietà items.
selectFunctions query Restituisce le funzioni utilizzate nel trigger nella proprietà functions.

Gli oggetti funzione rappresentano le funzioni utilizzate nell'espressione del trigger e hanno le seguenti proprietà:
functionid - (ID) ID della funzione;
itemid - (ID) ID dell'item utilizzato nella funzione;
function - (string) nome della funzione;
parameter - (string) parametro passato alla funzione. Il parametro della query viene sostituito dal simbolo $ nella stringa restituita.
selectDependencies query Restituisce i trigger da cui dipende il trigger nella proprietà dependencies.
selectDiscoveryData query Restituisce una proprietà discoveryData con i dati dell'oggetto di discovery del trigger. L'oggetto di discovery del trigger collega un trigger rilevato a un prototipo di trigger da cui è stato rilevato.

Ha le seguenti proprietà:
parent_triggerid - (ID) ID del prototipo di trigger da cui è stato creato il trigger;
status - (int) stato della discovery del trigger:
0 - (predefinito) il trigger è rilevato,
1 - il trigger non è più rilevato;
ts_delete - (timestamp) momento in cui un trigger non più rilevato verrà eliminato;
ts_disable - (timestamp) momento in cui un trigger non più rilevato verrà disabilitato;
disable_source - (int) indicatore che specifica se il trigger è stato disabilitato da una regola LLD o manualmente:
0 - (predefinito) disabilitato automaticamente,
1 - disabilitato da una regola LLD.
selectDiscoveryRule query Restituisce la regola di low-level discovery che ha creato il trigger nella proprietà discoveryRule.
selectLastEvent query Restituisce l'ultimo evento significativo del trigger nella proprietà lastEvent.
selectTags query Restituisce i tag del trigger nella proprietà tags.
inheritedTags boolean Restituisce i trigger che hanno i tags specificati anche in template/host/template collegati.

Valori possibili:
true - template/host/template collegati devono avere anch'essi i tag specificati;
false - (predefinito) i tag di template/host/template collegati vengono ignorati.
selectInheritedTags query Restituisce una proprietà inheritedTags con i tag ereditati da template, template collegati e host, e dagli item referenziati nelle espressioni del trigger o di recovery.
selectTemplateGroups query Restituisce i gruppi template a cui appartiene il trigger nella proprietà templategroups.
filter object Restituisce solo i risultati che corrispondono esattamente al filtro specificato.

Accetta un oggetto in cui le chiavi sono nomi di proprietà e i valori sono un singolo valore oppure un array di valori da confrontare.

Non supporta proprietà del tipo di dato text.

Supporta proprietà aggiuntive:
host - nome tecnico dell'host a cui appartiene il trigger;
hostid - ID dell'host a cui appartiene il trigger.
limitSelects integer Limita il numero di record restituiti dalle sotto-selezioni.

Si applica alle seguenti sotto-selezioni:
selectHosts - i risultati saranno ordinati per host.
sortfield string/array Ordina il risultato in base alle proprietà specificate.

Valori possibili: triggerid, description, status, priority, lastchange, hostname.
countOutput boolean Questi parametri sono descritti nel commento di riferimento.
editable boolean
excludeSearch boolean
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean
selectTriggerDiscovery query Restituisce l'oggetto di discovery del trigger nella proprietà triggerDiscovery. Gli oggetti di discovery del trigger collegano il trigger a un prototipo di trigger da cui è stato creato.

Questa query è deprecata, utilizzare invece selectDiscoveryData.

Valori restituiti

(integer/array) Restituisce:

  • un array di oggetti;
  • il numero di oggetti recuperati, se è stato utilizzato il parametro countOutput.

Esempi

Recupero dei dati tramite ID del trigger

Recupera tutti i dati e le funzioni utilizzate nel trigger "14062".

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "trigger.get",
    "params": {
        "triggerids": "14062",
        "output": "extend",
        "selectFunctions": "extend"
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "triggerid": "14062",
            "expression": "{13513}<10m",
            "description": "{HOST.NAME} has been restarted (uptime < 10m)",
            "url": "",
            "status": "0",
            "value": "0",
            "priority": "2",
            "lastchange": "0",
            "comments": "The host uptime is less than 10 minutes",
            "error": "",
            "templateid": "10016",
            "type": "0",
            "state": "0",
            "flags": "0",
            "recovery_mode": "0",
            "recovery_expression": "",
            "correlation_mode": "0",
            "correlation_tag": "",
            "manual_close": "0",
            "opdata": "",
            "event_name": "",
            "uuid": "",
            "url_name": "",
            "functions": [
                {
                    "functionid": "13513",
                    "itemid": "24350",
                    "triggerid": "14062",
                    "parameter": "$",
                    "function": "last"
                }
            ]
        }
    ],
    "id": 1
}

Recupero dei trigger nello stato di problema

Recupera l'ID, il nome e la gravità di tutti i trigger nello stato di problema e li ordina per gravità in ordine decrescente.

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "trigger.get",
    "params": {
        "output": [
            "triggerid",
            "description",
            "priority"
        ],
        "filter": {
            "value": 1
        },
        "sortfield": "priority",
        "sortorder": "DESC"
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "triggerid": "13907",
            "description": "Zabbix self-monitoring processes < 100% busy",
            "priority": "4"
        },
        {
            "triggerid": "13824",
            "description": "Zabbix discoverer processes more than 75% busy",
            "priority": "3"
        }
    ],
    "id": 1
}

Recupero di uno specifico trigger con tag

Recupera uno specifico trigger con tag.

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "trigger.get",
    "params": {
        "output": [
            "triggerid",
            "description"
        ],
        "selectTags": "extend",
        "triggerids": [
            "17578"
        ]
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "triggerid": "17370",
            "description": "Service status",
            "tags": [
                {
                    "tag": "service",
                    "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}",
                    "automatic": "1"
                },
                {
                    "tag": "error",
                    "value": "",
                    "automatic": "1"
                }
            ]
        }
    ],
    "id": 1
}

Vedi anche

Fonte

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