差分

このページの2つのバージョン間の差分を表示します。

この比較画面にリンクする

両方とも前のリビジョン 前のリビジョン
次のリビジョン
前のリビジョン
ja:documentation:02_installation:05_configuration_agents [2021/05/01 19:25]
admscopia
ja:documentation:02_installation:05_configuration_agents [2021/07/10 02:29] (現在)
junichi [module_regexp]
行 1: 行 1:
-====== エージェント設定 ====== +====== エージェント設定 ====== 
 {{indexmenu_n>5}} {{indexmenu_n>5}}
  
-[[ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]+[[:ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]
  
-= Pandora FMS ソフトウエアエージェント =+===== Pandora FMS ソフトウエアエージェント ===== 
 + 
 +==== ソフトウエアエージェントとは? ====
  
-====== ソフトウエアエージェントとは? ====== 
 その名前が示すとおり、OS にインストールされ、監視情報を抽出して Pandora FMS サーバへ定期的に送信するための小さなソフトウエアです。 その名前が示すとおり、OS にインストールされ、監視情報を抽出して Pandora FMS サーバへ定期的に送信するための小さなソフトウエアです。
  
行 12: 行 14:
  
 それぞれの監視項目は、//モジュール// と呼びます。 それぞれの監視項目は、//モジュール// と呼びます。
 +==== エージェント設定概要 ====
  
-====== エージェント設定概要 ====== 
 ソフトウエアエージェントの動作は、//pandora_agent.conf// という設定ファイルによって決まります。Windows であればインストール先ディレクトリ、Linux であれば ///etc// 以下にあります。 ソフトウエアエージェントの動作は、//pandora_agent.conf// という設定ファイルによって決まります。Windows であればインストール先ディレクトリ、Linux であれば ///etc// 以下にあります。
  
 設定ファイルには、そのエージェントの動作パラメータおよびモジュールが含まれます。 設定ファイルには、そのエージェントの動作パラメータおよびモジュールが含まれます。
  
-====== エージェントの一般的なパラメータ======+==== エージェントの一般的なパラメータ ==== 
 この章では、エージェントの一般的なパラメータ設定について説明します。Windows および UNIX 共通のものや、それぞれ専用のものがあります。以下に一般的なパラメータ詳細について記載します。 この章では、エージェントの一般的なパラメータ設定について説明します。Windows および UNIX 共通のものや、それぞれ専用のものがあります。以下に一般的なパラメータ詳細について記載します。
  
-{{pandora:documentation_ja:warning|エージェントから最初にサーバがデータを受け取った時は全ての情報がデータベースに保存されます。以降に受信したデータは(学習モードの有効・無効により)、XML ファイルにおける **version**, **date**, **OS version** および、設定ファイルの **gis_exec**, **latitude**, **longitude**, **altitude** **parent_agent_name**, **timezone_offset**, **address**, **custom_field** フィールドのみ更新されます。}}+<WRAP center round important 60%> エージェントから最初にサーバがデータを受け取った時は全ての情報がデータベースに保存されます。以降に受信したデータは(学習モードの有効・無効により)、XML ファイルにおける **version**, **date**, **OS version** および、設定ファイルの **gis_exec**, **latitude**, **longitude**, **altitude** **parent_agent_name**, **timezone_offset**, **address**, **custom_field** フィールドのみ更新されます。 </WRAP>
  
-{{pandora:documentation_ja:warning|Linux および Windows システム共に、**エージェント設定ファイルの文字コードは、UTF-8です。** ファイルを編集するときは、上書きする前に文字コードを確認してください。文字コードが UTF-8 ではなく、かつ記号(マークや拡張記号など)を使う場合は、エージェントが記号を誤認識する可能性があり、設定を正しく解釈するか保証できません。}}+<WRAP center round important 60%> Linux および Windows システム共に、**エージェント設定ファイルの文字コードは、UTF-8です。** ファイルを編集するときは、上書きする前に文字コードを確認してください。文字コードが UTF-8 ではなく、かつ記号(マークや拡張記号など)を使う場合は、エージェントが記号を誤認識する可能性があり、設定を正しく解釈するか保証できません。 </WRAP> 
 +=== server_ip ===
  
-====server_ip==== 
 データを保持する Pandora FMS サーバのホスト名もしくは IP アドレスを設定します。 データを保持する Pandora FMS サーバのホスト名もしくは IP アドレスを設定します。
  
-====server_path====+=== server_path === 
 エージェントから送られるデータを受け取るサーバのディレクトリパスを設定します。通常は、/var/spool/pandora/data_in です。 エージェントから送られるデータを受け取るサーバのディレクトリパスを設定します。通常は、/var/spool/pandora/data_in です。
  
-====temporal====+=== temporal === 
 エージェントがサーバにデータを送信する前にローカルで利用するフォルダのパスを設定します。 エージェントがサーバにデータを送信する前にローカルで利用するフォルダのパスを設定します。
  
-====description====+=== description === 
 XML でエージェントが送る「説明」を設定します。Pandora FMS はエージェントを作成する時に、この「説明」を取り込みます。 XML でエージェントが送る「説明」を設定します。Pandora FMS はエージェントを作成する時に、この「説明」を取り込みます。
  
-====group====+=== group === 
 エージェントが所属するグループ名を設定します。このパラメータで指定された名前のグループがある場合、サーバが特定のグループにエージェントを作成するようにしていなければ、指定したグループ内にエージェントが作成されます。 エージェントが所属するグループ名を設定します。このパラメータで指定された名前のグループがある場合、サーバが特定のグループにエージェントを作成するようにしていなければ、指定したグループ内にエージェントが作成されます。
  
-====temporal_min_size====+=== temporal_min_size === 
 テンポラリディレクトリのパーティション空き容量がここで指定したサイズ (MB 単位) より小さくなったら、データパケットの生成を停止します。何らかの理由でサーバへの接続が長時間切れた場合に、ディスクがいっぱいになるのを避けます。 テンポラリディレクトリのパーティション空き容量がここで指定したサイズ (MB 単位) より小さくなったら、データパケットの生成を停止します。何らかの理由でサーバへの接続が長時間切れた場合に、ディスクがいっぱいになるのを避けます。
  
-====logfile====+=== logfile === 
 Pandora FMS エージェントのログファイルのパスです。 Pandora FMS エージェントのログファイルのパスです。
  
-====interval====+=== interval === 
 エージェントの秒単位のデータ収集間隔です。この間隔でエージェントは情報を収集し、Pandora FMS サーバへ送ります。 エージェントの秒単位のデータ収集間隔です。この間隔でエージェントは情報を収集し、Pandora FMS サーバへ送ります。
  
-====disable_logfile====+=== disable_logfile === 
 このパラメータは、pandora_agent.log へのログ出力を無効化します。Windows のみ。 このパラメータは、pandora_agent.log へのログ出力を無効化します。Windows のみ。
  
-====debug==== +=== debug === 
-有効化(1)すると、エージェントのデータファイルはテンポラリディレクトリ内に名前を変えて保存され、サーバへ送信したあとも削除されません。XML ファイルを開いて内容を確認することができます。+ 
 +有効化すると、エージェントのデータファイルはテンポラリディレクトリ内に名前を変えて保存され、サーバへ送信したあとも削除されません。XML ファイルを開いて内容を確認することができます。 
 + 
 + 
 +=== agent_name ===
  
-====agent_name==== 
 カスタム名を設定できます。設定していない場合、エージェント名はマシンのホスト名になります。 カスタム名を設定できます。設定していない場合、エージェント名はマシンのホスト名になります。
  
-====(>=5.1SP2) agent_name_cmd====+=== agent_name_cmd === 
 + 
 +<WRAP center round tip 60%>バージョン 5.1 SP2 以上</WRAP> 
 外部コマンドを使ってエージェント名を定義したい場合に設定します。これはオプションです。このパラメータを設定した場合、'agent_name' は無視されます。外部コマンドはエージェント名を標準出力に返す必要があります。複数行を返した場合、1行目がエージェント名として扱われます。 外部コマンドを使ってエージェント名を定義したい場合に設定します。これはオプションです。このパラメータを設定した場合、'agent_name' は無視されます。外部コマンドはエージェント名を標準出力に返す必要があります。複数行を返した場合、1行目がエージェント名として扱われます。
  
-====(>=7.0) agent_alias_cmd====+=== agent_alias_cmd === 
 + 
 +<WRAP center round tip 60%>バージョン NG 7 以上</WRAP> 
 外部コマンドを使ってエージェントの別名を定義したい場合に設定します。このパラメータを設定した場合、'agent_alias' は無視されます。外部コマンドはエージェントの別名を標準出力に返す必要があります。複数行を返した場合、1行目がエージェントの別名として扱われます。 外部コマンドを使ってエージェントの別名を定義したい場合に設定します。このパラメータを設定した場合、'agent_alias' は無視されます。外部コマンドはエージェントの別名を標準出力に返す必要があります。複数行を返した場合、1行目がエージェントの別名として扱われます。
  
-====address====+=== address === 
 これは、ソフトウエアエージェントの IP アドレスです。X.X.X.X というフォーマットの IP アドレス、'localhost' のようなホスト名、または 'auto' を設定できます。IP アドレスまたはホスト名を指定した場合は、そのアドレスがエージェントに追加され、メインのアドレスとなります。'auto' を指定した場合は、ホストから IP アドレスを取得してエージェントに追加されます。 これは、ソフトウエアエージェントの IP アドレスです。X.X.X.X というフォーマットの IP アドレス、'localhost' のようなホスト名、または 'auto' を設定できます。IP アドレスまたはホスト名を指定した場合は、そのアドレスがエージェントに追加され、メインのアドレスとなります。'auto' を指定した場合は、ホストから IP アドレスを取得してエージェントに追加されます。
  
-====encoding====+=== encoding === 
 ISO-8859-15 や UTF-8 のように、システムのエンコーディングの種類を設定します。 ISO-8859-15 や UTF-8 のように、システムのエンコーディングの種類を設定します。
  
-====server_port====+=== server_port === 
 このパラメータは、リモートのサーバの待ち受けポートの設定です。Tentacle のデフォルトは 41121 です。 このパラメータは、リモートのサーバの待ち受けポートの設定です。Tentacle のデフォルトは 41121 です。
  
-====transfer_mode====+=== transfer_mode === 
 このパラメータには、エージェントからサーバへデータを送信するための方法を設定します。デフォルトは Tentacle です。 このパラメータには、エージェントからサーバへデータを送信するための方法を設定します。デフォルトは Tentacle です。
  
-==== (>6.0) transfer_timeout ====+=== transfer_timeout === 
 + 
 +<WRAP center round tip 60%>バージョン 6.0 以上</WRAP> 
 データ転送プログラムの実行タイムアウトを秒単位で指定します。設定されていない場合のデフォルトは 30 です。 データ転送プログラムの実行タイムアウトを秒単位で指定します。設定されていない場合のデフォルトは 30 です。
  
-====server_pwd====+=== server_pwd === 
 Windows の FTP もしくは Tentacle 転送モードのパスワードを設定します。Tentacle モードの場合はパスワードは必須ではありません。このパスワードでサーバでの認証を行います。 Windows の FTP もしくは Tentacle 転送モードのパスワードを設定します。Tentacle モードの場合はパスワードは必須ではありません。このパスワードでサーバでの認証を行います。
  
-====server_ssl====+=== server_ssl === 
 Tentacle の転送モードを設定します。SSL を利用する場合は 1、そうでなければ 0 を設定します。 Tentacle の転送モードを設定します。SSL を利用する場合は 1、そうでなければ 0 を設定します。
  
-====server_opts====+=== server_opts === 
 Tentacle の転送モードを設定します。Tentacle クライアントの拡張設定のために渡す、追加パラメータを設定します。 Tentacle の転送モードを設定します。Tentacle クライアントの拡張設定のために渡す、追加パラメータを設定します。
  
 バージョン 3.2 以降のエージェントでは、tentacle がサーバへデータを送信するのに HTTP プロキシをサポートしています。プロキシを利用するには、つぎのような拡張オプションを使います。 バージョン 3.2 以降のエージェントでは、tentacle がサーバへデータを送信するのに HTTP プロキシをサポートしています。プロキシを利用するには、つぎのような拡張オプションを使います。
 +<code>
  
- server_opts "-y user:[email protected]:8080"+server_opts "-y user:[email protected]:8080" 
 + 
 +</code>
  
 この例では、tentacle クライアントがポート 8080、ユーザ "user"、パスワード "pass" でプロキシ 'proxy.inet' に接続します。プロキシサーバが 192.168.1.2 で、ポート番号が 9000、また、認証が無い場合は次のようにします。 この例では、tentacle クライアントがポート 8080、ユーザ "user"、パスワード "pass" でプロキシ 'proxy.inet' に接続します。プロキシサーバが 192.168.1.2 で、ポート番号が 9000、また、認証が無い場合は次のようにします。
  
- server_opts "-y 192.168.1.2:9000"+<code> 
 +server_opts "-y 192.168.1.2:9000" 
 + 
 +</code> 
 + 
 +=== delayed_startup ===
  
-====delayed_startup==== 
 //デフォルトでは無効です。// エージェント起動後、処理を開始するまでの待ち時間(**秒** または **分**)です。MS Windows 以外のソフトウエアエージェントで利用できます。 //デフォルトでは無効です。// エージェント起動後、処理を開始するまでの待ち時間(**秒** または **分**)です。MS Windows 以外のソフトウエアエージェントで利用できます。
 +=== startup_delay ===
  
-====startup_delay==== +//デフォルトでは無効です。// エージェント起動後、処理を開始するまでの秒単位の待ち時間です。MS Windows のみ。 
-//デフォルトでは無効です。// エージェント起動後、処理を開始するまでの秒単位の待ち時間です。MS Windows® でのみ利用できます+=== pandora_nice ===
  
-====pandora_nice==== 
 このパラメータには、Pandora FMS エージェントプロセスの優先順位を設定します。この設定は、Unix/Linux エージェントにのみ存在します。 このパラメータには、Pandora FMS エージェントプロセスの優先順位を設定します。この設定は、Unix/Linux エージェントにのみ存在します。
  
-====autotime====+=== autotime === 
 これを有効に設定 (1 に設定) すると、エージェントが送信する時間データを無視し、サーバに接続した時間をサーバのローカル時間で認識するようになります。この設定は、何らかの理由によりエージェントの時刻がおかしかったり、サーバの時刻と大きくずれている場合に利用します。 これを有効に設定 (1 に設定) すると、エージェントが送信する時間データを無視し、サーバに接続した時間をサーバのローカル時間で認識するようになります。この設定は、何らかの理由によりエージェントの時刻がおかしかったり、サーバの時刻と大きくずれている場合に利用します。
  
-====cron_mode====+=== cron_mode === 
 このパラメータを有効にすると、エージェントをそれ自身の実行の仕組みではなく、Linux の crontab から指定した時刻に実行できるようになります。デフォルトでは無効になっています。 このパラメータを有効にすると、エージェントをそれ自身の実行の仕組みではなく、Linux の crontab から指定した時刻に実行できるようになります。デフォルトでは無効になっています。
  
-====remote_config====+=== remote_config === 
 (Pandora FMS Enterprise のみ) (Pandora FMS Enterprise のみ)
  
 リモートエージェント設定を有効化(1)または無効化(0)します。Tentacle 転送モードでのみ利用できます。 リモートエージェント設定を有効化(1)または無効化(0)します。Tentacle 転送モードでのみ利用できます。
  
-====xml_buffer====+=== xml_buffer === 
 有効化(1)すると、エージェントは接続障害等でサーバに XML ファイルを送信できなかったとき、それをテンポラリディレクトリに保存します。それらは、通信が復旧したときに送られます。 有効化(1)すると、エージェントは接続障害等でサーバに XML ファイルを送信できなかったとき、それをテンポラリディレクトリに保存します。それらは、通信が復旧したときに送られます。
  
-====timezone_offset====+=== timezone_offset === 
 エージェントではサーバのタイムゾーンとのオフセットを設定できます。これは、エージェントが異なるタイムゾーンのサーバで稼働しているとき、同じ時間に合わせる場合にとても便利です。エージェントは、調整したタイムゾーンでサーバに送信します。 エージェントではサーバのタイムゾーンとのオフセットを設定できます。これは、エージェントが異なるタイムゾーンのサーバで稼働しているとき、同じ時間に合わせる場合にとても便利です。エージェントは、調整したタイムゾーンでサーバに送信します。
  
 +<code>
  # Timezone offset: Difference with the server timezone  # Timezone offset: Difference with the server timezone
  timezone_offset 3  timezone_offset 3
 +
 +</code>
  
 サーバのタイムゾーンからエージェントのタイムゾーンを差し引いて計算されます。例えば、サーバのタイムゾーンが UTC+1 で、エージェントのタイムゾーンが UTC-5 であれば、タイムゾーンのオフセットは、6 = 1 - (-5) です。 サーバのタイムゾーンからエージェントのタイムゾーンを差し引いて計算されます。例えば、サーバのタイムゾーンが UTC+1 で、エージェントのタイムゾーンが UTC-5 であれば、タイムゾーンのオフセットは、6 = 1 - (-5) です。
  
-====parent_agent_name====+=== parent_agent_name === 
 ソフトウエアエージェントの親を指定します。Pandora FMS に存在するエージェント名である必要があります。 ソフトウエアエージェントの親を指定します。Pandora FMS に存在するエージェント名である必要があります。
  
-==== agent_threads <スレッド数> ====+=== agent_threads <スレッド数> === 
 モジュールを並行して実行するエージェントのスレッド数です。デフォルトではシングルスレッドで、すべての処理完了まで 1つずつモジュールを実行します。これは、UNIX エージェントのみの機能です。 モジュールを並行して実行するエージェントのスレッド数です。デフォルトではシングルスレッドで、すべての処理完了まで 1つずつモジュールを実行します。これは、UNIX エージェントのみの機能です。
  
 +<code>
  # Number of threads to execute modules in parallel  # Number of threads to execute modules in parallel
  agent_threads 4  agent_threads 4
  
-====include <ファイル名> ====+</code> 
 + 
 +=== include <ファイル名> === 
 別の設定ファイルパスです。このファイルには、メインの設定ファイルに加えて追加のモジュールや収集を含めることができます。これはオプションです。ファイルのアップロードには、ユーザに少なくともエージェントの(AW)権限が必要です。 別の設定ファイルパスです。このファイルには、メインの設定ファイルに加えて追加のモジュールや収集を含めることができます。これはオプションです。ファイルのアップロードには、ユーザに少なくともエージェントの(AW)権限が必要です。
  
-====broker_agent <名前> ====+=== broker_agent <名前> === 
 ブローカーエージェント機能を有効化します。有効化するにはパラメータのコメントを外し、ブローカーエージェントに割り当てる名前を指定する必要があるだけです。メインの設定ファイルに記載したブローカーエージェントの名前で新たな設定ファイルが生成されます。この設定はメインのエージェントでのみ利用でき、作成された新たなエージェント設定内では利用できません。 ブローカーエージェント機能を有効化します。有効化するにはパラメータのコメントを外し、ブローカーエージェントに割り当てる名前を指定する必要があるだけです。メインの設定ファイルに記載したブローカーエージェントの名前で新たな設定ファイルが生成されます。この設定はメインのエージェントでのみ利用でき、作成された新たなエージェント設定内では利用できません。
  
- broker_agent Name_broker+<code> 
 +broker_agent Name_broker 
 + 
 +</code> 
 + 
 +=== pandora_user <ユーザ> ===
  
-====pandora_user <ユーザ>==== 
 このパラメータはオプションで、システムの特定のユーザでエージェントを実行させるためのものです。指定するユーザは、エージェントの実行権限等を持つ必要があります。 このパラメータはオプションで、システムの特定のユーザでエージェントを実行させるためのものです。指定するユーザは、エージェントの実行権限等を持つ必要があります。
  
-====(>5.X) custom_id====+=== custom_id === 
 + 
 +<WRAP center round tip 60%>バージョン 5.X 以上</WRAP> 
 外部アプリケーションのための、エージェントのカスタム ID です。 外部アプリケーションのための、エージェントのカスタム ID です。
  
-====(>5.X) url_address====+=== url_address === 
 + 
 +<WRAP center round tip 60%>バージョン 5.X 以上</WRAP> 
 コンソールでエージェントから開くカスタム URL です。 コンソールでエージェントから開くカスタム URL です。
  
-====(>5.X) custom_fieldX_name====+=== custom_fieldX_name === 
 + 
 +<WRAP center round tip 60%>バージョン 5.X 以上</WRAP> 
 システムに設定済のエージェントのカスタムフィールド名です。存在しない場合は無視されます。 システムに設定済のエージェントのカスタムフィールド名です。存在しない場合は無視されます。
  
 例: 例:
  
- custom_field1_name Model+<code> 
 +custom_field1_name Model 
 + 
 +</code> 
 + 
 +=== custom_fieldX_value === 
 + 
 +<WRAP center round tip 60%>バージョン 5.X 以上</WRAP>
  
-====(>= 5.X) custom_fieldX_value==== 
 前述のパラメータで定義されたカスタムフィールド X の値です。 前述のパラメータで定義されたカスタムフィールド X の値です。
  
 例: 例:
  
- custom_field1_value C1700+<code> 
 +custom_field1_value C1700 
 + 
 +</code> 
 + 
 +=== macro === 
 + 
 +<WRAP center round tip 60%>バージョン 5.X 以上</WRAP> 
 + 
 +<code> 
 +macro<macro> <value>
  
-==== (>= 5.X) macro ==== +</code>
- macro<macro> <value>+
  
-モジュールの定義で利用可能なローカル実行マクロを定義します。この種のマクロは、主にメタコンソールシステムで利用します。ローカルモジュールコンポーネントシステムで、ローカルモジュールの利用を簡単にし、ソースモジュールの定義を編集する必要がないようにします。これにより、GUI に新たなフィールドが表示されます。ローカル実行マクロは、_field1_、_field2_、... のようなローカルプラグインマクロと似た名前をもちます。+モジュールの定義で利用可能なローカル実行マクロを定義します。この種のマクロは、主にメタコンソールシステムで利用します。ローカルモジュールコンポーネントシステムで、ローカルモジュールの利用を簡単にし、ソースモジュールの定義を編集する必要がないようにします。これにより、GUI に新たなフィールドが表示されます。ローカル実行マクロは、_field1_、_field2_、… のようなローカルプラグインマクロと似た名前をもちます。
  
 例: 例:
  
-<code>[email protected]@</code>+<code> 
 +module_begin 
 +module_name Particion_opt 
 +module_type generic_data 
 +module_exec df -kh _field1_ | tail -1 |  awk '{ print $5}' | tr -d "%" 
 +module_macro_field1_ /opt 
 +module_end 
 + 
 +</code
 + 
 +=== group_password <パスワード> === 
 + 
 +<WRAP center round tip 60%>バージョン 6.0SP5 以上</WRAP>
  
-==== (>= 6.0SP5) group_password <パスワード> ==== 
 エージェントグループのパスワードです。グループのパスワード保護をしない場合は、コメントアウトした状態にしてください。 エージェントグループのパスワードです。グループのパスワード保護をしない場合は、コメントアウトした状態にしてください。
  
-==== (>= 7.0) ehorus_conf <パス> ====+=== ehorus_conf <パス> === 
 + 
 +<WRAP center round tip 60%>バージョン NG 7 以上</WRAP> 
 [[https://ehorus.com/|eHorus]] エージェント設定ファイルの絶対パスです。エージェントは、eHorus エージェントを特定するキーを含むカスタムフィールド名 //eHoursID// を作成します。 [[https://ehorus.com/|eHorus]] エージェント設定ファイルの絶対パスです。エージェントは、eHorus エージェントを特定するキーを含むカスタムフィールド名 //eHoursID// を作成します。
 +=== transfer_mode_user <ユーザ> ===
 +
 +<WRAP center round tip 60%>バージョン NG 7.0 OUM713 以上</WRAP>
  
-==== (>= 7.0OUM713) transfer_mode_user <ユーザ> ==== 
 ローカル転送モードでコピーされるファイルのユーザでえす。正しく動作するためには、コンソールのフォルダで、このユーザがリモート設定ファイルを読み書きできる権限が必要です。デフォルトは //apache// です。 ローカル転送モードでコピーされるファイルのユーザでえす。正しく動作するためには、コンソールのフォルダで、このユーザがリモート設定ファイルを読み書きできる権限が必要です。デフォルトは //apache// です。
 +=== secondary_groups <セカンダリグループ> ===
 +
 +<WRAP center round tip 60%>バージョン NG 7.0 OUM721 以上</WRAP>
  
-===== (>= 7.0OUM721) secondary_groups <セカンダリグループ> ===== 
 エージェントに割り当てるセカンダリグループ名です。複数のセカンダリグループをカンマ区切りで指定できます。サーバ上に存在しないグループを指定した場合はグループは割り当てられませんが、エージェントの作成には影響ありません。 エージェントに割り当てるセカンダリグループ名です。複数のセカンダリグループをカンマ区切りで指定できます。サーバ上に存在しないグループを指定した場合はグループは割り当てられませんが、エージェントの作成には影響ありません。
  
-===== (>= 7.0OUM728) standby <1|0> =====+=== standby <1|0> === 
 + 
 +<WRAP center round tip 60%>バージョン NG 7.0 OUM728 以上</WRAP> 
 エージェントがスタンバイモード(1)の場合、エージェントは監視を実行せず XML の生成や送信を行いません。この設定は、リモート設定がある Enterprise 版の利用時に意味があります。これにより、エージェントを無効化した場合に動作を停止することができます。 エージェントがスタンバイモード(1)の場合、エージェントは監視を実行せず XML の生成や送信を行いません。この設定は、リモート設定がある Enterprise 版の利用時に意味があります。これにより、エージェントを無効化した場合に動作を停止することができます。
  
 デバッグモードの場合はこの機能を上書きし、エージェントは通常動作をします。 デバッグモードの場合はこの機能を上書きし、エージェントは通常動作をします。
  
-====== セカンダリサーバ ======+==== セカンダリサーバ ==== 
 データを送信するセカンダリサーバを設定することができます。設定により二種類の動作モードがあります。 データを送信するセカンダリサーバを設定することができます。設定により二種類の動作モードがあります。
  
   * **on_error**: プライマリサーバにデータを送信出来なかった場合のみ、セカンダリサーバにデータを送信します。   * **on_error**: プライマリサーバにデータを送信出来なかった場合のみ、セカンダリサーバにデータを送信します。
   * **always**: プライマリサーバにデータが送信できるかどうかに関わらず、常にセカンダリサーバにもデータを送信します。   * **always**: プライマリサーバにデータが送信できるかどうかに関わらず、常にセカンダリサーバにもデータを送信します。
- 
 設定例: 設定例:
 +<code>
  
  secondary_server_ip     192.168.1.123  secondary_server_ip     192.168.1.123
行 207: 行 309:
  secondary_server_port   41121  secondary_server_port   41121
  
-====== UDP サーバ ====== +</code>
-Pandora FMS エージェントは、リモートからコマンドを受け取る設定ができます。このサーバは、ユーザが指定した UDP のポートで待ち受けており、アラートが発生したときに何らかのコマンドを実行するなど、リモートシステム (基本的には Pandora FMS) から命令を受け取ることができます。+
  
-UDP リモートサーバの設定には、いくつかのオプションがあり、//pandora_agent.conf// にて設定します。+==== UDP サーバ ==== 
 + 
 +<WRAP center round important 60%> 
 + 
 +UDPは本質的に安全ではないことに注意してください(ただし、応答を必須としないメッセージを送信するには効率的です)。 </WRAP> 
 + 
 +Pandora FMS エージェントは、 [[:ja:documentation:03_monitoring:02_operations#udp_リモートコマンド|リモートからコマンドを受け取る]]設定ができます。このサーバは、ユーザが指定した UDP のポートで待ち受けており、アラートが発生したときに何らかのコマンドを実行するなど、リモートシステム (基本的には Pandora FMS) から命令を受け取ることができます。 
 + 
 +UDP リモートサーバの設定には、いくつかのオプションがあり、//pandora_agent.conf//  にて設定します。
  
   * **udp_server**:UDP サーバを有効にする場合は 1 を設定します。デフォルトでは無効です。   * **udp_server**:UDP サーバを有効にする場合は 1 を設定します。デフォルトでは無効です。
   * **udp_server_port**: 待ち受けポート番号を設定します。   * **udp_server_port**: 待ち受けポート番号を設定します。
   * **udp_server_auth_address**: 命令の送信を許可する IPアドレスを設定します。カンマ区切りで複数のアドレスを指定できます。0.0.0.0 に設定すると、UDP サーバはすべてのアドレスからのリクエストを受け付けます。   * **udp_server_auth_address**: 命令の送信を許可する IPアドレスを設定します。カンマ区切りで複数のアドレスを指定できます。0.0.0.0 に設定すると、UDP サーバはすべてのアドレスからのリクエストを受け付けます。
-  * **process_<name>_start <command>**: ユーザ定義プロセスを起動するコマンドを設定します。 +<WRAP center round important 60%> 
 + 
 +すべてのソースからのコマンド受け入れのために 0.0.0.0 に設定できますが、この方法はお勧めしません。複数の Pandora FMS サーバがある場合、または IPv6 を使用している場合は、カンマで区切って異なる IP アドレスを追加できます。たとえば、 IPv6:''2001:0db8:0000:130F:0000:0000:087C:140B''  があり、その省略形が ''2001:0db8:0:130F::87C:140B''  の場合は、両方をカンマで区切って指定します。 </WRAP> 
 + 
 +  * **process_<name>_start <command>**: ユーザ定義プロセスを起動するコマンドを設定します。
   * **process_<name>_stop <command>**: プロセスを停止するコマンドを設定します。   * **process_<name>_stop <command>**: プロセスを停止するコマンドを設定します。
   * **service_<name> 1**: リモートから停止や起動ができるサービス名 <name> を設定します。   * **service_<name> 1**: リモートから停止や起動ができるサービス名 <name> を設定します。
- 
 設定例: 設定例:
 +<code>
  
  udp_server 1  udp_server 1
行 225: 行 338:
  udp_server_auth_address 192.168.1.23  udp_server_auth_address 192.168.1.23
  process_firefox_start firefox  process_firefox_start firefox
- process_firefox_stop killall firefox  + process_firefox_stop killall firefox 
- service_messenger 1 + service_messenger 1 
 + 
 +</code>
  
 サーバは、次のコマンドを受け付けます。 サーバは、次のコマンドを受け付けます。
  
 +<code>
  * **<START|STOP> SERVICE <サービス名>**: サービスの起動や停止を行います。  * **<START|STOP> SERVICE <サービス名>**: サービスの起動や停止を行います。
  * **<START|STOP> PROCESS <プロセス名>**: プロセスの起動や停止を行います。  * **<START|STOP> PROCESS <プロセス名>**: プロセスの起動や停止を行います。
  * **REFRESH AGENT <エージェント名>**: エージェントの強制実行および、データの更新を行います。  * **REFRESH AGENT <エージェント名>**: エージェントの強制実行および、データの更新を行います。
 +
 +</code>
  
 例: 例:
 +<code>
  
  STOP SERVICE messenger  STOP SERVICE messenger
行 240: 行 359:
  REFRESH AGENT 007  REFRESH AGENT 007
  
-サーバの ///util/udp_client.pl// に、Pandora FMS サーバでアラート発生時にプロセスやサービスを起動できる実行コマンドとして利用できるスクリプトがあります。次のような書式で利用します。+</code>
  
- ./udp_client.pl <address> <port> <command>+サーバの ///util/udp_client.pl//  に、Pandora FMS サーバでアラート発生時にプロセスやサービスを起動できる実行コマンドとして利用できるスクリプトがあります。次のような書式で利用します。 
 + 
 +<code> 
 +./udp_client.pl <address> <port> <command
 + 
 +</code>
  
 例えば、エージェントを再起動するには次のようにします。 例えば、エージェントを再起動するには次のようにします。
  
- ./udp_client.pl 192.168.50.30 41122 "REFRESH AGENT"+<code> 
 +./udp_client.pl 192.168.50.30 41122 "REFRESH AGENT" 
 + 
 +</code> 
 + 
 +より詳しくは、 [[:ja:documentation:04_using:01_alerts#定義済のコマンド|アラート設定の章]]を参照ください。
  
-より詳しくは、アラト設の章を参照ください。+==== モジュ義 ====
  
-====== モジュール定義 ====== 
 設定ファイル pandora_agent.conf にてローカルモジュールの実行を定義します。利用可能な全パラメータを以下に説明します。 設定ファイル pandora_agent.conf にてローカルモジュールの実行を定義します。利用可能な全パラメータを以下に説明します。
  
 一般的な書式は次の通りです。 一般的な書式は次の通りです。
 +<code>
  
  module_begin  module_begin
行 259: 行 388:
  module_type generic_data  module_type generic_data
  module_exec <実行するローカルコマンド>  module_exec <実行するローカルコマンド>
- module_end + module_end 
 + 
 +</code>
  
 モジュールの種類によって違いがあります。この例は、ほとんどのモジュールで使われる共通で必須の行のみです。 モジュールの種類によって違いがあります。この例は、ほとんどのモジュールで使われる共通で必須の行のみです。
  
-==== 全モジュールで共通の項目 ==== +=== 全モジュールで共通の項目 === 
-{{pandora:documentation_ja:warning|モジュールのフィールド情報はモジュール作成時にのみ反映されます(モジュールデータ、説明、拡張情報を除く)。モジュールがすでに存在する場合は更新されません。}}+ 
 +<WRAP center round important 60%> モジュールのフィールド情報はモジュール作成時にのみ反映されます(モジュールデータ、説明、拡張情報を除く)。モジュールがすでに存在する場合は更新されません。 </WRAP> 
 + 
 +== module_begin ==
  
-=== **module_begin** === 
 モジュール定義の開始を示す、必須項目です。 モジュール定義の開始を示す、必須項目です。
  
-=== module_name <名前> ===+== module_name == 
 モジュールの名前です(必須)。重複した名前は設定できません。 モジュールの名前です(必須)。重複した名前は設定できません。
  
-=== module_type === +<code> 
-モジュールが返すデータタイプです。いずれか一つを選択することが必須です。指定可能なデータタイプは次の通りです。+module_name <名前>
  
-  * **Numerical** (generic_data): 小数または整数の数値データです。小数値の場合は整数に切り捨てられます。+</code>
  
-  * **Incremental** (generic_data_inc): 前の値と現在の値の差分を間隔の時間で割ったデータです。差分がマイナスの場合は値はリセットされます。これは、差分は再びプラスになること、増分がプラスの値である限りは前のデータとの差が利用されることを意味します。+== module_type ==
  
-  * **Absolute incremental** (generic_data_inc_abs): 前の値と現在の値の差分デーです。絶対的な差分の値であり、単位時間あたりの差分ではありません。差分がマナスの場合は値はリセットされます。差分が再びラスになった場合はベースの値として利用され、そこから差分が計算されます。+<code> 
 +module_type <タイプ>
  
-  * **Alphanumeric** (generic_data_string): 文字列です。+</code>
  
-  * **Booleans** (generic_proc): 正常(1)または異常(0)をとる値です。コンピュータが動いているか、プロセスやサービス動いているかどうかのチェックに便利です。異常値(0)に障害状態があらかじめ設定されています。それよりも大きい任意値(1よ大きい数字も扱えます)は正常と判断されます。+モジュールが返すデータタイプです。いずれか一つを選択すこと必須です。指定可能なデータタイプす。
  
-  * **Asynchronous Alphanumeric** (async_string): (定期実行ではない)非同期の文字列収集に使います。非同期監視は、任意のタイミングで発生するイベントや変更に依存するため、このタイプのモジュールは不明状態にはなりません。+  * **Numerical**  (generic_data): 小数または整数の数値データです。小数値の場合は整数に切り捨てられます。 
 +  * **Incremental**  (generic_data_inc): 前の値と現在の値の差分を間隔の時間で割ったデータです。差分がマイナスの場合は値はリセットされます。これは、差分は再びプラスになること、増分がプラスの値である限りは前のデータとの差が利用されることを意味します。 
 +  * **Absolute incremental**  (generic_data_inc_abs): 前の値と現在の値の差分データです。絶対的な差分の値であり、単位時間あたりの差分ではありません。差分がマイナスの場合は値はリセットされます。差分が再びプラスになった場合はベースの値として利用され、そこから差分が計算されます。 
 +  * **Alphanumeric**  (generic_data_string): 文字列です。 
 +  * **Booleans**  (generic_proc): 正常(1)または異常(0)をとる値です。コンピュータが動いているか、プロセスやサービスが動いているかどうかのチェックに便利です。異常値(0)には障害状態があらかじめ設定されています。それよりも大きい任意の値(1より大きい数字も扱えます)は正常と判断されます。 
 +  * **Asynchronous Alphanumeric**  (async_string): (定期実行ではない)非同期の文字列収集に使います。非同期監視は、任意のタイミングで発生するイベントや変更に依存するため、このタイプのモジュールは不明状態にはなりません。 
 +  * **Asynchronous Monitor**  (async_proc): generic_proc と似ていますが、非同期のデータタイプです。 
 +  * **Asynchronous Numerical**  (async_data): generic_data と似ていますが、非同期のデータタイプです。 
 +== module_min ==
  
-  * **Asynchronous Monitor** (async_proc): generic_proc と似ていますが、非同期のデータタイプです。+<code> 
 +module_min <値>
  
-  * **Asynchronous Numerical** (async_data): generic_data と似ていますが、非同期のデータタイプです。+</code>
  
-=== module_min <値> === 
 そのモジュールが返すことを許容されるデータの最小値です。範囲を外れたデータはサーバにより削除されます。 そのモジュールが返すことを許容されるデータの最小値です。範囲を外れたデータはサーバにより削除されます。
  
-=== module_max <値> ===+== module_max =
 + 
 +<code> 
 +module_max <値> 
 + 
 +</code> 
 そのモジュールが返すことを許容されるデータの最大値です。範囲を外れたデータはサーバにより削除されます。 そのモジュールが返すことを許容されるデータの最大値です。範囲を外れたデータはサーバにより削除されます。
  
-=== module_min_warning <値> ===+== module_min_warning =
 + 
 +<code> 
 +module_min_warning <値> 
 + 
 +</code> 
 モジュールが警告状態になる最小値です。 モジュールが警告状態になる最小値です。
  
-=== module_max_warning <値> ===+== module_max_warning =
 + 
 +<code> 
 +module_max_warning <値> 
 + 
 +</code> 
 モジュールが警告状態になる最大値です。 モジュールが警告状態になる最大値です。
  
-=== module_min_critical <値> ===+== module_min_critical =
 + 
 +<code> 
 +module_min_critical <値> 
 + 
 +</code> 
 モジュールが障害状態になる最小値です。 モジュールが障害状態になる最小値です。
  
-=== module_max_critical <値> ===+== module_max_critical =
 + 
 +<code> 
 +module_max_critical <値> 
 + 
 +</code> 
 モジュールが障害状態になる最大値です。 モジュールが障害状態になる最大値です。
  
-=== module_disabled <値> ===+== module_disabled =
 + 
 +<code> 
 +module_disabled <値> 
 + 
 +</code> 
 モジュールが、有効(0)か無効(1)かを表します。 モジュールが、有効(0)か無効(1)かを表します。
  
-=== module_min_ff_event <値> ===+== module_min_ff_event =
 + 
 +<code> 
 +module_min_ff_event <値> 
 + 
 +</code> 
 連続抑制回数を指定します。連続抑制回数とは、収集データに揺らぎがあるような場合に、それを変化としてとらえないように抑止するものです。 連続抑制回数を指定します。連続抑制回数とは、収集データに揺らぎがあるような場合に、それを変化としてとらえないように抑止するものです。
  
-=== (>= 6.0 SP4module_each_ff <===+== module_each_ff == 
 + 
 +<WRAP center round tip 60%>バージョン 6.0 SP4 以上</WRAP> 
 + 
 +<code> 
 +module_each_ff <0|1> 
 + 
 +</code> 
 有効化(1)すると、module_min_ff_event の代わりに連続抑制回数に個別状態変化(module_min_ff_event_normal, module_min_ff_event_warning および module_min_ff_event_critical)を利用します。 有効化(1)すると、module_min_ff_event の代わりに連続抑制回数に個別状態変化(module_min_ff_event_normal, module_min_ff_event_warning および module_min_ff_event_critical)を利用します。
  
-=== (>= 6.0 SP4module_min_ff_event_normal <値> ===+== module_min_ff_event_normal == 
 + 
 +<WRAP center round tip 60%>バージョン 6.0 SP4 以上</WRAP> 
 +<code> 
 + 
 +module_min_ff_event_normal <値> 
 + 
 +</code> 
 個別状態変化で、正常状態へ移行する場合の連続抑制回数です。 個別状態変化で、正常状態へ移行する場合の連続抑制回数です。
  
-=== (>= 6.0 SP4module_min_ff_event_warning <値> ===+== module_min_ff_event_warning == 
 + 
 +<WRAP center round tip 60%>バージョン 6.0 SP4 以上</WRAP> 
 + 
 +<code> 
 +module_min_ff_event_warning <値> 
 + 
 +</code> 
 個別状態変化で、警告状態へ移行する場合の連続抑制回数です。 個別状態変化で、警告状態へ移行する場合の連続抑制回数です。
  
-=== (>= 6.0 SP4module_min_ff_event_critical <値> ===+== module_min_ff_event_critical == 
 + 
 +<WRAP center round tip 60%>バージョン 6.0 SP4 以上</WRAP> 
 + 
 +<code> 
 +module_min_ff_event_critical <値> 
 + 
 +</code> 
 個別状態変化で、障害状態へ移行する場合の連続抑制回数です。 個別状態変化で、障害状態へ移行する場合の連続抑制回数です。
  
-=== (>= 6.0 SP4module_ff_timeout <秒> === +== module_ff_timeout == 
-指定した秒数が経過したら連続抑制回数のカウンターをリセットします。これは、//module_min_ff_event// に指定した抑制回数の状態変化が //module_ff_timeout// に指定の秒数以内に発生する必要があることを意味します。+ 
 +<WRAP center round tip 60%>バージョン 6.0 SP4 以上</WRAP> 
 + 
 +<code> 
 +module_ff_timeout <秒> 
 + 
 +</code> 
 + 
 +指定した秒数が経過したら連続抑制回数のカウンターをリセットします。これは、//module_min_ff_event//  に指定した抑制回数の状態変化が //module_ff_timeout//  に指定の秒数以内に発生する必要があることを意味します。 
 + 
 +== module_ff_type == 
 + 
 +<WRAP center round tip 60%>バージョン NG 734 以上</WRAP> 
 + 
 +<code> 
 +module_ff_type <値> 
 + 
 +</code>
  
-=== (>= 734) module_ff_type <値> === 
 これは、連続抑制の高度なオプションで、モジュールの状態を制御します。 "カウンタを保持する" ことによって、値の代わりに、受け取った値を持つモジュールの状態に応じて、ある状態から別の状態に渡すカウンタ値をいくつか設定します。 これは、連続抑制の高度なオプションで、モジュールの状態を制御します。 "カウンタを保持する" ことによって、値の代わりに、受け取った値を持つモジュールの状態に応じて、ある状態から別の状態に渡すカウンタ値をいくつか設定します。
  
 有効(1)か無効(0)かを指定します。 有効(1)か無効(0)かを指定します。
  
-=== module_description <テキスト> ===+== module_description =
 + 
 +<code> 
 +module_description <テキスト> 
 + 
 +</code> 
 モジュールの任意のコメントです。 モジュールの任意のコメントです。
  
-=== module_interval <間隔倍率> ===+== module_interval =
 + 
 +<code> 
 +module_interval <間隔倍率> 
 + 
 +</code> 
 それぞれのモジュールの実行間隔をエージェントの間隔の倍率で設定することができます。例えば、エージェントが 300 (5 分)間隔の設定であった場合に、あるモジュールだけ 15分間隔にしたいときに、module_interval 3 を設定します。そのモジュールは、300秒 x 3 = 900秒 (15分) 間隔で実行されます。 それぞれのモジュールの実行間隔をエージェントの間隔の倍率で設定することができます。例えば、エージェントが 300 (5 分)間隔の設定であった場合に、あるモジュールだけ 15分間隔にしたいときに、module_interval 3 を設定します。そのモジュールは、300秒 x 3 = 900秒 (15分) 間隔で実行されます。
  
-{{pandora:documentation_ja:warning|ブローカーエージェントで module_interval が動作するようにするには、元のエージェントと同じ間隔に設定する必要があります。 そうしないと、正しく動作しない可能性があります。}}+<WRAP center round important 60%> ブローカーエージェントで module_interval が動作するようにするには、元のエージェントと同じ間隔に設定する必要があります。 そうしないと、正しく動作しない可能性があります。 </WRAP> 
 + 
 +== module_timeout == 
 + 
 +<code> 
 +module_timeout <秒数> 
 + 
 +</code>
  
-=== module_timeout <秒数> === 
 モジュールの最大実行時間を秒単位で指定します。実行中にこの時間を超過した場合は、実行が中止されます。 モジュールの最大実行時間を秒単位で指定します。実行中にこの時間を超過した場合は、実行が中止されます。
  
-=== module_postprocess <倍率> ===+== module_postprocess =
 + 
 +<code> 
 +module_postprocess <倍率> 
 + 
 +</code> 
 モジュールから返される値を何倍するかの値です。データの単位を変換するのに便利です。もし、エージェントが取得した値に 1024 を掛けたい場合は、1024 を設定します。また、1024 で割りたい場合は、1/1024 を意味する 0.000976563 を設定します。 モジュールから返される値を何倍するかの値です。データの単位を変換するのに便利です。もし、エージェントが取得した値に 1024 を掛けたい場合は、1024 を設定します。また、1024 で割りたい場合は、1/1024 を意味する 0.000976563 を設定します。
  
-=== module_save <変数名> ===+== module_save =
 + 
 +<code> 
 +module_save <変数名> 
 + 
 +</code> 
 このパラメータで定義された名前の変数にモジュールから返された値を保存します。この値はあとから他のモジュールで利用できます。 このパラメータで定義された名前の変数にモジュールから返された値を保存します。この値はあとから他のモジュールで利用できます。
  
 例: 例:
  
 +<code>
  module_begin  module_begin
  module_name echo_1  module_name echo_1
行 360: 行 624:
  module_save ECHO_1  module_save ECHO_1
  module_end  module_end
 +
 +</code>
  
 "ECHO_1" という変数に、値 41121 を保存します。 "ECHO_1" という変数に、値 41121 を保存します。
  
 +<code>
  module_begin  module_begin
  module_name echo_2  module_name echo_2
行 368: 行 635:
  module_exec echo $ECHO_1  module_exec echo $ECHO_1
  module_end  module_end
 +
 +</code>
  
 2つ目のモジュールでは、"$ECHO_1" という変数の内容を表示します。"41121" となります。 2つ目のモジュールでは、"$ECHO_1" という変数の内容を表示します。"41121" となります。
  
-Windows エージェントでは、変数は $var ではなく %var% で指定します。 +Windows エージェントでは、変数は $var ではなく %var% で指定します。 以下に例を示します。
-以下に例を示します。+
  
 +<code>
  module_begin  module_begin
  module_name echo_2  module_name echo_2
行 380: 行 649:
  module_end  module_end
  
-=== module_crontab <<時間> <日> <月> <曜日> === +</code>
-バージョン 3.2 から、モジュールを指定した日時に実行させるようにすることができます。この設定は、**module_crontab** にて、crontab に似た設定を行うことにより実現します。+
  
 +== module_crontab ==
 +
 +バージョン 3.2 から、モジュールを指定した日時に実行させるようにすることができます。この設定は、**module_crontab**  にて、crontab に似た設定を行うことにより実現します。
 +
 +<code>
 module_crontab <分> <時間> <日> <月> <曜日> module_crontab <分> <時間> <日> <月> <曜日>
 +
 +</code>
  
 指定可能な範囲は次の通りです。 指定可能な範囲は次の通りです。
行 393: 行 668:
   * 曜日 0-6 (0 が日曜です)   * 曜日 0-6 (0 が日曜です)
  
-期間を指定する **-** を利用することも可能です。+期間を指定する **-**  を利用することも可能です。
  
 例えば、あるモジュールを毎週月曜の 12時から 15時の間に実行するには、次のような設定をします。 例えば、あるモジュールを毎週月曜の 12時から 15時の間に実行するには、次のような設定をします。
  
 +<code>
  module_begin  module_begin
  module_name crontab_test  module_name crontab_test
行 403: 行 679:
  module_crontab * 12-15 * * 1  module_crontab * 12-15 * * 1
  module_end  module_end
 +
 +</code>
  
 コマンドを毎時 10分に実行したい場合は、次のようにします。 コマンドを毎時 10分に実行したい場合は、次のようにします。
  
 +<code>
  module_begin  module_begin
  module_name crontab_test3  module_name crontab_test3
行 413: 行 692:
  module_end  module_end
  
-=== module_condition <評価式<コマンド> === +</code>
-バージョン 3.2 から、モジュールが特定の値を返す場合にコマンドを実行させることが可能です。次に示すオプションの一つを定義します。+
  
-  * **>** [[pandora:documentation_ja:値]]: モジュールの値が指定された値よりも大きい場合にコマンドを実行します。+== module_condition ==
  
-  * **<** [[pandora:documentation_ja:値]]: モジュールの値が指定された値よりも小さい場合にコマンドを実行します。+<code> 
 +module_condition <評価式> <コマンド>
  
-  * **=** [[pandora:documentation_ja:値]]: モジュールの値が指定された値と同じ場合にコマンドを実行します。+</code>
  
-  * **!=** [[pandora:documentation_ja:値]]: モジュールの値されたと異なる場合にコマンドを実行します。 +バージョン 3.2 から、モジュールがを返す場合にコマンドを実行させることが可能です。オプショの一つを定します。
- +
-  * **=~** [[pandora:documentation_ja:正規表現]]: モジュールの値が指定された正規表現マッチる場合にコマ実行します。 +
- +
-  * **(**値, 値**)**: モジュールの値が指された値の範囲の場合にコマンドを実行します。+
  
-同一のモジュールに複数の条件を設定することも可能です。以下の例では、モジュールの値が 1 と 3 の間の時に//script_1.sh// が実行されます。また、モジュールの値が 5.5 より大きい時に //script_2.sh// が実行されます。//module_exec// の結果が 2.5 なので、最初の //script_1.sh// のみ実行されます。+  * **>**  [値]: モジュールの値が指定された値よりも大きい場合にコマンドを実行します。 
 +  * **<**  [値]: モジュールの値が指定された値よりも小さい場合にコマンドを実行します。 
 +  * **=**  [値]: モジュールの値が指定された値と同じ場合にコマンドを実行します。 
 +  * **!=**  [値]: モジュールの値が指定された値と異なる場合にコマンドを実行します。 
 +  * **=~**  [正規表現]: モジュールの値が指定された正規表現にマッチする場合にコマンドを実行します。 
 +  * **(** 値, 値**)**: モジュールの値が指定された値の範囲の場合にコマンドを実行します。 
 +同一のモジュールに複数の条件を設定することも可能です。以下の例では、モジュールの値が 1 と 3 の間の時に//script_1.sh//  が実行されます。また、モジュールの値が 5.5 より大きい時に //script_2.sh//  が実行されます。//module_exec//  の結果が 2.5 なので、最初の //script_1.sh//  のみ実行されます。
  
 +<code>
  module_begin  module_begin
  module_name condition_test  module_name condition_test
行 435: 行 717:
  module_exec echo 2.5  module_exec echo 2.5
  module_condition (1, 3) script_1.sh  module_condition (1, 3) script_1.sh
- module_condition > 5.5 script_2.sh+ module_condition> 5.5 script_2.sh
  module_end  module_end
 +
 +</code>
  
 例: 例:
  
 +<code>
  module_begin  module_begin
  module_name MyProcess  module_name MyProcess
  module_type generic_data  module_type generic_data
  module_exec tasklist | grep MyProcess | wc -l  module_exec tasklist | grep MyProcess | wc -l
- module_condition > 2 taskkill /IM MyProcess* /F+ module_condition> 2 taskkill /IM MyProcess* /F
  module_end  module_end
 +
 +</code>
 +<code>
  
  module_begin  module_begin
行 451: 行 739:
  module_type generic_data  module_type generic_data
  module_exec ls -la "c:\Archivos de programa\pandora_agent\pandora_agent.log" | gawk "{ print $5 }"  module_exec ls -la "c:\Archivos de programa\pandora_agent\pandora_agent.log" | gawk "{ print $5 }"
- module_condition > 10000 del "c:\Archivos de programa\pandora_agent\pandora_agent.log"+ module_condition> 10000 del "c:\Archivos de programa\pandora_agent\pandora_agent.log"
  module_end  module_end
 +
 +</code>
 +<code>
  
  module_begin  module_begin
行 461: 行 752:
  module_end  module_end
  
-***注意**: Windows プラットホームでは、コマンドの実行にはそれが正しく実行されていることを確認するために **cmd.exe /c** を利用することをお勧めします。例えば次の通りです。+</code> 
 + 
 +  * 注意: Windows プラットホームでは、コマンドの実行にはそれが正しく実行されていることを確認するために **cmd.exe /c**  を利用することをお勧めします。例えば次の通りです。
  
 +<code>
  module_begin  module_begin
  module_name condition_test  module_name condition_test
行 470: 行 764:
  module_end  module_end
  
-=== module_precondition <評価式<コマンド> === +</code>
-事前状態定義にマッチした場合モジュールを実行します。次に示すオプションの一つを定義します。+
  
-  * **>** [[pandora:documentation_ja:値]]: コマンドの実行結果が指定された値よりも大きい場合にモジュールを実行します。+== module_precondition ==
  
-  * **<** [[pandora:documentation_ja:値]]: コマンドの実行結果が指定された値よりも小さい場合にモジュールを実行します。+<code> 
 +module_precondition <評価式> <コマンド>
  
-  * **=** [[pandora:documentation_ja:値]]: コマンドの実行結果が指定された値と同じ場合にモジュールを実行します。+</code>
  
-  * **!=** [[pandora:documentation_ja:値]]: コマンドの実行結果が指された値と異なる場合にモジュールを実行します。 +事前状態にマッチした場合モジュールを実行します。次に示すオプションの一つをします。
- +
-  * **=~** [[pandora:documentation_ja:正規表現]]: コマンドの実行結果が指定された正規表現にマッチする場合モジュールを実行します。 +
- +
-  * **(**値, 値**)**: コマ実行結果が指された値の範囲の場合にモジュールを実行します。+
  
-以下の例では、precondition で設定した実行結果が 2 と 8 の間の場合に、モジュール //monitoring_variable.bat// が実行されます。この例では //module_precondition// の実行結果が 5 であるため、値が 2 と 8 の間であり、//monitoring_variable.bat// が実行されます。+  * **>**  [値]: コマンドの実行結果が指定された値よりも大きい場合にモジュールを実行します。 
 +  * **<**  [値]: コマンドの実行結果が指定された値よりも小さい場合にモジュールを実行します。 
 +  * **=**  [値]: コマンドの実行結果が指定された値と同じ場合にモジュールを実行します。 
 +  * **!=**  [値]: コマンドの実行結果が指定された値と異なる場合にモジュールを実行します。 
 +  * **=~**  [正規表現]: コマンドの実行結果が指定された正規表現にマッチする場合にモジュールを実行します。 
 +  * **(** 値, 値**)**: コマンドの実行結果が指定された値の範囲の場合にモジュールを実行します。 
 +以下の例では、precondition で設定した実行結果が 2 と 8 の間の場合に、モジュール //monitoring_variable.bat//  が実行されます。この例では //module_precondition//  の実行結果が 5 であるため、値が 2 と 8 の間であり、//monitoring_variable.bat//  が実行されます。
  
 +<code>
  module_begin  module_begin
  module_name Precondition_test1  module_name Precondition_test1
行 493: 行 790:
  module_exec monitoring_variable.bat  module_exec monitoring_variable.bat
  module_end  module_end
 +
 +</code>
  
 module_condition と同様に、複数の事前状態定義を利用することができます。モジュールは、すべての事前状態定義にマッチした場合のみ実行されます。 module_condition と同様に、複数の事前状態定義を利用することができます。モジュールは、すべての事前状態定義にマッチした場合のみ実行されます。
  
 +<code>
  module_begin  module_begin
  module_name Precondition_test2  module_name Precondition_test2
  module_type generic_data  module_type generic_data
  module_precondition (2, 8) echo 5  module_precondition (2, 8) echo 5
- module_precondition < 3 echo 5+ module_precondition <3 echo 5
  module_exec monitoring_variable.bat  module_exec monitoring_variable.bat
  module_end  module_end
  
-***注意**: Windows プラットホームでは、コマンドの実行にはそれが正しく実行されていることを確認するために **cmd.exe /c** を利用することをお勧めします。例えば次の通りです。+</code> 
 + 
 +  * 注意: Windows プラットホームでは、コマンドの実行にはそれが正しく実行されていることを確認するために **cmd.exe /c**  を利用することをお勧めします。例えば次の通りです。
  
 +<code>
  module_begin  module_begin
  module_name Precondition_test3  module_name Precondition_test3
行 513: 行 816:
  module_end  module_end
  
-=== (>= 5.xmodule_unit <単位> ===+</code> 
 + 
 +== module_unit == 
 + 
 +<WRAP center round tip 60%>バージョン 5.x 以上</WRAP> 
 + 
 +<code> 
 +module_unit <単位> 
 + 
 +</code> 
 これは、モジュールの値に付与する単位です。 これは、モジュールの値に付与する単位です。
  
 例: 例:
  
- module_unit %+<code> 
 +module_unit % 
 + 
 +</code> 
 + 
 +== module_group == 
 + 
 +<WRAP center round tip 60%>バージョン 5.x 以上</WRAP> 
 + 
 +<code> 
 +module_group <値> 
 + 
 +</code>
  
-=== (>= 5.x) module_group <値> === 
 これは、モジュールグループ名です。 これは、モジュールグループ名です。
  
 例: 例:
  
- module_group Networking+<code> 
 +module_group Networking 
 + 
 +</code> 
 + 
 +== module_custom_id == 
 + 
 +<WRAP center round tip 60%>バージョン 5.x 以上</WRAP> 
 + 
 +<code> 
 +module_custom_id <値> 
 + 
 +</code>
  
-=== (>= 5.x) module_custom_id <値> === 
 モジュールのカスタム ID です。 モジュールのカスタム ID です。
  
 例: 例:
  
- module_custom_id host101+<code> 
 +module_custom_id host101 
 + 
 +</code> 
 + 
 +== module_str_warning == 
 + 
 +<WRAP center round tip 60%>バージョン 5.x 以上</WRAP> 
 + 
 +<code> 
 +module_str_warning <値> 
 + 
 +</code>
  
-=== (>= 5.x) module_str_warning <値> === 
 文字列タイプのモジュールで警告状態を定義する正規表現です。 文字列タイプのモジュールで警告状態を定義する正規表現です。
  
 例: 例:
  
- module_str_warning .*NOTICE.*+<code> 
 +module_str_warning .*NOTICE.* 
 + 
 +</code> 
 + 
 +== module_str_critical == 
 + 
 +<WRAP center round tip 60%>バージョン 5.x 以上</WRAP> 
 + 
 +<code> 
 +module_str_critical <値> 
 + 
 +</code>
  
-=== (>= 5.x) module_str_critical <値> === 
 文字列タイプのモジュールで障害状態を定義する正規表現です。 文字列タイプのモジュールで障害状態を定義する正規表現です。
  
 例: 例:
  
- module_str_critical .*CRITICAL.*+<code> 
 +module_str_critical .*CRITICAL.* 
 + 
 +</code> 
 + 
 +== module_warning_instructions == 
 + 
 +<WRAP center round tip 60%>バージョン 5.x 以上</WRAP> 
 + 
 +<code> 
 +module_warning_instructions <値> 
 + 
 +</code>
  
-=== (>= 5.x) module_warning_instructions <値> === 
 モジュールが警告状態に変化したときのオペレータへの指示です。 モジュールが警告状態に変化したときのオペレータへの指示です。
  
 例: 例:
  
- module_warning_instructions Increase incident priority+<code> 
 +module_warning_instructions Increase incident priority 
 + 
 +</code> 
 + 
 +== module_critical_instructions == 
 + 
 +<WRAP center round tip 60%>バージョン 5.x 以上</WRAP> 
 + 
 +<code> 
 +module_critical_instructions <値> 
 + 
 +</code>
  
-=== (>= 5.x) module_critical_instructions <値> === +モジュールが障害状態に変化したときのオペレータへの指示です。
-モジュールが障害状態に変化したときのオペレータへの指示です。 +
  
 例: 例:
  
- module_critical_instructions Call to sys department+<code> 
 +module_critical_instructions Call to sys department
  
-=== (>= 5.xmodule_unknown_instructions <値> === +</code> 
-モジュールが不明状態に変化したときのオペレータへの指示です。 + 
 +== module_unknown_instructions == 
 + 
 +<WRAP center round tip 60%>バージョン 5.x 以上</WRAP> 
 + 
 +<code> 
 +module_unknown_instructions <値> 
 + 
 +</code> 
 + 
 +モジュールが不明状態に変化したときのオペレータへの指示です。
  
 例: 例:
  
- module_unknown_instructions Open incident+<code> 
 +module_unknown_instructions Open incident 
 + 
 +</code> 
 + 
 +== module_tags == 
 + 
 +<WRAP center round tip 60%>バージョン 5.x 以上</WRAP> 
 + 
 +<code> 
 +module_tags <値> 
 + 
 +</code>
  
-=== (>= 5.x) module_tags <値> === 
 カンマ区切りでモジュールに割り当てるタグを指定します。 カンマ区切りでモジュールに割り当てるタグを指定します。
  
 例: 例:
  
- module_tags tag1,tag2,tag3+module_tags tag1,tag2,tag3 
 + 
 +== module_warning_inverse == 
 + 
 +<WRAP center round tip 60%>バージョン 5.x 以上</WRAP> 
 + 
 +<code> 
 +module_warning_inverse <値> 
 + 
 +</code>
  
-=== (>= 5.x) module_warning_inverse <値> === 
 警告閾値範囲の反転を有効化(1)します。 警告閾値範囲の反転を有効化(1)します。
  
 例: 例:
  
- module_warning_inverse 1+<code> 
 +module_warning_inverse 1 
 + 
 +</code> 
 + 
 +== module_critical_inverse == 
 + 
 +<WRAP center round tip 60%>バージョン 5.x 以上</WRAP> 
 + 
 +<code> 
 +module_critical_inverse <値> 
 + 
 +</code>
  
-=== (>= 5.x) module_critical_inverse <値> === 
 障害閾値範囲の反転を有効化(1)します。 障害閾値範囲の反転を有効化(1)します。
  
 例: 例:
  
- module_critical_inverse 1+<code> 
 +module_critical_inverse 1 
 + 
 +</code> 
 + 
 +== module_native_encoding == 
 + 
 +<WRAP center round tip 60%>バージョン 5.x 以上かつ、Win32 のみ</WRAP> 
 + 
 +<code> 
 +module_native_encoding <値>
  
-=== (>= 5.x) module_native_encoding <=== +</code>
-(Win32 のみ)+
  
 この設定トークンは、module_exec によってコマンドラインから実行されるモジュールにのみ影響します。 この設定トークンは、module_exec によってコマンドラインから実行されるモジュールにのみ影響します。
行 606: 行 1035:
 module_native_encoding の設定が無い場合は、変換は行われません。 module_native_encoding の設定が無い場合は、変換は行われません。
  
-=== (>= 5.x) module_quiet <値> ===+== (>= 5.x) module_quiet <値> == 
 有効化(1)すると、モジュールは静観モードになります。イベントやアラートを生成せずデータの保存も行いません。 有効化(1)すると、モジュールは静観モードになります。イベントやアラートを生成せずデータの保存も行いません。
  
 例: 例:
  
- module_quiet 1+<code> 
 +module_quiet 1 
 + 
 +</code> 
 + 
 +== module_ff_interval == 
 + 
 +<WRAP center round tip 60%>バージョン 5.x 以上</WRAP> 
 + 
 +<code> 
 +module_ff_interval <値> 
 + 
 +</code>
  
-=== (>= 5.x) module_ff_interval <値> === 
 収集データに揺らぎがあるような場合に、それを変化としてとらえるべきかを判断する期間のデータ収集間隔です。(秒単位) 収集データに揺らぎがあるような場合に、それを変化としてとらえるべきかを判断する期間のデータ収集間隔です。(秒単位)
  
 例: 例:
  
- module_ff_interval 2+<code> 
 +module_ff_interval 2 
 + 
 +</code> 
 + 
 +== module_macro == 
 + 
 +<WRAP center round tip 60%>バージョン 5.x 以上</WRAP> 
 + 
 +<code> 
 +module_macro<マクロ> <値> 
 + 
 +</code>
  
-=== (>= 5.x) module_macro<macro> <値> === 
 コンソールから、ローカルコンポーネントにのみ適用できます。設定ファイルで直接設定しません。 コンソールから、ローカルコンポーネントにのみ適用できます。設定ファイルで直接設定しません。
  
-=== (>5.1 SP4) module_alert_template <テンプレート名> === +== module_alert_template == 
-このマクロは、パラメータ名([[http://wiki.pandorafms.com/index.php?title=Pandora:Documentation_ja:Alerts#.E3.82.A2.E3.83.A9.E3.83.BC.E3.83.88.E3.83.86.E3.83.B3.E3.83.97.E3.83.AC.E3.83.BC.E3.83.88|アラートテンプレート]] 参照)に対応したモジュールにアラートテンプレートを割り当てます。+ 
 +<code> 
 +module_alert_template <テンプレート名> 
 + 
 +</code> 
 + 
 +このマクロは、パラメータ名([[:ja:documentation:04_using:01_alerts#e382a2e383a9e383bce38388e38386e383b3e38397e383ace383bce38388|アラートテンプレート]] 参照)に対応したモジュールにアラートテンプレートを割り当てます。
  
 例: 例:
 +<code>
  
  <module>  <module>
行 637: 行 1096:
  <max_warning>90</max_warning>  <max_warning>90</max_warning>
  <alert_template><![CDATA[Critical condition]]></alert_template>  <alert_template><![CDATA[Critical condition]]></alert_template>
- <nowiki><data><![CDATA[92]]></data></nowiki>+ <data><![CDATA[92]]></data>
  </module>  </module>
  
-=== module_end ===+</code> 
 + 
 +== module_end == 
 モジュール定義の終わりを表します。必須項目です。 モジュール定義の終わりを表します。必須項目です。
  
-==== 情報を取得するためのディレクティブ ====+=== 情報を取得するためのディレクティブ === 
 次に、それぞれのモジュールで情報を取得するためのディレクティブを示します。それぞれのモジュールで、1回ずつ利用できます。 次に、それぞれのモジュールで情報を取得するためのディレクティブを示します。それぞれのモジュールで、1回ずつ利用できます。
  
-=== module_exec <コマンド> ===+== module_exec =
 + 
 +<code> 
 +module_exec <コマンド> 
 + 
 +</code> 
 一般的なコマンド実行行です。 1行で情報を取得するコマンドを指定する必要があります。 一般的なコマンド実行行です。 1行で情報を取得するコマンドを指定する必要があります。
  
-Linux では、コマンドはデフォルトのシェルを使って実行されます。デフォルトのシェルは、 **/bin/sh** のシンボリックリンクによって決まります。通常は、//bash// ですが、Ubuntu のシステムでは異なります(この場合 //dash//)。端末でコマンドをテストしても、エージェントからの実行ではエラーが発生する可能性があります。解決策としては、次のようにコマンドラインの実行で明示的に bash を記載します。+Linux では、コマンドはデフォルトのシェルを使って実行されます。デフォルトのシェルは、 **/bin/sh**  のシンボリックリンクによって決まります。通常は、//bash//  ですが、Ubuntu のシステムでは異なります(この場合 //dash//)。端末でコマンドをテストしても、エージェントからの実行ではエラーが発生する可能性があります。解決策としては、次のようにコマンドラインの実行で明示的に bash を記載します。
  
- module_exec bash -c "<command>"+<code> 
 +module_exec bash -c "<command>"
  
-{{pandora:documentation_ja:warning|実行結果が '0' 以外を返す場合は、実行エラーであり情報は取り込まれません。}}+</code> 
 + 
 +<WRAP center round important 60%> 実行結果が '0' 以外を返す場合は、実行エラーであり情報は取り込まれません。 </WRAP>
  
 Windows エージェントでのデータ取得のためのディレクティブは他にもあります。以下に示します。 Windows エージェントでのデータ取得のためのディレクティブは他にもあります。以下に示します。
  
-=== module_service <サービス> ===+== module_service =
 + 
 +<code> 
 +module_service <サービス> 
 + 
 +</code> 
 指定したサービスが実行中であるかどうかをチェックします。サービス名にスペースが含まれる場合は、" " でくくるのを忘れないようにしてください。 指定したサービスが実行中であるかどうかをチェックします。サービス名にスペースが含まれる場合は、" " でくくるのを忘れないようにしてください。
  
 +<code>
  module_begin  module_begin
  module_name Service_Dhcp  module_name Service_Dhcp
行 666: 行 1145:
  module_description Service DHCP Client  module_description Service DHCP Client
  module_end  module_end
 +
 +</code>
  
 サービスは、Windows サービスマネージャに表示される短い名前 (サービス名) で識別されます。 サービスは、Windows サービスマネージャに表示される短い名前 (サービス名) で識別されます。
  
-<center> +[[:wiki:service_name_id.png?id=ja%3Adocumentation%3A02_installation%3A05_configuration_agents&media=wiki:service_name_id.png|{{  :wiki:service_name_id.png  }}]]
-[[image:Service_name_id.png]] +
-</center>+
  
-// 非同期モード //+//非同期モード //
  
-Pandora FMS は通常、(モジュールによって定義される)一定の秒間隔にてチェックを実行します (デフォルトでは、300秒 = 5分)。そのため、チェックの直後にサービスがダウンすると、それがダウンであると認識するのに、さらに 300秒かかります。非同期モジュールでは、Pandora に "今すぐ" サービスの障害を通知するようにできます。これは、//非同期//操作モードと呼んでいます。非同期モードにするには、以下のディレクティブを設定してください。+Pandora FMS は通常、(モジュールによって定義される)一定の秒間隔にてチェックを実行します (デフォルトでは、300秒 = 5分)。そのため、チェックの直後にサービスがダウンすると、それがダウンであると認識するのに、さらに 300秒かかります。非同期モジュールでは、Pandora に "今すぐ" サービスの障害を通知するようにできます。これは、//非同期// 操作モードと呼んでいます。非同期モードにするには、以下のディレクティブを設定してください。 
 +<code>
  
- module_async yes+module_async yes 
 + 
 +</code>
  
 この機能は、ブローカーエージェントでは利用できません。 この機能は、ブローカーエージェントでは利用できません。
  
-{{pandora:documentation_ja:warning|Windows Home Edition では、この非同期機能はサポートされていません。Pandora エージェントはサービスが動作しているかどうかを定期的に確認します。大量のサービスを監視する場合システムリソースを消費するため、同期モードを利用することをお勧めします。}}+<WRAP center round important 60%> Windows Home Edition では、この非同期機能はサポートされていません。Pandora エージェントはサービスが動作しているかどうかを定期的に確認します。大量のサービスを監視する場合システムリソースを消費するため、同期モードを利用することをお勧めします。 </WRAP>
  
-// サービスのウォッチドッグ //+//サービスのウォッチドッグ //
  
 サービスがダウンしたときに再起動するためのウォッチドッグモードがあります。サービスを起動するためのパラメータは Windows が認識しているため必要ありません。設定は簡単で、以下に例を示します。 サービスがダウンしたときに再起動するためのウォッチドッグモードがあります。サービスを起動するためのパラメータは Windows が認識しているため必要ありません。設定は簡単で、以下に例を示します。
  
 +<code>
  module_begin  module_begin
  module_name ServiceSched  module_name ServiceSched
行 695: 行 1178:
  module_watchdog yes  module_watchdog yes
  module_end  module_end
 +
 +</code>
  
 **Unix** **Unix**
行 700: 行 1185:
 Unix でも Windows と同様に動作します。違いは Unix であることだけで、プロセスおよびサービスは同じ考え方です。例えば、bash プロセスが動作しているかを確認するには次のようにします。 Unix でも Windows と同様に動作します。違いは Unix であることだけで、プロセスおよびサービスは同じ考え方です。例えば、bash プロセスが動作しているかを確認するには次のようにします。
  
 +<code>
  module_begin  module_begin
  module_name Service_bash  module_name Service_bash
行 706: 行 1192:
  module_description Process bash running  module_description Process bash running
  module_end  module_end
 +
 +</code>
  
 Unix エージェントでは、ウォッチドッグと非同期検出はできません。 Unix エージェントでは、ウォッチドッグと非同期検出はできません。
  
-=== module_proc <プロセス> === +== module_proc =
-指定した名前のプロセスがいるかどうかをチェックします。プロセス名にスペースが含まれていても、" " は**使わない**でください。プロセス名に拡張子 .exe がつくかどうかを良く確認してください。モジュールは、指定した名前で実行されているプロセスの数を返します。+ 
 +<code> 
 +module_proc <プロセス> 
 + 
 +</code> 
 + 
 +指定した名前のプロセスがいるかどうかをチェックします。 
 + 
 +**Windows**<WRAP center round tip 60%>プロセス名にスペースが含まれていても、" " は**使わない** でください。プロセス名に拡張子 .exe がつくかどうかを良く確認してください。モジュールは、指定した名前で実行されているプロセスの数を返します。</WRAP>
  
 以下に cmd.exe プロセスをモニタリングする例を示します。 以下に cmd.exe プロセスをモニタリングする例を示します。
  
 +<code>
  module_begin  module_begin
  module_name CMDProcess  module_name CMDProcess
行 721: 行 1218:
  module_end  module_end
  
-**Unix** +</code>
- +
-UNIX では、このモジュールは module_service のように動作します。非同期およびウォッチドッグモードはサポートしません。+
  
-// 非同期モード //+//非同期モード //
  
-サービスと同じように、モニタリングしているプロセスにて何らかの原因で障害が発生することがあります。Windows エージェントでは、//module_proc// モジュールで非同期チェックをサポートしています。この場合、プロセスの状態が変化したとき、通常のモニタリング間隔における次のチェックタイミングを待たずに**すぐに**通知されます。これにより、プロセスに障害が発生したのとほぼ同時にそれを知ることができます。以下にプロセスの非同期モニタリング設定の例を示します。+サービスと同じように、モニタリングしているプロセスにて何らかの原因で障害が発生することがあります。Windows エージェントでは、//module_proc//  モジュールで非同期チェックをサポートしています。この場合、プロセスの状態が変化したとき、通常のモニタリング間隔における次のチェックタイミングを待たずに**すぐに** 通知されます。これにより、プロセスに障害が発生したのとほぼ同時にそれを知ることができます。以下にプロセスの非同期モニタリング設定の例を示します。
  
 +<code>
  module_begin  module_begin
  module_name Notepad  module_name Notepad
行 736: 行 1232:
  module_async yes  module_async yes
  module_end  module_end
 +
 +</code>
  
 違いは、"module_async yes" が設定されている点です。 違いは、"module_async yes" が設定されている点です。
  
-//プロセスのウォッチドッグ // This feature is not supported on broker agents.+//プロセスのウォッチドッグ //  This feature is not supported on broker agents.
  
 ウォッチドッグは、ダウンしたプロセスを見つけた場合にそれをすぐに起動させることができます。Pandora FMS の Windows エージェントは、プロセスがダウンしたときにウォッチドッグとして動作させることができます。 ウォッチドッグは、ダウンしたプロセスを見つけた場合にそれをすぐに起動させることができます。Pandora FMS の Windows エージェントは、プロセスがダウンしたときにウォッチドッグとして動作させることができます。
  
-プロセスの実行には、いくつかのパラメータが必要です。このモジュールには、いくつかの追加設定オプションがあります。//ウォッチドッグ//モードは、モジュールタイプが//非同期//の場合のみ動作することに注意してください。ウォッチドッグでの module_proc の設定例を見てみます。+プロセスの実行には、いくつかのパラメータが必要です。このモジュールには、いくつかの追加設定オプションがあります。//ウォッチドッグ// モードは、モジュールタイプが//非同期// の場合のみ動作することに注意してください。ウォッチドッグでの module_proc の設定例を見てみます。
  
 +<code>
  module_begin  module_begin
  module_name Notepad  module_name Notepad
行 757: 行 1256:
  module_retries 5  module_retries 5
  module_end  module_end
 +
 +</code>
  
 以下に、ウォッチドッグを行う場合の module_proc の追加パラメータを示します。 以下に、ウォッチドッグを行う場合の module_proc の追加パラメータを示します。
  
   * **module_retries**:ウォッチドッグによりプロセスを起動させるリトライ回数を指定します。指定した回数に達した場合、該当モジュールのウォッチドッグは無効になり、ユーザによる復旧 (少なくともエージェントの再起動) がされるまでプロセスの起動を行わなくなります。デフォルトでは上限はありません。   * **module_retries**:ウォッチドッグによりプロセスを起動させるリトライ回数を指定します。指定した回数に達した場合、該当モジュールのウォッチドッグは無効になり、ユーザによる復旧 (少なくともエージェントの再起動) がされるまでプロセスの起動を行わなくなります。デフォルトでは上限はありません。
- 
   * **module_startdelay**:プロセスのダウンを認識した後、最初にプロセスを起動させるまでの待ち時間をミリ秒単位で指定します。   * **module_startdelay**:プロセスのダウンを認識した後、最初にプロセスを起動させるまでの待ち時間をミリ秒単位で指定します。
- 
   * **module_retrydelay**:プロセスダウンを検知した後に起動に失敗した場合の再実行の待ち時間をミリ秒単位で指定します。   * **module_retrydelay**:プロセスダウンを検知した後に起動に失敗した場合の再実行の待ち時間をミリ秒単位で指定します。
 +  * **module_user_session**: プロセスの起動をどのセッションで行うかを制御します。'no' に設定すると、プロセスはサービスセッションで起動し、バックグラウンドで動作します(デフォルト)。'yes' に設定すると、プロセスはユーザセッションで起動し、PC のデスクトップに表示されます。
 +<WRAP center round important 60%> Windows Vista 以前のバージョンでは、Pandora FMS サービスプロパティで、"Interactive access with desktop" を有効にすることにより //module_user_session//  を設定することができます。以下のスクリーンショットに示します。
  
-***module_user_session**プロセスの起動をどのセッションで行うかを制御します。'no' に設定すると、プロセスはサービスセッションで起動し、バックグラウンドで動作します(デフォルト)。'yes' に設定すると、プロセスはユーザセッションで起動し、PC のデスクトップに表示されます。 +[[:wiki:service_interactive.png?id=ja%3Adocumentation%3A02_installation%3A05_configuration_agents&media=wiki:service_interactive.png|{{  :wiki:service_interactive.png  }}]] </WRAP>
- +
-{{pandora:documentation_ja:warning|Windows Vista 以前のバージョンでは、Pandora FMS サービスプロパティで、"Interactive access with desktop" を有効にすることにより //module_user_session// を設定することができます。以下のスクリーンショットに示します。 +
- +
-<center> +
-[[image:Service_interactive.png]] +
-</center>}}+
  
 また、Pandora FMS は "SYSTEM" アカウントのサービスとして動作するため、実行されるコマンドはこのユーザおよびこのユーザの環境で動作することに注意してください。したがって、特定のプロセスを特定のユーザで実行したい場合は、環境変数の設定やその他事前処理を行う呼び出し用スクリプト (.bat など) を用意し、そのスクリプトをウォッチドッグの起動プログラムとして設定する必要があります。 また、Pandora FMS は "SYSTEM" アカウントのサービスとして動作するため、実行されるコマンドはこのユーザおよびこのユーザの環境で動作することに注意してください。したがって、特定のプロセスを特定のユーザで実行したい場合は、環境変数の設定やその他事前処理を行う呼び出し用スクリプト (.bat など) を用意し、そのスクリプトをウォッチドッグの起動プログラムとして設定する必要があります。
  
-=== module_cpuproc <プロセス> (Unix のみ) ===+== module_cpuproc <プロセス> (Unix のみ) == 
 特定のプロセスの CPU 使用率を返します。 特定のプロセスの CPU 使用率を返します。
 +<code>
  
  module_begin  module_begin
行 786: 行 1283:
  module_end  module_end
  
-=== module_memproc <プロセス> (Unix のみ) === +</code> 
-特定のプロセスが利用しているメモリ量を返します。+ 
 +**Unix** 
 + 
 +UNIX では、このモジュールは module_service のように動作します。非同期およびウォッチドッグモードはサポートしません。 
 + 
 +== module_memproc =
 + 
 +<code> 
 +module_memproc <プロセス> 
 + 
 +</code> 
 + 
 +**Unixのみです。**  特定のプロセスが利用しているメモリ量を返します。
  
 +<code>
  module_begin  module_begin
  module_name myserver_mem  module_name myserver_mem
行 796: 行 1306:
  module_end  module_end
  
-=== module_freedisk <ドライブ名:>|<ボリューム> === +</code>
-このモジュールは、UNIX および Windows 双方で利用できます。ディスクの空き容量をチェックします。(Windows では **ドライブ名**のあとに ":" を忘れないようにしてください。) UNIX であれば、/var などのボリュームを指定します。+
  
-<code>[email protected]@</code>+== module_freedisk ==
  
-<code>[email protected]@</code>+<code> 
 +module_freedisk <ドライブ名:>|<ボリューム> 
 + 
 +</code> 
 + 
 +このモジュールは、UNIX および Windows 双方で利用できます。ディスクの空き容量をチェックします。(Windows では **ドライブ名** のあとに ":" を忘れないようにしてください。) UNIX であれば、/var などのボリュームを指定します。 
 +<code> 
 + 
 +module_begin 
 +module_name freedisk 
 +module_type generic_data 
 +module_freedisk C: 
 +module_end 
 + 
 +</code> 
 + 
 +<code> 
 +module_begin 
 +module_name disk_var 
 +module_type generic_data 
 +module_freedisk /var 
 +module_end 
 + 
 +</code> 
 + 
 +== module_freepercentdisk == 
 + 
 +<code> 
 +module_freepercentdisk <ドライブ名:>|<ボリューム> 
 + 
 +</code>
  
-=== module_freepercentdisk <ドライブ名:>|<ボリューム> === 
 このモジュールは、ディスクの空きをパーセントで返します。Windows であれば、ドライブ名: (":"を忘れないようにしてください) で、UNIX であれば、/var などのボリュームを指定します。 このモジュールは、ディスクの空きをパーセントで返します。Windows であれば、ドライブ名: (":"を忘れないようにしてください) で、UNIX であれば、/var などのボリュームを指定します。
 +<code>
 +
 + module_begin
 + module_name freepercentdisk
 + module_type generic_data
 + module_freepercentdisk C:
 + module_end
  
-<code>[email protected]@</code>+</code>
  
 +<code>
  module_begin  module_begin
  module_name disk_var  module_name disk_var
行 814: 行 1360:
  module_end  module_end
  
-=== module_occupiedpercentdisk <ドライブ名:>|<ボリューム> === +</code>
-(Unix のみ)+
  
-このモジュールは、/var 等の Unix ファイルシステムのディスク使用率(%)を返します。+== module_occupiedpercentdisk == 
 + 
 +<code> 
 +module_occupiedpercentdisk <ドライブ名:>|<ボリューム> 
 + 
 +</code> 
 + 
 +**Unix のみです。**  このモジュールは、/var 等の Unix ファイルシステムのディスク使用率(%)を返します。 
 +<code>
  
  module_begin  module_begin
行 825: 行 1378:
  module_end  module_end
  
-=== module_cpuusage <cpu id> ===+</code> 
 + 
 +== module_cpuusage =
 + 
 +<code> 
 +module_cpuusage <cpu id|all> 
 + 
 +</code> 
 このモジュールは、UNIX および Windows 双方で使えます。指定した CPU 番号の CPU 使用率を返します。CPU が 1つしかない場合は番号を指定しないか、all を指定します。 このモジュールは、UNIX および Windows 双方で使えます。指定した CPU 番号の CPU 使用率を返します。CPU が 1つしかない場合は番号を指定しないか、all を指定します。
  
 次のように、マルチ CPU 環境で全 CPU の平均使用率を得ることができます。 次のように、マルチ CPU 環境で全 CPU の平均使用率を得ることができます。
 +<code>
  
  module_begin  module_begin
行 836: 行 1398:
  module_description Average CPU use in systme  module_description Average CPU use in systme
  module_end  module_end
 +
 +</code>
  
 1つ目の CPU 使用率を確認するのは次のようにします。 1つ目の CPU 使用率を確認するのは次のようにします。
  
 +<code>
  module_begin  module_begin
  module_name SystemCPU_1  module_name SystemCPU_1
行 846: 行 1411:
  module_end  module_end
  
-=== module_freememory ===+</code> 
 + 
 +== module_freememory == 
 Windows および Unix 双方で使えます。システム全体の空きメモリ量を取得します。 Windows および Unix 双方で使えます。システム全体の空きメモリ量を取得します。
  
 +<code>
  module_begin  module_begin
  module_name FreeMemory  module_name FreeMemory
行 856: 行 1425:
  module_end  module_end
  
-=== module_freepercentmemory === +</code>
-Windows および Unix 双方で使えます。システム全体の空きメモリ量のパーセンテージを取得します。 +
  
 +== module_freepercentmemory ==
 +
 +Windows および Unix 双方で使えます。システム全体の空きメモリ量のパーセンテージを取得します。
 +
 +<code>
  module_begin  module_begin
  module_name freepercentmemory  module_name freepercentmemory
行 865: 行 1438:
  module_end  module_end
  
-=== module_tcpcheck ==+</code> 
-(Windows のみ)+ 
 +== module_tcpcheck ==
  
-このモジュールは、指定された IPアドレスおよびポート番号への接続確認を行います。成功すると 1 が返り、失敗すると 0 が返ります。なお、タイムアウトを設定する必要があります。+**Windows のみです。**  このモジュールは、指定された IPアドレスおよびポート番号への接続確認を行います。成功すると 1 が返り、失敗すると 0 が返ります。なお、タイムアウトを設定する必要があります。
  
 +<code>
  module_begin  module_begin
  module_name tcpcheck  module_name tcpcheck
行 878: 行 1453:
  module_end  module_end
  
-=== module_regexp === +</code>
-(Windows のみ)+
  
-このモジュールは、正規表現を使ってファイル(ログ)の内容の比較を行います。モニタリングを開始した時点ですでに存在している行については無視します。モジュールが返す値はモジュールタイプにより異なります。+== module_regexp == 
 + 
 +Windows のみです。このモジュールは、 [[http://www.regular-expressions.info/reference.html|正規表現]]を使ってファイル(ログ)の内容の比較を行います。モニタリングを開始した時点ですでに存在している行については無視します。モジュールが返す値はモジュールタイプにより異なります。
  
   * **generic_data_string**, **async_string**: 正規表現にマッチした行全体を返します。   * **generic_data_string**, **async_string**: 正規表現にマッチした行全体を返します。
行 887: 行 1463:
   * **generic_proc**: 正規表現にマッチしたら 1、そうでなければ 0 を返します。   * **generic_proc**: 正規表現にマッチしたら 1、そうでなければ 0 を返します。
   * **module_noseekeof**: 0 がデフォルトです。これを有効にすると、それぞれのモジュールの実行において、ターゲットのファイル更新からは独立して、ファイルの EOF を確認することなくチェック処理が実行されます。これにより、常に検索パターンにマッチするすべての行が XML 出力に展開されます。   * **module_noseekeof**: 0 がデフォルトです。これを有効にすると、それぞれのモジュールの実行において、ターゲットのファイル更新からは独立して、ファイルの EOF を確認することなくチェック処理が実行されます。これにより、常に検索パターンにマッチするすべての行が XML 出力に展開されます。
 +<code>
  
  module_begin  module_begin
行 892: 行 1469:
  module_type generic_data_string  module_type generic_data_string
  module_regexp C:\WINDOWS\my.log  module_regexp C:\WINDOWS\my.log
- module_pattern ^\[[pandora:documentation_ja:error]].*+ module_pattern ^\[error\].*
  module_noseekeof 1  module_noseekeof 1
  module_end  module_end
  
-正規表現の詳細の書式については、こちら [[http://www.regular-expressions.info/reference.html]] を参照してください。+</code>
  
-=== module_wmiquery === 
-(Windows のみ) 
  
-WMI モジュールは、外部ツールを使わずにローカルで WMI クエリを実行できます。2つのパラメータで設定します。+== module_wmiquery == 
 + 
 +Windows のみです。WMI モジュールは、外部ツールを使わずにローカルで WMI クエリを実行できます。2つのパラメータで設定します。
  
   * **module_wmiquery**: 利用する WQL クエリを設定します。さまざまなデータを含む複数の行で結果を得ることができます。   * **module_wmiquery**: 利用する WQL クエリを設定します。さまざまなデータを含む複数の行で結果を得ることができます。
- 
   * **module_wmicolumn**:データソースとして利用するカラム名を設定します。   * **module_wmicolumn**:データソースとして利用するカラム名を設定します。
- 
 例えば、インストールされているサービス一覧を取得するには次のようにします。 例えば、インストールされているサービス一覧を取得するには次のようにします。
  
 +<code>
  module_begin  module_begin
  module_name Services  module_name Services
行 915: 行 1491:
  module_wmicolumn Name  module_wmicolumn Name
  module_end  module_end
 +
 +</code>
  
 現在の CPU 負荷であれば次のようにします。 現在の CPU 負荷であれば次のようにします。
  
 +<code>
  module_begin  module_begin
  module_name CPU_speed  module_name CPU_speed
行 925: 行 1504:
  module_end  module_end
  
-=== module_perfcounter === +</code>
-(Win32 のみ)+
  
-PDH インタフェースを通して、パフォーマンスカウンタ ([[http://msdn.microsoft.com/ja-jp/library/aa373083(v=vs.85).aspx|http://msdn.microsoft.com/ja-jp/library/aa373083(v=vs.85).aspx パフォーマンスカウンタドキュメント]]) からデータを取得します。Windows のライブラリの //pdh.dll// がインストールされている必要があります。もしインストールされていない場合は、Windows パフォーマンス解析ツールをインストールする必要があります (通常はデフォルトでインストールされています)。+== module_perfcounter == 
 + 
 +**Windowsのみです。**  PDH インタフェースを通して、パフォーマンスカウンタ ([[http://msdn.microsoft.com/ja-jp/library/aa373083(v = vs.85).aspx|http://msdn.microsoft.com/ja-jp/library/aa373083(v = vs.85).aspx パフォーマンスカウンタドキュメント]]) からデータを取得します。Windows のライブラリの //pdh.dll//  がインストールされている必要があります。もしインストールされていない場合は、Windows パフォーマンス解析ツールをインストールする必要があります (通常はデフォルトでインストールされています)。 
 +<code>
  
  module_begin  module_begin
行 935: 行 1516:
  module_perfcounter \Memory\Pages/sec  module_perfcounter \Memory\Pages/sec
  module_end  module_end
 +
 +</code>
  
 Windows パフォーマンスモニタは、モニタリングに利用できる何百ものパラメータを持つ強力なツールです。加えて、各ベンダによる独自のモニタ項目も追加されています。 Windows パフォーマンスモニタは、モニタリングに利用できる何百ものパラメータを持つ強力なツールです。加えて、各ベンダによる独自のモニタ項目も追加されています。
行 940: 行 1523:
 パフォーマンスツールから、パフォーマンスカウンターを確認できます。 パフォーマンスツールから、パフォーマンスカウンターを確認できます。
  
-<center> +[[:wiki:perfcounter_screen1.png?id=ja%3Adocumentation%3A02_installation%3A05_configuration_agents&media=wiki:perfcounter_screen1.png|{{  :wiki:perfcounter_screen1.png?450  }}]]
-[[image:Perfcounter_screen1.png|center|450px]] +
-</center>+
  
-システムツールを用いて新たなパフォーマンスカウンターを追加することができます。その構成には、要素とサブ要素を含む管理構造があります。ここでは、//Processor, % of processor time// および //_Total// です。+システムツールを用いて新たなパフォーマンスカウンターを追加することができます。その構成には、要素とサブ要素を含む管理構造があります。ここでは、//Processor, % of processor time//  および //_Total//  です。
  
-<center> +[[:wiki:perfcounter_screen2.png?id=ja%3Adocumentation%3A02_installation%3A05_configuration_agents&media=wiki:perfcounter_screen2.png|{{  :wiki:perfcounter_screen2.png  }}]]
-[[image:Perfcounter_screen2.png]] +
-</center>+
  
 このように、OS のツールを使うことにより、システムパフォーマンスのさまざまな要素を取り込むことができます。この場合、モジュールの設定は次のようになります。 このように、OS のツールを使うことにより、システムパフォーマンスのさまざまな要素を取り込むことができます。この場合、モジュールの設定は次のようになります。
 +<code>
  
  module_begin  module_begin
行 958: 行 1538:
  module_end  module_end
  
-デフォルトでは、カウンタの生データが表示されます。調整値を取得するには、**module_cooked 1** を設定します。+</code>
  
 +デフォルトでは、カウンタの生データが表示されます。調整値を取得するには、**module_cooked 1**  を設定します。
 +
 +<code>
  module_begin  module_begin
  module_name Disk_E/S_Seg  module_name Disk_E/S_Seg
行 966: 行 1549:
  module_perfcounter \DiscoFísico(_Total)\E/S divididas por seg.  module_perfcounter \DiscoFísico(_Total)\E/S divididas por seg.
  module_end  module_end
 +
 +</code>
  
 多くのデータは、カウンタ値として返ってきます。そのため、データタイプとしては generic_data_inc を使う必要があります。また、とても大きなスケール (数百万) のデータが返ってくることがありますので、事前処理モジュールで 0.000001 などを設定して値を小さくすると良いです。 多くのデータは、カウンタ値として返ってきます。そのため、データタイプとしては generic_data_inc を使う必要があります。また、とても大きなスケール (数百万) のデータが返ってくることがありますので、事前処理モジュールで 0.000001 などを設定して値を小さくすると良いです。
  
-=== module_inventory (廃止) === +== module_inventory (廃止) == 
-{{pandora:documentation_ja:warning|Windows および Linux/UNIX 双方で、現在この機能はエージェントプラグインによるインベントリで置き換えられています。}}+ 
 +<WRAP center round important 60%> Windows および Linux/UNIX 双方で、現在この機能はエージェントプラグインによるインベントリで置き換えられています。 </WRAP>
  
 //(Win32 のみ。Linux/Unix ではエージェントプラグインとして実装されています。)// //(Win32 のみ。Linux/Unix ではエージェントプラグインとして実装されています。)//
行 987: 行 1573:
   * **RAM**: RAM モジュールの情報を取得します。(タグ、容量および名前)   * **RAM**: RAM モジュールの情報を取得します。(タグ、容量および名前)
   * **Service**: インストールされたサービスの情報を取得します。最初のカラムに、Pandora FMS がサービスのモニタリングに使う、サービスの短い名前が表示されます。   * **Service**: インストールされたサービスの情報を取得します。最初のカラムに、Pandora FMS がサービスのモニタリングに使う、サービスの短い名前が表示されます。
- 
 追加モジュールパラメータ: 追加モジュールパラメータ:
  
-  * **module_interval**: このモジュールは、//日単位で//情報収集するための間隔を定義する追加設定です。 +  * **module_interval**: このモジュールは、//日単位で// 情報収集するための間隔を定義する追加設定です。
 このモジュールの利用例を以下に示します。 このモジュールの利用例を以下に示します。
  
 +<code>
  module_begin  module_begin
  module_name Inventory  module_name Inventory
行 1002: 行 1587:
  module_end  module_end
  
-=== module_logevent === +</code>
-(Win32 のみ) +
  
-指定されたパターンに基づいて Windows イベントログから情報を取得し、ソースおよびイベントタイプに従ってフィルタリングする機能を提供します。+== module_logevent == 
 + 
 +Windows のみです。指定されたパターンに基づいて Windows イベントログから情報を取得し、ソースおよびイベントタイプに従ってフィルタリングする機能を提供します。
  
 このモジュールの一般的な書式は次の通りです。 このモジュールの一般的な書式は次の通りです。
  
 +<code>
  module_begin  module_begin
  module_name MyEvent  module_name MyEvent
行 1020: 行 1607:
  module_description  module_description
  module_end  module_end
 +
 +</code>
  
 すでに表示されたものを再度表示するのを防ぐために、エージェントが実行された最終時間より後のイベントのみを対象とします。 すでに表示されたものを再度表示するのを防ぐために、エージェントが実行された最終時間より後のイベントのみを対象とします。
行 1030: 行 1619:
   * **module_eventcode**: 5112 等のイベント ID 番号です。このフィールドはオプションです。   * **module_eventcode**: 5112 等のイベント ID 番号です。このフィールドはオプションです。
   * **module_application**: イベント発生元のアプリケーションを指定します。イベントが検索される名前やログファイルを示す module_source と混同しないように注意してください。   * **module_application**: イベント発生元のアプリケーションを指定します。イベントが検索される名前やログファイルを示す module_source と混同しないように注意してください。
- 
 例えば、system の error に分類される全てのイベントを表示するには、次のように設定します。 例えば、system の error に分類される全てのイベントを表示するには、次のように設定します。
  
 +<code>
  module_begin  module_begin
  module_name log_events  module_name log_events
行 1041: 行 1630:
  module_eventtype error  module_eventtype error
  module_end  module_end
 +
 +</code>
  
 PandoraAgent という文字を含む全イベントを表示するには次のようにします。 PandoraAgent という文字を含む全イベントを表示するには次のようにします。
  
 +<code>
  module_begin  module_begin
  module_name log_events_pandora  module_name log_events_pandora
行 1053: 行 1645:
  module_end  module_end
  
-その他例として、以下にイベントフィルタリングのスナップショットを示します。+</code>
  
-<center> +その他例として、以下にイベントフィルタリングのスナップショットを示します。
-{{ wiki:Event sample.png ?450}} +
-</center>+
  
 +[[:wiki:event_sample.png?id=ja%3Adocumentation%3A02_installation%3A05_configuration_agents&media=wiki:event_sample.png|{{  :wiki:event_sample.png?450  }}]]
 +<code>
  
  module_begin  module_begin
行 1071: 行 1663:
  module_end  module_end
  
-Pandora FMS は、**ログを収集するシステムではない**ということを理解してください。このツールは、これらのクリティカルまたは重要なイベントを選択し、監視するためのシステムです。すべてのイベントを未分類で収集すると、データベースが飽和状態になりシステムパフォーマンスが著しく低下し、長期的に問題をもたらします。Pandora FMS を一般的なイベント収集ツールとして使うべきではありません。+</code>
  
-=== module_logchannel === +Pandora FMS は、**ログを収集するシステムではない** ということを理解してください。こツールは、これらのクリティカルまたは重要なイベントを選択し、監視するためのシステムです。すべてのイベントを未分類で収集すると、データベースが飽和状態になりシステムパフォーマンスが著しく低下し長期的に問題をもたらします。Pandora FMS を一般的なイベント収集ツールとして使うべきではありません。
-(Windows 7.0OUM715以降) +
  
-Windows ログチャネルに関する情報を取得するモジュールです。//module_logevent// は Windows ログにのみアクセスしますが、これは、チャネルとして設定された他のログファイルからデータを展開することができます。これにより、サービスやアプリケーションログを含めたログ取得が可能になります。+== module_logchannel == 
 + 
 +<WRAP center round tip 60%>バージョン NG 715 以上および、Windows のみ</WRAP> 
 + 
 +Windows ログチャネルに関する情報を取得するモジュールです。//module_logevent//  は Windows ログにのみアクセスしますが、これは、チャネルとして設定された他のログファイルからデータを展開することができます。これにより、サービスやアプリケーションログを含めたログ取得が可能になります。
  
 このモジュールの一般的な書式は次の通りです。 このモジュールの一般的な書式は次の通りです。
  
 +<code>
  module_begin  module_begin
  module_name MyEvent  module_name MyEvent
行 1091: 行 1687:
  module_description <説明>  module_description <説明>
  module_end  module_end
 +
 +</code>
  
 すでに表示されたものを再度表示するのを防ぐために、エージェントが実行された最終時間より後のイベントのみを対象とします。 すでに表示されたものを再度表示するのを防ぐために、エージェントが実行された最終時間より後のイベントのみを対象とします。
行 1096: 行 1694:
 module_logchannel には、次のパラメータを設定できます。(すべて大文字小文字を区別します) module_logchannel には、次のパラメータを設定できます。(すべて大文字小文字を区別します)
  
-  * **module_source**: イベントチャネルを指定します。**wevtutil.exe enum-logs** を実行すると、ローカルログチャネルの一覧を取得できます。このフィールドは必須項目です。+  * **module_source**: イベントチャネルを指定します。**wevtutil.exe enum-logs**  を実行すると、ローカルログチャネルの一覧を取得できます。このフィールドは必須項目です。
   * **module_eventtype**: イベントタイプ (critical, error, warning, info, verbose) を指定します。このフィールドはオプションです。   * **module_eventtype**: イベントタイプ (critical, error, warning, info, verbose) を指定します。このフィールドはオプションです。
   * **module_pattern**: 検索するパターン (文字列) を指定します。このフィールドはオプションです。   * **module_pattern**: 検索するパターン (文字列) を指定します。このフィールドはオプションです。
   * **module_eventcode**: 5112 等のイベント ID 番号です。このフィールドはオプションです。   * **module_eventcode**: 5112 等のイベント ID 番号です。このフィールドはオプションです。
   * **module_application**: イベント発生元のアプリケーションを指定します。イベントが検索される名前やログファイルを示す module_source と混同しないように注意してください。   * **module_application**: イベント発生元のアプリケーションを指定します。イベントが検索される名前やログファイルを示す module_source と混同しないように注意してください。
 +例えば、チャネル //Microsoft-Windows-TaskScheduler/Operational//  の //information//  タイプ、コード //201// 、文字列 //code 0//  を含むすべてのイベントを表示するモジュールは次のようになります。
  
-例えば、チャネル //Microsoft-Windows-TaskScheduler/Operational// の //information// タイプ、コード //201//、文字列 //code 0// を含むすべてのイベントを表示するモジュールは次のようになります。 +<code>
  module_begin  module_begin
  module_name New logs  module_name New logs
行 1114: 行 1712:
  module_pattern code 0  module_pattern code 0
  module_end  module_end
 +
 +</code>
  
 このモジュール設定により、Pandora FMS エージェントは次のようなログを収集します。 このモジュール設定により、Pandora FMS エージェントは次のようなログを収集します。
  
-<center> +[[:wiki:logchannel_example.png?id=ja%3Adocumentation%3A02_installation%3A05_configuration_agents&media=wiki:logchannel_example.png|{{  :wiki:logchannel_example.png?700  }}]]
-{{ wiki:Logchannel example.png ?700}} +
-</center> +
-<br>+
  
-{{pandora:documentation_ja:warning|イベントチャネルの名前を取得するには、チャネルを右クリックして、"<b>プロパティ(properties)</b>" を選択し、パラメータ "<b>フルネーム(Full name)</b>" をコピーします。これは、<b>module_source</b> で必要です。}}+<WRAP center round important 60%> イベントチャネルの名前を取得するには、チャネルを右クリックして、"**プロパティ(properties)**" を選択し、パラメータ "**フルネーム(Full name)**" をコピーします。これは、**module_source**  で必要です。 </WRAP>
  
-=== module_plugin === +== module_plugin == 
-プラグインから取得したデータを定義するためのパラメータです。これは、特殊なモジュールで、'module_begin' や 'module_type' などの **他の識別子は必要ありません**。+ 
 +プラグインから取得したデータを定義するためのパラメータです。これは、特殊なモジュールで、'module_begin' や 'module_type' などの **他の識別子は必要ありません** 。
  
 次のような書式です。 次のような書式です。
 +<code>
  
- module_plugin plugin_filename parameter_1 parameter_2 parameter_3+module_plugin plugin_filename parameter_1 parameter_2 parameter_3 
 + 
 +</code>
  
 ただし、プラグインに状態や実行間隔などの追加パラメータを設定する場合は、次のように通常の書式を利用します。 ただし、プラグインに状態や実行間隔などの追加パラメータを設定する場合は、次のように通常の書式を利用します。
  
 +<code>
  module_begin  module_begin
  module_plugin plugin_filename parameter_1 parameter_2 parameter_3  module_plugin plugin_filename parameter_1 parameter_2 parameter_3
行 1138: 行 1740:
  module_condition (0, 1) script.sh  module_condition (0, 1) script.sh
  module_end  module_end
 +
 +</code>
  
 それぞれのプラグインには個別のパラメータが使われます。そのため、それぞれの特定のドキュメントを参照する必要があります。ここでは、エージェントにデフォルトで付属しているプラグインの一つであるファイル内を検索する grep_log で説明します。 それぞれのプラグインには個別のパラメータが使われます。そのため、それぞれの特定のドキュメントを参照する必要があります。ここでは、エージェントにデフォルトで付属しているプラグインの一つであるファイル内を検索する grep_log で説明します。
  
- module_plugin grep_log /var/log/syslog Syslog ssh+<code> 
 +module_plugin grep_log /var/log/syslog Syslog ssh 
 + 
 +</code>
  
 この例では、プラグインの名前が "grep_log" で、"/var/log/syslog" を正規表現 "ssh" で検索する "Syslog" というモジュールであることを意味します。 この例では、プラグインの名前が "grep_log" で、"/var/log/syslog" を正規表現 "ssh" で検索する "Syslog" というモジュールであることを意味します。
行 1147: 行 1754:
 Windows システムの場合の別の例を示します。(バージョン 3.1 以上) Windows システムの場合の別の例を示します。(バージョン 3.1 以上)
  
- module_plugin cscript.exe <nowiki>//</nowiki>B "%ProgramFiles%\Pandora_Agent\util\df_percent.vbs"+<code> 
 +module_plugin cscript.exe //B "%ProgramFiles%\Pandora_Agent\util\df_percent.vbs"
  
-=== module_ping <ホスト> === +</code> 
-(バージョン 4.0.1 以降、Windows のみ)+ 
 +== module_ping =
 + 
 +**Windows のみ。** 
 + 
 +<code> 
 +module_ping <ホスト> 
 + 
 +</code>
  
 このモジュールは、指定したホストに ping を行い、応答があれば 1、そうでなければ 0 を返します。 このモジュールは、指定したホストに ping を行い、応答があれば 1、そうでなければ 0 を返します。
行 1158: 行 1774:
   * **module_ping_count x**: 送信する ECHO_REQUEST パッケットの数 (1 がデフォルト)   * **module_ping_count x**: 送信する ECHO_REQUEST パッケットの数 (1 がデフォルト)
   * **module_ping_timeout x**: 応答を待つタイムアウトミリ秒数 (1000 がデフォルト)   * **module_ping_timeout x**: 応答を待つタイムアウトミリ秒数 (1000 がデフォルト)
-  * **module_advanced_options**: //ping.exe// の拡張オプション +  * **module_advanced_options**: //ping.exe//  の拡張オプション
 例: 例:
  
 +<code>
  module_begin  module_begin
  module_name Ping  module_name Ping
行 1170: 行 1786:
  module_end  module_end
  
-=== module_snmpget === +</code> 
-(Windows のみ)+ 
 +== module_snmpget == 
 + 
 +**Windows のみ。**
  
 このモジュールは snmpget を実行し、その応答を返します。 このモジュールは snmpget を実行し、その応答を返します。
行 1177: 行 1796:
 次のパラメータを設定できます。 次のパラメータを設定できます。
  
-  * **module_snmpversion [[pandora:documentation_ja:1_2c_3]]**: SNMP バージョン (1 がデフォルト) +  * **module_snmpversion [1_2c_3]**: SNMP バージョン (1 がデフォルト) 
-  * **module_snmp_community <community>**: SNMP コミュニティ (//public// がデフォルト)+  * **module_snmp_community <community>**: SNMP コミュニティ (//public//  がデフォルト)
   * **module_snmp_agent <host>**: 対象の SNMP エージェント   * **module_snmp_agent <host>**: 対象の SNMP エージェント
   * **module_snmp_oid <oid>**: 対象の OID   * **module_snmp_oid <oid>**: 対象の OID
-  * **module_advanced_options**: //snmpget.exe// の拡張オプション +  * **module_advanced_options**: //snmpget.exe//  の拡張オプション
 例: 例:
  
 +<code>
  module_begin  module_begin
  module_name SNMP get  module_name SNMP get
行 1195: 行 1814:
  module_end  module_end
  
-====== 自動エージェント設定 ====== +</code> 
-=====概要=====+== module_wait_timeout == 
 + 
 +**Windows のみ。** 
 +<code> 
 +module_wait_timeout X 
 + 
 +</code> 
 + 
 +モジュールの module_exec および module_plugin 出力がチェックされる際のタイムアウト時間。デフォルトの値は 500ミリ秒です。大量の出力を生成するモジュールで実行が遅い場合は、5に変更します。それ以外の場合は使用しないことをお勧めします。 
 + 
 + 
 +==== 自動エージェント設定 ==== 
 + 
 +=== 概要 === 
 Pandora FMS バージョン 725 から、エージェントを自動的に設定するための一連のルールを設定できます。 Pandora FMS バージョン 725 から、エージェントを自動的に設定するための一連のルールを設定できます。
  
 エージェントの自動設定処理は次のように動作します。 エージェントの自動設定処理は次のように動作します。
  
-**1-** Pandora FMS コンソールまたは、Pandora FMS メタコンソールで、自動設定の準備をします。+**1-**  Pandora FMS コンソールまたは、Pandora FMS メタコンソールで、自動設定の準備をします。
  
-**2-** Pandora FMS へ接続するエージェントをインストールします。(単一のコンソールの場合はエージェントの接続先は Pandora FMS サーバです。自動プロビジョニングを設定したメタコンソールがある場合は、メタコンソールをサーバとして設定します。)+**2-**  Pandora FMS へ接続するエージェントをインストールします。(単一のコンソールの場合はエージェントの接続先は Pandora FMS サーバです。自動プロビジョニングを設定したメタコンソールがある場合は、メタコンソールをサーバとして設定します。)
  
-**3-** Pandora FMS サーバが、エージェントのデータを含む XML (.data) を初回受信します。+**3-**  Pandora FMS サーバが、エージェントのデータを含む XML (.data) を初回受信します。
  
-**4-** 適用される自動設定を決定するためのルールが評価されます。+**4-**  適用される自動設定を決定するためのルールが評価されます。
  
-**5-** エージェントが新たな設定を受け取り、次回の処理から更新された設定で動作します。+**5-**  エージェントが新たな設定を受け取り、次回の処理から更新された設定で動作します。 
 + 
 +=== 自動エージェント設定の作成 ===
  
-=====自動エージェント設定の作成===== 
 自動設定画面へは次のようにアクセスできます。 自動設定画面へは次のようにアクセスできます。
  
-<b>コンソール</b> +**コンソール**  管理(Management) > 自動エージェント設定管理(Manage automatic agent configuration)
-管理(Management) > 自動エージェント設定管理(Manage automatic agent configuration)+
  
-<center>{{wiki:autoconf_menu_console.png‎‎}}</center>+{{  :wiki:autoconf_menu_console.png  }}
  
-<b>メタコンソール</b> +**メタコンソール**  拡張 > エージェント管理 > 自動エージェント設定
-拡張 > エージェント管理 > 自動エージェント設定+
  
-<center>{{wiki:Autoconf1.png‎‎}}</center>+{{  :wiki:autoconf1.png  }}
  
 管理ページにアクセスしたら、"自動設定の作成(Create automatic configuration)" ボタンをクリックすることにより新たな自動設定を作成することができます。 管理ページにアクセスしたら、"自動設定の作成(Create automatic configuration)" ボタンをクリックすることにより新たな自動設定を作成することができます。
行 1228: 行 1860:
 自動設定の名前と説明を設定します。 自動設定の名前と説明を設定します。
  
-<center>{{wiki:Autoconf_new.png‎‎}}</center>+{{  :wiki:autoconf_new.png}}
  
 新たな自動設定を作成したら、必要な項目をクリックすることにより設定フォームを表示できます。 新たな自動設定を作成したら、必要な項目をクリックすることにより設定フォームを表示できます。
  
-<center>{{wiki:Autoconf_options.png‎‎}}</center>+{{  :wiki:autoconf_options.png  }}
  
 +== ルール ==
  
-==== ルール ==== 
 自動設定を適用するエージェントを定義するには、ルールを追加します。 自動設定を適用するエージェントを定義するには、ルールを追加します。
  
行 1242: 行 1874:
 設定対象のエージェントを特定するために、ルールのオプションを選択できます。 設定対象のエージェントを特定するために、ルールのオプションを選択できます。
  
-<center>{{wiki:autoconf_rules1.png|750px‎‎}}</center>+{{  :wiki:autoconf_rules1.png?750  }}
  
-Server name: マッチするサーバ名 +**Server name**
-; Group name: マッチするグループ名 +
-; OS: マッチする OS 名 (正規表現) +
-; Custom field: エージェントが報告してくる、キー/値 のカスタムフィールドマッチ。カスタムフィールド名と値を指定する必要があります。  +
-; IP range: IP の範囲(ネットワーク)にマッチ。IP/ネットマスク の書式を追加います。例: 192.168.1.0/24+
  
-; Script output (> 0): スクリプトの実行結果で、標準出力の結果が 0より大きい場合にルールにマッチしたと評価されま+マッチするサーバ名
  
-ルールスクリプトでは、'arguments' フィールドに次のマクロが使えます。 +**Group name**
-; _agent_ : エージェント名に置き換えられます。 +
-; _agentalias_ : エージェントの別名に置き換えられます。 +
-; _address_ : エージェントから報告された IP アドレスに置き換えられます。 +
-; _agentgroup_ : エージェントから報告されたグループ名に置き換えられます。 +
-; _agentos_ : エージェントの OS で置き換えられます。+
  
-ルールの適用条件で <i>AND</i> および <i>OR</i> を選択できます。+マッチするグループ名
  
-<center>{{wiki:autoconf_rules2.png|750px‎‎}}</center>+**OS**
  
 +マッチする OS 名 (正規表現)
  
-<b>注意:</b> ルールが無い場合は、自動設定は適用されません。+**Custom field**
  
-全てのエージェントに対して一つの設定でよい場合はすべて<i>別名</i>マッチする次の正規表現を使うことできます。+エージェントが報告してくるキー/値 カスタムフィールドマッチ。カスタムフィールド名と値を指定する必要あります。
  
- .*+**IP range**
  
 +IP の範囲(ネットワーク)にマッチ。IP/ネットマスク の書式を追加います。例: 192.168.1.0/24
  
 +**Script output (> 0)**
 +
 +スクリプトの実行結果で、標準出力の結果が 0より大きい場合にルールにマッチしたと評価されます。
 +
 +**Call to the rule script**
 +
 + ルールスクリプトでは、'arguments' フィールドに次のマクロが使えます。(演算子 ''AND'' と ''OR'' のどちらかを選択して、ルールロジックを変更できます)
 +  * **_agent_ :**  エージェント名に置き換えられます。
 +  * **_agentalias_ : **  エージェントの別名に置き換えられます。
 +  * **_address_ :**  エージェントから報告された IP アドレスに置き換えられます。
 +  * **_agentgroup_ :**  エージェントから報告されたグループ名に置き換えられます。
 +  * **_agentos_ :**  エージェントの OS で置き換えられます。
 +[[:wiki:autoconf_rules2.png?id=ja:documentation:02_installation:05_configuration_agents&media=wiki:autoconf_rules2.png|{{  :wiki:autoconf_rules2.png?nolink&400  }}]]
 +
 +<WRAP center round tip 60%>ルールが無い場合は、自動設定は適用されません。全てのエージェントに対して一つの設定でよい場合は、すべての別名にマッチする正規表現 ''.*''  を使うことができます。</WRAP>
 +
 +
 +== 設定 ==
  
-==== 設定 ==== 
 ここから設定に進みます。 ここから設定に進みます。
  
-エージェントグループ: 変更せずにそのままとするか、強制的に変更します。 +**エージェントグループ**
-: セカンダリグループ: エージェントにセカンダリグループとして追加するグループを選択します。 +
-; ポリシー: エージェントがサーバに接続してきたときに適用するポリシーを選択できます。 +
-; 設定ブロック: エージェントの設定ファイルに追加する設定内容です。+
  
-<center>{{wiki:autoconf_config.png}}</center>+変更せずにそのままとするか、強制的に変更します。
  
-<b>注意:</b> 集中管理が有効なメタコソーに属するノードから自動設定管理を行おうとすると、リードオンリ表示になります。+**セカダリグループ**
  
-<center>{{wiki:autoconf_ro.png}}</center>+エージェントにセカンダリグループとして追加するグループを選択します。
  
 +**ポリシー**
  
 +エージェントがサーバに接続してきたときに適用するポリシーを選択できます。
  
-==== 追加アクション ==== +**設定ブロッ**
-ここでは、自動設定に追加のアションを行うことができます。例えば以下のような処理です。+
  
-#独自イベントをす +エージェントの設定ファイルに追加する設定内容です。 
-#アラートアクションを実行する  + 
-#スリプト行す+{{  :wiki:autoconf_config.png  }} 
 + 
 +**注意:**  集中管理が有効なメタコンソールに属するノードから自動設定管理行おうとすると、リードオンリー表示になりま 
 + 
 +{{  :wiki:autoconf_ro.png  }} 
 + 
 +== 追加アクション == 
 + 
 +ここでは、自動設定に追加のアションを行うことができま。例えば以下のような処理です。
  
-<center>{{wiki:autoconf_actions.png}}</center>+  - 独自イベントを出す 
 +  - アラートアクションを実行する 
 +  - スクリプトを実行する
  
 +{{  :wiki:autoconf_actions.png  }}
  
 システムは、次のマクロをサポートします。 システムは、次のマクロをサポートします。
-; _agent_ : エージェント名に置き換えられます。 
-; _agentalias_ : エージェントの別名に置き換えられます。 
-; _address_ : エージェントが報告した IP アドレスに置き換えられます。 
-; _agentgroup_ : エージェントが報告したグループ名に置き換えられます。 
-; _agentos_ : エージェントの OS に置き換えられます。  
-; _agentid_ : エージェント ID に置き換えられます。 
  
-====== Unix/Linux エージェント ====== +**_agent_**
-UNIX には、簡単にデータを収集できるいくつかのコマンドラインツールがあります。UNIX エージェントはこれをベースにしており、次の 2つの種類があります。+
  
-  * ShellScript:さまざまな OS にある、bash、ksh、csh などのシェルスクリプトを用いたエージェントです。Linux や MAC 向けはすべての機能が実装さていますが、伝統的な UNIX システム (Solaris、AIX、HPUX) 向けには、すべての機能は実装されていません+エージェント置き換えられます。
  
-  Perl:全ての UNIX システムで動作する、Perl 5.8 をベースにしたマルチプラットフォームエージェントです。Perl 5.8 以上が必要です。+**_agentalias_ **
  
-シェルスクリプトエージェントは、古い UNIX (HPUX11.0、AIX 4.1、Solaris 2.6 など) でも動くようられています。ただし、機能は制限されており、Tentacle クライアントがありません。サーバにモニタデータをアップロードするには、FTP もしくは SSH を利用する必要があります。+エージェントの別名置き換えられます。
  
-===== Pandora FMS Unix エージェントの設定 ===== +**_address_**
-把握しておくべき基本的なファイルとディレクトリは次のとおりです。+
  
-  * ///usr/share/pandora_agent///: Pandora FMS エージェントがイントールされる場所です。厳密なシステムポリシーがあり、ここインストールでないシステムでは、実際のインストールパスかこのパスへのリンクを作成することを推奨します。例: '/opt/pandora' -> '/usr/share/pandora_agent'+エージェントが報告した IP アドレスに換えます。
  
-  ///etc/pandora/pandora_agent.conf//: エージェントのメインの設定ファイルです。ここにデータの収集に使うコマンドの定義がされています。+**_agentgroup_**
  
-  * ///usr/local/bin/pandora_agent//: Pandora FMS エージェント本体です。これは、pandora_agent.conf で設定されタ収集を行うシェルスクリトです。これはまた、Pandora サーバデータパケットを送信します。通常、/usr/bin/pandora_agent にリンクさています。+エージェントが報告しグループ置き換えられます。
  
-  ///usr/local/bin/tentacle_client//: サーバにデータファイルを送信するためにエージェントが追加する Tentacle クライアントです。これは、Perl 5.8 で動作するように作られています。通常、/usr/bin/tentacle_client にリンクされています。+**_agentos_**
  
-  * ///etc/init.d/pandora_agent_daemon//: エージェントの起動スクリプトです。pandora_agent を呼び出します。オプションとして、start/stop を利用できます。AIX システムでは、**/etc/rc.pandora_agent_daemon** です。+エージェントの OS に置換えられます。
  
-  ///var/log/pandora/pandora_agent.log//: Pandora FMS エージェントがデバッグモードで動作している時にログが出力されるログファイルです。+**_agentid_**
  
-  * ///etc/pandora/plugins//: エージェントプラグインをくディレクトリです。これは ///usr/share/pandora_agent/plugins// にリンクさています。+エージェント ID にき換えられます。
  
-*///etc/pandora/collections//: エージェントのコレクションを置くディレクトリです。これは ///usr/share/pandora_agent/collections// にリンクされています。+==== Unix/Linux エージェント ==== 
 + 
 + 
 +=== Pandora FMS Unix エージェントの設定 === 
 + 
 +把握しておくべき基本的なファイルとディレクトリは次のとおりです。 
 + 
 +  * ///usr/share/pandora_agent//  /: Pandora FMS エージェントがインストールされる場所です。厳密なシステムポリシーがあり、ここにインストールできないシステムでは、実際のインストールパスからこのパスへのリンクを作成することを推奨します。例: '/opt/pandora' → '/usr/share/pandora_agent' 
 +  * ///etc/pandora/pandora_agent.conf//: エージェントのメインの設定ファイルです。ここにデータの収集に使うコマンドの定義がされています。 
 +  * ///usr/local/bin/pandora_agent//: Pandora FMS エージェント本体です。これは、pandora_agent.conf で設定されたデータ収集を行うシェルスクリプトです。これはまた、Pandora サーバにデータパケットを送信します。通常、/usr/bin/pandora_agent にリンクされています。 
 +  * ///usr/local/bin/tentacle_client//: サーバにデータファイルを送信するためにエージェントが追加する Tentacle クライアントです。これは、Perl 5.8 で動作するように作られています。通常、/usr/bin/tentacle_client にリンクされています。 
 +  * ///etc/init.d/pandora_agent_daemon//: エージェントの起動スクリプトです。pandora_agent を呼び出します。オプションとして、start/stop を利用できます。AIX システムでは、**/etc/rc.pandora_agent_daemon**  です。 
 +  * ///var/log/pandora/pandora_agent.log//: Pandora FMS エージェントがデバッグモードで動作している時にログが出力されるログファイルです。 
 +  * ///etc/pandora/plugins//: エージェントプラグインを置くディレクトリです。これは ///usr/share/pandora_agent/plugins//  にリンクされています。 
 +*///etc/pandora/collections//: エージェントのコレクションを置くディレクトリです。これは ///usr/share/pandora_agent/collections//  にリンクされています。 
 + 
 +=== Unix エージェントの実行 ===
  
-===== Unix エージェントの実行 ===== 
 エージェントの起動は以下のようにします。 エージェントの起動は以下のようにします。
  
- /etc/init.d/pandora_agent_daemon start+<code> 
 +/etc/init.d/pandora_agent_daemon start 
 + 
 +</code>
  
 エージェントの停止は以下のようにします。 エージェントの停止は以下のようにします。
  
- /etc/init.d/pandora_agent_daemon stop+<code> 
 +/etc/init.d/pandora_agent_daemon stop 
 + 
 +</code>
  
 起動スクリプトで Pandora FMS エージェントの起動・停止ができます。デフォルトでは起動後はデーモーンとして動作します。 起動スクリプトで Pandora FMS エージェントの起動・停止ができます。デフォルトでは起動後はデーモーンとして動作します。
  
-===== Unix エージェントでシステム情報を取得する別の方法 =====+=== Unix エージェントでシステム情報を取得する別の方法 === 
 設定の章で示した通り、module_exec で特定のコマンドを実行することなく定義済の情報を取得できるモジュールがあります。以下がそれらです。 設定の章で示した通り、module_exec で特定のコマンドを実行することなく定義済の情報を取得できるモジュールがあります。以下がそれらです。
  
行 1358: 行 2023:
   * module_freepercentmemory   * module_freepercentmemory
  
-これらのモジュールの動作は、エージェントの実行ファイル (デフォルトでは ///usr/bin/pandora_agent//) を直接編集することにより変更できます。Pandora FMS エージェントは一般的に ///usr/bin/pandora_agent// にあります。コマンド名で検索することにより、内部コマンドを含むコードを見つけます。システムに合わせて変更する場合は、修正を行います。+これらのモジュールの動作は、エージェントの実行ファイル (デフォルトでは ///usr/bin/pandora_agent//) を直接編集することにより変更できます。Pandora FMS エージェントは一般的に ///usr/bin/pandora_agent//  にあります。コマンド名で検索することにより、内部コマンドを含むコードを見つけます。システムに合わせて変更する場合は、修正を行います。
  
 +<code>
  # Commands to retrieve total memory information in kB  # Commands to retrieve total memory information in kB
  use constant TOTALMEMORY_CMDS => {  use constant TOTALMEMORY_CMDS => {
-  linux => 'cat /proc/meminfo  | grep MemTotal: | awk \'{ print $2 }\//, +     linux => 'cat /proc/meminfo  | grep MemTotal: | awk \'{ print $2 }\//, 
-  solaris => 'MEM=`prtconf | grep Memory | awk \'{print $3}\'` bash -c \'echo $(( 1024 * $MEM ))\//, +     solaris => 'MEM =`prtconf | grep Memory | awk \'{print $3}\'` bash -c \'echo $(( 1024 * $MEM ))\//, 
-  hpux => 'swapinfo -t | grep memory | awk \'{print $2}\//+     hpux => 'swapinfo -t | grep memory | awk \'{print $2}\//
  };  };
 +
 +</code>
 +<code>
  
  # Commands to retrieve partition information in kB  # Commands to retrieve partition information in kB
  use constant PART_CMDS => {  use constant PART_CMDS => {
-  # total, available, mount point +     # total, available, mount point 
-  linux => 'df -P | awk \'NR > 1 {print $2, $4, $6}\//, +     linux => 'df -P | awk \'NR> 1 {print $2, $4, $6}\//, 
-  solaris => 'df -k | awk \'NR > 1 {print $2, $4, $6}\//, +     solaris => 'df -k | awk \'NR> 1 {print $2, $4, $6}\//, 
-  hpux => 'df -P | awk \'NR > 1 {print $2, $4, $6}\//, +     hpux => 'df -P | awk \'NR> 1 {print $2, $4, $6}\//, 
-  aix => 'df -kP | awk \'NR > 1 {print $2, $4, $6}\//+     aix => 'df -kP | awk \'NR> 1 {print $2, $4, $6}\//
  };  };
 +
 +</code>
  
 情報取得のための定義済の値を変更するには、コマンドを編集するだけですが、以下に注意します。 情報取得のための定義済の値を変更するには、コマンドを編集するだけですが、以下に注意します。
行 1380: 行 2051:
   - 行の終わりに ";" があることを確認   - 行の終わりに ";" があることを確認
   - コマンドが ' ' でくくられているか確認   - コマンドが ' ' でくくられているか確認
-  - ' を使う場合は、次のように でエスケープしているか確認+  - ' を使う場合は、次のように でエスケープしているか確認 
 +<code>
  
- df -P | awk 'NR > 1 {print $2, $4, $6}'+df -P | awk 'NR> 1 {print $2, $4, $6}' 
 + 
 +</code>
  
 上記は以下のようになります。 上記は以下のようになります。
 +<code>
 +
 +df -P | awk \'NR> 1 {print $2, $4, $6}\'
 +
 +</code>
 +
 +==== Pandora FMS Windows エージェント ====
 +
 +=== Pandora FMS Windows エージェントの設定 ===
 +
 +Windows エージェントの基本的なパスやディレクトリは、エージェントをインストールした場所になります。デフォルトでは //C:\Program files// です。
 +
 +{{  :wiki:programfiles-pandora_agent.png?500  }}
 +
 +理解しておきたい基本的なファイルは次の通りです。
 +
 +  * //C:\Program Files\pandora_agent//: Pandora FMS エージェントの実行ファイルやディレクトリがあるインストール先です。
 +  * //C:\Program Files\pandora_agent\pandora_agent.conf//: エージェントの設定ファイルです。実行モジュールおよびエージェントプラグインの設定はここにあります。
 +  * //C:\Program Files\pandora_agent\PandoraAgent.exe//: エージェントの実行バイナリです。
 +  * //C:\Program Files\pandora_agent\util\tentacle_client.exe//: サーバへファイルを転送するための Tentacle 実行バイナリです。
 +  * //C:\Program Files\pandora_agent\scripts//: Pandora FMS エージェントの起動・停止・再起動スクリプトです。
 +  * //C:\Program Files\pandora_agent\pandora_agent.log//: Pandora FMS エージェントがデバッグモードで実行されたときに出力されるログファイルです。
 +  * //C:\Program Files\pandora_agent\util//: エージェントプラグインを含むディレクトリです。
 +  * //C:\Program Files\pandora_agent\collections//: エージェントのコレクションを含むディレクトリです。
 +==== ソフトウエアエージェントの自動デプロイ ====
  
- df -P awk \'NR > 1 {print $2, $4, $6}\'+自動検出システムを通したデプロイの仕組みを使ってソフトウエアエージェントをデプロイすることができます。より詳細は、 [[:ja:documentation:03_monitoring:04_discovery#自動エージェントデプロイ|こちら]]を参照してください。
  
-====== Pandora FMS Windows エージェント ====== 
-===== Pandora FMS Windows エージェントの設定 ===== 
-Windows エージェントの基本的なパスやディレクトリは、エージェントをインストールした場所になります。デフォルトでは //C:\Program files// です。理解しておきたい基本的なファイルは次の通りです。 
  
-*//C:\Program Files\pandora_agent//: Pandora FMS エージェントの実行ァイルやディレクリがあるインストール先です。 +==== ソフトエージェントのップグレード ====
-*//C:\Program Files\pandora_agent\pandora_agent.conf//: ージェントの設定ファイルです。実行モジュールおよびエージェントプラグインの設定はここにあります。 +
-*//C:\Program Files\pandora_agent\PandoraAgent.exe//: エージェントの実行バイナリです。 +
-*//C:\Program Files\pandora_agent\util\tentacle_client.exe//: サーバへファイルを転送するための Tentacle 実行バイナリです。 +
-*//C:\Program Files\pandora_agent\scripts//: Pandora FMS エージェントの・停止・再起動スクリプトです。 +
-*//C:\Program Files\pandora_agent\pandora_agent.log//: Pandora FMS エージェントがデバグモードで実行されたときに出力されるログファイルです。 +
-*//C:\Program Files\pandora_agent\util//: エージェントインを含むディクトリです。 +
-*//C:\Program Files\pandora_agent\collections//:ジェントのコレクションを含むディレクトリです。+
  
-====== ソフトウエアエージェントの自動アップグレード ====== 
 ファイルコレクションと pandora_update ツールを使って、ソフトウエアエージェントは自分自身の更新ができます。 ファイルコレクションと pandora_update ツールを使って、ソフトウエアエージェントは自分自身の更新ができます。
  
-{{pandora:documentation_ja:tip|Pandora_update ツールは、Perl の Digest:MD5 モジュールが必要です。Perl 5.14 からはデフォルトで含まれていますが、古いバージョンでは手動でインストールしておく必要があります。}}+<WRAP center round tip 60%> Pandora_update ツールは、Perl の Digest:MD5 モジュールが必要です。Perl 5.14 からはデフォルトで含まれていますが、古いバージョンでは手動でインストールしておく必要があります。 </WRAP>
  
 これは、次のように動作します。 これは、次のように動作します。
行 1411: 行 2099:
  
 Windows の例: Windows の例:
 +<code>
  
- c:\program files\pandora_agent\collections\fc_1\PandoraAgent.exe+c:\program files\pandora_agent\collections\fc_1\PandoraAgent.exe 
 + 
 +</code>
  
 Linux の例: Linux の例:
  
- /etc/pandora/collections/fc_1/pandora_agent+<code> 
 +/etc/pandora/collections/fc_1/pandora_agent 
 + 
 +</code>
  
 2. エージェントは、pandora_update プラグインを実行します。このプラグインは、コレクションの短い名前をパラメータとして受け取ります(この例では //fc_1//)。コレクションディレクトリ内のエージェントバイナリをスキャンし、現在動作しているものと比較します。違いがあれば、pandora_update がエージェントを停止し、バイナリを置き換え、新しいバイナリを使ってエージェントを再起動します。 2. エージェントは、pandora_update プラグインを実行します。このプラグインは、コレクションの短い名前をパラメータとして受け取ります(この例では //fc_1//)。コレクションディレクトリ内のエージェントバイナリをスキャンし、現在動作しているものと比較します。違いがあれば、pandora_update がエージェントを停止し、バイナリを置き換え、新しいバイナリを使ってエージェントを再起動します。
  
-異なるアーキテクチャのアップデートを行うには、それぞれ異なるコレクションを用意する必要があります。例えば、32bit および 64bit の Windows エージェントをアップデートする必要がある場合は、2つのコレクションを作成し、それぞれに対応した //PandoraAgent.exe// バイナリを含める必要があります。+異なるアーキテクチャのアップデートを行うには、それぞれ異なるコレクションを用意する必要があります。例えば、32bit および 64bit の Windows エージェントをアップデートする必要がある場合は、2つのコレクションを作成し、それぞれに対応した //PandoraAgent.exe//  バイナリを含める必要があります。
  
 3. Pandora_update はまた、async_string モジュールを使うことによって、次の実行タイミングでユーザに通知を出せるように、エージェントのアップデートプロセスに関するアップデートイベントログを出力します。 3. Pandora_update はまた、async_string モジュールを使うことによって、次の実行タイミングでユーザに通知を出せるように、エージェントのアップデートプロセスに関するアップデートイベントログを出力します。
行 1428: 行 2122:
 **Unix 通常インストール** **Unix 通常インストール**
  
 +<code>
  module_begin  module_begin
  module_name Pandora_Update  module_name Pandora_Update
行 1435: 行 2130:
  module_description Module to check new version of pandora agent and update itself  module_description Module to check new version of pandora agent and update itself
  module_end  module_end
 +
 +</code>
  
 **Unix カスタムインストール** **Unix カスタムインストール**
  
 +<code>
  module_begin  module_begin
  module_name Pandora_Update  module_name Pandora_Update
行 1445: 行 2143:
  module_description Module to check new version of pandora agent and update itself  module_description Module to check new version of pandora agent and update itself
  module_end  module_end
 +
 +</code>
  
 注意: pandora_update コマンドの 2つ目のパラメータは、Pandora FMS のインストールパスです。このパラメータは、デフォルトのパスとは異なる場所に Pandora FMS をインストールした場合にのみ必要です。 注意: pandora_update コマンドの 2つ目のパラメータは、Pandora FMS のインストールパスです。このパラメータは、デフォルトのパスとは異なる場所に Pandora FMS をインストールした場合にのみ必要です。
行 1450: 行 2150:
 **Windows** **Windows**
  
 +<code>
  module_begin  module_begin
  module_name Pandora_Update  module_name Pandora_Update
行 1458: 行 2159:
  module_end  module_end
  
-====== XML ファイルからのエージェント・モジュールの自動作成 / 学習モード ======+</code> 
 + 
 +==== XML ファイルからのエージェント・モジュールの自動作成 / 学習モード ==== 
 エージェントは、コンソールから 3つの動作モードを設定できます。 エージェントは、コンソールから 3つの動作モードを設定できます。
  
-***学習モード(Learning mode)**: ソフトウエアエージェントから新たなモジュールを含む XML を受け取ると、それらが自動的に作成されます。これがデフォルト動作です。 +  * **学習モード(Learning mode)**: ソフトウエアエージェントから新たなモジュールを含む XML を受け取ると、それらが自動的に作成されます。これがデフォルト動作です。 
-***通常モード(Normal mode)**: コンソールに存在しない新たなモジュールを XML で受け取っても作成しません。 +  * **通常モード(Normal mode)**: コンソールに存在しない新たなモジュールを XML で受け取っても作成しません。 
-***自動無効化モード(Autodisable mode)**: 学習モードに似ていますが、すべてのモジュールが不明状態になった場合にエージェントを自動的に無効化します。新たな情報を受け取ったときに改めて自動化します。+  * **自動無効化モード(Autodisable mode)**: 学習モードに似ていますが、すべてのモジュールが不明状態になった場合にエージェントを自動的に無効化します。新たな情報を受け取ったときに改めて自動化します。 
 +{{  :wiki:learning_mode.png  }}
  
-<center> +=== エージェント作成時に XML からロードされるデータ ===
-{{wiki:Learning mode.png}} +
-</center>+
  
-===== エージェント作成時に XML からロードされるデータ ===== 
 XML を受け取ったときにエージェントの作成とともに自動的に取り込まれるデータは次の通りです。 XML を受け取ったときにエージェントの作成とともに自動的に取り込まれるデータは次の通りです。
  
行 1486: 行 2188:
   * エージェントモード: 学習、通常、自動無効化   * エージェントモード: 学習、通常、自動無効化
  
-===== XML を受け取ったときに修正されるデータ (学習モード有効時) =====+=== XML を受け取ったときに修正されるデータ (学習モード有効時) === 
   * エージェントの IP アドレス   * エージェントの IP アドレス
   * エージェントの親   * エージェントの親
行 1494: 行 2197:
   * カスタムフィールド   * カスタムフィールド
  
-{{pandora:documentation_ja:tip|GIS データは(GIS が有効の場合)、学習モードが有効であるか無効であるかに関わらず、常に更新されます。}}+<WRAP center round tip 60%> GIS データは(GIS が有効の場合)、学習モードが有効であるか無効であるかに関わらず、常に更新されます。 </WRAP>
  
 加えて、学習モードが有効の場合、XML ファイルで受け取った新たなモジュールは、Pandora で作成されます。 加えて、学習モードが有効の場合、XML ファイルで受け取った新たなモジュールは、Pandora で作成されます。
  
-===== 作成時にモジュールに追加されるデータ =====+=== 作成時にモジュールに追加されるデータ === 
 初回の各モジュールの XML 受信時に反映されるデータは次の通りです。 初回の各モジュールの XML 受信時に反映されるデータは次の通りです。
  
行 1525: 行 2229:
   * Crontab   * Crontab
  
-===== モジュールがすでに存在する場合に反映されるデータ =====+=== モジュールがすでに存在する場合に反映されるデータ === 
 すでに存在するモージュールのデータを XML で受け取った場合は、モジュールのデータに加えて説明および拡張情報のみ更新されます。 すでに存在するモージュールのデータを XML で受け取った場合は、モジュールのデータに加えて説明および拡張情報のみ更新されます。
  
-[[Category: Pandora FMS]] +
-[[Category:Documentation]] +
-[[Category:Japanese]]+
ºº