8 内部チェック

概要

内部チェックは、Zabbixの内部プロセスを監視することを可能にします。言い換えれば、ZabbixサーバーやZabbixプロキシで何が起こっているかを監視できます。

内部チェックは以下のように計算されます:

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

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

このアイテムを使用するには、Zabbix内部アイテムタイプを選択します。

パフォーマンス

一部の内部アイテムはパフォーマンスに悪影響を及ぼす可能性があります。これらのアイテムは以下の通りです:

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

システム情報およびキューのフロントエンドセクションも影響を受けます。

サポートされているチェック

アイテムキーはカスタマイズ可能なパラメータや追加情報なしでリストされています。アイテムキーをクリックすると、詳細が表示されます。

アイテムキーの詳細

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

zabbix[boottime]

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

zabbix[cluster,discovery,nodes]

高可用性クラスタのノードを検出します。
戻り値: JSONオブジェクト。

コメント:

• このアイテムは、ローレベルディスカバリで使用できます。

zabbix[connector_queue]

コネクタキューにエンキューされた値の数。
戻り値: 整数。

zabbix[discovery_queue]

ディスカバリキューに入っているネットワークチェックの数。
戻り値: 整数。

zabbix[host,,items]

ホスト上で有効なアイテム数（サポートされているものとサポートされていないものの両方）。
戻り値: 整数。

zabbix[host,,items_unsupported]

ホストで有効なサポートされていないアイテムの数。
戻り値: 整数。

zabbix[host,,maintenance]

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

コメント:

• このアイテムは、ホストの場所（サーバーまたはプロキシ）に関係なく、常にZabbixサーバーによって処理されます。プロキシはこのアイテムを設定データとともに受信しません。
• 2番目のパラメータは空でなければならず、将来の使用のために予約されています。

zabbix[host,active_agent,available]

ホスト上のアクティブエージェントチェックの可用性。
戻り値: 0 - 不明; 1 - 利用可能; 2 - 利用不可。

zabbix[host,discovery,interfaces]

Zabbixフロントエンドで設定されたホストのすべてのインターフェースの詳細。
戻り値: JSONオブジェクト。

コメント:

• このアイテムはローレベルディスカバリで使用できます。
• このアイテムはZabbixプロキシではサポートされていません。

zabbix[host,<type>,available]

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

パラメータ:

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

コメント:

• アイテム値は、ホストの到達不能/利用不可に関する設定パラメータに従って計算されます。

zabbix[hosts]

監視対象ホストの数。
戻り値: 整数。

zabbix[items]

有効なアイテム数（サポートされているものとサポートされていないもの）。
戻り値: 整数。

zabbix[items_unsupported]

サポートされていないアイテムの数。
戻り値: 整数。

zabbix[java,,<param>]

Zabbix Javaゲートウェイに関する情報です。
戻り値: 1 - <param>がpingの場合; Javaゲートウェイのバージョン - <param>がversionの場合 (例: "8.0.0")。

パラメータ:

• param - pingまたはversion。

コメント:

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

zabbix[lld_queue]

低レベルディスカバリ処理キューにエンキューされた値の数。
戻り値: 整数。

コメント:

• このアイテムは、低レベルディスカバリ処理キューの長さを監視するために使用できます。

zabbix[preprocessing]

前処理マネージャーが受信した値の統計情報:
- queued - 前処理が必要なキューイングされた値の数とサイズ (カウンター)
- direct - 前処理が不要なキューイングされた値の数とサイズ (カウンター)
- queue - 前処理キューにキューイングされた値の数 (zabbix[preprocessing_queue]と同じ)
戻り値: JSON。

戻り値の例:

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

zabbix[preprocessing_queue]

前処理キューに入れられた値の数。
戻り値: 整数。

コメント:

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

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

特定のZabbixプロセスまたはプロセスグループ（<type>と<mode>で識別）が<state>で費やした時間の割合。直近1分間のみ計算されます。
戻り値：Float。

パラメータ:

• 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、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 - 最小値；
  <process number> - プロセス番号（1から事前フォークされたインスタンス数までの間；例えば、4つのtrapperが実行されている場合、値は1から4の間）；
• state - busy - プロセスがビジー状態、例えばリクエスト処理中（デフォルト）；
  idle - プロセスがアイドル状態で何もしていない。

コメント:

• <mode>が実行されていないZabbixプロセス番号の場合（例えば、5つのpollerが実行されているのに<mode>が6の場合）、そのアイテムはサポート対象外になります。
• 最小値と最大値は、単一プロセスの使用率を指します。したがって、3つのpollerグループで各プロセスの使用率が2、18、66だった場合、minは2、maxは66を返します。
• プロセスは共有メモリで自分の状態を報告し、self-monitoringプロセスがそのデータを毎秒集計します。状態の変化（busy/idle）は変化時に登録されます。したがって、プロセスがbusyになった場合、その状態として登録され、idleになるまで状態は変更または更新されません。これにより、完全にハングしたプロセスでも100% busyとして正しく登録されます。
• 現在、「busy」は「スリープしていない」ことを意味しますが、将来的には追加の状態（ロック待ち、データベースクエリの実行など）が導入される可能性があります。非同期pollerは、server/proxyのMaxConcurrentChecksPerPoller設定パラメータで設定された上限に達した場合、busyと見なされることに注意してください。
• Linuxおよびほとんどの他のシステムでは、分解能は1/100秒です。

例:

zabbix[process,poller,avg,busy] #直近1分間にpollerプロセスが何かをしていた平均時間
       zabbix[process,"icmp pinger",max,busy] #直近1分間に任意のICMP pingerプロセスが何かをしていた最大時間
       zabbix[process,"history syncer",2,busy] #直近1分間にhistory syncerの2番目が何かをしていた時間
       zabbix[process,trapper,count] #現在実行中のtrapperプロセスの数

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

Zabbixプロキシに関する情報。
戻り値: 整数。

パラメータ:

• name - プロキシ名
• param - lastaccess - プロキシから受信した最後のハートビートメッセージのタイムスタンプ
  delay - 収集された値が未送信のままになっている時間。計算式は「プロキシ遅延」+（「現在のサーバー時刻」-「プロキシのlastaccess」）で、「プロキシ遅延」はプロキシの現在時刻とプロキシ上の最も古い未送信値のタイムスタンプの差。

コメント:

• このアイテムは、ホストの場所（サーバーまたはプロキシ上）に関係なく、常にZabbixサーバーによって処理されます。
• プロキシの可用性を確認するために、fuzzytime()関数を使用できます。

例:

zabbix[proxy,"Germany",lastaccess] # "Germany"プロキシから受信した最後のハートビートメッセージのタイムスタンプ

zabbix[proxy,discovery]

名前、モード、暗号化、圧縮、バージョン、最終確認時刻、ホスト数、アイテム数、必要な値/秒（vps）、バージョンステータス（current/outdated/unsupported）、アイテムタイプごとのタイムアウト、プロキシグループ名（プロキシがグループに属している場合）、状態（unknown/offline/online）を含むZabbixプロキシのリスト。
戻り値：JSONオブジェクト。

zabbix[proxy group,<name>,available]

プロキシグループ内のオンラインプロキシの数。
戻り値: 整数。

パラメータ:

• name - プロキシグループ名。

zabbix[proxy group,<name>,pavailable]

プロキシグループ内のオンラインプロキシの割合。
戻り値: Float。

パラメータ:

• name - プロキシグループ名。

zabbix[proxy group,<name>,proxies]

名前、モード、暗号化、圧縮、バージョン、最終確認、ホスト数、アイテム数、必要な値/秒（vps）、バージョンステータス（current/outdated/unsupported）、タイムアウト、プロキシグループ名、状態（unknown/offline/online）を持つプロキシグループ内のZabbixプロキシのリスト。
戻り値：JSON。

パラメータ:

• name - プロキシグループ名。

zabbix[proxy group,<name>,state]

プロキシグループの状態。
戻り値: 0 - 不明; 1 - オフライン; 2 - 復旧中; 3 - オンライン; 4 - 劣化中。

パラメータ:

• name - プロキシグループ名。

zabbix[proxy group,discovery]

設定データとリアルタイムデータを持つプロキシグループのリストを返します。設定データには、プロキシグループ名、フェイルオーバー遅延、必要なオンラインプロキシの最小数が含まれます。リアルタイムデータには、プロキシグループの状態（詳細はコメント参照）、オンラインプロキシの数、オンラインプロキシの割合が含まれます。
戻り値：JSON。

コメント:

• このアイテムはグループに属さないプロキシは返しません。
• "failover_delay"または"min_online"に無効な値がある場合は、特別な値-1が報告されます。無効な値は、設定にマクロが使用されていて、そのマクロが有効な値に展開できない場合に発生することがあります。
• プロキシグループの状態は整数で報告されます：0 - 不明; 1 - オフライン; 2 - 復旧中; 3 - オンライン; 4 - 劣化中。

戻り値の例：

{
           "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>]

プロキシのメモリバッファ使用統計。
戻り値: Integer (サイズの場合); Float (パーセンテージの場合)。

パラメータ:

• mode: total - バッファの合計サイズ (メモリバッファが有効かどうかの確認に使用可能);
  free - 空きバッファのサイズ;
  pfree - 空きバッファのパーセンテージ;
  used - 使用済みバッファのサイズ;
  pused - 使用済みバッファのパーセンテージ。

コメント:

• メモリバッファが無効な場合は「Proxy memory buffer is disabled」エラーを返します;
  
• このアイテムはZabbixサーバーではサポートされていません。

zabbix[proxy_buffer,state,changes]

起動後、ディスク/メモリバッファモード間の状態変更回数を返します。
戻り値: 整数; 0 - メモリバッファが無効です。

コメント:

• 状態変更が頻繁に発生する場合は、メモリバッファのサイズまたは有効期間を増やす必要があります。
• メモリバッファの状態を監視する頻度が低い場合(例えば1分に1回)は、バッファが状態を切り替えても記録されないことがあります。

zabbix[proxy_buffer,state,current]

新しいデータが保存されている現在の作業状態を返します。
戻り値: 0 - ディスク; 1 - メモリ。

コメント:

• メモリバッファが無効な場合も "0" が返されます。

zabbix[proxy_history]

サーバーに送信されるのを待っているプロキシ履歴テーブル内の値の数。
戻り値: 整数。

コメント:

• このアイテムはZabbixサーバーではサポートされていません。

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

監視対象アイテムのうち、<from>秒以上、<to>秒未満遅延しているキュー内のアイテム数を返します。
戻り値: 整数。

パラメータ:

• from - 少なくともこの秒数だけ遅延している（デフォルトは6秒）;
• to - 最大でこの秒数だけ遅延している（デフォルトは無限大）。

コメント:

• パラメータには時間のサフィックス（s,m,h,d,w）が使用できます。

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

Zabbix設定キャッシュの可用性統計情報。
戻り値: サイズの場合は整数; パーセンテージの場合は浮動小数点数。

パラメータ:

• cache - buffer;
• mode - total - バッファの合計サイズ;
  free - 空きバッファのサイズ;
  pfree - 空きバッファのパーセンテージ;
  used - 使用済みバッファのサイズ;
  pused - 使用済みバッファのパーセンテージ。

zabbix[requiredperformance]

ZabbixサーバーまたはZabbixプロキシの必要なパフォーマンス（1秒あたりの新しい値の期待値）。
戻り値: Float。

コメント:

• レポート → システム情報 の「必要なサーバーパフォーマンス（1秒あたりの新しい値）」とほぼ相関します。

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

リモートのZabbixサーバーまたはプロキシの内部メトリクス。
戻り値: JSONオブジェクト。

パラメータ:

• ip - リモートでクエリを実行するサーバー/プロキシのIP/DNS/ネットワークマスクリスト（デフォルトは127.0.0.1）
• port - リモートでクエリを実行するサーバー/プロキシのポート（デフォルトは10051）

コメント:

• statsリクエストは、ターゲットインスタンスのserver/proxyパラメータの'StatsAllowedIP'にリストされているアドレスからのみ受け付けられます。
• このアイテムによって返されるのは、内部メトリクスの選択されたセットです。詳細はZabbix statsのリモート監視を参照してください。

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

リモートZabbixサーバーまたはプロキシの内部キューメトリクス（zabbix[queue,<from>,<to>]を参照）。
戻り値：JSONオブジェクト。

パラメータ:

• ip - リモートでクエリするサーバー/プロキシのIP/DNS/ネットワークマスクリスト（デフォルトは127.0.0.1）;
• port - リモートでクエリするサーバー/プロキシのポート（デフォルトは10051）;
• from - 少なくともこの秒数だけ遅延（デフォルトは6秒）;
• to - 最大でこの秒数だけ遅延（デフォルトは無限大）。

コメント:

• statsリクエストは、ターゲットインスタンスのserver/proxyパラメータの'StatsAllowedIP'にリストされているアドレスからのみ受け付けられます。
• このアイテムによって、選択された内部メトリクスのセットが返されます。詳細はZabbix statsのリモート監視を参照してください。

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

Zabbixトレンド関数キャッシュの有効性統計。
戻り値: Integer (サイズの場合); Float (パーセンテージの場合)。

パラメータ:

• cache - buffer;
• parameter - all - キャッシュリクエストの合計 (デフォルト);
  hits - キャッシュヒット数;
  phits - キャッシュヒットのパーセンテージ;
  misses - キャッシュミス数;
  pmisses - キャッシュミスのパーセンテージ;
  items - キャッシュされたアイテム数;
  requests - キャッシュされたリクエスト数;
  pitems - キャッシュされたアイテム数/(キャッシュされたアイテム数+リクエスト数)のパーセンテージ。パーセンテージが低い場合、キャッシュサイズを減らすことができます。

コメント:

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

zabbix[triggers]

有効なホスト上のすべてのアイテムが有効なZabbixデータベース内の有効なトリガーの数。
戻り値: 整数。

コメント:

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

zabbix[uptime]

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

zabbix[vcache,buffer,<mode>]

Zabbix値キャッシュの可用性統計情報。
戻り値: サイズの場合は整数; パーセンテージの場合は浮動小数点数。

パラメータ:

• mode - total - バッファの合計サイズ;
  free - 空きバッファのサイズ;
  pfree - 空きバッファのパーセンテージ;
  used - 使用済みバッファのサイズ;
  pused - 使用済みバッファのパーセンテージ。

コメント:

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

zabbix[vcache,cache,<parameter>]

Zabbix値キャッシュの有効性統計。
戻り値: 整数。modeパラメータを指定した場合の戻り値: 0 - 通常モード; 1 - 低メモリモード。

パラメータ:

• parameter - requests - リクエストの総数;
  hits - キャッシュヒット数（キャッシュから取得した履歴値）;
  misses - キャッシュミス数（データベースから取得した履歴値）;
  mode - 値キャッシュの動作モード。

コメント:

• 低メモリモードが有効になると、このモードを引き起こした問題が早期に解決しても、値キャッシュは24時間この状態を維持します。
• このキーは、秒間の変化の前処理ステップと組み合わせて、1秒あたりの統計値を取得するために使用できます。
• このアイテムはZabbixプロキシではサポートされていません。

zabbix[version]

Zabbixサーバーまたはプロキシのバージョン。
戻り値: 文字列。例: 8.0.0。

zabbix[vmware,buffer,<mode>]

Zabbix vmwareキャッシュの可用性統計情報。
戻り値：Integer（サイズの場合）；Float（パーセンテージの場合）。

パラメータ：

• mode - total - バッファの合計サイズ；
  free - 空きバッファのサイズ；
  pfree - 空きバッファのパーセンテージ；
  used - 使用済みバッファのサイズ；
  pused - 使用済みバッファのパーセンテージ。

zabbix[vps,written]

データベースに書き込まれた履歴値の合計数。
戻り値: 整数。

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

Zabbix書き込みキャッシュの統計と可用性。
戻り値: 整数（数値/サイズの場合）、浮動小数点数（パーセンテージの場合）。

パラメータ:

• cache - values、history、index、またはtrend;
• mode - （valuesの場合）all（デフォルト）- Zabbixサーバー/プロキシによって処理された値の合計数（未サポートアイテムを除く）（カウンタ）；
  float - 処理された浮動小数点値の数（カウンタ）；
  uint - 処理された符号なし整数値の数（カウンタ）；
  str - 処理された文字列値の数（カウンタ）；
  log - 処理されたログ値の数（カウンタ）；
  text - 処理されたテキスト値の数（カウンタ）；
  not supported - アイテム処理がアイテムを未サポート状態にした、またはその状態を維持した回数（カウンタ）；
  （history、index、trendキャッシュの場合）pfree（デフォルト）- 空きバッファのパーセンテージ；
  total - バッファの合計サイズ；
  free - 空きバッファのサイズ；
  used - 使用中バッファのサイズ；
  pused - 使用中バッファのパーセンテージ。

コメント:

• <cache>の指定は必須です。trendキャッシュパラメータはZabbixプロキシではサポートされていません。
• ヒストリキャッシュはアイテム値を保存するために使用されます。値が小さい場合は、データベース側のパフォーマンス問題を示します。
• ヒストリインデックスキャッシュは、ヒストリキャッシュに保存された値をインデックス化するために使用されます。
• ヒストリキャッシュが満杯になり、その後クリアされた場合でも、ヒストリインデックスキャッシュは一部のデータを保持し続けます。 この動作は想定されており、メモリサイズを常に変更するために必要な追加処理を回避することで、システムをより効率的に動作させます。
• トレンドキャッシュは、データを受信するすべてのアイテムの現在の1時間分の集計を保存します。
• zabbix[wcache,values]キーを1秒あたりの変化量の前処理ステップと組み合わせて使用することで、1秒あたりの値の統計を取得できます。