Table of Contents

3 Zabbixエージェント2

3 Zabbixエージェント2

概要

Zabbixエージェント2は新世代のZabbixエージェントであり、Zabbixエージェントの代わりに使用できます。 Zabbixエージェント2は次の目的で開発されました。

TCP接続の数を減らす
チェックの同時実行性改善
プラグイン拡張の簡易化。プラグインは次のようなことが可能です
- 数行の単純なコードのみで構成される簡単なチェック
- 長時間実行されるスクリプトと、データの定期的な返送を伴うスタンドアロンのデータ収集で構成される複雑なチェック
Zabbixエージェントのドロップイン代替品 (以前のすべての機能をサポートするという点で)

Zabbixエージェント2はGo言語で記述されています(ZabbixエージェントのCコードが再利用されています)。Zabbixエージェント2をビルドするには、現在サポートされているGoバージョンで構成されたGo環境が必要です。

Zabbixエージェント2には、Linux向け組み込みデーモン化サポートがありません。WindowsではWindowsサービスとして実行できます。

パッシブチェックとアクティブチェック

パッシブチェックはZabbixエージェントと同様に機能します。アクティブチェックは、スケジュールされた柔軟な間隔設定をサポートし、アクティブサーバー内の同時実行性をチェックします。

デフォルトでは、Zabbixエージェント2は、リソース使用量の急増を防ぐために、アイテムの更新間隔内の条件付きランダム時間にアクティブチェックの最初のデータ収集をスケジュールします。エージェントの再起動直後に予定された更新確認間隔にないアクティブチェックを実行するには、構成ファイルでForceActiveChecksOnStartパラメーター（グローバルレベル）またはPlugins.<プラグイン名>.System.ForceActiveChecksOnStart（特定のプラグインチェックにのみ影響します）を設定します。プラグインレベルのパラメータが設定されている場合、グローバルパラメータを上書きします。

同時実行性の確認

異なるプラグインからのチェックを同時に実行できます。 1つのプラグイン内の同時チェック数は、プラグイン容量設定によって制限されます。各プラグインにはハードコードされた容量設定（デフォルトは1000）があり、プラグイン設定パラメーターのPlugins.<プラグイン名>.System.Capacity=Nを使用して下げることができます。

サポートするプラットフォーム

Zabbixエージェント2は以下のプラットフォームでサポートされています。

Windows (Windows 10/Server 2016以降のすべてのバージョン) - コンパイル済み実行バイナリかZabbixソースで提供
Linux - ディストリビューション用パッケージかZabbixソースで提供

Zabbix 7.0.5以降、Go 1.22(およびそれ以降)はRHEL 6が提供するGCC 4.4.7と互換性がなく、コンパイルエラーが発生するため、Zabbixエージェント2パッケージはRHEL 6では使用できなくなりました。ただし、Zabbixエージェントパッケージは引き続きサポートされていることに注意してください。

Agent 2 on UNIX-like systems

Zabbix agent 2 on UNIX-like systems is run on the host being monitored.

インストール

Zabbixエージェント2をインストールする方法はいくつかあります :

Windows :

コンパイル済みのバイナリから - バイナリをダウンロードし、MSIからのWindowsエージェントのインストールページの指示に従います。
ソースから - WindowsでのZabbixエージェント2の構築を参照します。

Linux :

配付パッケージから - Zabbixパッケージページの指示に従います。このページは、ディストリビューションとエージェント2コンポーネントを選択することで利用できます。
ソースから - ソースコードからのインストールを参照してください。--enable-agent2構成オプションを指定してソースを構成する必要があることに注意してください。

Zabbixエージェント2の監視機能は、プラグインを使用して拡張できます。組み込みプラグインはすぐに使用できますが、ロード可能なプラグインは個別にインストールする必要があります。詳細については、プラグインを参照してください。

If installed as package

Zabbix agent 2 runs as a foreground process and relies on an external service manager (e.g., systemd) for background execution; Zabbix agent 2 does not have built-in daemonization support on Linux.

The agent can be started by executing:

systemctl start zabbix-agent2

To stop, restart, or check the status of Zabbix agent 2, use the following commands:

systemctl stop zabbix-agent2
       systemctl restart zabbix-agent2
       systemctl status zabbix-agent2

Start up manually

You can start Zabbix agent by locating the zabbix_agent2 binary and running it directly; for example:

zabbix_agent2

Agent 2 on Windows systems

Zabbix agent 2 runs as a standalone process; however, it can also be run as a Windows service.

Installation

Zabbix agent 2 can be installed on Windows using one of the following methods:

Pre-compiled Zabbix agent binaries - download the Zabbix agent MSI installer package and follow the instructions on the Windows agent installation from MSI page.
Zabbix sources - download the source files and follow the instructions on the Building Zabbix agent 2 on Windows page. Note that a configured Go environment with a currently supported Go version is required for building Zabbix agent 2.

Zabbix agent 2 monitoring capabilities can be extended with plugins. While built-in plugins are available out-of-the-box, loadable plugins on Windows must be installed separately. For more information, see Zabbix agent 2 loadable plugins.

See the Zabbix agent on Microsoft Windows page for additional details on installing Zabbix agent 2 (from a ZIP archive) as a Windows service.

オプション

Zabbixエージェント2では次のコマンドラインパラメータを使用できます。

パラメーター	説明
UNIXとWindows エージェント
-c --config <config-file>	設定ファイルへのパスを指定します。このオプションを使用してデフォルトではない設定ファイルを指定できます。 UNIXの場合、デフォルトは/usr/local/etc/zabbix_agent2.confであるか、コンパイル時の変数--sysconfdir または --prefixで設定されます。 Windowsの場合、デフォルトはC:\Program Files\Zabbix Agent 2\zabbix_agent2.confです。
-f --foreground	Zabbixエージェントをフォアグラウンドで実行します(デフォルト: true)。
-p --print	既知のアイテムを出力して終了します。注: ユーザーパラメーターの結果も返すには、（デフォルトの場所にない場合は）構成ファイルを指定する必要があります。
-t --test <item key>	指定されたアイテムをテストして終了します。注: ユーザーパラメーターの結果も返すには、（デフォルトの場所にない場合は）構成ファイルを指定する必要があります。
-T --test-config	設定ファイルを検証して終了します。
-h --help	ヘルプを出力して終了します。
-v --verbose	デバッグ情報を出力します。このオプションは -p および -t オプションとともに使用します。
-V --version	エージェントのバージョン番号を出力して終了します。
-R --runtime-control <option>	管理機能を実行します。ランタイム制御を参照してください。
Windowsエージェントのみ
-m --multiple-agents	複数のエージェントインスタンスを使用する (-i, -d, -s, -xオプションと一緒に)。インスタンスのサービス名を区別するために、各サービス名には、指定された設定ファイルのホスト名の値が含まれます。
-S --startup-type <value>	Zabbix Windowsエージェントサービスのスタートアップの種類を設定します。許可される値 : `automatic` - (デフォルト) Windows 起動時にサービスを自動的に開始する。 `delayed` - 自動的に開始されるサービスが開始を完了するまで、サービスの開始を遅らせる。 `manual` - (ユーザーかアプリケーションが)サービスを手動で開始する。 `disabled` - サービスを無効にして、ユーザーまたはアプリケーションがサービスを開始できないようにします。このオプションを -i オプションと一緒に使用することも、個別に使用して、すでにインストールされているサービスのスタートアップの種類を変更することもできます。
-i --install	Zabbix Windowsエージェントをサービスとしてインストールします。
-d --uninstall	Zabbix Windowsエージェントサービスをアンインストールします。
-s --start	Zabbix Windowsエージェントサービスを開始します。
-x --stop	Zabbix Windowsエージェントサービスを停止します。

コマンドラインパラメータの使用の具体的な例：

すべての組み込みエージェントアイテムの値を出力します
指定された設定ファイルで定義された"mysql.ping"キーを使用してユーザーパラメータをテストします
Windowsの"Zabbixエージェント"サービスを設定ファイルC:\Program Files\Zabbix Agent 2\zabbix_agent2.confのデフォルトのパスを用いてインストールします
エージェントの実行可能ファイルと同じフォルダーにある構成ファイルzabbix_agent2.confを使用して、インストールされているWindowsの"Zabbixエージェント"サービスのスタートアップの種類を変更する

    shell> zabbix_agent2 --print
           shell> zabbix_agent2 -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf
           shell> zabbix_agent2.exe -i
           shell> zabbix_agent2.exe -c zabbix_agent2.conf -S delayed

ランタイムコントロール

ランタイムコントロールは、リモート制御のためのいくつかのオプションを提供します。

オプション	説明
log_level_increase	ログレベルを上げます。
log_level_decrease	ログレベルを下げます。
metrics	利用可能なメトリックを一覧表示します。
version	エージェントのバージョンを表示します。
userparameter_reload	現在の設定ファイルからUserParameterおよびIncludeオプションの値を再ロードします。
help	ランタイムコントロールのヘルプを表示します。

例:

エージェント2のログレベルを上げます
ランタイムコントロールオプションを出力します

    zabbix_agent2 -R log_level_increase
           zabbix_agent2 -R help

設定ファイル

Zabbixエージェント2の設定パラメータは、いくつかの例外を除いて、Zabbixエージェントと互換性があります。

新しいパラメータ	説明
ControlSocket	ランタイムコントロールソケットパス。エージェント2はランタイムコマンドにコントロールソケットを使用します。
EnablePersistentBuffer, PersistentBufferFile, PersistentBufferPeriod	これらのパラメーターは、アクティブなアイテムのエージェント2の永続ストレージを設定するために使用されます。
ForceActiveChecksOnStart	エージェントがアクティブチェックを再起動直後に実行するか、時間経過で均等に分散実行するかを決定します。
Plugins	プラグインは`Plugins.<プラグイン名>.<Parameter>=<value>`の形式で独自のパラメータを設定できます。一般的なプラグインパラメータはSystem.Capacityで、同時に実行できるチェックの制限を設定します。
StatusPort	ポートエージェント2は、HTTPステータスリクエストをリッスンし、設定されたプラグインといくつかの内部パラメーターのリストを表示します。
削除されたパラメータ	説明
AllowRoot, User	デーモン化がサポートされていないため、サポートされていません。
LoadModule, LoadModulePath	ロードモジュールはサポートされていません。
StartAgents	このパラメータは、Zabbixエージェントではパッシブチェックの同時実行性を高めたり無効にしたりするために使用されていました。エージェント2では、同時実行はプラグインレベルで設定され、容量設定によって制限できます。一方、パッシブチェックの無効化は現在サポートされていません。
HostInterface, HostInterfaceItem	まだサポートされていません。

詳細についてはzabbix_agent2の設定ファイルオプションを参照してください。

終了コード

Zabbixエージェント2は古いOpenSSLバージョン（1.0.1、1.0.2）でコンパイルすることもできます。

この場合、ZabbixはOpenSSLでロックするためのミューテックスを提供します。ミューテックスのロックまたはロック解除が失敗した場合、エラーメッセージが標準エラーストリーム（STDERR）に出力され、エージェント2はそれぞれリターンコード2または3で終了します。

Documentation