Zabbix Documentation 1.8

2.23.03.4In development:4.0Unsupported versions:1.82.02.43.2

User Tools

Site Tools

This translation is older than the original page and might be outdated. See what has changed.

Sidebar


Ask questions to Zabbix Dev Team in person at the Zabbix Summit 2018!
jp:manual:processes:zabbix_agentd_win

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.