8 Internal checks
8.1 Overview
Internal checks allow the monitoring of internals of Zabbix. To use this item, choose the item type Zabbix internal.
Internal checks are calculated either by Zabbix server or by Zabbix proxy, depending on whether the host is monitored by a proxy or not.
8.2 Supported checks
| Key | |||||
|---|---|---|---|---|---|
| ▲ | Description | Return value | Comments | ||
| zabbix[boottime] | |||||
| Startup time of Zabbix server or Zabbix proxy process in seconds. | Seconds since the epoch. | ||||
| zabbix[history] | |||||
| Number of values stored in table HISTORY | Number of values. Integer. | Do not use if MySQL InnoDB, Oracle or PostgreSQL is used! (not supported by proxy) |
|||
| zabbix[history_log] | |||||
| Number of values stored in table HISTORY_LOG | Number of values. Integer. | Do not use if MySQL InnoDB, Oracle or PostgreSQL is used! This item is supported starting with Zabbix 1.8.3. (not supported by proxy) |
|||
| zabbix[history_str] | |||||
| Number of values stored in table HISTORY_STR | Number of values. Integer. | Do not use if MySQL InnoDB, Oracle or PostgreSQL is used! (not supported by proxy) |
|||
| zabbix[history_text] | |||||
| Number of values stored in table HISTORY_TEXT | Number of values. Integer. | Do not use if MySQL InnoDB, Oracle or PostgreSQL is used! This item is supported starting with Zabbix 1.8.3. (not supported by proxy) |
|||
| zabbix[history_uint] | |||||
| Number of values stored in table HISTORY_UINT | Number of values. Integer. | Do not use if MySQL InnoDB, Oracle or PostgreSQL is used! This item is supported starting with Zabbix 1.8.3. (not supported by proxy) |
|||
| zabbix[host,<type>,available] | |||||
| Returns availability of a particular type of checks on the host. Value of this item corresponds to availability icons in the host list. | 0 – not available, 1 – available, 2 – unknown. | Valid types are: agent, snmp, ipmi, jmx.
This item is supported starting with Zabbix 2.0.0. |
|||
| zabbix[hosts] | |||||
| Number of monitored hosts | Number of values. Integer. | This item is supported starting with Zabbix 2.2.0. | |||
| zabbix[items] | |||||
| Number of enabled items (supported and not supported) | Number of values. Integer. | ||||
| zabbix[items_unsupported] | |||||
| Number of not supported items | Number of values. Integer. | ||||
| zabbix[java,,<param>] | |||||
| Returns information associated with Zabbix Java gateway. | If <param> is ping, “1” is returned. Can be used to check Java gateway availability using nodata() trigger function.
If <param> is version, version of Java gateway is returned. Example: “2.0.0”. |
Second parameter must be empty and is reserved for future use.
This item is supported starting with Zabbix 2.0.0. |
|||
| zabbix[process,<type>,<mode>,<state>] | |||||
| Time a particular Zabbix process or a group of processes (identified by <type> and <mode>) spent in <state> in percentage. It is calculated for the last minute only.
If <mode> is Zabbix process number that is not running (for example, with 5 pollers running <mode> is specified to be 6), such an item will turn into unsupported state. |
Percentage of time. | The following process types are currently supported: alerter – process for sending notifications (not supported by proxy) configuration syncer – process for managing in-memory cache of configuration data data sender – proxy data sender (not supported by server) db watchdog – sender of a warning message in case DB is not available (not supported by proxy) discoverer – process for discovery of devices escalator – process for escalation of actions (not supported by proxy) heartbeat sender – proxy heartbeat sender (not supported by server) history syncer – history DB writer housekeeper – process for removal of old historical data http poller – web monitoring poller icmp pinger – poller for icmpping checks ipmi poller – poller for IPMI checks java poller – poller for Java checks node watcher – process for sending historical data and configuration changes between nodes (not supported by proxy) poller – normal poller for passive checks proxy poller – poller for passive proxies (not supported by proxy) self-monitoring – process for collecting internal server statistics timer – process for evaluation of time-related trigger functions and maintenances (not supported by proxy) trapper – trapper for active checks, traps, inter-node and -proxy communication unreachable poller – poller for unreachable devices vmware collector – VMware data collector responsible for data gathering from VMware services Note: You can also see these process types in a server log file. Valid modes are: Valid states are: Examples: This item is supported starting with Zabbix 1.8.5. |
|||
| zabbix[proxy,<name>,<param>] | |||||
| Access to Zabbix proxy related information. | Integer. | <name> – proxy name List of supported parameters (<param>): lastaccess – timestamp of last heart beat message received from proxy For example, zabbix[proxy,"Germany",lastaccess] fuzzytime() trigger function can be used to check availability of proxies. (not supported by proxy) |
|||
| zabbix[proxy_history] | |||||
| Number of values in proxy history table waiting to be sent to the server | Number of values. Integer. | This item is supported starting with Zabbix 2.2.0. (not supported by server) |
|||
| zabbix[queue,<from>,<to>] | |||||
| Number of monitored items in the Queue which are delayed by <from> to <to> seconds, inclusive. | Number of values. Integer. | <from> – default: 6 seconds <to> – default: infinity Time-unit symbols (s,m,h,d,w) are supported for these parameters. Parameters from and to are supported starting with Zabbix 1.8.3. |
|||
| zabbix[rcache,<cache>,<mode>] | |||||
| Availability statistics of Zabbix configuration cache. | Integer (for size); float (for percentage). | Cache: buffer Mode: total – total size of buffer free – size of free buffer pfree – percentage of free buffer used – size of used buffer |
|||
| zabbix[requiredperformance] | |||||
| Required performance of the Zabbix server or Zabbix proxy, in new values per second expected. | Float. | Approximately correlates with “Required server performance, new values per second” in Reports → Status of Zabbix. This item is supported starting with Zabbix 1.6.2. |
|||
| zabbix[trends] | |||||
| Number of values stored in table TRENDS | Number of values. Integer. | Do not use if MySQL InnoDB, Oracle or PostgreSQL is used! (not supported by proxy) |
|||
| zabbix[trends_uint] | |||||
| Number of values stored in table TRENDS_UINT | Number of values. Integer. | Do not use if MySQL InnoDB, Oracle or PostgreSQL is used! This item is supported starting with Zabbix 1.8.3. (not supported by proxy) |
|||
| zabbix[triggers] | |||||
| Number of active triggers in Zabbix database | Number of values. Integer. | (not supported by proxy) | |||
| zabbix[uptime] | |||||
| Uptime of Zabbix server or Zabbix proxy process in seconds. | Seconds. | ||||
| zabbix[vcache,buffer,<mode>] | |||||
| Availability statistics of Zabbix value cache. | Integer (for size); float (for percentage). | Mode: total – total size of buffer free – size of free buffer pfree – percentage of free buffer used – size of used buffer pused – percentage of used buffer This item is supported starting with Zabbix 2.2.0. |
|||
| zabbix[vcache,cache,<parameter>] | |||||
| Effectiveness statistics of Zabbix value cache. | Integer. | Parameter: requests – total number of requests hits – number of cache hits (history values taken from the cache) misses – number of cache misses (history values taken from the database) This item is supported starting with Zabbix 2.2.0. You may use this key with a Delta (speed per second) store value in order to get values per second statistics. |
|||
| zabbix[vmware,buffer,<mode>] | |||||
| Availability statistics of Zabbix vmware cache. | Integer (for size); float (for percentage). | Mode: total – total size of buffer free – size of free buffer pfree – percentage of free buffer used – size of used buffer pused – percentage of used buffer This item is supported starting with Zabbix 2.2.0. |
|||
| zabbix[wcache,<cache>,<mode>] | |||||
| Statistics and availability of Zabbix write cache. | |||||
| Cache | Mode | ||||
| values | all | Total number of values processed by Zabbix server or Zabbix proxy, except unsupported items. | Integer. | Counter. You may use this key with a Delta (speed per second) store value in order to get values per second statistics. |
|
| float | Number of processed float values. | Integer. | Counter. | ||
| uint | Number of processed unsigned integer values. | Integer. | Counter. | ||
| str | Number of processed character/string values. | Integer. | Counter. | ||
| log | Number of processed log items. | Integer. | Counter. | ||
| text | Number of processed text items. | Integer. | Counter. | ||
| not supported | Number of processed unsupported items. | Integer. | Counter. Not supported mode is supported starting with Zabbix 1.8.6. |
||
| history | pfree | Percentage of free history buffer. | Float. | History cache stores item and timestamp information for all item types as well as value for the numeric types. A low number indicates performance problems on the database side. | |
| free | Size of free history buffer. | Integer. | |||
| total | Total size of history buffer. | Integer. | |||
| used | Size of used history buffer. | Integer. | |||
| trend | pfree | Percentage of free trend cache. | Float. | Trend cache stores aggregate for the current hour for all items that receive data. (not supported by proxy) |
|
| free | Size of free trend buffer. | Integer. | (not supported by proxy) | ||
| total | Total size of trend buffer. | Integer. | (not supported by proxy) | ||
| used | Size of used trend buffer. | Integer. | (not supported by proxy) | ||
| text | pfree | Percentage of free text history buffer. | Float. | Text history cache is used for storing character, text or log history data – item and timestamp information for these values is still stored in the history cache. | |
| free | Size of free text history buffer. | Integer. | |||
| total | Total size of text history buffer. | Integer. | |||
| used | Size of used text history buffer. | Integer. | |||
Data source: Zabbix