Documentation
Table of Contents
3 Zabbixエージェント2
概要
Zabbixエージェント2は新世代の[Zabbixエージェント]](/manual/concepts/agent)であり、Go言語で記述されています(ZabbixエージェントのC言語コードが再利用されています)。次のように設計されています:
- TCP接続の数を減らす
- チェックの同時実行性の改善
- プラグイン拡張の簡易化。最小限のコードで簡単なチェックを提供し、定期的なレポートを使用して、長期にわたるスクリプトとスタンドアロンのデータ収集で構成される複雑なチェックをサポートします。
- Zabbixエージェントの代替品として機能し、以前のすべての機能をサポートします。
パッシブチェックとアクティブチェック
Zabbixエージェント2はZabbixエージェントと同様にパッシブおよびアクティブチェックをサポートしています。 さらに、Zabbixエージェント2アクティブチェックは、柔軟な/スケジューリング間隔をサポートし、1つのアクティブサーバー内の同時実行性をチェックします。
デフォルトでは、Zabbixエージェント2はリソース使用量の急増を防ぐために、アイテムの更新間隔内の条件付きランダム時間にアクティブチェックの最初のデータ収集をスケジュールします。エージェントの再起動直後に予定された更新確認間隔にないアクティブチェックを実行するには、設定ファイルでForceActiveChecksOnStartパラメーター(グローバルレベル)またはPlugins.<プラグイン名>.System.ForceActiveChecksOnStart (特定のプラグインチェックにのみ影響します)を設定します。プラグインレベルのパラメーターが設定されている場合、グローバルパラメーターを上書きします。
同時実行性の確認
異なるプラグインからのチェックを同時に実行できます。 1つのプラグイン内の同時チェック数は、プラグイン容量設定によって制限されます。各プラグインにはハードコードされた容量設定（デフォルトは1000）があり、プラグイン設定パラメーターのPlugins.<プラグイン名>.System.Capacity=Nを使用して下げることができます。
サポートしているプラットフォーム
サポートしているプラットフォームについては、要件ページを参照してください。
UNIX系OS上のZabbixエージェント2
UNIX系OS上のZabbixエージェント2は、監視対象のホストで実行されます。
インストール
Zabbixエージェント2をLinuxベースのシステムにインストールする方法はいくつかあります:
- Zabbixパッケージ - (Zabbixバージョン、OS分布、OSバージョンを選択した後)エージェント2コンポーネントを選択し、提供された指示に従ってください。
- Zabbixソース - ソースファイルをダウンロードし、
--enable-agent2オプションでソースを構成してZabbixエージェントをコンパイルします。現在サポートされているGOバージョン備えた構成GO環境がZabbixエージェント2の構築に必要であることに注意してください。
Zabbix 7.0.5以降、Go 1.22(およびそれ以降)はRHEL 6で提供されるGCC 4.4.7と互換性がなく、コンパイルエラーが発生するため、Zabbixエージェント2パッケージはRHEL 6では利用できなくなりました。 ただし、Zabbixエージェントパッケージは引き続きサポートされています。
パッケージでインストールした場合
Zabbixエージェント2はフォアグラウンドプロセスとして実行され、バックグラウンド実行には外部サービスマネージャー(systemdなど)に依存します。 Zabbixエージェント2にはLinux上でのデーモン化サポートが組み込まれていません。
エージェントは、次のコマンドを実行して起動できます:
Zabbixエージェント2を停止、再起動、またはステータスを確認するには、次のコマンドを使用します:
手動で起動
zabbix_agent2バイナリを見つけて直接実行することで、Zabbixエージェントを起動できます。例:
Windowsシステム上のエージェント2
Zabbixエージェント2はスタンドアロンプロセスとして実行されますが、Windowsサービスとして実行することもできます。
インストール
Zabbixエージェント2は、次のいずれかの方法でWindowsにインストールできます。
- プリコンパイルされたZabbixエージェントバイナリ - ZabbixエージェントMSIインストーラーパッケージをダウンロードし、MSIでWindowsエージェントのインストールページの指示に従います。
- Zabbixソース - ソースファイルをダウンロードし、WindowsでのZabbixエージェント2のビルドページの指示に従います。 Zabbixエージェント2をビルドするには、現在サポートされているGo バージョンで構成されたGo環境が必要であることに注意してください。
Zabbixエージェント2の監視機能は、プラグインを使用して拡張できます。 組み込みプラグインはすぐに使用できますが、Windows上のロード可能なプラグインは別途インストールする必要があります。 詳細については、Zabbixエージェント2ロード可能なプラグインを参照してください。
Zabbixエージェント2 (ZIP アーカイブから)をWindowsサービスとしてインストールする方法の詳細については、Microsoft Windows上のZabbixエージェントページを参照してください。
オプション
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エージェント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で終了します。