触发器 - trigger.get - 《Zabbix 3.4 手册》

trigger.get

trigger.get

Description说明

integer/array trigger.get(object parameters)该方法用于指定的参数检索触发器.

Parameters参数

(object)定义所需输出的参数。

该方法提供以下参数.

参数	类型	说明
triggerids	string/array	只返回指定 ID 的触发器.
groupids	string/array	只返回指定主机组所属主机的触发器.
templateids	string/array	只返回指定模板的触发器.
hostids	string/array	只返回指定主机所属的触发器.
itemids	string/array	只返回指定监控项所属的触发器.
applicationids	string/array	只返回指定应用集包含监控项所属的触发器.
functions	string/array	只返回指定函数所属的触发器. 有关支持的功能列表，请参阅supported trigger functions页面
group	string	只返回指定名称的主机组中属于主机的触发器.
host	string	只返回指定名称的主机的触发器.

inherited	boolean	如果设置为“true”，则只返回从模板继承的触发器.
templated	boolean	如果设置为“true”，则只返回所属模板的触发器.
monitored	flag	只返回所属被监控主机启用触发器，且包含已启用的监控项.
active	flag	只返回所属被监控主机的已启用触发器.
maintenance	boolean	如果设置为“true”，则只返回所属维护中主机的已启用触发器.
withUnacknowledgedEvents	flag	只返回具有未确认事件的触发器.
withAcknowledgedEvents	flag	只返回所有事件确认的触发器.
withLastEventUnacknowledged	flag	只返回最后一个未确认事件的触发器.
skipDependent	flag	在依赖于其他触发器的问题状态中跳过触发器。请注意：如果禁用，禁用监控项或禁用主机监控项，其他触发器将被忽略
lastChangeSince	timestamp	只返回指定时间之后改变状态的触发器.
lastChangeTill	timestamp	只返回指定时间之前更改其状态的触发器.
onlytrue	flag	只返回最近处于问题状态的触发器.
min_severity	integer	只返回严重级别大于或等于给定严重性的触发器.

expandComment	flag	在触发器注释中扩展宏.
expandDescription	flag	以触发器的名称扩展宏.
expandExpression	flag	扩展触发器表达式中的函数和宏.
selectGroups	query	在`groups`属性中返回触发器所属的主机组.
selectHosts	query	在`hosts`属性中返回触发器所属的主机.
selectItems	query	在`items`属性中返回触发器所包含的监控项.
selectFunctions	query	Return functions used in the trigger in the `functions` property. 函数对象表示触发器表达式中使用的函数，并具有以下属性: `functionid` - (string) 函数的ID; `itemid` - (string) 函数中使用的监控项的ID;`function` - (string) 函数名称;`parameter` - (string)_ 参数传递给函数.
selectDependencies	query	返回触发器依赖于`dependencies`属性的触发器.
selectDiscoveryRule	query	返回创建触发器的低水平发现规则.
selectLastEvent	query	返回`lastEvent`属性中的最后一个重要触发事件.
selectTags	query	在“标签”属性中返回触发器标记.

filter	object	只返回与给定过滤器完全匹配的结果.接受一个数组，其中keys是属性名称，并且值是单个值或要匹配值的数组. 支持新增的过滤器: `host` - technical name of the host that the trigger belongs to触发器所属主机的技术性名称; `hostid` - ID of the host that the trigger belongs to触发器所属主机的ID.
limitSelects	integer	限制子选择返回的记录数. 适用于以下子选择: `selectHosts` - results will be sorted by `host`结果将按`host`分类.
sortfield	string/array	Sort the result by the given properties给定属性的结果.Possible values are可能的值为: `triggerid`, `description`, `status`, `priority`, `lastchange` and和 `hostname`.
countOutput	flag	These parameters being common for all `get` methods are described in detail in the reference commentary page这些参数对于所有的`get`方法是常见的，在 reference commentsary页面中有详细描述.
editable	boolean
excludeSearch	flag
limit	integer
output	query
preservekeys	flag
search	object
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	string/array
startSearch	flag

Return values

(integer/array) Returns either返回两者其中任一:

一组对象;
如果已经使用了“countOutput”参数，则检索对象的计数.

范例

从触发器ID中检索数据

检索触发器“14062”中使用的所有数据和功能.

请求:

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

响应:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "functions": [
                {
                    "functionid": "13513",
                    "itemid": "24350",
                    "function": "diff",
                    "parameter": "0"
                }
            ],
            "triggerid": "14062",
            "expression": "{13513}>0",
            "description": "/etc/passwd has been changed on {HOST.NAME}",
            "url": "",
            "status": "0",
            "value": "0",
            "priority": "2",
            "lastchange": "0",
            "comments": "",
            "error": "",
            "templateid": "10016",
            "type": "0",
            "state": "0",
            "flags": "0",
            "recovery_mode": "0",
            "recovery_expression": "",
            "correlation_mode": "0",
            "correlation_tag": "",
            "manual_close": "0"
        }
    ],
    "id": 1
}

在问题状态下检索触发器

检索在问题状态下的所有触发器的ID，名称和严重性，并按严重性级别按降序分类。.

请求:

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

响应:

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

使用标签检索特定触发器

使用标签检索特定触发器.

请求:

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

响应:

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

参考

来源

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