2 Zabbixエージェント

概要

ローカルリソースやアプリケーション（ハードディスクドライブ、メモリ、プロセッサの統計など）を能動的に監視するために、Zabbixエージェントを監視対象上にインストールします。

Zabbixエージェントは、稼働情報をローカルで収集し、さらに処理するためにデータをZabbixサーバーに報告します。障害（ハードディスクがいっぱいになっている、サービスプロセスがクラッシュしているなど）が発生した場合、Zabbixサーバーは障害が発生したマシンの管理者に対して、障害が発生したことを能動的に通知することができます。

Zabbixエージェントは、統計情報を収集するためにネイティブなシステムコールを使用するため、極めて効率的に動作します。

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

Zabbixエージェントは、パッシブチェックとアクティブチェックを行うことができます。

パッシブチェックでは、エージェントはデータの要求に対して応答します。Zabbixサーバー(またはプロキシ)が、例えばCPU負荷のデータを要求すると、Zabbixエージェントが結果を返却します。

アクティブチェックでは、より複雑な処理が求められます。Zabbixエージェントは、独立した処理のために、最初にZabbixサーバーからアイテムのリストを取得します。その後、定期的に新しい値をZabbixサーバーに送信します。

パッシブチェック、アクティブチェックのどちらで動作するかは、それぞれの監視対象のアイテムのタイプを選択することによって設定されます。Zabbixエージェントは、アイテムの'Zabbixエージェント'または'Zabbixエージェント(アクティブ)'のタイプを処理します。

サポートしているプラットフォーム

Zabbixエージェントは以下のプラットフォームでの動作をサポートしています :

• Windows (XP以降のデスクトップおよびサーバー)
• Linux (配付パッケージでも利用可能)
• macOS
• IBM AIX
• FreeBSD
• OpenBSD
• Solaris

NetBSDおよびHP-UX用のレガシーZabbixエージェントバイナリをダウンロードすることもできます。これらは、現在のZabbixサーバー/プロキシバージョンと互換性があります。

UNIX系OS上のZabbixエージェント

UNIX系OS上のZabbixエージェントは、監視対象のホストで実行されます。

インストール

パッケージを使用してZabbixエージェントをインストールする方法については、パッケージインストールのセクションを参照してください。

また、パッケージを使用しない場合はソースコードからのインストールの手順を参照してください。

パッケージでインストールした場合

Zabbixエージェントはデーモンプロセスとして実行されます。エージェントを起動するには以下を実行します。

systemctl start zabbix-agent

これはほとんどのGNU/Linuxシステムで動きます。他のシステムでは、以下のように実行する必要がある場合があります。

/etc/init.d/zabbix-agent start

同様に、Zabbixエージェントを停止/再起動/ステータス表示するには以下を実行します。

systemctl stop zabbix-agent
       systemctl restart zabbix-agent
       systemctl status zabbix-agent

手動での起動

手動で起動しようとして上記の方法で起動できない場合は、zabbix_agentdの実行ファイルのパスを確認して以下のように実行します:

zabbix_agentd

Windows上でのZabbixエージェント

Windows上のZabbixエージェントは、Windowsサービスとして実行されます。

準備

Zabbixエージェントは、zipアーカイブとして配布されます。アーカイブをダウンロードしたら展開する必要があります。Zabbixエージェント本体と設定ファイルを保存するフォルダを選択してください。例:

C:\zabbix

bin\zabbix_agentd.exeとconf\zabbix_agentd.confファイルをc:\zabbixにコピーしてください。

c:\zabbix\zabbix_agentd.confファイルを必要に応じて編集し、特に"Hostname"パラメーターは正しいことを確かめてください。

インストール

完了後、次のコマンドを使用してZabbixエージェントをWindowsサービスとしてインストールします:

C:\> c:\zabbix\zabbix_agentd.exe -c c:\zabbix\zabbix_agentd.conf -i

これで、"Zabbix agent"サービスをその他のWindowsサービスと同様、通常どおりに構成できるはずです。

WindowsでのZabbixエージェントのインストールと実行については、詳細を参照してください。

その他のエージェントオプション

ホスト上でエージェントは複数のインスタンスを実行することができます。 単一のインスタンスは、デフォルトの設定ファイルまたはコマンドラインで指定された設定ファイルを利用できます。複数の場合には、各エージェントインスタンス毎に独自の設定ファイルが必要です (1つのインスタンスはデフォルトの設定ファイルを使用できます)。

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

コマンドラインパラメーターを使用する具体的な例:

• すべてのビルトインエージェントアイテムを値とともに出力します。
• 指定した設定ファイル内で定義された"mysql.ping"キーを使用したユーザー パラメータのテスト
• Windows用の"Zabbix Agent"サービスをインストールします。デフォルトの設定ファイルへのパス c:\zabbix_agentd.conf
• Windows用の"Zabbix Agent [Hostname]"サービスをインストールします。エージェントが実行可能な、同じ場所にある設定ファイルフォルダのzabbix_agentd.confをHostnameの値で拡張してサービス名を一意にします。

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

ランタイム制御

ランタイム制御オプションを使用すると、エージェントプロセスのログレベルを変更できます。

例:

• すべてのプロセスのログレベルを上げる
• 3番目のlistenerプロセスのログレベルを上げる
• PID 1234のプロセスのログレベルを上げる
• すべてのアクティブなチェックプロセスのログレベルを下げる

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"

エージェントプロセスタイプ

• active checks - アクティブチェックを実行するためのプロセス
• collector - データ収集のプロセス
• listener - パッシブチェックを受け付けるプロセス

エージェントログファイルを利用して、これらのプロセスタイプを観察できます。

プロセスユーザー

UNIX上のZabbixエージェントは、root以外のユーザーとして実行するように設計されていて、起動されたroot以外のユーザーとして実行されます。したがって、root以外のユーザーでエージェントを実行しても何も問題ありません。

'root'として実行しようとすると、ハードコードされた'zabbix'ユーザーに切り替わるため、'zabbix'ユーザーがシステム上に存在している必要があります。'root'として実行するためには、エージェントの設定ファイルの'AllowRoot'パラメーターを適切に変更する必要があります。

設定ファイル

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

ロケール

一部の文字型のエージェントアイテムで期待される値を返すには、UTF-8ロケールがエージェントに必要であることに注意してください。最新のUnixライクシステムのほとんどはデフォルトでUTF-8ロケールを持っていますが、一部のシステムでは具体的に設定する必要がある可能性があります。

終了コード

バージョン2.2より前のZabbixエージェントは、正常に終了した場合に0を、失敗した場合は255を返します。バージョン2.2以降のZabbixエージェントは、正常に終了した場合は0を、失敗した場合は1を返します。