インストールは非常に簡単で、3つのステップで完了します:
設定ファイルの作成
設定ファイルc:/zabbix_agentd.confを作成します(UNIXエージェントと同じ構文を使用)。
サンプルの設定ファイルは、Zabbixのソースアーカイブの中のmisc/confzabbix_agentd.win.confです。
エージェントをWindowsサービスとしてインストール。
もしc:zabbix_agentd.conf以外の設定ファイルを使用する場合は、以下のコマンドを実行してサービスをインストールする必要があります。
設定ファイルはフルパスで指定する必要があります。
エージェントの実行。
Now you can use Control Panel to start agent's service or run: エージェントのサービスを開始するには、[コントロール パネル]を使用するか、または以下のコマンドを実行します。
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の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.