ローカルリソースやアプリケーション(ハードディスクドライブ、メモリ、プロセッサの統計など)を能動的に監視するために、Zabbixエージェントを監視対象上にインストールします。
Zabbixエージェントは、稼働情報をローカルで収集し、さらに処理するためにデータをZabbixサーバーに報告します。障害(ハードディスクがいっぱいになっている、サービスプロセスがクラッシュしているなど)が発生した場合、Zabbixサーバーは障害が発生したマシンの管理者に対して、障害が発生したことを能動的に通知することができます。
Zabbixエージェントは、統計情報を収集するためにネイティブなシステムコールを使用するため、極めて効率的に動作します。
Zabbixエージェントは、パッシブチェックとアクティブチェックを行うことができます。
エージェントチェックタイプは、それぞれの監視アイテムのタイプを選択することで設定されます。Zabbixエージェントは、アイテムの"Zabbixエージェント"または"Zabbixエージェント(アクティブ)"のタイプを処理します。
サポートしているプラットフォームについては、要件ページを参照してください。
UNIX系OS上のZabbixエージェントは、監視対象のホストで実行されます。
Zabbixエージェントは、次のいずれかの方法でLinuxベースのシステムにインストールできます。
--enable-agent
オプションを使用してソースを構成、Zabbix エージェントをコンパイルします。一般的に、32bit版Zabbixエージェントは64bitのシステム上で動作しますが、場合によっては失敗する可能性があります。
macOS、IBM AIX、FreeBSD、OpenBSD、Solaris用のコンパイル済みZabbixエージェントバイナリは、ダウンロードから入手できます。 現在のZabbixサーバー/プロキシバージョンと互換性のあるレガシーバイナリは、NetBSDおよびHP-UXから入手できます。
Zabbixエージェントはデーモンプロセスとして実行されます。エージェントを起動するには以下を実行します。
これはほとんどのGNU/Linuxシステムで動きます。他のシステムでは、以下のように実行する必要がある場合があります。
Zabbixエージェントを停止/再起動/ステータス表示するには以下を実行します。
zabbix_agentdバイナリを見つけて直接実行することで、Zabbixエージェントを起動できます。例:
Windows上のZabbixエージェントは、Windowsサービスとして実行されます。
Zabbixエージェントは、次のいずれかの方法でWindowsにインストールできます。
Zabbixエージェント(ZIPアーカイブから)をWindowsサービスとしてインストールする方法の詳細については、Microsoft Windows上のZabbixエージェントページを参照してください。
ホスト上でエージェントは複数のインスタンスを実行することができます。単一のインスタンスは、デフォルトの設定ファイルまたはコマンドラインで指定された設定ファイルを利用できます。複数の場合には、各エージェントインスタンス毎に独自の設定ファイルが必要です(1つのインスタンスはデフォルトの設定ファイルを使用できます)。
Zabbixエージェントでは、次のコマンドラインパラメーターを使用できます:
パラメーター | 説明 |
---|---|
UNIXおよびWindowsエージェント | |
-c --config <config-file> | 設定ファイルへのパス。 このオプションを使用して、デフォルト以外の設定ファイルを指定できます。 UNIXでは、デフォルトは/usr/local/etc/zabbix_agentd.confまたはコンパイル時変数--sysconfdirまたは--prefixで設定されたもの。 Windowsでは、デフォルトはC:\Program Files\Zabbix Agent\zabbix_agentd.conf |
-f --foreground | Zabbixエージェントをフォアグラウンドで実行する (デフォルト: true)。 |
-p --print | 既知の項目を出力して終了します。 注: ユーザーパラメーターの結果も返すには、設定ファイルを指定する必要があります (デフォルトの場所にない場合)。 |
-t --test <item key> | 指定されたアイテムをテストして終了します。 注: ユーザーパラメーターの結果も返すには、設定ファイルを指定する必要があります (デフォルトの場所にない場合)。 |
-T --test-config | 設定ファイルを検証して終了します。 |
-h --help | ヘルプ情報を表示します。 |
-V --version | バージョン番号を表示します。 |
UNIXエージェントのみ | |
-R --runtime-control <option> | 管理機能を実行します。 ランタイム制御を参照してください。 |
Windowsエージェントのみ | |
-m --multiple-agents | 複数のエージェントインスタンスを使用します (-i、-d、-s、-x ファンクションと共に)。 インスタンスのサービス名を区別するために、各サービス名には設定ファイルで指定されたHostnameの値が含まれます。 |
-S --startup-type <value> | Zabbix Windowsエージェントサービスのスタートアップの種類を設定します。 許可される値:automatic - (デフォルト) Windows 起動時にサービスを自動的に開始します。delayed - 自動的に開始するサービスが開始完了するまで、サービスの開始を遅らせる (Windows Server 2008/Vista以降のバージョンで利用可能)。manual - (ユーザーかアプリケーションが)サービスを手動で開始します。disabled - サービスを無効にして、ユーザーまたはアプリケーションがサービスを開始できないようにします。このオプションを -i オプションと一緒に使用することも、個別に使用して、すでにインストールされているサービスのスタートアップの種類を変更することもできます。 |
-i --install | Zabbix Windowsエージェントをサービスとしてインストールする。 |
-d --uninstall | Zabbix Windowsエージェントサービスをアンインストールする。 |
-s --start | Zabbix Windowsエージェントサービスを開始する。 |
-x --stop | Zabbix Windowsエージェントサービスを停止する。 |
コマンドラインパラメーターを使用する具体的な例:
zabbix_agentd --print
zabbix_agentd -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf
zabbix_agentd.exe -i
zabbix_agentd.exe -i -m -c zabbix_agentd.conf
zabbix_agentd.exe -c zabbix_agentd.conf -S delayed
ランタイム制御オプションを使用すると、エージェントプロセスのログレベルを変更できます。
オプション | 説明 | ターゲット |
---|---|---|
log_level_increase[=<target>] | ログレベルを上げます。 ターゲットが指定されていない場合、すべてのプロセスが影響を受けます。 |
ターゲットは次のように指定できます: process type - 指定されたタイプ (例 listener) のすべてのプロセス すべてのエージェントプロセスタイプを参照してください。 process type,N - プロセスのタイプと数 (例: listener,3)<br >pid - プロセスID (1 ~ 65535)。より大きな値の場合は、'process-type,N'の指定方法にしてください。 |
log_level_decrease[=<target>] | ログレベルを下げます。 ターゲットが指定されていない場合、すべてのプロセスが影響を受けます。 |
|
userparameter_reload | 現在の構成ファイルからUserParameterおよびIncludeオプションの値を再ロードします。 |
例:
zabbix_agentd -R log_level_increase
zabbix_agentd -R log_level_increase=listener,3
zabbix_agentd -R log_level_increase=1234
zabbix_agentd -R log_level_decrease="active checks"
ランタイム制御は、OpenBSD、NetBSD、およびWindowsではサポートしません。
active checks
- アクティブチェックを実行するためのプロセスcollector
- データ収集のプロセスlistener
- パッシブチェックを受け付けるプロセスエージェントログファイルを利用して、これらのプロセスタイプを観察できます。
UNIX上のZabbixエージェントは、root以外のユーザーとして実行するように設計されていて、起動されたroot以外のユーザーとして実行されます。したがって、root以外のユーザーでエージェントを実行しても何も問題ありません。
'root'として実行しようとすると、ハードコードされた'zabbix'ユーザーに切り替わるため、'zabbix'ユーザーがシステム上に存在している必要があります。'root'として実行するためには、エージェントの設定ファイルの'AllowRoot'パラメーターを適切に変更する必要があります。
Zabbixエージェントの設定の詳細については、Zabbixエージェント (UNIX)または Zabbixエージェント (Windows)の設定ファイルのオプションを参照してください。
一部の文字型のエージェントアイテムで期待される値を返すには、UTF-8ロケールがエージェントに必要であることに注意してください。最新のUnixライクシステムのほとんどはデフォルトでUTF-8ロケールを持っていますが、一部のシステムでは具体的に設定する必要がある可能性があります。
Zabbixエージェントは、正常に終了した場合は0を返し、失敗した場合は1を返します。