我的书签
添加书签
移除书签The method allows to retrieve items according to the given parameters. 此方法允许根据给定的参数获取监控项。
(object) Parameters defining the desired output. (object) 参数定义期望输出。
The method supports the following parameters. 此方法支持如下参数。
Finding items by key 根据key查找监控项
Retrieve all items from host with ID “10084” that have the word “system” in the key and sort them by name. 从ID为“10084”的主机获取key带有“system”的监控项，并以名称排序。
Request:
{"jsonrpc": "2.0","result": [{"itemid": "23298","type": "0","snmp_community": "","snmp_oid": "","hostid": "10084","name": "Context switches per second","key_": "system.cpu.switches","delay": "1m","history": "7d","trends": "365d","lastvalue": "2552","lastclock": "1351090998","prevvalue": "2641","state": "0","status": "0","value_type": "3","trapper_hosts": "","units": "sps","snmpv3_securityname": "","snmpv3_securitylevel": "0","snmpv3_authpassphrase": "","snmpv3_privpassphrase": "","snmpv3_authprotocol": "0","snmpv3_privprotocol": "0","snmpv3_contextname": "","error": "","lastlogsize": "0","logtimefmt": "","templateid": "22680","valuemapid": "0","params": "","ipmi_sensor": "","authtype": "0","username": "","password": "","publickey": "","privatekey": "","mtime": "0","lastns": "564054253","flags": "0","interfaceid": "1","port": "","description": "","inventory_link": "0","lifetime": "0s","evaltype": "0","jmx_endpoint": "","master_itemid": "0","timeout": "3s","url": "","query_fields": [],"posts": "","status_codes": "200","follow_redirects": "1","post_type": "0","http_proxy": "","headers": [],"retrieve_mode": "0","request_method": "1","output_format": "0","ssl_cert_file": "","ssl_key_file": "","ssl_key_password": "","verify_peer": "0","verify_host": "0","allow_traps": "0"},{"itemid": "23299","type": "0","snmp_community": "","snmp_oid": "","hostid": "10084","name": "CPU $2 time","key_": "system.cpu.util[,idle]","delay": "1m","history": "7d","trends": "365d","lastvalue": "86.031879","lastclock": "1351090999","prevvalue": "85.306944","state": "0","status": "0","value_type": "0","trapper_hosts": "","units": "%","snmpv3_securityname": "","snmpv3_securitylevel": "0","snmpv3_authpassphrase": "","snmpv3_privpassphrase": "","snmpv3_authprotocol": "0","snmpv3_privprotocol": "0","snmpv3_contextname": "","error": "","lastlogsize": "0","logtimefmt": "","templateid": "17354","valuemapid": "0","params": "","ipmi_sensor": "","authtype": "0","username": "","password": "","publickey": "","privatekey": "","mtime": "0","lastns": "564256864","flags": "0","interfaceid": "1","port": "","description": "The time the CPU has spent doing nothing.","inventory_link": "0","lifetime": "0s","evaltype": "0","jmx_endpoint": "","master_itemid": "0","timeout": "3s","url": "","query_fields": [],"posts": "","status_codes": "200","follow_redirects": "1","post_type": "0","http_proxy": "","headers": [],"retrieve_mode": "0","request_method": "1","output_format": "0","ssl_cert_file": "","ssl_key_file": "","ssl_key_password": "","verify_host": "0","allow_traps": "0"},{"type": "0","snmp_community": "","snmp_oid": "","hostid": "10084","name": "CPU $2 time","key_": "system.cpu.util[,interrupt]","history": "7d","trends": "365d","lastvalue": "0.008389","lastclock": "1351091000","prevvalue": "0.000000","state": "0","status": "0","value_type": "0","trapper_hosts": "","units": "%","snmpv3_securityname": "","snmpv3_securitylevel": "0","snmpv3_authpassphrase": "","snmpv3_privpassphrase": "","snmpv3_authprotocol": "0","snmpv3_privprotocol": "0","snmpv3_contextname": "","error": "","lastlogsize": "0","logtimefmt": "","templateid": "22671","valuemapid": "0","params": "","ipmi_sensor": "","authtype": "0","username": "","password": "","publickey": "","privatekey": "","mtime": "0","lastns": "564661387","flags": "0","interfaceid": "1","port": "","description": "The amount of time the CPU has been servicing hardware interrupts.","inventory_link": "0","lifetime": "0s","evaltype": "0","jmx_endpoint": "","master_itemid": "0","timeout": "3s","url": "","query_fields": [],"posts": "","status_codes": "200","follow_redirects": "1","post_type": "0","http_proxy": "","headers": [],"retrieve_mode": "0","request_method": "1","output_format": "0","ssl_cert_file": "","ssl_key_file": "","ssl_key_password": "","verify_peer": "0","verify_host": "0","allow_traps": "0"}],"id": 1}
Finding dependent items by key 根据key查找依赖监控项
Retrieve all dependent items from host with ID “10116” that have the word “apache” in the key. 从ID未“10116”的主机中获取key名包含“apache”的依赖监控项。
Request:
Response:
{"jsonrpc": "2.0","result": [{"itemid": "25550","type": "18","snmp_community": "","snmp_oid": "","hostid": "10116","name": "Days","key_": "apache.status.uptime.days","delay": "","history": "90d","trends": "365d","status": "0","value_type": "3","trapper_hosts": "","units": "","snmpv3_securityname": "","snmpv3_securitylevel": "0","snmpv3_authpassphrase": "","snmpv3_privpassphrase": "","formula": "","error": "","lastlogsize": "0","logtimefmt": "","templateid": "0","valuemapid": "0","params": "","ipmi_sensor": "","authtype": "0","username": "","password": "","publickey": "","privatekey": "","mtime": "0","flags": "0","interfaceid": "0","port": "","description": "","inventory_link": "0","lifetime": "30d","snmpv3_authprotocol": "0","snmpv3_privprotocol": "0","state": "0","snmpv3_contextname": "","evaltype": "0","master_itemid": "25545","jmx_endpoint": "","timeout": "3s","url": "","query_fields": [],"posts": "","status_codes": "200","follow_redirects": "1","post_type": "0","http_proxy": "","headers": [],"retrieve_mode": "0","request_method": "1","output_format": "0","ssl_cert_file": "","ssl_key_file": "","ssl_key_password": "","verify_peer": "0","verify_host": "0","allow_traps": "0","lastclock": "0","lastns": "0","lastvalue": "0","prevvalue": "0"},{"itemid": "25555","snmp_community": "","snmp_oid": "","hostid": "10116","name": "Hours","key_": "apache.status.uptime.hours","history": "90d","trends": "365d","status": "0","value_type": "3","trapper_hosts": "","units": "","snmpv3_securityname": "","snmpv3_securitylevel": "0","snmpv3_authpassphrase": "","snmpv3_privpassphrase": "","formula": "","error": "","lastlogsize": "0","logtimefmt": "","templateid": "0","valuemapid": "0","params": "","ipmi_sensor": "","authtype": "0","username": "","password": "","publickey": "","privatekey": "","mtime": "0","flags": "0","interfaceid": "0","port": "","description": "","inventory_link": "0","lifetime": "30d","snmpv3_authprotocol": "0","snmpv3_privprotocol": "0","state": "0","snmpv3_contextname": "","evaltype": "0","master_itemid": "25545","jmx_endpoint": "","timeout": "3s","url": "","query_fields": [],"posts": "","status_codes": "200","follow_redirects": "1","post_type": "0","http_proxy": "","headers": [],"retrieve_mode": "0","request_method": "1","output_format": "0","ssl_cert_file": "","ssl_key_file": "","ssl_key_password": "","verify_peer": "0","verify_host": "0","allow_traps": "0","lastclock": "0","lastns": "0","lastvalue": "0","prevvalue": "0"}],"id": 1}
Find HTTP agent item 查找HTTP agent 监控项
Find HTTP agent item with post body type XML for specific host id. 根据定义的主机id来查找带有XML post报文类型的监控项。
Request:
{"jsonrpc": "2.0","result": [{"itemid": "28252","type": "19","snmp_community": "","snmp_oid": "","hostid": "10255","name": "template item","key_": "ti","delay": "30s","history": "90d","trends": "365d","status": "0","value_type": "3","trapper_hosts": "","units": "","snmpv3_securityname": "","snmpv3_securitylevel": "0","snmpv3_authpassphrase": "","snmpv3_privpassphrase": "","formula": "","error": "","lastlogsize": "0","logtimefmt": "","templateid": "0","valuemapid": "0","params": "","ipmi_sensor": "","authtype": "0","username": "","password": "","publickey": "","privatekey": "","mtime": "0","flags": "0","interfaceid": "0","port": "","description": "","inventory_link": "0","lifetime": "30d","snmpv3_authprotocol": "0","snmpv3_privprotocol": "0","state": "0","snmpv3_contextname": "","evaltype": "0","jmx_endpoint": "","master_itemid": "0","timeout": "3s","url": "localhost","query_fields": [{"mode": "xml"}],"posts": "<body>\r\n<![CDATA[{$MACRO}<foo></bar>]]>\r\n</body>","status_codes": "200","follow_redirects": "0","post_type": "3","http_proxy": "","headers": [],"retrieve_mode": "1","request_method": "3","output_format": "0","ssl_cert_file": "","ssl_key_file": "","ssl_key_password": "","verify_peer": "0","verify_host": "0","allow_traps": "0","lastclock": "0","lastns": "0","lastvalue": "0","prevvalue": "0"}],"id": 3
CItem::get() in frontends/php/include/classes/api/services/CItem.php.
