item_get
Read-onlyIdempotent
Retrieve Zabbix items (metrics) by host, group, template, or search criteria to examine monitored data sources, collection intervals, and associated triggers.
Instructions
Get items (metrics) from Zabbix.
Items are the data sources in Zabbix - they define what metrics are collected and how (protocol, interval, etc.). Each item produces a stream of values over time.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of results to return. Default is 100. | |
| offset | No | Number of matching records to skip. Use with 'limit' to page through results; check 'has_more' and 'total' in the response. | |
| output | No | extend | |
| search | No | Dictionary with search criteria like {'name': 'CPU'} for substring matching. | |
| hostids | No | List of host IDs to get items from. Filters items by host. | |
| itemids | No | List of item IDs to get. If empty, returns all items. | |
| groupids | No | List of group IDs to get items from hosts in those groups. | |
| sortfield | No | Field to sort by. A deterministic sort is required for paging to be consistent. | itemid |
| sortorder | No | Sort direction - 'ASC' or 'DESC'. | ASC |
| select_tags | No | If true, include the tags for each item in the response (selectTags=extend). | |
| templateids | No | List of template IDs to get items from those templates. | |
| count_output | No | If true, returns only the count of matched objects as an integer. | |
| select_hosts | No | If true, include the hosts each item belongs to in the response (selectHosts=extend). | |
| filter_params | No | Additional filter parameters for advanced filtering. | |
| select_triggers | No | If true, include the triggers for each item in the response (selectTriggers=extend). | |
| item_key_contains | No | Shortcut to search for items by key (constructs search={'key_': item_key_contains}). | |
| item_name_contains | No | Shortcut to search for items by name (constructs search={'name': item_name_contains}). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||