8 内部チェック

概要

内部チェックでは、Zabbixの内部処理を監視することができます。つまり、ZabbixサーバーやZabbixプロキシで何が行われているのかを監視することができます。

内部チェックを算出:

• Zabbixサーバーの場合 - ホストがサーバーによって監視されている場合
• Zabbixプロキシの場合 - ホストがプロキシによって監視されている場合

内部チェックは、ホストのメンテナンス状態に関係なく、サーバーまたはプロキシで処理されます。

このアイテムを使用するには、アイテムのZabbixインターナルタイプを選択してください。

パフォーマンス

いくつかの内部チェックアイテムを使用すると、パフォーマンスに悪影響を及ぼす可能性があります。そのアイテムは以下の通り:

• zabbix[host,,items]
• zabbix[host,,items_unsupported]
• zabbix[hosts]
• zabbix[items]
• zabbix[items_unsupported]
• zabbix[queue]
• zabbix[required_performance]
• zabbix[stats,,,queue]
• zabbix[triggers]

Webインターフェースのシステム情報 と キュー も影響を受けます。

サポートしている監視

アイテムキーの一覧にカスタマイズ可能なパラメータや追加情報の説明が記載されていません。。アイテムキーをクリックすると、詳細が表示されます。

アイテムキーの詳細

• 山括弧のないパラメータは必須であり、そのまま使用する必要があります。 (たとえば、zabbix[host,<type>,available] の "host" と "available")
• 山括弧 < > のあるパラメータは、有効な値に置き換える必要があります。パラメータにデフォルト値がある場合は省略できます。
• "プロキシでサポートされていません"というラベルの付いたアイテムとアイテムのパラメータ値は、ホストがサーバーによって監視されている場合にのみ取得できます。 逆に、"サーバーではサポートされていません"というアイテムの値はホストがプロキシによって監視されている場合にのみ取得できます。

zabbix[boottime]

ZabbixサーバーまたはZabbixプロキシのプロセスの起動時間(秒単位)
戻り値: 数値(整数)

zabbix[cluster,discovery,nodes]

Zabbix HAノードを検出します。
戻り値: JSONオブジェクト.

コメント:

• このアイテムはLLDで使用できます。

zabbix[connector_queue]

connectorキューに登録された値の数
戻り値: 数値(整数)

zabbix[discovery_queue]

discoveryキューに登録されたネットワーク・チェックの数
戻り値: 数値(整数)

zabbix[host,,items]

ホスト上で有効なアイテム(正常または取得不可のアイテム)の数
戻り値: 数値(整数).

zabbix[host,,items_unsupported]

ホスト上で有効な取得不可のアイテムの数
戻り値: 数値(整数)

zabbix[host,,maintenance]

ホストの現在のメンテナンス状態
Return values: 0 - 通常​​の状態 1 - データ収集ありのメンテナンス 2 - データ収集なしのメンテナンス

コメント:

• このアイテムは、ホストの場所 (サーバー上またはプロキシ上) に関係なく、常にZabbixサーバーによって処理されます。プロキシはこのアイテムの監視は行いません。
• 2番目のパラメータは空である必要があり、将来の使用のために予約されています。

zabbix[host,active_agent,available]

The availability of active agent checks on the host.
Return values: 0 - unknown; 1 - available; 2 - not available.

zabbix[host,discovery,interfaces]

Webインタフェースのホストに設定されているすべてのインターフェースの詳細
戻り値: JSONオブジェクト

コメント:

• このアイテムはLLDで使用できます。
• このアイテムはZabbixプロキシではサポートされていません。

zabbix[host,<type>,available]

ホスト上の特定タイプの監視のメインインターフェイスの可用性
戻り値: 0 - 利用不可 1 - 利用可能 2 - 不明

パラメータ:

• type - agent、snmp、ipmiまたはjmx

コメント:

• アイテムの値は、ホストのunreachability/unavailabilityに関する設定パラメータに従って計算されます。

zabbix[hosts]

The number of monitored hosts.
Return value: Integer.

zabbix[items]

The number of enabled items (supported and not supported).
Return value: Integer.

zabbix[items_unsupported]

The number of unsupported items.
Return value: Integer.

zabbix[java,,<param>]

Zabbix Java gatewayに関する情報
戻り値: 1 - <param>がpingの場合; Java gatewayバージョン - <param>がversionの場合(例: "7.0.0")

パラメータ:

• param - pingまたはversion.

コメント:

• このアイテムはトリガー関数nodata()を使用してJava gatewayの可用性を確認するために使用できます。
• 2番目のパラメータは空である必要があり、将来の使用のために予約されています。

zabbix[lld_queue]

LLDキューに登録された値の数
戻り値: 数値(整数)

コメント:

• このアイテムはLLDキューの長さを監視するために使用できます。

zabbix[preprocessing]

preprocessing managerによって受信された値の統計:
- queued - 保存前処理を必要とするキューに入れられた値の数とサイズ(カウンター)
- direct - 保存前処理を必要としないキューに入れられた値の数とサイズ(カウンター)
- queue - preprocessingキューに登録された値の数(zabbix[preprocessing_queue] と同じ)
戻り値: JSON

このアイテムはZabbix7.0.12以降でサポートされています。

戻り値の例:

{"data":
           {
           "queued": {
               "count": 106,
               "size": 58620
           },
           "direct": {
               "count": 395,
               "size": 33843
           },
           "queue": 0
           }
       }

zabbix[preprocessing_queue]

preprocessingキューに登録された値の数
戻り値: 数値(整数)

コメント:

• このアイテムはpreprocessingキューの長さを監視するために使用できます。

zabbix[process,<type>,<mode>,<state>]

特定のZabbixプロセスまたはプロセスグループ(<type>および<mode>で識別)が<state>で動作した時間の割合(パーセンテージ)。これは最後の1分間のみ計算されます。<type>の指定は必須です。
戻り値：数値(浮動小数)

パラメータ:

• type - サーバープロセスの場合: agent poller, alert manager, alert syncer, alerter, availability manager, browser poller, configuration syncer, configuration syncer worker, connector manager, connector worker, discovery manager, discovery worker, escalator, ha manager (since Zabbix 7.0.5), history poller, history syncer, housekeeper, http agent poller, http poller, icmp pinger, internal poller, ipmi manager, ipmi poller, java poller, lld manager, lld worker, odbc poller, poller, preprocessing manager, preprocessing worker, proxy group manager, proxy poller, self-monitoring, service manager, snmp poller, snmp trapper, task manager, timer, trapper, trigger housekeeper, unreachable poller, vmware collector;
  プロキシプロセス)の場合: agent poller, availability manager, browser poller, configuration syncer, data sender, discovery manager, discovery worker, history syncer, housekeeper, http agent poller, http poller, icmp pinger, internal poller, ipmi manager, ipmi poller, java poller, odbc poller, poller, preprocessing manager, preprocessing worker, self-monitoring, snmp poller, snmp trapper, task manager, trapper, unreachable poller, vmware collector;
• mode - avg - 指定されたタイプのすべてのプロセスの平均値（デフォルト）
  count - 指定されたプロセスタイプのフォーク数を返します。<state>は指定しないでください
  max - 最大値
  min - 最小値
  <プロセス番号> - プロセス番号(1からプリフォークされたインスタンスの数まで）例えば、4つのトラッパーが実行中の場合、値は1から4までになります。
• state - busy - プロセスはbusy状態です。たとえば、リクエストを処理しています。(デフォルト)
  idle - プロセスはidle状態です。何もしていません。

コメント:

• <mode>が実行していないZabbixプロセス番号である場合(たとえば、5つのpollerプロセスが実行中で、<mode>が6に指定されている場合)、アイテムは取得不可になります。
• 最小値と最大値は、単一プロセスの使用率を示します。したがって、3つのpollerプロセスのグループでプロセスあたりの使用率が 2、18、66だった場合、最小値は 2を返し、最大値は66を返します。
• プロセスは共有メモリに状態を登録し、self-monitoringプロセスは毎秒そのデータを集計します。状態の変更(bust/idle)は処理の切り替わり時に共有メモリを更新します。したがって、busyになったプロセスは共有メモリの状態がbusyとなり、idleになるまで状態は更新されません。これにより、完全にハングしたプロセスであっても、100% busyとして正しく集計されます。
• 現在"busy"は"スリープしていない"ことを意味しますが、将来的には、ロックの待機中、データベースクエリの実行中などの追加の状態が導入される可能性があります。 Zabbix7.0.6以降、非同期ポーラーは、MaxConcurrentChecksPerPollerserver/proxyパラメータで設定された制限に達した場合にbusyであるとみなされることに注意してください。
• Linux および他のほとんどのシステムでは、解析は1/100 秒です。

例:

zabbix[process,poller,avg,busy] #pollerプロセスが過去1分間に何らかの処理を行った時間の割合
       zabbix[process,"icmp pinger",max,busy] #過去1分間で ICMP pingerプロセスが何らかの処理を行った時間の割合
       zabbix[process,"history syncer",2,busy] #過去1分間で history syncer #2 が何らかの処理を行った時間の割合
       zabbix[process,trapper,count] #現在実行中のトラッパー プロセスの数

zabbix[proxy,<name>,<param>]

The information about Zabbix proxy.
Return value: Integer.

Parameters:

• name - the proxy name;
• param - delay - how long the collected values are unsent, calculated as "proxy delay" (difference between the current proxy time and the timestamp of the oldest unsent value on proxy) + ("current server time" - "proxy lastaccess").

zabbix[proxy,discovery]

The list of Zabbix proxies with name, mode, encryption, compression, version, last seen, host count, item count, required values per second (vps) and version status (current/outdated/unsupported).
Return value: JSON object.

zabbix[proxy group,<name>,available]

The number of online proxies in a proxy group.
Return value: Integer.

Parameters:

• name - the proxy group name.

zabbix[proxy group,<name>,pavailable]

The percentage of online proxies in a proxy group.
Return value: Float.

Parameters:

• name - the proxy group name.

zabbix[proxy group,<name>,proxies]

The list of Zabbix proxies in a proxy group with name, mode, encryption, compression, version, last seen, host count, item count, required values per second (vps), version status (current/outdated/unsupported), timeouts, proxy group name, state (unknown/offline/online).
Return value: JSON.

Parameters:

• name - the proxy group name.

zabbix[proxy group,<name>,state]

The state of a proxy group.
Return value: 0 - unknown; 1 - offline; 2 - recovering; 3 - online; 4 - degrading.

Parameters:

• name - the proxy group name.

zabbix[proxy group,discovery]

Returns a list of proxy groups with configuration data and real-time data. Configuration data include the proxy group name, failover delay, and the minimum number of online proxies required. Real-time data include the proxy group state (see comments for details), the number of online proxies, and the percentage of online proxies.
Return value: JSON.

Comments:

• This item does not return groupless proxies;
• If there is an invalid value for "failover_delay" or "min_online", then a special value -1 is reported to indicate that. Invalid values might occur if macros are used for configuration and the macros cannot be expanded to a valid value.
• The proxy group state is reported as an integer: 0 - unknown; 1 - offline; 2 - recovering; 3 - online; 4 - degrading;

Example of return values:

{
           "groups": [
              { "name": "Riga", "failover_delay": 60, "min_online": 1 },
              { "name": "Tokyo", "failover_delay": 60, "min_online": 2 },
              { "name": "Porto Alegre", "failover_delay": 60, "min_online": 3 }
           ],
           "details": {
               "Riga": { "state": 3, "available": 10, "pavailable": 20 },
               "Tokyo": { "state": 3, "available": 10, "pavailable": 20 },
               "Porto Alegre": { "state": 1, "available": 0, "pavailable": 0 }
           }
       }

zabbix[proxy_buffer,buffer,<mode>]

The proxy memory buffer usage statistics.
Return values: Integer (for size); Float (for percentage).

Parameters:

• mode:
  total - the total size of buffer (can be used to check if memory buffer is enabled)
  free - the size of free buffer
  pfree - the percentage of free buffer
  used - the size of used buffer
  pused - the percentage of used buffer

Comments: - Returns a 'Proxy memory buffer is disabled' error when the memory buffer is disabled;
- This item is not supported on Zabbix server.

zabbix[proxy_buffer,state,changes]

Returns the number of state changes between disk/memory buffer modes since start.
Return values: Integer; 0 - the memory buffer is disabled.

Comments:

• Frequent state changes indicate that either the memory buffer size or age must be increased;
• If the memory buffer state is monitored infrequently (for example, once a minute) then the buffer might flip its state without it being registered.

zabbix[proxy_buffer,state,current]

Returns the current working state where the new data are being stored.
Return values: 0 - disk; 1 - memory.

"0" is also returned when the memory buffer is disabled.

zabbix[proxy_history]

The number of values in the proxy history table waiting to be sent to the server.
Return values: Integer.

This item is not supported on Zabbix server.

zabbix[queue,<from>,<to>]

The number of monitored items in the queue which are delayed at least by <from> seconds, but less than <to> seconds.
Return value: Integer.

Parameters:

• from - default: 6 seconds;
• to - default: infinity.

Time-unit symbols (s,m,h,d,w) are supported in the parameters.

zabbix[rcache,<cache>,<mode>]

The availability statistics of the Zabbix configuration cache.
Return values: Integer (for size); Float (for percentage).

Parameters:

• cache - buffer;
• mode - total - the total size of buffer
  free - the size of free buffer
  pfree - the percentage of free buffer
  used - the size of used buffer
  pused - the percentage of used buffer

zabbix[requiredperformance]

The required performance of Zabbix server or Zabbix proxy, in new values per second expected.
Return value: Float.

Approximately correlates with "Required server performance, new values per second" in Reports → System information.

zabbix[stats,<ip>,<port>]

The internal metrics of a remote Zabbix server or proxy.
Return values: JSON object.

Parameters:

• ip - the IP/DNS/network mask list of servers/proxies to be remotely queried (default is 127.0.0.1);
• port - the port of server/proxy to be remotely queried (default is 10051).

Comments:

• The stats request will only be accepted from the addresses listed in the 'StatsAllowedIP' server/proxy parameter on the target instance;
• A selected set of internal metrics is returned by this item. For details, see Remote monitoring of Zabbix stats.

zabbix[stats,<ip>,<port>,queue,<from>,<to>]

The internal queue metrics (see zabbix[queue,<from>,<to>]) of a remote Zabbix server or proxy.
Return values: JSON object.

Parameters:

• ip - the IP/DNS/network mask list of servers/proxies to be remotely queried (default is 127.0.0.1);
• port - the port of server/proxy to be remotely queried (default is 10051);
• from - delayed by at least (default is 6 seconds);
• to - delayed by at most (default is infinity).

Comments:

• The stats request will only be accepted from the addresses listed in the 'StatsAllowedIP' server/proxy parameter on the target instance;
• A selected set of internal metrics is returned by this item. For details, see Remote monitoring of Zabbix stats.

zabbix[tcache,<cache>,<parameter>]

The effectiveness statistics of the Zabbix trend function cache.
Return values: Integer (for size); Float (for percentage).

Parameters:

• cache - buffer;
• mode - **all* - total cache requests (default)
  hits - cache hits
  phits - percentage of cache hits
  misses - cache misses
  pmisses - percentage of cache misses
  items - the number of cached items
  requests - the number of cached requests
  pitems - percentage of cached items from cached items + requests. Low percentage most likely means that the cache size can be reduced.

This item is not supported on Zabbix proxy.

zabbix[triggers]

The number of enabled triggers in Zabbix database, with all items enabled on enabled hosts.
Return value: Integer.

This item is not supported on Zabbix proxy.

zabbix[uptime]

The uptime of the Zabbix server or proxy process in seconds.
Return value: Integer.

zabbix[vcache,buffer,<mode>]

The availability statistics of the Zabbix value cache.
Return values: Integer (for size); Float (for percentage).

Parameter:

• mode - total - the total size of buffer
  free - the size of free buffer
  pfree - the percentage of free buffer
  used - the size of used buffer
  pused - the percentage of used buffer

This item is not supported on Zabbix proxy.

zabbix[vcache,cache,<parameter>]

The effectiveness statistics of the Zabbix value cache.
Return values: Integer. With the mode parameter returns: 0 - normal mode; 1 - low memory mode.

Parameters:

• parameter - requests - the total number of requests
  hits - the number of cache hits (history values taken from the cache)
  misses - the number of cache misses (history values taken from the database)
  mode - the value cache operating mode

Comments:

• Once the low-memory mode has been switched on, the value cache will remain in this state for 24 hours, even if the problem that triggered this mode is resolved sooner;
• You may use this key with the Change per second preprocessing step in order to get values-per-second statistics;
• This item is not supported on Zabbix proxy.

zabbix[version]

The version of Zabbix server or proxy.
Return value: String. For example: 6.0.0beta1.

zabbix[vmware,buffer,<mode>]

The availability statistics of the Zabbix vmware cache.
Return values: Integer (for size); Float (for percentage).

Parameters:

• mode - total - the total size of buffer
  free - the size of free buffer
  pfree - the percentage of free buffer
  used - the size of used buffer
  pused - the percentage of used buffer

zabbix[vps,written]

The total number of history values written to database.
Return value: Integer.

zabbix[wcache,<cache>,<mode>]

The statistics and availability of the Zabbix write cache.
Return values: Integer (for number/size); Float (for percentage).

Parameters:

• cache - values, history, index, or trend;
• mode - (with values) all (default) - the total number of values processed by Zabbix server/proxy, except unsupported items (counter)
  float - the number of processed float values (counter)
  uint - the number of processed unsigned integer values (counter)
  str - the number of processed character/string values (counter)
  log - the number of processed log values (counter)
  text - the number of processed text values (counter)
  not supported - the number of times item processing resulted in item becoming unsupported or keeping that state (counter)
  (with history, index, trend cache) pfree (default) - the percentage of free buffer
  total - the total size of buffer
  free - the size of free buffer
  used - the size of used buffer
  pused - the percentage of used buffer

Comments:

• Specifying <cache> is mandatory. The trend cache parameter is not supported with Zabbix proxy.
• The history cache is used to store item values. A low number indicates performance problems on the database side.
• The history index cache is used to index the values stored in the history cache;
• The trend cache stores the aggregate for the current hour for all items that receive data;
• You may use the zabbix[wcache,values] key with the Change per second preprocessing step in order to get values-per-second statistics.