conf/zabbix_agentd.conf を、zabbix_agentd.exe がインストールされるディレクトリに手動でコピーする
conf/zabbix_agent2.conf と conf/zabbix_agent2.d ディレクトリを、zabbix_agent2.exe がインストールされるディレクトリに手動でコピーする

Zabbix Windowsエージェントの設定方法の詳細については、設定ファイルのオプションを参照してください。

Hostname パラメーター

ホストで active checks を実行するには、Zabbix エージェントにホスト名が定義されている必要があります。さらに、エージェント側で設定されたホスト名の値は、Webインターフェースでホストに設定されている "Host name" と完全に一致している必要があります。

エージェント側のホスト名の値は、エージェントの configuration file 内の Hostname または HostnameItem パラメーターのいずれかで定義できます。これらのパラメーターが指定されていない場合は、デフォルト値が使用されます。

HostnameItem パラメーターのデフォルト値は、"system.hostname" エージェントキーが返す値です。Windows では、gethostname() 関数の結果が返されます。この関数は、名前空間プロバイダーに問い合わせてローカルホスト名を判定します。名前空間プロバイダーが応答しない場合は、NetBIOS 名が返されます。

Hostname のデフォルト値は、HostnameItem パラメーターが返す値です。つまり、実質的には、これら両方のパラメーターが未指定の場合、実際のホスト名はホストの NetBIOS 名になります。Zabbix エージェントは NetBIOS ホスト名を使用して Zabbix サーバーから active checks の一覧を取得し、その結果を送信します。

"system.hostname" キーは、2 つのオプションパラメーター - type と transform - をサポートしています。

Type は、アイテムが返す名前の種類を決定します。

netbios (default) - 15 文字に制限された、UPPERCASE のみの NetBIOS ホスト名を返します。
host - 大文字小文字を区別し、完全な実際の Windows ホスト名を返します（ドメインは含みません）。
shorthost - ホスト名の最初のドットより前の部分を返します。ドットを含まない場合は、文字列全体を返します。
fqdn - 完全修飾ドメイン名を返します（末尾のドットは含みません）。

Transform では、ホスト名に対する追加の変換ルールを指定できます。

none (default) - 元の文字の大文字小文字をそのまま使用します。
lower - テキストを小文字に変換します。

したがって、zabbix_agentd.conf ファイルの設定を簡素化し、統一するために、次の 3 つの異なる方法を使用できます。

Hostname または HostnameItem パラメーターを未定義のままにすると、Zabbix エージェントは NetBIOS ホスト名をホスト名として使用します。
Hostname パラメーターを未定義のままにし、HostnameItem を次のように定義します:
HostnameItem=system.hostname[host] - Zabbix エージェントが完全な実際の（大文字小文字を区別する）Windows ホスト名をホスト名として使用するようにします。
HostnameItem=system.hostname[shorthost,lower] - Zabbix エージェントがホスト名の最初のドットより前の部分のみを使用し、小文字に変換するようにします。
HostnameItem=system.hostname[fqdn] - Zabbix エージェントが完全修飾ドメイン名をホスト名として使用するようにします。

ホスト名は、Windows サービスのインストール、開始、停止、アンインストールに使用される Windows サービス名の一部としても使用されます。たとえば、Zabbix エージェントの設定ファイルで Hostname=Windows_db_server が指定されている場合、エージェントは Windows サービス "Zabbix Agent [Windows_db_server]" としてインストールされます。したがって、Zabbix エージェントの各インスタンスで異なる Windows サービス名を使用するには、各インスタンスで異なるホスト名を使用する必要があります。

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

エージェントをインストールする前に、conf/zabbix_agentd.conf を手動で、zabbix_agentd.exe がインストールされるディレクトリにコピーしてください。

デフォルトの設定ファイルを使用して Zabbix エージェントの単一インスタンスをインストールするには、次のコマンドを実行します。

zabbix_agentd.exe --install

64ビットシステムでは、64ビットプロセスの実行に関連するすべてのチェックを正しく動作させるために、64ビット版の Zabbix エージェントが必要です。

デフォルト以外の設定ファイルを使用したい場合は、サービスのインストールに次のコマンドを使用してください。

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

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

Zabbix エージェントの複数インスタンスは、次のようにサービスとしてインストールできます。

  zabbix_agentd.exe --config <configuration_file_for_instance_1> --install --multiple-agents
  zabbix_agentd.exe --config <configuration_file_for_instance_2> --install --multiple-agents
  ...
  zabbix_agentd.exe --config <configuration_file_for_instance_N> --install --multiple-agents

インストールされたサービスは、コントロールパネルに表示されるはずです。

エージェントの起動

エージェントサービスを起動するには、コントロールパネルを使用するか、コマンドラインから実行できます。

デフォルトの設定ファイルを使用して Zabbix エージェントの単一インスタンスを起動するには、次のようにします。

 zabbix_agentd.exe --start

別の設定ファイルを使用して Zabbix エージェントの単一インスタンスを起動するには、次のようにします。

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

複数の Zabbix エージェントインスタンスのうち 1 つを起動するには、次のようにします。

 zabbix_agentd.exe --config <configuration_file_for_this_instance> --start --multiple-agents

エージェントの停止

エージェントサービスを停止するには、コントロールパネルを使用するか、コマンドラインから実行できます。

デフォルトの設定ファイルで起動した Zabbix エージェントの単一インスタンスを停止するには、次のコマンドを使用します。

 zabbix_agentd.exe --stop

別の設定ファイルで起動した Zabbix エージェントの単一インスタンスを停止するには、次のコマンドを使用します。

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

複数の Zabbix エージェントインスタンスのうち 1 つを停止するには、次のコマンドを使用します。

 zabbix_agentd.exe --config <configuration_file_for_this_instance> --stop --multiple-agents

エージェント Windows サービスのアンインストール

デフォルトの設定ファイルを使用して Zabbix エージェントの単一インスタンスをアンインストールするには:

   zabbix_agentd.exe --uninstall

デフォルト以外の設定ファイルを使用して Zabbix エージェントの単一インスタンスをアンインストールするには:

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

Windows サービスから Zabbix エージェントの複数インスタンスをアンインストールするには:

  zabbix_agentd.exe --config <configuration_file_for_instance_1> --uninstall --multiple-agents
  zabbix_agentd.exe --config <configuration_file_for_instance_2> --uninstall --multiple-agents
  ...
  zabbix_agentd.exe --config <configuration_file_for_instance_N> --uninstall --multiple-agents

制限事項

Windows 用の Zabbix エージェントは、CPU が NUMA ノード間で不均一に分散される非標準の Windows 構成をサポートしていません。論理 CPU が不均一に分散されている場合、一部の CPU では CPU パフォーマンスメトリクスを利用できないことがあります。たとえば、72 個の論理 CPU があり、NUMA ノードが 2 つある場合、両方のノードにそれぞれ 36 個の CPU が必要です。

What’s next?

エージェント 2

Docs

Microsoft Windows 上の Zabbix エージェント

エージェントの設定