5 Zabbixエージェント(Windows)

Installation

インストールは非常に簡単で、3つのステップで完了します:

ステップ 1

設定ファイルの作成

設定ファイルc:/zabbix_agentd.confを作成します(UNIXエージェントと同じ構文を使用)。

サンプルの設定ファイルは、Zabbixのソースアーカイブの中のmisc/confzabbix_agentd.win.confです。

ステップ 2

エージェントをWindowsサービスとしてインストール。

zabbix_agentd.exe --install

もしc:zabbix_agentd.conf以外の設定ファイルを使用する場合は、以下のコマンドを実行してサービスをインストールする必要があります。

zabbix_agentd.exe --config <your_configuration_file> --install

設定ファイルはフルパスで指定する必要があります。

ステップ 3

エージェントの実行。

Now you can use Control Panel to start agent's service or run: エージェントのサービスを開始するには、[コントロールパネル]を使用するか、または以下のコマンドを実行します。

zabbix_agentd.exe --start

Windows NT 4.0では、Zabbix_agentd.exeはPDH(Performance Data Helper) APIを使用して様々なシステム情報を収集するので、PDH.DLLが必要です。このDLLはWindows NT 4.0に標準で付属していないため、ダウンロードしてインストールする必要があります。Microsoft Knowledge Baseの記事番号284996に詳細とダウンロード先のリンクが記載されています。記事のURL: http://support.microsoft.com/default.aspx?scid=kb;en-us;284996

使用方法

コマンドラインの構文:

zabbix_agentd.exe [-Vhp] [-idsx] [-c <file>] [-t <metric>]

設定ファイル

ZABBIXのWindowsエージェントは、次のコマンドラインパラメータを受け付けます:

オプション:

  -c --config <file>   設定ファイルの指定 (デフォルトはc:\zabbix_agentd.conf)。
         -h --help            ヘルプ情報表示
         -V --version         バージョン番号表示
         -p --print           分かっているアイテムを表示して終了
         -t --test <item key> 一つのアイテムをテストして終了

Functions:

  -i --install   Zabbixエージェントをサービスに登録
         -d --uninstall Zabbixエージェントをサービスから削除
         -s --start     Zabbixエージェントサービス開始
         -x --stop      Zabbixエージェントサービス停止

zabbix_agentd.exeのパラメータは設定ファイル(c:/zabbix_agentd.conf)に含まれます。サポートされているパラメータ:

パラメータ必須	範囲	デフォルト値	説明
Alias	no			Sets an alias for parameter. It can be useful to substitute long and complex parameter name with a smaller and simpler one. For example, if you wish to retrieve paging file usage in percents from the server, you may use parameter "perf_counter[\Paging File(_Total)\% Usage]", or you may define an alias by adding the following line to configuration file Alias = pg_usage:perf_counter[\Paging File(_Total)\% Usage] After that you can use parameter name "pg_usage" to retrieve the same information. You can specify as many "Alias" records as you wish. Aliases cannot be used for parameters defined in "PerfCounter" configuration file records. Starting from version 1.8.6 Zabbix Agent will not start up in case incorrectly formatted Alias entry or duplicate Alias key is present in configuration file.
BufferSend	no	1-3600	5	バッファにN秒以上データを保持しません。
BufferSize	no	2-65535	100	Maximum number of values in a memory buffer. The agent will send all collected data to Zabbix server or Proxy if the buffer is full.
DebugLevel	no	0-4	3	デバッグレベルの指定 0 - ノー・デバッグ 1 - 致命的情報 2 - エラー情報 3 - 警告 4 - デバッグ用 (大量な情報が出力される)
DisableActive	no		0	アクティブチェック無効. エージェントはサーバからListenされる受動モードでで動作します。
DisablePassive	no		0	受動チェック無効。エージェントは、任意のTCPポートでListenしません。アクティブチェックのみ処理されます。 0 - 有効 1 - 無効
EnableRemoteCommands	no		0	Zabbixサーバからのリモートコマンド実行の許可。 0 - 無効 1 - 許可
Hostname	no		HostnameItemを設定大文	と小文字を区別したユニークなホスト名。アクティブチェックのために必要で、サーバ上の設定したホスト名と一致している必要があります。使用できる文字：英数字、、''、'_'と ' - '。 ' 最大長：64
HostnameItem	no		system.hostname	Hostnameが未定義の場合、この項目の値が設定されます。 UserParameters、パフォーマンスカウンタまたはエイリアスをサポートしていませんが、EnableRemoteCommandsの値にかかわらずsystem.run[]をサポートします。ホスト名が設定されている場合は無視されます。このオプションはバージョン1.8.6以降でサポートされています。
Include	no			設定ファイルに個々のファイルを含めることができます。
ListenIP	no		0.0.0.0	エージェントは、指定されたインターフェイス上でListenします。
ListenPort	no	1024-32767	10050	エージェントは、サーバからの接続をこのポートでListenします。
LogFileSize	no	0-1024	1	MB単位のログファイルの最大サイズ。 0 - 自動ログローテーションを行わない。
LogFile	no			ログファイル名。設定されていない場合は、Windowsイベントログを使用します。
LogRemoteCommands	no		0	Enable logging of executed shell commands as warnings. 0 - disabled 1 - enabled
MaxLinesPerSecond	no	1-1000	100	Maximum number of new lines the agent will send per second to Zabbix Server or Proxy processing 'log', 'logrt' and 'eventlog' active checks. The provided value will be overridden by the parameter 'maxlines', provided in 'log', 'logrt' or 'eventlog' item keys.
PerfCounter	no			Syntax: <parameter_name>,"<perf_counter_path>",<period> Defines new parameter <parameter_name> which is an average value for system performance counter <perf_counter_path> for the specified time period <period> (in seconds). For example, if you wish to receive average number of processor interrupts per second for last minute, you can define new parameter "interrupts" as following: PerfCounter = interrupts,"\Processor(0)\Interrupts/sec",60 Please note double quotes around performance counter path. Samples for calculating average value will be taken every second. You may run "typeperf -qx" to get list of all performance counters available in Windows. Starting from version 1.8.6 Zabbix Agent will not start up in case incorrectly formatted PerfCounter entry or duplicate PerfCounter key is present in configuration file.
RefreshActiveChecks	no	60-3600	120	How often list of active checks is refreshed, in seconds.
Server	yes			ZabbixのサーバのIPアドレス(またはホスト名)のカンマ区切りリスト。スペースは許可されません。 ServerActiveが指定されていない場合、最初のエントリのリストを受信し、アクティブチェックを送信するために使用されます。ホスト名がホスト名 - > IPアドレスとIPアドレス - >ホスト名の解決が必要なことに注意してください。 IPv6サポートが有効になっている場合はその後'127.0.0.1'、' ::127.0.0.1'、':: FFFF：127.0.0.1が'等価に扱われます。
ServerActive	no			List of comma delimited IP:port (or hostname:port) pairs of Zabbix servers for active checks. No spaces allowed. If ServerActive is specified, first host in the Server option is not used for active checks, only for passive checks. If the port is not specified, ServerPort port is used for that host. If ServerPort is not specified, default port is used. IPv6 addresses must be enclosed in square brackets if port for that host is specified. If port is not specified, square brackets for IPv6 addresses are optional. This option is supported in version 1.8.12 and higher.
ServerPort	no		10051	Server port for retrieving list of and sending active checks.
SourceIP	no			発信接続用の送信元IPアドレス。
StartAgents	no	1-100	3	Number of pre-forked instances of zabbix_agentd that process passive checks. The upper limit used to be 16 before version 1.8.5.
Timeout	no	1-30	3	Spend no more than Timeout seconds on processing
UnsafeUserParameters	no	0-1	0	ユーザ定義のパラメータ文字列ですべての文字を許可します。 0 - 無効 1 - 許可
UserParameter				監視するユーザ定義パラメータ。ユーザ定義パラメータは複数設定できます。フォーマット: UserParameter=<key>,<shell command> シェルコマンドが空の文字列またはEOLだけを返してはならないことに注意して下さい。例:UserParameter=system.test,echo 1 Starting from version 1.8.6 Zabbix Agent will not start up in case incorrectly formatted UserParameter entry or duplicate UserParameter key is present in configuration file.

Starting from version 1.8.6 Zabbix agent will not start up if invalid (not following parameter=value notation) or unknown parameter entry is present in configuration file.

Documentation