2 Agent

概要

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

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

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

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

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

• パッシブチェック - Zabbixエージェントは、Zabbixサーバー(またはプロキシ)からのリクエストに対して応答します。例えばサーバーがCPU loadのデータを要求すると、エージェントが結果を返します。
• アクティブチェック - Zabbixエージェントは、Zabbixサーバー(またはプロキシ)からのリクエストを待たずにデータを収集および送信します。まず、サーバーから監視アイテムのリスト(CPU load、使用可能なメモリなど)を取得し、必要なデータを収集し、定期的に新しい値を送信します。

エージェントチェックタイプは、それぞれの監視アイテムのタイプを選択することで設定されます。Zabbixエージェントは、アイテムの"Zabbixエージェント"または"Zabbixエージェント(アクティブ)"のタイプを処理します。

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

サポートしているプラットフォームについては、要件ページを参照してください。

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

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

インストール

Zabbixエージェントは、次のいずれかの方法でLinuxベースのシステムにインストールできます。

• Zabbixパッケージ - エージェントコンポーネントを選択し(Zabbixのバージョン、OSディストリビューション、OSバージョンを選択した後)、提供されている手順に従います。
• Zabbixソース - ソースファイルをダウンロードし、--enable-agentオプションを使用してソースを構成、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エージェントを起動できます。例:

zabbix_agentd

Windows上でのZabbixエージェント

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

インストール

Zabbixエージェントは、次のいずれかの方法でWindowsにインストールできます。

• プリコンパイルされたZabbixエージェントバイナリ - ZabbixエージェントMSIインストーラーパッケージをダウンロードし、MSIでWindowsエージェントのインストールページの指示に従います。
• Zabbixソース - ソースファイルをダウンロードし、WindowsでのZabbixエージェントのビルドページの指示に従います。

Zabbixエージェント(ZIPアーカイブから)をWindowsサービスとしてインストールする方法の詳細については、Microsoft Windows上のZabbixエージェントページを参照してください。

オプション

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

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

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

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

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

ランタイム制御

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

例 :

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

shell> zabbix_agentd -R log_level_increase
       shell> zabbix_agentd -R log_level_increase=listener,3
       shell> zabbix_agentd -R log_level_increase=1234
       shell> zabbix_agentd -R log_level_decrease="active checks"

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

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

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

プロセス ユーザー

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

単純に「root」として実行しようとすると、システムから提供されている「zabbix」ユーザーに切り替わるようハードコードされています。 エージェントの設定ファイルの「AllowRoot」パラメーターを適切に変更することによって「root」としてエージェントを実行できます。

設定ファイル

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

ロケール

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

終了コード

Zabbixエージェントは、正常に終了した場合は0を返し、失敗した場合は1を返します。