Zabbix Documentation 2.4

3.04.04.45.0 (current)| In development:5.2 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

User Tools

Site Tools


manual:api:reference:item:object

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Previous revision
manual:api:reference:item:object [2013/10/18 10:55]
manual:api:reference:item:object [2018/12/17 09:59] (current)
martins-v 'hostid' clarified to include both hosts and templates
Line 1: Line 1:
 +===== > Item object =====
  
 +The following objects are directly related to the ''​item''​ API.
 +
 +==== Item ====
 +
 +<​note>​Web items cannot be directly created, updated or deleted via the Zabbix API.</​note>​
 +
 +The item object has the following properties.
 +
 +^  Property ​ ^  Type  ^  Description ​ ^
 +| itemid ​ | string ​ | //​(readonly)//​ ID of the item.  |
 +| **delay** \\ (required) | integer | Update interval of the item in seconds. |
 +| **hostid** \\ (required) | string | ID of the host or template that the item belongs to. |
 +| **interfaceid** \\ (required) | string ​ | ID of the item's host interface.\\ \\ Not required for template items. Optional for Zabbix agent (active), Zabbix internal, Zabbix trapper, Zabbix aggregate, database monitor and calculated items. |
 +| **key_** \\ (required) | string | Item key. |
 +| **name** \\ (required) | string | Name of the item. |
 +| **type** \\ (required) | integer | Type of the item. \\ \\ Possible values: \\ 0 - Zabbix agent; \\ 1 - SNMPv1 agent; \\ 2 - Zabbix trapper; \\ 3 - simple check; \\ 4 - SNMPv2 agent; \\ 5 - Zabbix internal; \\ 6 - SNMPv3 agent; \\ 7 - Zabbix agent (active); \\ 8 - Zabbix aggregate; \\ 9 - web item; \\ 10 - external check; \\ 11 - database monitor; \\ 12 - IPMI agent; \\ 13 - SSH agent; \\ 14 - TELNET agent; \\ 15 - calculated; \\ 16 - JMX agent; \\ 17 - SNMP trap. |
 +| **value_type** \\ (required) | integer | Type of information of the item. \\ \\ Possible values: \\ 0 - numeric float; \\ 1 - character; \\ 2 - log; \\ 3 - numeric unsigned; \\ 4 - text. |
 +| authtype | integer | SSH authentication method. Used only by SSH agent items. \\ \\ Possible values: \\ 0 - //​(default)//​ password; \\ 1 - public key. |
 +| data_type | integer | Data type of the item. \\ \\ Possible values: \\ 0 - //​(default)//​ decimal; \\ 1 - octal; \\ 2 - hexadecimal;​ \\ 3 - boolean. |
 +| delay_flex | string | Flexible intervals as a serialized string. \\ \\ Each serialized flexible interval consists of an update interval and a [[manual:​appendix:​time_period|time period]] separated by a forward slash. Multiple intervals are separated by a colon. |
 +| delta | integer | Value that will be stored. \\ \\ Possible values: \\ 0 - //​(default)//​ as is; \\ 1 - Delta, speed per second; \\ 2 - Delta, simple change. |
 +| description | string | Description of the item. |
 +| error | string | //​(readonly)//​ Error text if there are problems updating the item. |
 +| flags | integer | //​(readonly)//​ Origin of the item. \\ \\ Possible values: \\ 0 - a plain item; \\ 4 - a discovered item. |
 +| formula | integer/​float | Custom multiplier. \\ \\ Default: 1. |
 +| history | integer | Number of days to keep item's history data. \\ \\ Default: 90. |
 +| inventory_link | integer | ID of the host inventory field that is populated by the item. \\ \\ Refer to the [[manual:​api:​reference:​host:​object#​host_inventory|host inventory page]] for a list of supported host inventory fields and their IDs. \\ \\ Default: 0. |
 +| ipmi_sensor | string | IPMI sensor. Used only by IPMI items. |
 +| lastclock | timestamp | //​(readonly)//​ Time when the item was last updated. \\ \\ This property will only return a value for the period configured in [[manual:​web_interface:​definitions|ZBX_HISTORY_PERIOD]]. |
 +| lastns | integer | //​(readonly)//​ Nanoseconds when the item was last updated. \\ \\ This property will only return a value for the period configured in [[manual:​web_interface:​definitions|ZBX_HISTORY_PERIOD]]. |
 +| lastvalue | string | //​(readonly)//​ Last value of the item. \\ \\ This property will only return a value for the period configured in [[manual:​web_interface:​definitions|ZBX_HISTORY_PERIOD]]. |
 +| logtimefmt | string | Format of the time in log entries. Used only by log items. |
 +| mtime | timestamp | Time when the monitored log file was last updated. Used only by log items. |
 +| multiplier | integer | Whether to use a custom multiplier. |
 +| params | string | Additional parameters depending on the type of the item: \\ - executed script for SSH and Telnet items; \\ - SQL query for database monitor items; \\ - formula for calculated items. |
 +| password | string | Password for authentication. Used by simple check, SSH, Telnet, database monitor and JMX items. |
 +| port | string | Port monitored by the item. Used only by SNMP items. |
 +| prevvalue | string | //​(readonly)//​ Previous value of the item. \\ \\ This property will only return a value for the period configured in [[manual:​web_interface:​definitions|ZBX_HISTORY_PERIOD]]. |
 +| privatekey | string | Name of the private key file. |
 +| publickey | string | Name of the public key file. |
 +| snmp_community | string | SNMP community. Used only by SNMPv1 and SNMPv2 items. |
 +| snmp_oid | string | SNMP OID. |
 +| snmpv3_authpassphrase | string | SNMPv3 auth passphrase. Used only by SNMPv3 items. |
 +| snmpv3_authprotocol | integer | SNMPv3 authentication protocol. Used only by SNMPv3 items. \\ \\ Possible values: \\ 0 - //​(default)//​ MD5; \\ 1 - SHA. |
 +| snmpv3_contextname | string | SNMPv3 context name. Used only by SNMPv3 items. |
 +| snmpv3_privpassphrase | string | SNMPv3 priv passphrase. Used only by SNMPv3 items. ​ |
 +| snmpv3_privprotocol | integer | SNMPv3 privacy protocol. Used only by SNMPv3 items. \\ \\ Possible values: \\ 0 - //​(default)//​ DES; \\ 1 - AES. |
 +| snmpv3_securitylevel | integer | SNMPv3 security level. Used only by SNMPv3 items. \\ \\ Possible values: \\ 0 - noAuthNoPriv;​ \\ 1 - authNoPriv; \\ 2 - authPriv. |
 +| snmpv3_securityname | string | SNMPv3 security name. Used only by SNMPv3 items. |
 +| state | integer | //​(readonly)//​ State of the item. \\ \\ Possible values: \\ 0 - //​(default)//​ normal; \\ 1 - not supported. |
 +| status | integer | Status of the item. \\ \\ Possible values: \\ 0 - //​(default)//​ enabled item; \\ 1 - disabled item. |
 +| templateid | string | (readonly) ID of the parent template item.\\ \\ //Hint//: Use the ''​hostid''​ property to specify the template that the item belongs to. |
 +| trapper_hosts | string | Allowed hosts. Used only by trapper items. |
 +| trends | integer | Number of days to keep item's trends data. \\ \\ Default: 365. |
 +| units | string | Value units. |
 +| username | string | Username for authentication. Used by simple check, SSH, Telnet, database monitor and JMX items. \\ \\ Required by SSH and Telnet items. |
 +| valuemapid | string | ID of the associated value map. |