2 Windows Zabbixエージェント

概要

Windows Zabbixエージェントのアイテムは、2つのリストで表示されます。

• 共通アイテム - UNIX Zabbixエージェントと共通のアイテムキー
• Windows固有のアイテム - Windowsのみでサポートされているアイテムキー

Windows上のZabbixエージェントでサポートされているすべてのアイテムキーは、新世代のZabbixエージェント2でもサポートされていることに注意してください。 エージェント2でのみ使用できる追加のアイテムキーも参照してください。

参考: Windowsアイテムの最小権限

共有アイテム

以下の表は、Windows でサポートされ、UNIX Zabbix エージェントと共有される Zabbix エージェントのアイテムを示しています。

• アイテムキーは、UNIX Zabbix エージェントのアイテムの詳細情報へのリンクです
• Windows に関連するアイテムのコメントが含まれています

Windows固有のアイテム

この表は、Windows Zabbixエージェントでのみサポートされているアイテムキーの詳細を示しています。

Windows固有のアイテムは、同様のエージェントアイテムの概算的な対応物である場合があります。たとえば、Windowsでサポートされているproc_infoは、Windowsでサポートされていないproc.memアイテムに大まかに対応します。

アイテムキーは、完全なアイテムキーの詳細へのリンクです。

アイテムキーの詳細

山括弧のないパラメータは必須です。 山括弧 < > で囲まれたパラメータはオプションです。

eventlog[name,<regexp>,<severity>,<source>,<eventid>,<maxlines>,<mode>]

イベントログの監視。
戻り値: Log。

パラメータ:

• name - イベントログチャネルの名前（Event Viewer GUI での Log Name）;
  
• regexp - 必要なパターンを表す正規表現（大文字小文字を区別）;
  
• severity - 深刻度を表す正規表現（大文字小文字を区別しない）。 このパラメータは、次の値に基づく正規表現を受け付けます: "Information", "Warning", "Error", "Critical", "Verbose"（Windows Vista 以降で動作）。
  
• source - ソース識別子を表す正規表現（大文字小文字を区別しない）;
  
• eventid - イベント識別子を表す正規表現（大文字小文字を区別）;
  
• maxlines - エージェントが Zabbix サーバーまたはプロキシに送信する 1 秒あたりの新しい行の最大数。 このパラメータは zabbix_agentd.conf の MaxLinesPerSecond の値を上書きします。
  
• mode - 可能な値:
  • all（デフォルト）;
  • skip - 古いデータの処理をスキップします（新規作成されたアイテムにのみ影響します）。

コメント:

• アイテムは active check として設定する必要があります;
• エージェントは "Forwarded events" ログのイベントを送信できません;
• Windows Eventing 6.0 がサポートされています;
• このアイテムに対して Log 以外の type of information を選択すると、ローカルタイムスタンプに加えて、ログの深刻度とソース情報が失われます;
• log monitoring に関する追加情報も参照してください。

例:

eventlog[Application]
eventlog[Microsoft-Windows-Application-Experience/Program-Compatibility-Assistant]
eventlog[Security,,"Failure Audit",,^(529|680)$]
eventlog[System,,"Warning|Error"]
eventlog[System,,,,^1$]
eventlog[Windows PowerShell,,,,,,skip]
eventlog[System,,,,@TWOSHORT] #ここでは、`TWOSHORT` というカスタム正規表現が参照されています（*Result is TRUE* タイプとして定義されており、式自体は `^1$|^70$` です）。

eventlog.count[name,<regexp>,<severity>,<source>,<eventid>,<maxproclines>,<mode>]

Windows イベントログ内の行数をカウントします。
戻り値: Integer。

パラメータ:

• name - イベントログチャネルの名前（Event Viewer GUI の Log Name）;
  
• regexp - 必要なパターンを表す正規表現（大文字小文字を区別）;
  
• severity - 深刻度を表す正規表現（大文字小文字を区別しない）。 このパラメータは、次の値に基づく正規表現を受け付けます: "Information", "Warning", "Error", "Critical", "Verbose"（Windows Vista 以降で動作）;
  
• source - ソース識別子を表す正規表現（大文字小文字を区別しない）;
  
• eventid - イベント識別子を表す正規表現（複数可）（大文字小文字を区別）;
  
• maxproclines - エージェントが 1 秒あたりに解析する新しい行の最大数（10000 を超えることはできません）。 デフォルト値は zabbix_agentd.conf の 10*'MaxLinesPerSecond' です。
  
• mode - 指定可能な値:
  • all（デフォルト）;
  • skip - 古いデータの処理をスキップします（新しく作成されたアイテムにのみ影響します）。

コメント:

• このアイテムは アクティブチェック として設定する必要があります;
• エージェントは "Forwarded events" ログのイベントを送信できません;
• Windows Eventing 6.0 がサポートされています;
• このアイテムに対して Log 以外の 情報の種類 を選択すると、ローカルタイムスタンプに加えて、ログの深刻度とソース情報が失われます;
• ログ監視に関する追加情報も参照してください: log monitoring。

例:

eventlog.count[System,,"Warning|Error"]
eventlog.count[Windows PowerShell,,,,,,skip]

net.if.list

ネットワークインターフェースのリスト(インターフェースの種類、状態、IPv4アドレス、説明を含む)。
戻り値: テキスト。

コメント:

• マルチバイトのインターフェース名をサポート;
• 無効なインターフェースはリストされません;
• 一部のコンポーネントの有効化/無効化により、Windowsのインターフェース名の順序が変更される場合があります;
• 一部のWindowsバージョン(例: Server 2008)では、インターフェース名で非ASCII文字をサポートするために最新の更新プログラムが必要な場合があります。

perf_counter[counter,<interval>]

任意の Windows パフォーマンス カウンターの値。
戻り値: Integer、float、string または text（要求内容による）。

パラメーター:

• counter - カウンターへのパス。
  
• interval - 平均値を保存するための直近 N 秒。 interval は 1 から 900 秒（両端を含む）の範囲である必要があり、デフォルト値は 1 です。

コメント:

• このアイテムは UNC パスに従います。これは セキュリティリスク になる可能性があります。
• interval は、CPU 使用率のように複数回のサンプル取得を必要とするカウンターに使用されます。そのため、チェックは毎回、直近 "interval" 秒の平均値を返します。
• 利用可能なカウンターの一覧を取得するには、Performance Monitor を使用できます。
• 参照: Windows performance counters。

perf_counter_en[counter,<interval>]

英語表記の任意の Windows パフォーマンスカウンターの値。
戻り値: Integer、float、string または text (要求内容による)。

パラメーター:

• counter - カウンターへの英語表記のパス。
  
• interval - 平均値を保存するための直近 N 秒。 interval は 1 から 900 秒までの範囲内である必要があり、デフォルト値は 1 です。

コメント:

• このアイテムは UNC パスに従うため、セキュリティリスク となる可能性があります。
• interval は、CPU 使用率のように複数のサンプルを必要とするカウンターに使用され、チェックのたびに直近 "interval" 秒の平均値を返します。
• このアイテムは Windows Server 2008/Vista 以降でのみサポートされます。
• 英語文字列の一覧は、次のレジストリキーを参照することで確認できます: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009。

perf_instance.discovery[object]

Windowsパフォーマンスカウンターのオブジェクトインスタンスのリスト。
ローレベルディスカバリで使用されます。
戻り値: JSONオブジェクト。

パラメータ:

• object - オブジェクト名（ローカライズ済み）。

perf_instance_en.discovery[object]

英語のオブジェクト名を使用して検出されたWindowsパフォーマンスカウンターのオブジェクトインスタンスのリスト。 ローレベルディスカバリで使用されます。
戻り値：JSONオブジェクト。

パラメータ:

• object - オブジェクト名（英語）。

proc_info[process,<attribute>,<type>]

特定のプロセスに関するさまざまな情報。
戻り値: Float。

パラメータ:

• process - プロセス名;
  
• attribute - 要求するプロセス属性;
• type - 表現タイプ（同じ名前のプロセスが複数存在する場合に意味を持ちます）

コメント:

• 次の attributes がサポートされています:
  • vmsize - プロセスの仮想メモリサイズ（Kbytes、デフォルト）;
  • wkset - プロセスのワーキングセットサイズ（プロセスが使用している物理メモリ量、Kbytes）;
  • pf - ページフォールト数;
  • ktime - プロセスのカーネル時間（ミリ秒）;
  • utime - プロセスのユーザー時間（ミリ秒）;
  • io_read_b - I/O 操作中にプロセスが読み取ったバイト数;
  • io_read_op - プロセスが実行した読み取り操作数;
  • io_write_b - I/O 操作中にプロセスが書き込んだバイト数;
  • io_write_op - プロセスが実行した書き込み操作数;
  • io_other_b - 読み取りおよび書き込み以外の操作中にプロセスが転送したバイト数;
  • io_other_op - 読み取りおよび書き込み以外の、プロセスが実行した I/O 操作数;
  • gdiobj - プロセスが使用している GDI オブジェクト数;
  • userobj - プロセスが使用している USER オブジェクト数。
• 有効な types は次のとおりです:
  • avg - <process> という名前のすべてのプロセスの平均値（デフォルト）;
  • min - <process> という名前のすべてのプロセスの最小値;
  • max - <process> という名前のすべてのプロセスの最大値;
  • sum - <process> という名前のすべてのプロセスの値の合計。
• 64 ビットシステムでは、このアイテムを正しく動作させるには 64 ビット版の Zabbix エージェントが必要です。
  

例:

proc_info[iexplore.exe,wkset,sum] #すべての Internet Explorer プロセスが使用している物理メモリ量を取得
proc_info[iexplore.exe,pf,avg] #Internet Explorer プロセスのページフォールト数の平均を取得

registry.data[key,<value name>]

Windows レジストリの指定したキーにある、指定した値名のデータを返します。
戻り値: Integer, string または text (値の型による)

パラメーター:

• key - ルートキーを含むレジストリキー。ルートの省略形 (例: HKLM) を使用できます;
• value name - キー内のレジストリ値名 (既定では空文字列 "")。 値名が指定されていない場合は、既定値が返されます。

コメント:

• サポートされるルートの省略形:
  • HKCR - HKEY_CLASSES_ROOT
  • HKCC - HKEY_CURRENT_CONFIG
  • HKCU - HKEY_CURRENT_USER
  • HKCULS - HKEY_CURRENT_USER_LOCAL_SETTINGS
  • HKLM - HKEY_LOCAL_MACHINE
  • HKPD - HKEY_PERFORMANCE_DATA
  • HKPN - HKEY_PERFORMANCE_NLSTEXT
  • HKPT - HKEY_PERFORMANCE_TEXT
  • HKU - HKEY_USERS
• スペースを含むキーは二重引用符で囲む必要があります。

例:

registry.data["HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting"] #このキーの既定値のデータを返す
registry.data["HKLM\SOFTWARE\Microsoft\Windows\Windows Error Reporting","EnableZip"] #このキー内の "Enable Zip" という名前の値のデータを返す

registry.get[key,<mode>,<name regexp>]

指定されたキーにある Windows レジストリの値またはキーの一覧。
戻り値: JSON object。

パラメーター:

• key - ルートキーを含むレジストリキー。ルートの省略形（例: HKLM）も使用できます（省略形の完全な一覧については registry.data[] のコメントを参照してください）。
  
• mode - 指定可能な値:
  values（デフォルト）または keys;
  
• name regexp - 正規表現に一致する名前の値のみを検出します（デフォルト - すべての値を検出）。 mode が values の場合にのみ使用できます。

スペースを含むキーは二重引用符で囲む必要があります。

例:

registry.get[HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall,values,"^DisplayName|DisplayVersion$"] #このキー内で "DisplayName" または "DisplayValue" という名前の値のデータを返します。
JSON には、キー、最後のサブキー、値名、値の種類、および値データの詳細が含まれます。
registry.get[HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall,values] #このキー内のすべての値のデータを返します。
JSON には、キー、最後のサブキー、値名、値の種類、および値データの詳細が含まれます。
registry.get[HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall,keys] #このキーのすべてのサブキーを返します。
JSON には、キーと最後のサブキーの詳細が含まれます。

service.discovery

Windowsサービスのリスト。
ローレベルディスカバリで使用します。
戻り値: JSONオブジェクト。

service.info[service,<param>]

サービスに関する情報。
戻り値:

• Integer - param が state、startup の場合。
  state の場合は次のとおり:
  • 0 - 実行中
  • 1 - 一時停止中
  • 2 - 開始保留中
  • 3 - 一時停止保留中
  • 4 - 継続保留中
  • 5 - 停止保留中
  • 6 - 停止済み
  • 7 - 不明
  • 255 - 該当するサービスなし
    startup の場合は次のとおり:
  • 0 - 自動
  • 1 - 自動（遅延開始）
  • 2 - 手動
  • 3 - 無効
  • 4 - 不明
  • 5 - 自動トリガー開始
  • 6 - 自動（遅延）トリガー開始
  • 7 - 手動トリガー開始
• String - param が displayname、path、user の場合;
• Text - param が description の場合。

パラメータ:

• service - MMC の Services スナップインで表示される実際のサービス名、または表示名;
• param - state（デフォルト）、displayname、path、user、startup、または description。

コメント:

• service.info[service,state] と service.info[service] のようなアイテムは、同じ情報を返します;
• state の場合のみ、このアイテムは存在しないサービスに対する値（255）を返します。

例:

service.info[SNMPTRAP] - SNMPTRAP サービスの状態;
service.info[SNMP Trap] - 同じサービスの状態。ただし表示名を指定した場合;
service.info[EventLog,startup] - EventLog サービスの起動種類

services[<type>,<state>,<exclude>]

サービスの一覧。
戻り値: 0 - 空の場合; Text - サービスのリスト(改行で区切られる)。

パラメータ:

• type - all (デフォルト), automatic, manual, または disabled;
• state - all (デフォルト), stopped, started, start_pending, stop_pending, running, continue_pending, pause_pending, または paused;
• exclude - 結果から除外するサービス。 除外するサービスはダブルクォーテーションで囲み、カンマで区切り、スペースは入れません。

例:

services[,started] #起動しているサービスのリストを返します;
services[automatic, stopped] #起動しているべきなのに停止しているサービスのリストを返します;
services[automatic, stopped, "service1,service2,service3"] #起動しているべきなのに停止しているサービスのリストを返します。ただし、"service1"、"service2"、"service3"という名前のサービスは除外します

vm.vmemory.size[<type>]

バイト単位または合計からのパーセンテージでの仮想メモリサイズ。
戻り値: バイトの場合は整数、パーセンテージの場合は浮動小数点数。

パラメータ:

• type - 指定可能な値: available (利用可能な仮想メモリ), pavailable (利用可能な仮想メモリ、パーセンテージ), pused (使用中の仮想メモリ、パーセンテージ), total (合計仮想メモリ、デフォルト), used (使用中の仮想メモリ)

コメント:

• 仮想メモリ統計の監視は以下に基づきます:
  
  • Windows上の合計仮想メモリ(物理メモリ合計 + ページファイルサイズ);
    
  • Zabbixエージェントがコミットできる最大メモリ量;
    
  • システムまたはZabbixエージェントの現在のコミット済みメモリ制限(小さい方)。

例:

vm.vmemory.size[pavailable] #利用可能な仮想メモリをパーセンテージで返す

wmi.get[<namespace>,<query>]

WMIクエリを実行し、最初に選択されたオブジェクトを返します。
戻り値: 整数、浮動小数点数、文字列またはテキスト（リクエストによる）。

パラメータ:

• namespace - WMI名前空間;
  
• query - 単一オブジェクトを返すWMIクエリ。

WMIクエリはWQLで実行されます。

例:

wmi.get[root\cimv2,select status from Win32_DiskDrive where Name like '%PHYSICALDRIVE0%'] #最初の物理ディスクのステータスを返す

wmi.getall[<namespace>,<query>]

WMIクエリを実行し、応答全体を返します。 ローレベルディスカバリで使用できます。
戻り値: JSON object

パラメータ:

• namespace - WMI名前空間。
  
• query - WMIクエリ。

コメント:

• WMIクエリは WQL を使用して実行されます。
• 返されたJSON内のより具体的な値を指定するために、JSONPathの前処理を使用できます。

例:

wmi.getall[root\cimv2,select * from Win32_DiskDrive where Name like '%PHYSICALDRIVE%'] #returns status information of physical disks

Windowsサービスの監視

このチュートリアルでは、Windowsサービスの監視を設定する手順を説明します。 Zabbixサーバーとエージェントが設定され、稼働していることを前提としています。

ステップ 1

サービス名を取得します。

MMC の Services スナップインを開き、対象サービスのプロパティを表示すると、サービス名を確認できます。
General タブに、Service name という項目があります。
その後に表示される値が、監視用のアイテムを設定するときに使用する名前です。
たとえば、"workstation" サービスを監視したい場合、サービス名は lanmanworkstation になります。

ステップ2

サービスの監視のためにアイテムを設定します。

アイテム service.info[service,<param>] は、特定のサービスに関する情報を取得します。 必要な情報に応じて、param オプションを指定します。param には displayname、state、path、user、startup、description のいずれかの値を指定できます。 param を指定しない場合（service.info[service]）、デフォルト値は state です。

返される値の型は、選択した param によって異なります。state および startup の場合は整数、displayname、path、user の場合は文字列、description の場合はテキストです。

例:

• キー: service.info[lanmanworkstation]
• 情報の型: 数値（整数）

アイテム service.info[lanmanworkstation] は、サービスの状態を数値として取得します。 フロントエンドで数値をテキスト表現にマッピングするには（例: "0" を "Running"、"1" を "Paused" など）、アイテムが設定されているホストで値のマッピングを設定できます。 これを行うには、Windows services by Zabbix agent または Windows services by Zabbix agent active テンプレートをホストにリンクするか、または該当テンプレートで設定されている Windows service state の値のマッピングを基に、ホストで新しい値のマッピングを設定します。

なお、上記の両テンプレートには、サービスを自動的に検出するディスカバリルールが設定されています。 これを望まない場合は、テンプレートをホストにリンクした後、ホストレベルでディスカバリルールを無効化できます。

Windowsサービスのディスカバリ

ローレベルディスカバリは、コンピュータ上のさまざまなエンティティのアイテム、トリガー、グラフを自動的に作成する方法を提供します。 Zabbixは、サービスの正確な名前を知る必要や、各サービスごとに手動でアイテムを作成することなく、マシン上のWindowsサービスの監視を自動的に開始できます。 フィルタを使用して、関心のあるサービスのみの実際のアイテム、トリガー、グラフを生成することができます。