5 Zabbix内部

概要

内部チェックを使用すると、Zabbix の内部プロセスを監視できます。 言い換えると、Zabbix サーバーまたは Zabbix プロキシで何が起きているかを監視できます。

内部チェックは次のように計算されます。

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

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

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

パフォーマンス

一部の内部アイテムを使用すると、パフォーマンスに悪影響を及ぼす可能性があります。 該当するアイテムは次のとおりです。

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

システム情報 および キュー の Webインターフェースセクションも影響を受けます。

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

アイテムキーは、カスタマイズ可能なパラメータおよび追加情報を省略して一覧表示されています。 アイテムキーをクリックすると、完全な詳細を確認できます。

アイテムキーの詳細

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

zabbix[boottime]

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

zabbix[cluster,discovery,nodes]

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

コメント:

• このアイテムはローレベルディスカバリで使用できます。
• 返されるフィールドは、主にHigh availability node objectのプロパティに対応しています。
• 追加フィールド:
  • db_timestamp — レスポンスに含まれる現在のサーバー時刻（Unixタイムスタンプ）
  • lastaccess_age — 最後のノードハートビートからの経過秒数（db_timestamp - lastaccess）
  • status — ノードの状態:
    • 0 — スタンバイ
    • 1 — 手動停止
    • 2 — 利用不可
    • 3 — アクティブ

戻り値の例:

[
  {
    "id": "ckvupihk70001z8mkpw5cg0u3",
    "name": "zabbix-prod-01",
    "status": 3,
    "address": "10.0.4.12:10051",
    "port": 10051,
    "lastaccess": 1756115995,
    "db_timestamp": 1756116000,
    "lastaccess_age": 5
  },
  {
    "id": "ckvx2a9k70004b1nq2hz9d7f",
    "name": "zabbix-standby-02",
    "status": 0,
    "address": "10.0.4.13:10051",
    "port": 10051,
    "lastaccess": 1756115550,
    "db_timestamp": 1756116000,
    "lastaccess_age": 450
  },
  {
    "id": "ckw0bq3l70007y4r1a0m5kz8",
    "name": "zabbix-backup-eu1",
    "status": 1,
    "address": "backup.example.com:10051",
    "port": 10051,
    "lastaccess": 1756105080,
    "db_timestamp": 1756116000,
    "lastaccess_age": 10920
  }
]

zabbix[connector_queue]

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

zabbix[discovery_queue]

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

zabbix[host,,items]

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

zabbix[host,,items_unsupported]

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

zabbix[host,,maintenance]

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

コメント:

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

zabbix[host,active_agent,available]

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

zabbix[host,discovery,interfaces]

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

コメント:

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

zabbix[host,<type>,available]

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

パラメーター:

• type - エージェント, snmp, ipmi, または jmx。

コメント:

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

zabbix[hosts]

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

zabbix[items]

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

zabbix[items_unsupported]

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

zabbix[java,,<param>]

Zabbix Javaゲートウェイに関する情報。
戻り値: 1 - <param> が ping の場合; Java gateway version - <param> が version の場合（例: "7.0.0"）。

パラメーター:

• param - ping または version。

コメント:

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

zabbix[lld_queue]

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

コメント:

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

zabbix[preprocessing]

preprocessing manager が受信した値の統計情報:

• queued - preprocessing が必要なキュー済み値の数とサイズ（カウンター）;
• direct - preprocessing を必要としないキュー済み値の数とサイズ（カウンター）;
• queue - preprocessing キューに入っている値の件数（zabbix[preprocessing_queue] と同じ）。

戻り値: JSON。

このアイテムは Zabbix 7.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 分間についてのみ計算されます。
戻り値: 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 (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 - 指定した type のすべてのプロセスの平均値（デフォルト）;
  • count - 指定したプロセス種別の fork 数を返します。<state> は指定しないでください;
  • max - 最大値;
  • min - 最小値;
  • <process number> - プロセス番号（1 から事前 fork されたインスタンス数まで。たとえば、4 個の trapper が稼働している場合、値は 1 から 4 の範囲になります）;
• state:
  • busy - プロセスが busy 状態、たとえばリクエストを処理中であることを示します（デフォルト）;
  • idle - プロセスが何もしていない idle 状態であることを示します。

コメント:

• <mode> が稼働していない Zabbix プロセス番号である場合（たとえば、5 個の poller が稼働しているときに <mode> に 6 を指定した場合）、そのアイテムは unsupported になります。
• 最小値と最大値は、単一プロセスの使用率を指します。
  したがって、3 個の poller グループで各プロセスの使用率が 2、18、66 だった場合、min は 2 を返し、max は 66 を返します。
• プロセスは共有メモリ上で自分の処理内容を報告し、self-monitoring プロセスがそのデータを毎秒集計します。
  状態の変更（busy/idle）は変更時に登録されます。そのため、busy になったプロセスはその時点で登録され、idle になるまで状態は変更・更新されません。
  これにより、完全にハングしたプロセスでも 100% busy として正しく登録されます。
• 現在のところ、"busy" は "not sleeping" を意味しますが、将来的にはロック待ち、データベースクエリの実行など、追加の状態が導入される可能性があります。
  Zabbix 7.0.6 以降では、非同期 poller は 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プロキシに関する情報。
戻り値: Integer。

パラメータ:

• name - プロキシ名;
• param:
  • lastaccess - プロキシから受信した最後のハートビートメッセージのタイムスタンプ;
  • delay - 収集された値が未送信のままになっている時間。これは "proxy delay" + ("current server time" - "proxy lastaccess") として計算されます。ここで "proxy delay" は、現在のプロキシ時刻と、プロキシ上で未送信の最も古い値のタイムスタンプとの差です。

コメント:

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

例:

zabbix[proxy,"Germany",lastaccess] #the timestamp of the last heartbeat message received from "Germany" proxy

zabbix[proxy,discovery]

Zabbixプロキシのリスト（名前、モード、暗号化、圧縮、バージョン、最終接続、ホスト数、アイテム数、1秒あたりの必要な値（VPS）、バージョンステータス（最新/旧バージョン/サポート対象外）、アイテムタイプごとのタイムアウト、プロキシグループ名（プロキシがグループに属している場合）、状態（不明/オフライン/オンライン））
戻り値：JSONオブジェクト

zabbix[プロキシグループ,<name>,available]

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

パラメーター:

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

zabbix[プロキシグループ,<name>,pavailable]

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

パラメーター:

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

zabbix[プロキシグループ,<名前>,プロキシ]

プロキシグループ内のZabbixプロキシのリスト。名前、モード、暗号化、圧縮、バージョン、最終接続、ホスト数、アイテム数、1秒あたりの必要な値（VPS）、バージョンステータス（最新/旧バージョン/サポート対象外）、タイムアウト、プロキシグループ名、状態（不明/オフライン/オンライン）が含まれます。
戻り値: JSON

パラメーター:

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

zabbix[プロキシグループ,<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]

起動以降のディスク/メモリバッファモード間の状態変化回数を返します。
戻り値: Integer; 0 - メモリバッファは無効です。

コメント:

• 頻繁に状態変化が発生する場合は、メモリバッファのサイズまたは経過時間を増やす必要があります。
• メモリバッファの状態が頻繁に監視されない場合（たとえば1分に1回）、バッファの状態が記録されずに切り替わる可能性があります。

zabbix[proxy_buffer,state,current]

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

コメント:

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

zabbix[proxy_history]

プロキシ履歴テーブル内でサーバーへの送信を待機している値の数
戻り値: Integer

コメント:

• この項目はZabbixサーバーではサポートされていません。

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

キュー内で監視されているアイテムのうち、<from> 秒以上遅延しているが、<to> 秒未満の遅延であるものの数。
戻り値: Integer。

パラメーター:

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

コメント:

• パラメーターでは Time suffixes (s,m,h,d,w) がサポートされています。

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

Zabbix設定キャッシュの使用可能状況統計。
戻り値: Integer (サイズの場合); Float (割合の場合)。

パラメーター:

• cache - buffer;
• mode:
  • total - bufferの合計サイズ;
  • free - 空きbufferのサイズ;
  • pfree - 空きbufferの割合;
  • used - 使用済みbufferのサイズ;
  • pused - 使用済みbufferの割合。

zabbix[requiredperformance]

ZabbixサーバーまたはZabbixプロキシに必要なパフォーマンスを、期待される1秒あたりの新規値の数で返します。
戻り値: Float。

コメント:

• Reports > System information の「Required server performance, new values per second」におおむね対応します。

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

Zabbix サーバーまたはプロキシの内部メトリクスを返します。<ip> と <port> が指定されている場合は、リモートインスタンスからメトリクスを取得します。指定されていない場合は、ローカルインスタンスから取得します。
戻り値: JSON object。

パラメータ:

• ip - リモートで問い合わせるサーバー/プロキシの IP/DNS/ネットワークマスクのリスト（デフォルトは 127.0.0.1）;
• port - リモートで問い合わせるサーバー/プロキシのポート（デフォルトは 10051）。

コメント:

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

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

Zabbix サーバーまたはプロキシの内部キューメトリクスを返します（zabbix[queue,<from>,<to>] を参照）。<ip> と <port> が指定されている場合、メトリクスはリモートインスタンスから取得されます。指定されていない場合は、ローカルインスタンスから取得されます。
戻り値: JSON object。

パラメータ:

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

コメント:

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

zabbix[tcache,cache,<parameter>]

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

パラメーター:

• parameter:
  • all - キャッシュ要求の合計 (デフォルト);
  • hits - キャッシュヒット数;
  • phits - キャッシュヒットの割合;
  • misses - キャッシュミス数;
  • pmisses - キャッシュミスの割合;
  • items - キャッシュされたアイテム数;
  • requests - キャッシュされたリクエスト数;
  • pitems - キャッシュされたアイテム数の割合 (キャッシュされたアイテム数 + リクエスト数に対する割合)。 割合が低い場合、キャッシュサイズを削減できる可能性が高いです。

コメント:

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

zabbix[triggers]

Zabbixデータベース内の有効なトリガーの数。有効なホスト上のすべての項目が有効になっています。
戻り値: Integer

コメント:

• この項目はZabbixプロキシではサポートされていません。

zabbix[uptime]

Zabbixサーバーまたはプロキシプロセスの稼働時間（秒）
戻り値: Integer

zabbix[vcache,buffer,<mode>]

Zabbix value cache の利用可能性統計。
戻り値: Integer (サイズの場合); Float (割合の場合)。

パラメータ:

• mode:
  • total - バッファの合計サイズ;
  • free - 空きバッファのサイズ;
  • pfree - 空きバッファの割合;
  • used - 使用済みバッファのサイズ;
  • pused - 使用済みバッファの割合。

コメント:

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

zabbix[vcache,cache,<parameter>]

Zabbix value cache の有効性統計です。
戻り値: Integer。 <parameter> が mode に設定されている場合、戻り値は次のとおりです: 0 - 通常モード; 1 - 低メモリモード。

パラメーター:

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

コメント:

• 低メモリモードが一度有効になると、そのモードを引き起こした障害がより早く解決された場合でも、value cache は 24 時間この状態のまま維持されます。
• 値/秒の統計を取得するために、このキーを Change per second の前処理ステップと組み合わせて使用できます。
• このアイテムは Zabbix プロキシではサポートされていません。

zabbix[version]

Zabbixサーバーまたはプロキシのバージョン。
戻り値: String。 例: 7.0.0。

zabbix[vmware,buffer,<mode>]

Zabbix vmwareキャッシュの可用性統計。
戻り値: Integer（サイズの場合）; Float（割合の場合）。

パラメーター:

• mode:
  • total - バッファーの総サイズ;
  • free - 空きバッファーのサイズ;
  • pfree - 空きバッファーの割合;
  • used - 使用済みバッファーのサイズ;
  • pused - 使用済みバッファーの割合。

zabbix[vps,written]

データベースに書き込まれた履歴値の総数
戻り値: Integer

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

Zabbix書き込みキャッシュの統計情報と可用性。
戻り値: Integer（数値/サイズの場合）; Float（割合の場合）。

パラメーター:

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

コメント:

• trend キャッシュパラメーターは Zabbix プロキシではサポートされていません。
• history キャッシュはアイテム値を保存するために使用されます。 低い値は、データベース側のパフォーマンス問題を示します。
• history index キャッシュは、history キャッシュに保存された値をインデックス化するために使用されます。
• history キャッシュがいっぱいになってからクリアされた後も、history index キャッシュには一部のデータが残ります。 この動作は想定どおりであり、メモリーのサイズ変更を頻繁に行うために必要な追加処理を避けることで、システムをより効率的に動作させるのに役立ちます。
• trend キャッシュは、データを受信するすべてのアイテムについて、現在の1時間分の集計値を保存します。
• 値/秒の統計情報を取得するには、前処理ステップ Change per second と組み合わせて zabbix[wcache,values] キーを使用できます。