差分
このページの2つのバージョン間の差分を表示します。
ja:documentation:02_installation:05_configuration_agents [2023/11/01 04:45] – [追加アクション] junichi | ja:documentation:02_installation:05_configuration_agents [Unknown date] (現在) – 削除 - 外部編集 (Unknown date) 127.0.0.1 | ||
---|---|---|---|
行 1: | 行 1: | ||
- | ====== ソフトウエアエージェント設定 ====== | ||
- | |||
- | {{indexmenu_n> | ||
- | |||
- | [[: | ||
- | |||
- | |||
- | |||
- | ===== ソフトウエアエージェントとは? | ||
- | |||
- | They are small pieces of software that are installed in the operating systems and remain running on them to extract monitoring information and regularly send it to the Pandora FMS Data server, which processes and stores it in the database. | ||
- | |||
- | OS にインストールされ、監視情報を抽出して Pandora FMS (のデータを処理して DB へ保存する)データサーバへ定期的に送信するための小さなソフトウエアです。 | ||
- | |||
- | ===== エージェント設定概要 ===== | ||
- | |||
- | The operation of the Software Agent (operation parameters and modules) is determined by its configuration file. | ||
- | |||
- | ソフトウェアエージェントの動作 (動作パラメータとモジュール) は、その設定ファイルによって決定されます。 | ||
- | |||
- | * On MS Windows®: | ||
- | |||
- | * MS Windows® の場合: | ||
- | < | ||
- | |||
- | %ProgramFiles%\pandora_agent\pandora_agent.conf | ||
- | |||
- | </ | ||
- | |||
- | * On GNU/Linux® systems: | ||
- | |||
- | * GNU/Linux® システムの場合 | ||
- | < | ||
- | / | ||
- | |||
- | </ | ||
- | |||
- | ===== エージェントの一般的なパラメータ ===== | ||
- | |||
- | Most of the parameters are common for MS Windows® and GNU/Linux® systems. After having modified any general parameter, you must restart the Software Agent. | ||
- | |||
- | パラメータのほとんどは、MS Windows® および GNU/Linux® システムで共通です。 一般パラメータを変更した後は、ソフトウェアエージェントを再起動する必要があります。 | ||
- | |||
- | <WRAP center round important 60%> | ||
- | |||
- | **The agent configuration file encoding is UTF-8** on both GNU/Linux® and MS Windows® systems. | ||
- | |||
- | </ | ||
- | |||
- | <WRAP center round important 60%> | ||
- | |||
- | **エージェント設定ファイルのエンコードは、GNU/ | ||
- | |||
- | </ | ||
- | |||
- | <WRAP center round tip 90%> | ||
- | |||
- | The first time data is received from the Software Agent, all the information is saved in the database. For successive information submissions (and depending on whether the learning mode is enabled) only the following fields of the [[: | ||
- | |||
- | </ | ||
- | |||
- | <WRAP center round tip 90%> | ||
- | |||
- | ソフトウェア エージェントから初めてデータを受信すると、すべての情報がデータベースに保存されます。 連続した情報の送信では (学習モードが有効かどうかに応じて)、[[: | ||
- | |||
- | </ | ||
- | |||
- | ==== server_ip ==== | ||
- | |||
- | データを保持する Pandora FMS サーバのホスト名もしくは IP アドレスを設定します。 | ||
- | |||
- | ==== server_path ==== | ||
- | |||
- | エージェントから送られるデータを受け取るサーバのディレクトリパスを設定します。通常は、/ | ||
- | |||
- | ==== temporal ==== | ||
- | |||
- | エージェントがサーバにデータを送信する前にローカルで利用するフォルダのパスを設定します。 | ||
- | |||
- | ==== description ==== | ||
- | |||
- | XML でエージェントが送る「説明」を設定します。Pandora FMS はエージェントを作成する時に、この「説明」を取り込みます。 | ||
- | |||
- | ==== group ==== | ||
- | |||
- | エージェントが所属するグループ名を設定します。このパラメータで指定された名前のグループがある場合、サーバが特定のグループにエージェントを作成するようにしていなければ、指定したグループ内にエージェントが作成されます。 | ||
- | |||
- | ==== temporal_min_size ==== | ||
- | |||
- | If the free space (in megabytes) of the partition where the temporary directory is located is less than this value (by default one megabyte), **the generation of data packets is stopped**. This prevents the disk from filling up if for some reason the connection to the primary and/or [[: | ||
- | |||
- | テンポラリディレクトリのパーティション空き容量がここで指定したサイズ (MB 単位) より小さくなったら、**データパケットの生成を停止します。** (デフォルトは 1MB) 何らかの理由でプライマリおよび[[: | ||
- | |||
- | <WRAP center round tip 90%>In the [[: | ||
- | |||
- | {{ : | ||
- | |||
- | In this particular example with four days offline, monitoring data will be saved until only 1 megabyte (or the value you set) of free disk space is left.</ | ||
- | |||
- | <WRAP center round tip 90%> | ||
- | |||
- | {{ : | ||
- | |||
- | 4日間オフラインのこの例では、1メガバイト(または設定した値)の空きディスク容量が残るまで、監視データが保存されます。</ | ||
- | |||
- | <WRAP center round important 60%> | ||
- | |||
- | <WRAP center round important 60%> | ||
- | |||
- | ==== temporal_max_size ==== | ||
- | |||
- | Maximum size (in megabytes) allowed for the XML buffer, default value '' | ||
- | |||
- | XML バッファの最大サイズ(メガバイト)です。デフォルトは '' | ||
- | |||
- | See also '' | ||
- | |||
- | '' | ||
- | |||
- | ==== temporal_max_files ==== | ||
- | |||
- | Maximum number of files allowed for the XML buffer, default value '' | ||
- | |||
- | XML バッファの最大ファイル数です。デフォルトは '' | ||
- | |||
- | See also '' | ||
- | |||
- | '' | ||
- | |||
- | ==== logfile ==== | ||
- | |||
- | Pandora FMS エージェントのログファイルのパスです。 | ||
- | |||
- | ==== interval ==== | ||
- | |||
- | エージェントの秒単位のデータ収集間隔です。この間隔でエージェントは情報を収集し、Pandora FMS サーバへ送ります。 | ||
- | |||
- | ==== disable_logfile ==== | ||
- | |||
- | このパラメータは、pandora_agent.log へのログ出力を無効化します。Windows のみ。 | ||
- | |||
- | ==== debug ==== | ||
- | |||
- | 有効化すると、エージェントのデータファイルはテンポラリディレクトリ内に名前を変えて保存され、サーバへ送信したあとも削除されません。XML ファイルを開いて内容を確認することができます。 | ||
- | |||
- | ==== agent_name ==== | ||
- | |||
- | カスタム名を設定できます。設定していない場合、エージェント名はマシンのホスト名になります。 | ||
- | |||
- | ==== agent_name_cmd ==== | ||
- | |||
- | 外部コマンドを使ってエージェント名を定義したい場合に設定します。これはオプションです。このパラメータを設定した場合、' | ||
- | |||
- | ==== agent_alias_cmd ==== | ||
- | |||
- | <WRAP center round tip 60%> | ||
- | |||
- | 外部コマンドを使ってエージェントの別名を定義したい場合に設定します。このパラメータを設定した場合、' | ||
- | |||
- | ==== address ==== | ||
- | |||
- | これは、ソフトウエアエージェントの IP アドレスです。X.X.X.X というフォーマットの IP アドレス、' | ||
- | |||
- | ==== encoding ==== | ||
- | |||
- | ISO-8859-15 や UTF-8 のように、システムのエンコーディングの種類を設定します。 | ||
- | |||
- | ==== server_port ==== | ||
- | |||
- | このパラメータは、リモートのサーバの待ち受けポートの設定です。Tentacle のデフォルトは 41121 です。 | ||
- | |||
- | ==== transfer_mode ==== | ||
- | |||
- | このパラメータには、エージェントからサーバへデータを送信するための方法を設定します。デフォルトは Tentacle です。 | ||
- | |||
- | ==== transfer_timeout ==== | ||
- | |||
- | <WRAP center round tip 60%> | ||
- | |||
- | データ転送プログラムの実行タイムアウトを秒単位で指定します。設定されていない場合のデフォルトは 30 です。 | ||
- | |||
- | ==== server_pwd ==== | ||
- | |||
- | Windows の FTP もしくは Tentacle 転送モードのパスワードを設定します。Tentacle モードの場合はパスワードは必須ではありません。このパスワードでサーバでの認証を行います。 | ||
- | |||
- | ==== server_ssl ==== | ||
- | |||
- | It specifies the Tentacle transfer mode. Allows to enable ( '' | ||
- | |||
- | Tentacle の転送モードを設定します。SSL による暗号化を有効化('' | ||
- | |||
- | ==== server_opts ==== | ||
- | |||
- | Tentacle の転送モードを設定します。Tentacle クライアントの拡張設定のために渡す、追加パラメータを設定します。 | ||
- | |||
- | バージョン 3.2 以降のエージェントでは、tentacle がサーバへデータを送信するのに HTTP プロキシをサポートしています。プロキシを利用するには、つぎのような拡張オプションを使います。 | ||
- | < | ||
- | |||
- | server_opts "-y user: | ||
- | |||
- | </ | ||
- | |||
- | この例では、tentacle クライアントがポート 8080、ユーザ " | ||
- | |||
- | < | ||
- | server_opts "-y 192.168.1.2: | ||
- | |||
- | </ | ||
- | |||
- | ==== delayed_startup ==== | ||
- | |||
- | // | ||
- | ==== startup_delay ==== | ||
- | |||
- | // | ||
- | ==== pandora_nice ==== | ||
- | |||
- | このパラメータには、Pandora FMS エージェントプロセスの優先順位を設定します。この設定は、Unix/ | ||
- | |||
- | ==== autotime ==== | ||
- | |||
- | これを有効に設定 (1 に設定) すると、エージェントが送信する時間データを無視し、サーバに接続した時間をサーバのローカル時間で認識するようになります。この設定は、何らかの理由によりエージェントの時刻がおかしかったり、サーバの時刻と大きくずれている場合に利用します。 | ||
- | |||
- | ==== cron_mode ==== | ||
- | |||
- | このパラメータを有効にすると、エージェントをそれ自身の実行の仕組みではなく、Linux の crontab から指定した時刻に実行できるようになります。デフォルトでは無効になっています。 | ||
- | |||
- | ==== remote_config ==== | ||
- | |||
- | (Pandora FMS Enterprise のみ) | ||
- | |||
- | リモートエージェント設定を有効化(1)または無効化(0)します。Tentacle 転送モードでのみ利用できます。 | ||
- | |||
- | ==== xml_buffer ==== | ||
- | |||
- | 有効化(1)すると、エージェントは接続障害等でサーバに XML ファイルを送信できなかったとき、それをテンポラリディレクトリに保存します。それらは、通信が復旧したときに送られます。 | ||
- | |||
- | ==== timezone_offset ==== | ||
- | |||
- | The agent can now install its [[https:// | ||
- | |||
- | エージェントではサーバの[[https:// | ||
- | |||
- | < | ||
- | # Timezone offset: Difference with the server timezone | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | サーバのタイムゾーンからエージェントのタイムゾーンを差し引いて計算されます。例えば、サーバのタイムゾーンが UTC+1 で、エージェントのタイムゾーンが UTC-5 であれば、タイムゾーンのオフセットは、6 = 1 - (-5) です。 | ||
- | |||
- | ==== parent_agent_name ==== | ||
- | |||
- | ソフトウエアエージェントの親を指定します。Pandora FMS に存在するエージェント名である必要があります。 | ||
- | |||
- | ==== agent_threads ==== | ||
- | |||
- | モジュールを並行して実行するエージェントのスレッド数です。デフォルトではシングルスレッドで、すべての処理完了まで 1つずつモジュールを実行します。これは、UNIX エージェントのみの機能です。 | ||
- | |||
- | < | ||
- | # Number of threads to execute modules in parallel | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | ==== include ==== | ||
- | |||
- | < | ||
- | include < | ||
- | |||
- | </ | ||
- | |||
- | It allows to include an additional configuration ''< | ||
- | |||
- | 別の設定 ''< | ||
- | |||
- | ==== broker_agent ==== | ||
- | |||
- | < | ||
- | broker_agent < broker_name > | ||
- | |||
- | </ | ||
- | |||
- | It enables broker agent feature. To activate it, you only need to uncomment the parameter and indicate the name (''< | ||
- | |||
- | ブローカーエージェント機能を有効化します。有効化するにはパラメータのコメントを外し、ブローカーエージェントに割り当てる名前 (''< | ||
- | |||
- | ==== pandora_user ==== | ||
- | |||
- | < | ||
- | pandora_user < | ||
- | |||
- | </ | ||
- | |||
- | This parameter is optional and allows the agent to be executed with a specified system user(''< | ||
- | |||
- | このパラメータはオプションで、システムの特定のユーザ (''< | ||
- | |||
- | ==== custom_id ==== | ||
- | |||
- | 外部アプリケーションのための、エージェントのカスタム ID です。 | ||
- | |||
- | ==== url_address ==== | ||
- | |||
- | コンソールでエージェントから開くカスタム URL です。 | ||
- | |||
- | ==== custom_fieldX_name ==== | ||
- | |||
- | システムに設定済のエージェントのカスタムフィールド名です。存在しない場合は無視されます。 | ||
- | |||
- | 例: | ||
- | |||
- | < | ||
- | custom_field1_name Model | ||
- | |||
- | </ | ||
- | |||
- | ==== custom_fieldX_value ==== | ||
- | |||
- | 前述のパラメータで定義されたカスタムフィールド X の値です。 | ||
- | |||
- | 例: | ||
- | |||
- | < | ||
- | custom_field1_value C1700 | ||
- | |||
- | </ | ||
- | |||
- | ==== module_macro ==== | ||
- | |||
- | <WRAP center round tip 60%> Software Agent for Unix/Linux. </ | ||
- | |||
- | <WRAP center round tip 60%> Unix/Linux 用ソフトウエアエージェント</ | ||
- | |||
- | < | ||
- | module_macro< | ||
- | |||
- | </ | ||
- | |||
- | It defines a [[: | ||
- | |||
- | モジュールの定義で利用可能な[[: | ||
- | |||
- | Local execution macros start by '' | ||
- | |||
- | '' | ||
- | |||
- | Example: | ||
- | |||
- | 例: | ||
- | < | ||
- | |||
- | 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 | ||
- | |||
- | </ | ||
- | |||
- | |||
- | ==== group_password ==== | ||
- | |||
- | < | ||
- | group_password < | ||
- | |||
- | </ | ||
- | |||
- | Password for the agent group. Leave it commented if the group is not password-protected. | ||
- | |||
- | エージェントグループのパスワードです。グループのパスワード保護をしない場合は、コメントアウトした状態にしてください。 | ||
- | |||
- | ==== ehorus_conf ==== | ||
- | |||
- | < | ||
- | |||
- | ehorus_conf < | ||
- | |||
- | </ | ||
- | |||
- | Absolute path to a valid [[: | ||
- | |||
- | 有効な [[: | ||
- | |||
- | ==== transfer_mode_user ==== | ||
- | |||
- | < | ||
- | |||
- | transfer_mode_user < | ||
- | |||
- | </ | ||
- | |||
- | User of files copied in the local transfer mode. In console folders, this user must have reading and writing permissions for the remote configuration to work properly. By default it is '' | ||
- | |||
- | ローカル転送モードでコピーされるファイルのユーザでえす。正しく動作するためには、コンソールのフォルダで、このユーザがリモート設定ファイルを読み書きできる権限が必要です。デフォルトは '' | ||
- | |||
- | ==== secondary_groups ==== | ||
- | |||
- | < | ||
- | secondary_groups <group name1>, <group name2>, ... <group nameN> | ||
- | |||
- | </ | ||
- | |||
- | エージェントに割り当てるセカンダリグループ名です。複数のセカンダリグループをカンマ区切りで指定できます。サーバ上に存在しないグループを指定した場合はグループは割り当てられませんが、エージェントの作成には影響ありません。 | ||
- | |||
- | ==== standby ==== | ||
- | |||
- | < | ||
- | standby <1|0> | ||
- | |||
- | </ | ||
- | |||
- | エージェントがスタンバイモード('' | ||
- | |||
- | デバッグモードの場合はこの機能を上書きし、エージェントは通常動作をします。 | ||
- | |||
- | ==== module_absoluteinterval ==== | ||
- | |||
- | < | ||
- | module_absoluteinterval < | ||
- | |||
- | </ | ||
- | |||
- | < | ||
- | module_absoluteinterval once | ||
- | |||
- | </ | ||
- | |||
- | Specifies the execution interval for the module, but unlike [[en: | ||
- | |||
- | モジュールの実行間隔を指定しますが、[[: | ||
- | |||
- | - Remember the last run date when the agent is restarted. The module will not run until the specified interval has passed. | ||
- | - Allows you to specify the interval in seconds, minutes, hours or days (e.g., '' | ||
- | - It is possible to configure modules to be executed only once by specifying '' | ||
- | |||
- | - エージェントを再起動するときに、最後の実行日を記憶します。 モジュールは、指定された間隔が経過するまで実行されません。 | ||
- | - 間隔を秒、分、時間、または日単位で指定できます (例: '' | ||
- | - 間隔値として '' | ||
- | |||
- | ===== セカンダリサーバ ===== | ||
- | |||
- | データを送信するセカンダリサーバを設定することができます。設定により二種類の動作モードがあります。 | ||
- | |||
- | * **on_error**: | ||
- | * **always**: プライマリサーバにデータが送信できるかどうかに関わらず、常にセカンダリサーバにもデータを送信します。 | ||
- | |||
- | ===== UDP サーバ ===== | ||
- | |||
- | <WRAP center round important 60%> Bear in mind that UDP is unsafe by nature (but efficient to send messages without compromising a true response). </ | ||
- | |||
- | <WRAP center round important 60%> | ||
- | |||
- | UDPは本質的に安全ではないことに注意してください(ただし、応答を必須としないメッセージを送信するには効率的です)。 </ | ||
- | |||
- | Pandora FMS エージェントは、 [[: | ||
- | |||
- | UDP リモートサーバの設定には、いくつかのオプションがあり、// | ||
- | |||
- | * **udp_server**: | ||
- | * **udp_server_port**: | ||
- | * **udp_server_auth_address**: | ||
- | <WRAP center round important 60%> Although it can be set to // | ||
- | |||
- | <WRAP center round important 60%> | ||
- | |||
- | すべてのソースからのコマンド受け入れのために 0.0.0.0 に設定できますが、この方法はお勧めしません。複数の Pandora FMS サーバがある場合、または IPv6 を使用している場合は、カンマで区切って異なる IP アドレスを追加できます。たとえば、 IPv6:'' | ||
- | |||
- | * **process_< | ||
- | * **process_< | ||
- | * **service_< | ||
- | 設定例: | ||
- | < | ||
- | |||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | サーバは、次のコマンドを受け付けます。 | ||
- | |||
- | < | ||
- | * **< | ||
- | * **< | ||
- | * **REFRESH AGENT < | ||
- | |||
- | </ | ||
- | |||
- | 例: | ||
- | < | ||
- | |||
- | STOP SERVICE messenger | ||
- | START PROCESS firefox | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | サーバの ''/ | ||
- | |||
- | < | ||
- | ./ | ||
- | |||
- | </ | ||
- | |||
- | 例えば、エージェントを再起動するには次のようにします。 | ||
- | |||
- | < | ||
- | ./ | ||
- | |||
- | </ | ||
- | |||
- | ===== モジュール定義 ===== | ||
- | |||
- | The local execution modules are defined in the [[: | ||
- | |||
- | [[: | ||
- | |||
- | < | ||
- | |||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | ==== 全モジュールで共通の項目 ==== | ||
- | |||
- | <WRAP center round important 60%> モジュールのフィールド情報はモジュール作成時にのみ反映されます(モジュールデータ、説明、拡張情報を除く)。モジュールがすでに存在する場合は更新されません。 </ | ||
- | |||
- | === module_begin === | ||
- | |||
- | モジュール定義の開始を示す、必須項目です。 | ||
- | |||
- | === module_name === | ||
- | |||
- | モジュールの名前です(必須)。重複した名前は設定できません。 | ||
- | |||
- | < | ||
- | module_name < | ||
- | |||
- | </ | ||
- | |||
- | === module_type === | ||
- | |||
- | < | ||
- | module_type < | ||
- | |||
- | </ | ||
- | |||
- | モジュールが返すデータタイプです。いずれか一つを選択することが必須です。指定可能なデータタイプは次の通りです。 | ||
- | |||
- | * **Numeric** ( '' | ||
- | * **Incremental** ( '' | ||
- | * **Incremental absolute** ( '' | ||
- | * **Alphanumeric** ( '' | ||
- | * **Booleans** ( '' | ||
- | * **Asynchronous alphanumeric** ( '' | ||
- | * **Async Boolean** ( '' | ||
- | * **Asynchronous Numeric** ( '' | ||
- | |||
- | * **Numerical** | ||
- | * **Incremental** | ||
- | * **Incremental absolute** | ||
- | * **Alphanumeric** | ||
- | * **Booleans** | ||
- | * **Asynchronous Alphanumeric** | ||
- | * **Async Boolean** | ||
- | * **Asynchronous Numeric** | ||
- | |||
- | === module_min === | ||
- | |||
- | < | ||
- | module_min <値> | ||
- | |||
- | </ | ||
- | |||
- | そのモジュールが返すことを許容されるデータの最小値です。範囲を外れたデータはサーバにより削除されます。 | ||
- | |||
- | === module_max === | ||
- | |||
- | < | ||
- | module_max <値> | ||
- | |||
- | </ | ||
- | |||
- | そのモジュールが返すことを許容されるデータの最大値です。範囲を外れたデータはサーバにより削除されます。 | ||
- | |||
- | === module_min_warning === | ||
- | |||
- | < | ||
- | module_min_warning <値> | ||
- | |||
- | </ | ||
- | |||
- | モジュールが警告状態になる最小値です。 | ||
- | |||
- | === module_max_warning === | ||
- | |||
- | < | ||
- | module_max_warning <値> | ||
- | |||
- | </ | ||
- | |||
- | モジュールが警告状態になる最大値です。 | ||
- | |||
- | === module_min_critical === | ||
- | |||
- | < | ||
- | module_min_critical <値> | ||
- | |||
- | </ | ||
- | |||
- | モジュールが障害状態になる最小値です。 | ||
- | |||
- | === module_max_critical === | ||
- | |||
- | < | ||
- | module_max_critical <値> | ||
- | |||
- | </ | ||
- | |||
- | モジュールが障害状態になる最大値です。 | ||
- | |||
- | === module_disabled === | ||
- | |||
- | < | ||
- | module_disabled <値> | ||
- | |||
- | </ | ||
- | |||
- | モジュールが、有効(0)か無効(1)かを表します。 | ||
- | |||
- | === module_min_ff_event === | ||
- | |||
- | < | ||
- | module_min_ff_event <値> | ||
- | |||
- | </ | ||
- | |||
- | 連続抑制回数を指定します。連続抑制回数とは、収集データに揺らぎがあるような場合に、それを変化としてとらえないように抑止するものです。 | ||
- | |||
- | === module_each_ff === | ||
- | |||
- | < | ||
- | module_each_ff <0|1> | ||
- | |||
- | </ | ||
- | |||
- | 有効化(1)すると、module_min_ff_event の代わりに連続抑制回数に個別状態変化(module_min_ff_event_normal, | ||
- | |||
- | === module_min_ff_event_normal === | ||
- | |||
- | < | ||
- | |||
- | module_min_ff_event_normal <値> | ||
- | |||
- | </ | ||
- | |||
- | 個別状態変化で、正常状態へ移行する場合の連続抑制回数です。 | ||
- | |||
- | === module_min_ff_event_warning === | ||
- | |||
- | < | ||
- | module_min_ff_event_warning <値> | ||
- | |||
- | </ | ||
- | |||
- | 個別状態変化で、警告状態へ移行する場合の連続抑制回数です。 | ||
- | |||
- | === module_min_ff_event_critical === | ||
- | |||
- | < | ||
- | module_min_ff_event_critical <値> | ||
- | |||
- | </ | ||
- | |||
- | 個別状態変化で、障害状態へ移行する場合の連続抑制回数です。 | ||
- | |||
- | === module_ff_timeout === | ||
- | |||
- | < | ||
- | module_ff_timeout <秒> | ||
- | |||
- | </ | ||
- | |||
- | 指定した秒数が経過したら連続抑制回数のカウンターをリセットします。これは、// | ||
- | |||
- | === module_ff_type === | ||
- | |||
- | < | ||
- | module_ff_type <値> | ||
- | |||
- | </ | ||
- | |||
- | これは、連続抑制の高度なオプションで、モジュールの状態を制御します。 " | ||
- | |||
- | 有効(1)か無効(0)かを指定します。 | ||
- | |||
- | === module_ff_event === | ||
- | < | ||
- | |||
- | module_ff_event X | ||
- | |||
- | </ | ||
- | |||
- | This is the flip flip execution threshold of the module (in seconds). | ||
- | |||
- | これは、モジュールの連続抑制実行のしきい値(秒単位)です。 | ||
- | |||
- | === module_description === | ||
- | |||
- | < | ||
- | module_description < | ||
- | |||
- | </ | ||
- | |||
- | モジュールの任意のコメントです。 | ||
- | |||
- | === module_interval === | ||
- | |||
- | < | ||
- | module_interval < | ||
- | |||
- | </ | ||
- | |||
- | それぞれのモジュールの実行間隔をエージェントの間隔の倍率で設定することができます。例えば、エージェントが 300 (5 分)間隔の設定であった場合に、あるモジュールだけ 15分間隔にしたいときに、module_interval 3 を設定します。そのモジュールは、300秒 x 3 = 900秒 (15分) 間隔で実行されます。 | ||
- | |||
- | <WRAP center round important 60%> ブローカーエージェントで module_interval が動作するようにするには、元のエージェントと同じ間隔に設定する必要があります。 そうしないと、正しく動作しない可能性があります。 </ | ||
- | |||
- | === module_timeout === | ||
- | |||
- | < | ||
- | module_timeout < | ||
- | |||
- | </ | ||
- | |||
- | モジュールの最大実行時間を秒単位で指定します。実行中にこの時間を超過した場合は、実行が中止されます。 | ||
- | |||
- | === module_postprocess === | ||
- | |||
- | < | ||
- | module_postprocess < | ||
- | |||
- | </ | ||
- | |||
- | モジュールから返される値を何倍するかの値です。データの単位を変換するのに便利です。もし、エージェントが取得した値に 1024 を掛けたい場合は、1024 を設定します。また、1024 で割りたい場合は、1/ | ||
- | |||
- | === module_save === | ||
- | |||
- | < | ||
- | module_save < | ||
- | |||
- | </ | ||
- | |||
- | このパラメータで定義された名前の変数にモジュールから返された値を保存します。この値はあとから他のモジュールで利用できます。 | ||
- | |||
- | 例: | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | " | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | 2つ目のモジュールでは、" | ||
- | |||
- | Windows エージェントでは、変数は $var ではなく %var% で指定します。 以下に例を示します。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | === module_crontab === | ||
- | |||
- | From version 3.2, it's possible to schedule modules in the order they' | ||
- | |||
- | バージョン 3.2 から、モジュールを指定した日時に実行させるようにすることができます。この設定は、**module_crontab** | ||
- | |||
- | < | ||
- | module_crontab <分> < | ||
- | |||
- | </ | ||
- | |||
- | 指定可能な範囲は次の通りです。 | ||
- | |||
- | * 分 0-59 | ||
- | * 時間 0-23 | ||
- | * 日 1-31 | ||
- | * 月 1-12 | ||
- | * 曜日 0-6 (0 が日曜です) | ||
- | |||
- | 期間を指定する **-** を利用することも可能です。 | ||
- | |||
- | 例えば、あるモジュールを毎週月曜の 12時から 15時の間に実行するには、次のような設定をします。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | コマンドを毎時 10分に実行したい場合は、次のようにします。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | === module_condition === | ||
- | |||
- | < | ||
- | module_condition < | ||
- | |||
- | </ | ||
- | |||
- | バージョン 3.2 から、モジュールが特定の値を返す場合にコマンドを実行させることが可能です。次に示すオプションの一つを定義します。 | ||
- | |||
- | * **> | ||
- | * **< | ||
- | * **=** [値]: モジュールの値が指定された値と同じ場合にコマンドを実行します。 | ||
- | * **!=** | ||
- | * **=~** | ||
- | * **(** 値, 値**)**: モジュールの値が指定された値の範囲の場合にコマンドを実行します。 | ||
- | 同一のモジュールに複数の条件を設定することも可能です。以下の例では、モジュールの値が 1 と 3 の間の時に// | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | 例: | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | < | ||
- | |||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | < | ||
- | |||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | * 注意: Windows プラットホームでは、コマンドの実行にはそれが正しく実行されていることを確認するために **cmd.exe /c** を利用することをお勧めします。例えば次の通りです。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | === module_precondition === | ||
- | |||
- | < | ||
- | module_precondition < | ||
- | |||
- | </ | ||
- | |||
- | 事前状態定義にマッチした場合モジュールを実行します。次に示すオプションの一つを定義します。 | ||
- | |||
- | * **> | ||
- | * **< | ||
- | * **=** [値]: コマンドの実行結果が指定された値と同じ場合にモジュールを実行します。 | ||
- | * **!=** | ||
- | * **=~** | ||
- | * **(** 値, 値**)**: コマンドの実行結果が指定された値の範囲の場合にモジュールを実行します。 | ||
- | 以下の例では、precondition で設定した実行結果が 2 と 8 の間の場合に、モジュール // | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | module_condition と同様に、複数の事前状態定義を利用することができます。モジュールは、すべての事前状態定義にマッチした場合のみ実行されます。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | * 注意: Windows プラットホームでは、コマンドの実行にはそれが正しく実行されていることを確認するために **cmd.exe /c** を利用することをお勧めします。例えば次の通りです。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | === module_unit === | ||
- | |||
- | < | ||
- | module_unit < | ||
- | |||
- | </ | ||
- | |||
- | これは、モジュールの値に付与する単位です。 | ||
- | |||
- | 例: | ||
- | |||
- | < | ||
- | module_unit % | ||
- | |||
- | </ | ||
- | |||
- | === module_group === | ||
- | |||
- | < | ||
- | module_group <値> | ||
- | |||
- | </ | ||
- | |||
- | これは、モジュールグループ名です。 | ||
- | |||
- | 例: | ||
- | |||
- | < | ||
- | module_group Networking | ||
- | |||
- | </ | ||
- | |||
- | === module_custom_id === | ||
- | |||
- | < | ||
- | module_custom_id <値> | ||
- | |||
- | </ | ||
- | |||
- | モジュールのカスタム ID です。 | ||
- | |||
- | 例: | ||
- | |||
- | < | ||
- | module_custom_id host101 | ||
- | |||
- | </ | ||
- | |||
- | === module_str_warning === | ||
- | |||
- | < | ||
- | module_str_warning <値> | ||
- | |||
- | </ | ||
- | |||
- | 文字列タイプのモジュールで警告状態を定義する正規表現です。 | ||
- | |||
- | 例: | ||
- | |||
- | < | ||
- | module_str_warning .*NOTICE.* | ||
- | |||
- | </ | ||
- | |||
- | === module_str_critical === | ||
- | |||
- | < | ||
- | module_str_critical <値> | ||
- | |||
- | </ | ||
- | |||
- | 文字列タイプのモジュールで障害状態を定義する正規表現です。 | ||
- | |||
- | 例: | ||
- | |||
- | < | ||
- | module_str_critical .*CRITICAL.* | ||
- | |||
- | </ | ||
- | |||
- | === module_warning_instructions === | ||
- | |||
- | < | ||
- | module_warning_instructions <値> | ||
- | |||
- | </ | ||
- | |||
- | モジュールが警告状態に変化したときのオペレータへの指示です。 | ||
- | |||
- | 例: | ||
- | |||
- | < | ||
- | module_warning_instructions Increase incident priority | ||
- | |||
- | </ | ||
- | |||
- | === module_critical_instructions === | ||
- | |||
- | < | ||
- | module_critical_instructions <値> | ||
- | |||
- | </ | ||
- | |||
- | モジュールが障害状態に変化したときのオペレータへの指示です。 | ||
- | |||
- | 例: | ||
- | |||
- | < | ||
- | module_critical_instructions Call to sys department | ||
- | |||
- | </ | ||
- | |||
- | === module_unknown_instructions === | ||
- | |||
- | < | ||
- | module_unknown_instructions <値> | ||
- | |||
- | </ | ||
- | |||
- | モジュールが不明状態に変化したときのオペレータへの指示です。 | ||
- | |||
- | 例: | ||
- | |||
- | < | ||
- | module_unknown_instructions Open incident | ||
- | |||
- | </ | ||
- | |||
- | === module_tags === | ||
- | |||
- | < | ||
- | module_tags <値> | ||
- | |||
- | </ | ||
- | |||
- | カンマ区切りでモジュールに割り当てるタグを指定します。 | ||
- | |||
- | 例: | ||
- | |||
- | module_tags tag1, | ||
- | |||
- | === module_warning_inverse === | ||
- | |||
- | < | ||
- | module_warning_inverse <値> | ||
- | |||
- | </ | ||
- | |||
- | 警告閾値範囲の反転を有効化(1)します。 | ||
- | |||
- | 例: | ||
- | |||
- | < | ||
- | module_warning_inverse 1 | ||
- | |||
- | </ | ||
- | |||
- | === module_critical_inverse === | ||
- | |||
- | < | ||
- | module_critical_inverse <値> | ||
- | |||
- | </ | ||
- | |||
- | 障害閾値範囲の反転を有効化(1)します。 | ||
- | |||
- | 例: | ||
- | |||
- | < | ||
- | module_critical_inverse 1 | ||
- | |||
- | </ | ||
- | |||
- | === module_native_encoding === | ||
- | |||
- | <WRAP center round tip 60%> On Win32 only. </ | ||
- | |||
- | <WRAP center round tip 60%> | ||
- | |||
- | < | ||
- | module_native_encoding <値> | ||
- | |||
- | </ | ||
- | |||
- | この設定トークンは、module_exec によってコマンドラインから実行されるモジュールにのみ影響します。 | ||
- | |||
- | Windows では、コマンドラインエンコーディング(OEM)、システムエンコーディング(ANSI)および、UTF-16 の 3つのプロセスのエンコーディングがあります。いずれのエンコーディングも通常の文字を扱うことができますが、アクセントを表したものなどいくつかの文字に違いがあります。このトークンにより、Pandora エージェントが設定ファイル(pandora_agent.conf)で指定したエンコーディングに出力を変換します。 | ||
- | |||
- | module_native_encoding は、次の 4種類の値を設定できます。 | ||
- | |||
- | * module_native_encoding OEM: コマンドラインエンコーディングに変換 | ||
- | * module_native_encoding ANSI: システムエンコーディングに変換 | ||
- | * module_native_encoding UTFLE: UTF-16 のリトルエンディアンに変換 | ||
- | * module_native_encoding UTFBE: UTF-16 のビッグエンディアンに変換 | ||
- | |||
- | module_native_encoding の設定が無い場合は、変換は行われません。 | ||
- | |||
- | === module_quiet === | ||
- | |||
- | < | ||
- | module_quiet <値> | ||
- | |||
- | </ | ||
- | |||
- | If enabled ('' | ||
- | |||
- | 有効化('' | ||
- | |||
- | Example: | ||
- | |||
- | 例: | ||
- | |||
- | < | ||
- | module_quiet 1 | ||
- | |||
- | </ | ||
- | |||
- | === module_ff_interval === | ||
- | |||
- | < | ||
- | module_ff_interval <値> | ||
- | |||
- | </ | ||
- | |||
- | 収集データに揺らぎがあるような場合に、それを変化としてとらえるべきかを判断する期間のデータ収集間隔です。(秒単位) | ||
- | |||
- | 例: | ||
- | |||
- | < | ||
- | module_ff_interval 2 | ||
- | |||
- | </ | ||
- | |||
- | === module_macro === | ||
- | |||
- | < | ||
- | module_macro< | ||
- | |||
- | </ | ||
- | |||
- | コンソールから、ローカルコンポーネントにのみ適用できます。設定ファイルで直接設定しません。 | ||
- | |||
- | === module_alert_template === | ||
- | |||
- | < | ||
- | module_alert_template < | ||
- | |||
- | </ | ||
- | |||
- | このマクロは、パラメータ名([[: | ||
- | |||
- | 例: | ||
- | < | ||
- | |||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | </ | ||
- | |||
- | </ | ||
- | |||
- | === intensive_interval === | ||
- | |||
- | [[: | ||
- | |||
- | [[: | ||
- | |||
- | === module_intensive_condition === | ||
- | |||
- | Condition for [[: | ||
- | |||
- | [[: | ||
- | |||
- | === module_end === | ||
- | |||
- | モジュール定義の終わりを表します。必須項目です。 | ||
- | |||
- | ==== 情報を取得するためのディレクティブ ==== | ||
- | |||
- | <WRAP center round info 60%> | ||
- | |||
- | In each Module only one of these types can be used. | ||
- | |||
- | </ | ||
- | |||
- | <WRAP center round info 60%> | ||
- | |||
- | 各モジュールでは、これらのタイプのうち 1 つだけ使用できます。 | ||
- | |||
- | </ | ||
- | |||
- | === module_exec === | ||
- | |||
- | < | ||
- | module_exec < | ||
- | |||
- | </ | ||
- | |||
- | General ''< | ||
- | |||
- | 一般的な''< | ||
- | |||
- | On GNU/Linux, the command will be executed using the default command prompt. The default interpreter will be determined by the symbolic link ''/ | ||
- | |||
- | GNU/Linux では、コマンドはデフォルトのシェルを使って実行されます。デフォルトのシェルは、 ''/ | ||
- | |||
- | < | ||
- | module_exec bash -c "< | ||
- | |||
- | </ | ||
- | |||
- | <WRAP center round important 60%> 実行結果が ' | ||
- | |||
- | Windows エージェントでのデータ取得のためのディレクティブは他にもあります。以下に示します。 | ||
- | |||
- | === module_service === | ||
- | |||
- | < | ||
- | module_service < | ||
- | |||
- | </ | ||
- | |||
- | 指定したサービスが実行中であるかどうかをチェックします。 | ||
- | |||
- | == MS Windows == | ||
- | |||
- | サービス名にスペースが含まれる場合は、" | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | サービスは、Windows サービスマネージャに表示される短い名前 (サービス名) で識別されます。 | ||
- | |||
- | [[: | ||
- | |||
- | // | ||
- | |||
- | Pandora FMS は通常、(モジュールによって定義される)一定の秒間隔にてチェックを実行します (デフォルトでは、300秒 = 5分)。そのため、チェックの直後にサービスがダウンすると、それがダウンであると認識するのに、さらに 300秒かかります。非同期モジュールでは、Pandora に " | ||
- | < | ||
- | |||
- | module_async yes | ||
- | |||
- | </ | ||
- | |||
- | この機能は、ブローカーエージェントでは利用できません。 | ||
- | |||
- | <WRAP center round important 60%> Windows Home Edition では、この非同期機能はサポートされていません。Pandora エージェントはサービスが動作しているかどうかを定期的に確認します。大量のサービスを監視する場合システムリソースを消費するため、同期モードを利用することをお勧めします。 </ | ||
- | |||
- | // | ||
- | |||
- | サービスがダウンしたときに再起動するためのウォッチドッグモードがあります。サービスを起動するためのパラメータは Windows が認識しているため必要ありません。設定は簡単で、以下に例を示します。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | == Unix == | ||
- | |||
- | Unix でも Windows と同様に動作します。違いは Unix であることだけで、プロセスおよびサービスは同じ考え方です。例えば、bash プロセスが動作しているかを確認するには次のようにします。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | <WRAP center round info 60%> | ||
- | |||
- | <WRAP center round info 60%>Unix エージェントでは、ウォッチドッグと非同期検出はできません。</ | ||
- | |||
- | For '' | ||
- | |||
- | '' | ||
- | |||
- | < | ||
- | ps aux | grep ssh | ||
- | |||
- | </ | ||
- | |||
- | {{ : | ||
- | |||
- | Configure it: | ||
- | |||
- | <code bash> | ||
- | module_begin | ||
- | module_name MY_SSHD | ||
- | module_type generic_proc | ||
- | module_service / | ||
- | module_description Is sshd running? | ||
- | module_end | ||
- | |||
- | </ | ||
- | |||
- | |||
- | === module_proc === | ||
- | |||
- | < | ||
- | module_proc < | ||
- | |||
- | </ | ||
- | |||
- | 指定した名前のプロセスがいるかどうかをチェックします。 | ||
- | |||
- | **Windows**< | ||
- | |||
- | 以下に cmd.exe プロセスをモニタリングする例を示します。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | // | ||
- | |||
- | サービスと同じように、モニタリングしているプロセスにて何らかの原因で障害が発生することがあります。Windows エージェントでは、// | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | 違いは、" | ||
- | |||
- | // | ||
- | |||
- | ウォッチドッグは、ダウンしたプロセスを見つけた場合にそれをすぐに起動させることができます。Pandora FMS の Windows エージェントは、プロセスがダウンしたときにウォッチドッグとして動作させることができます。 | ||
- | |||
- | プロセスの実行には、いくつかのパラメータが必要です。このモジュールには、いくつかの追加設定オプションがあります。// | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | 以下に、ウォッチドッグを行う場合の module_proc の追加パラメータを示します。 | ||
- | |||
- | * **module_retries**: | ||
- | * **module_startdelay**: | ||
- | * **module_retrydelay**: | ||
- | * **module_user_session**: | ||
- | <WRAP center round important 60%> Windows Vista 以前のバージョンでは、Pandora FMS サービスプロパティで、" | ||
- | |||
- | [[: | ||
- | |||
- | また、Pandora FMS は " | ||
- | |||
- | === module_cpuproc < | ||
- | |||
- | 特定のプロセスの CPU 使用率を返します。 | ||
- | < | ||
- | |||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | **Unix** | ||
- | |||
- | UNIX では、このモジュールは module_service のように動作します。非同期およびウォッチドッグモードはサポートしません。 | ||
- | |||
- | === module_memproc === | ||
- | |||
- | < | ||
- | module_memproc < | ||
- | |||
- | </ | ||
- | |||
- | **Unixのみです。** | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | === module_freedisk === | ||
- | |||
- | < | ||
- | module_freedisk < | ||
- | |||
- | </ | ||
- | |||
- | It checks for the free space in the disk unit. | ||
- | |||
- | このモジュールは、ディスクの空き容量をチェックします。 | ||
- | |||
- | **In Windows®** | ||
- | |||
- | **Windows® の場合** | ||
- | |||
- | Place '':'' | ||
- | |||
- | ドライブ名の後に '':'' | ||
- | |||
- | < | ||
- | |||
- | module_begin | ||
- | module_name freedisk | ||
- | module_type generic_data | ||
- | module_freedisk C: | ||
- | module_end | ||
- | |||
- | </ | ||
- | |||
- | **In Unix®** | ||
- | |||
- | **Unix® の場合** | ||
- | |||
- | The volume to check, such as ''/ | ||
- | |||
- | ''/ | ||
- | |||
- | < | ||
- | module_begin | ||
- | module_name disk_var | ||
- | module_type generic_data | ||
- | module_freedisk /var | ||
- | module_end | ||
- | |||
- | </ | ||
- | |||
- | === module_freepercentdisk === | ||
- | |||
- | < | ||
- | module_freepercentdisk < | ||
- | |||
- | </ | ||
- | |||
- | このモジュールは、ディスクの空きをパーセントで返します。 | ||
- | |||
- | **Windows** | ||
- | |||
- | ドライブ名: | ||
- | |||
- | < | ||
- | |||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | **Unix** | ||
- | |||
- | /var などのボリュームを指定します。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | === module_occupiedpercentdisk === | ||
- | |||
- | < | ||
- | module_occupiedpercentdisk < | ||
- | |||
- | </ | ||
- | |||
- | **Unix のみです。** | ||
- | < | ||
- | |||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | === module_cpuusage === | ||
- | |||
- | < | ||
- | module_cpuusage <cpu id|all> | ||
- | |||
- | </ | ||
- | |||
- | このモジュールは、UNIX および Windows 双方で使えます。指定した CPU 番号の CPU 使用率を返します。CPU が 1つしかない場合は番号を指定しないか、all を指定します。 | ||
- | |||
- | 次のように、マルチ CPU 環境で全 CPU の平均使用率を得ることができます。 | ||
- | < | ||
- | |||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | 1つ目の CPU 使用率を確認するのは次のようにします。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | === module_freememory === | ||
- | |||
- | Windows および Unix 双方で使えます。システム全体の空きメモリ量を取得します。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | === module_freepercentmemory === | ||
- | |||
- | Windows および Unix 双方で使えます。システム全体の空きメモリ量のパーセンテージを取得します。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | === module_tcpcheck === | ||
- | |||
- | **Windows のみです。** | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | === module_regexp === | ||
- | |||
- | Windows のみです。このモジュールは、 [[http:// | ||
- | |||
- | * **generic_data_string**, | ||
- | * **generic_data**: | ||
- | * **generic_proc**: | ||
- | * **module_noseekeof**: | ||
- | < | ||
- | |||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | |||
- | === module_wmiquery === | ||
- | |||
- | Windows のみです。WMI モジュールは、外部ツールを使わずにローカルで WMI クエリを実行できます。2つのパラメータで設定します。 | ||
- | |||
- | * **module_wmiquery**: | ||
- | * **module_wmicolumn**: | ||
- | 例えば、インストールされているサービス一覧を取得するには次のようにします。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | 現在の CPU 負荷であれば次のようにします。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | === module_perfcounter === | ||
- | |||
- | **Windowsのみです。** | ||
- | < | ||
- | |||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | Windows パフォーマンスモニタは、モニタリングに利用できる何百ものパラメータを持つ強力なツールです。加えて、各ベンダによる独自のモニタ項目も追加されています。 | ||
- | |||
- | パフォーマンスツールから、パフォーマンスカウンターを確認できます。 | ||
- | |||
- | [[: | ||
- | |||
- | システムツールを用いて新たなパフォーマンスカウンターを追加することができます。その構成には、要素とサブ要素を含む管理構造があります。ここでは、// | ||
- | |||
- | [[: | ||
- | |||
- | このように、OS のツールを使うことにより、システムパフォーマンスのさまざまな要素を取り込むことができます。この場合、モジュールの設定は次のようになります。 | ||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | |||
- | </ | ||
- | |||
- | デフォルトでは、カウンタの生データが表示されます。調整値を取得するには、**module_cooked 1** を設定します。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | 多くのデータは、カウンタ値として返ってきます。そのため、データタイプとしては generic_data_inc を使う必要があります。また、とても大きなスケール (数百万) のデータが返ってくることがありますので、事前処理モジュールで 0.000001 などを設定して値を小さくすると良いです。 | ||
- | |||
- | === module_inventory (廃止) === | ||
- | |||
- | <WRAP center round important 60%> Windows および Linux/UNIX 双方で、現在この機能はエージェントプラグインによるインベントリで置き換えられています。 </ | ||
- | |||
- | //(Win32 のみ。Linux/ | ||
- | |||
- | 前述の WMI を利用することにより、このモジュールはソフトウエアおよびハードウエアの違った情報を取得します。 | ||
- | |||
- | モジュールは、取得した情報の種類を分類し収集します。以下に情報の種類の一覧を示します。 | ||
- | |||
- | * **cpu**: システムの CPU 情報を取得します。(プロセッサ名、クロック数、説明) | ||
- | * **CDROM**: CD-ROM の情報を取得します。(名称およびドライブ名) | ||
- | * **Video**: ビデオカードの情報を取得します。(説明、RAM容量、プロセッサ) | ||
- | * **HDs**: ハードディスクの情報を取得します。(モデル、サイズおよび、システムにおける名前) | ||
- | * **NICs**: ネットワークコントローラの情報を取得します。(説明、MAC アドレスおよび、IPアドレス) | ||
- | * **Patches**: | ||
- | * **Software**: | ||
- | * **RAM**: RAM モジュールの情報を取得します。(タグ、容量および名前) | ||
- | * **Service**: | ||
- | 追加モジュールパラメータ: | ||
- | |||
- | * **module_interval**: | ||
- | このモジュールの利用例を以下に示します。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | === module_logevent === | ||
- | |||
- | Windows のみです。指定されたパターンに基づいて Windows イベントログから情報を取得し、ソースおよびイベントタイプに従ってフィルタリングする機能を提供します。 | ||
- | |||
- | このモジュールの一般的な書式は次の通りです。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | すでに表示されたものを再度表示するのを防ぐために、エージェントが実行された最終時間より後のイベントのみを対象とします。 | ||
- | |||
- | module_logevent には、次のパラメータを設定できます。(すべて大文字小文字を区別します) | ||
- | |||
- | * **module_source**: | ||
- | * **module_eventtype**: | ||
- | * **module_pattern**: | ||
- | * **module_eventcode**: | ||
- | * **module_application**: | ||
- | 例えば、system の error に分類される全てのイベントを表示するには、次のように設定します。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | PandoraAgent という文字を含む全イベントを表示するには次のようにします。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | その他例として、以下にイベントフィルタリングのスナップショットを示します。 | ||
- | |||
- | [[: | ||
- | < | ||
- | |||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | Pandora FMS は、**ログを収集するシステムではない** ということを理解してください。このツールは、これらのクリティカルまたは重要なイベントを選択し、監視するためのシステムです。すべてのイベントを未分類で収集すると、データベースが飽和状態になりシステムパフォーマンスが著しく低下し、長期的に問題をもたらします。Pandora FMS を一般的なイベント収集ツールとして使うべきではありません。 | ||
- | |||
- | === module_logchannel === | ||
- | |||
- | <WRAP center round tip 60%> | ||
- | |||
- | Windows ログチャネルに関する情報を取得するモジュールです。// | ||
- | |||
- | このモジュールの一般的な書式は次の通りです。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | すでに表示されたものを再度表示するのを防ぐために、エージェントが実行された最終時間より後のイベントのみを対象とします。 | ||
- | |||
- | module_logchannel には、次のパラメータを設定できます。(すべて大文字小文字を区別します) | ||
- | |||
- | * **module_source**: | ||
- | * **module_eventtype**: | ||
- | * **module_pattern**: | ||
- | * **module_eventcode**: | ||
- | * **module_application**: | ||
- | 例えば、チャネル // | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | このモジュール設定により、Pandora FMS エージェントは次のようなログを収集します。 | ||
- | |||
- | [[: | ||
- | |||
- | <WRAP center round important 60%> イベントチャネルの名前を取得するには、チャネルを右クリックして、" | ||
- | |||
- | === module_plugin === | ||
- | |||
- | プラグインから取得したデータを定義するためのパラメータです。これは、特殊なモジュールで、' | ||
- | |||
- | 次のような書式です。 | ||
- | < | ||
- | |||
- | module_plugin plugin_filename parameter_1 parameter_2 (...) parameter_X | ||
- | |||
- | </ | ||
- | |||
- | ただし、プラグインに状態や実行間隔などの追加パラメータを設定する場合は、次のように通常の書式を利用します。 | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | それぞれのプラグインには個別のパラメータが使われます。そのため、それぞれの特定のドキュメントを参照する必要があります。ここでは、エージェントにデフォルトで付属しているプラグインの一つであるファイル内を検索する grep_log で説明します。 | ||
- | |||
- | < | ||
- | module_plugin grep_log / | ||
- | |||
- | </ | ||
- | |||
- | In this example, the name of the plugin is '' | ||
- | |||
- | この例では、プラグインの名前が '' | ||
- | |||
- | Windows システムの場合の別の例を示します。(バージョン 3.1 以上) | ||
- | |||
- | < | ||
- | module_plugin cscript.exe //B " | ||
- | |||
- | </ | ||
- | |||
- | === module_ping === | ||
- | |||
- | **Windows のみ。** | ||
- | |||
- | < | ||
- | module_ping < | ||
- | |||
- | </ | ||
- | |||
- | このモジュールは、指定したホストに ping を行い、応答があれば 1、そうでなければ 0 を返します。 | ||
- | |||
- | 次のパラメータを設定できます。 | ||
- | |||
- | * **module_ping_count x**: 送信する ECHO_REQUEST パッケットの数 (1 がデフォルト) | ||
- | * **module_ping_timeout x**: 応答を待つタイムアウトミリ秒数 (1000 がデフォルト) | ||
- | * **module_advanced_options**: | ||
- | 例: | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | === module_snmpget === | ||
- | |||
- | **Windows のみ。** | ||
- | |||
- | このモジュールは snmpget を実行し、その応答を返します。 | ||
- | |||
- | 次のパラメータを設定できます。 | ||
- | |||
- | * **module_snmpversion [1_2c_3]**: SNMP バージョン (1 がデフォルト) | ||
- | * **module_snmp_community < | ||
- | * **module_snmp_agent < | ||
- | * **module_snmp_oid < | ||
- | * **module_advanced_options**: | ||
- | 例: | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | === module_wait_timeout === | ||
- | |||
- | **Windows のみ。** | ||
- | < | ||
- | module_wait_timeout X | ||
- | |||
- | </ | ||
- | |||
- | Expiration time used when the module **module_exec** and **module_plugin **output is checked. Value by default 500 miliseconds. Modify to 5 if the execution of a module that generates lots of outputs is slow. It is recommended no to use in the rest of cases. | ||
- | |||
- | モジュールの module_exec および module_plugin 出力がチェックされる際のタイムアウト時間。デフォルトの値は 500ミリ秒です。大量の出力を生成するモジュールで実行が遅い場合は、5に変更します。それ以外の場合は使用しないことをお勧めします。 | ||
- | |||
- | === module_advanced_options === | ||
- | |||
- | **Only for MS Windows®.** | ||
- | |||
- | **MS Windows® のみ** | ||
- | |||
- | < | ||
- | module_advanced_options < | ||
- | |||
- | </ | ||
- | |||
- | For '' | ||
- | |||
- | '' | ||
- | |||
- | < | ||
- | |||
- | module_advanced_options -l 512 | ||
- | |||
- | </ | ||
- | |||
- | ===== 自動エージェント設定 ===== | ||
- | |||
- | ==== 概要 ==== | ||
- | |||
- | In the agent configuration process, you may set a series of rules for your agents to be configured automatically. It works like this: | ||
- | |||
- | エージェント設定処理では、エージェントを自動的に設定するための一連のルールを設定できます。 それはこのように動作します: | ||
- | |||
- | - **Prepare automatic configurations** | ||
- | - **Install the agents** | ||
- | - **Pandora FMS Server will receive** | ||
- | - **Rules will be evaluated** | ||
- | - **The agent will retrieve the new configuration** | ||
- | |||
- | - Pandora FMS コンソールまたは、Pandora FMS メタコンソールで、自動設定の準備をします。 | ||
- | - Pandora FMS へ接続するエージェントをインストールします。(単一のコンソールの場合はエージェントの接続先は Pandora FMS サーバです。自動プロビジョニングを設定したメタコンソールがある場合は、メタコンソールをサーバとして設定します。) | ||
- | - Pandora FMS サーバが、エージェントのデータを含む XML (.data) を初回受信します。 | ||
- | - 適用される自動設定を決定するためのルールが評価されます。 | ||
- | - エージェントが新たな設定を受け取り、次回の処理から更新された設定で動作します。 | ||
- | |||
- | ==== 自動エージェント設定の作成/ | ||
- | |||
- | **Console** | ||
- | |||
- | **コンソール** | ||
- | |||
- | Access the management of automatic configurations through **Configuration** → **Manage agent autoconfiguration**. | ||
- | |||
- | 自動設定画面へは **設定(Configuration)** → **自動エージェント設定管理(Manage agent autoconfiguration)** からアクセスします。 | ||
- | |||
- | **Metaconsole** | ||
- | |||
- | **メタコンソール** | ||
- | |||
- | Go to **Centralized management** → **Agent management** → automatic agent configuration icon. | ||
- | |||
- | **中央管理(Centralized management)** → **エージェント管理(Agent management)** → エージェント自動設定アイコン: | ||
- | |||
- | By accessing the administration page you can create new automatic configurations by pressing the **Add new configuration definition** button. You will need to choose a name and description for your automatic configuration. | ||
- | |||
- | 管理ページにアクセスしたら、**新たな設定定義の追加(Add new configuration definition)** ボタンをクリックすることにより新たな自動設定を作成することができます。自動設定の名前と説明を設定します。 | ||
- | |||
- | Once the new auto configuration is created, you can display the configuration forms by clicking on the section you need: **Rules**, **Agent autoconfiguration** or **Extra actions**. | ||
- | |||
- | 新たな自動設定を作成したら、必要な項目 (**ルール(Rules)**、**エージェント自動設定(Agent autoconfiguration)**、**追加アクション(Extra actions)**) をクリックすることにより設定フォームを表示できます。 | ||
- | |||
- | === ルール === | ||
- | |||
- | To define the Agents to which the automatic configuration will be applied, you can first add rules to identify them. | ||
- | |||
- | 自動設定が適用されるエージェントを定義するには、まずエージェントを識別するルールを追加します。 | ||
- | |||
- | Expand the rules section within your automatic configuration, | ||
- | |||
- | 自動設定内のルールセクションを展開し、**新しいルールの追加(Add new rule)** を選択します。 ルールセレクターで一連のオプションを選択して、設定するエージェントを識別できます。 | ||
- | |||
- | * **Server name**: Match on server name. | ||
- | * **Group ****name**: Match on group name. | ||
- | * **OS**: Match operating system name using regular expressions. | ||
- | * **Custom field**: Match by key/value based on a custom field reported by the Agent. Indicate the name of the custom field and the value it should have. | ||
- | * **IP range**: Match by range of IP (network) addresses, use IP/mask notation. | ||
- | * **Script output (> 0)**: Intended to execute a script whose execution result is evaluated as valid when the standard output is greater than 0. | ||
- | * **Rules script call**: Supports the following macros in the ' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | |||
- | * **Server name**: マッチするサーバ名 | ||
- | * **Group name**: マッチするグループ名 | ||
- | * **OS**: マッチする OS 名 (正規表現) | ||
- | * **Custom field**: エージェントが報告してくる、キー/ | ||
- | * **IP range**: IP の範囲(ネットワーク)にマッチ。IP/ | ||
- | * **Script output (> 0)**: スクリプトの実行結果で、標準出力の結果が 0より大きい場合にルールにマッチしたと評価されます。 | ||
- | * **Rules script call**: ' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | |||
- | <WRAP center round tip 60%> | ||
- | |||
- | If you don't add any rules, the automatic settings will not be applied. If you need a single configuration for all agents, you can use the following regular expression to match any alias: '' | ||
- | |||
- | <WRAP center round tip 60%> | ||
- | |||
- | === 設定 === | ||
- | |||
- | * **Agent Group**: You can keep it unchanged or force it to be a specific one. | ||
- | * **Secondary Groups**: The groups selected here will be added as secondary groups to the Agent. | ||
- | * **Policies**: | ||
- | * **Configuration Block**: Adds the extra raw configuration to the Agent configuration file. | ||
- | |||
- | * **エージェントグループ(Agent Group)**: 変更せずにそのままとするか、強制的に変更します。 | ||
- | * **セカンダリグループ(Secondary Group)**: エージェントにセカンダリグループとして追加するグループを選択します。 | ||
- | * **ポリシー(Policies)**: | ||
- | * **設定ブロック(Configuration Block)**: エージェントの設定ファイルに追加する設定内容です。 | ||
- | |||
- | <WRAP center round info 60%> | ||
- | |||
- | If you try to access the automatic configuration administration from a node that belongs to a Metaconsole, | ||
- | |||
- | </ | ||
- | |||
- | <WRAP center round info 60%> | ||
- | |||
- | 集中管理が有効なメタコンソールに属するノードから自動設定管理を行おうとすると、リードオンリー表示になります。 | ||
- | |||
- | </ | ||
- | |||
- | === 追加アクション === | ||
- | |||
- | From this section you can associate other actions to the autoconfiguration, | ||
- | |||
- | ここでは、自動設定に追加のアクションを行うことができます。例えば以下のような処理です。 | ||
- | |||
- | - Launch a custom event (**Launch custom event**). | ||
- | - Execute an alert action (**Launch alert action**). | ||
- | - Execute a script (**Launch script**). | ||
- | |||
- | - 独自イベントを出す (**Launch custom event**) | ||
- | - アラートアクションを実行する (**Launch alert action**) | ||
- | - スクリプトを実行する (**Launch script**) | ||
- | |||
- | The system supports the following macros: | ||
- | |||
- | システムは、次のマクロをサポートします。 | ||
- | |||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | |||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
- | |||
- | ===== Unix/Linux エージェント ===== | ||
- | |||
- | |||
- | ==== Pandora FMS Unix エージェントの設定 ==== | ||
- | |||
- | 把握しておくべき基本的なファイルとディレクトリは次のとおりです。 | ||
- | |||
- | * /// | ||
- | * /// | ||
- | * /// | ||
- | * /// | ||
- | * /// | ||
- | * /// | ||
- | * /// | ||
- | */// | ||
- | |||
- | ==== Unix エージェントの実行 ==== | ||
- | |||
- | エージェントの起動は以下のようにします。 | ||
- | < | ||
- | |||
- | / | ||
- | |||
- | </ | ||
- | |||
- | エージェントの停止は以下のようにします。 | ||
- | |||
- | < | ||
- | / | ||
- | |||
- | </ | ||
- | |||
- | 起動スクリプトで Pandora FMS エージェントの起動・停止ができます。デフォルトでは起動後はデーモーンとして動作します。 | ||
- | |||
- | ==== Unix エージェントでシステム情報を取得する別の方法 ==== | ||
- | |||
- | As we saw in the configuration section, there are some modules that obtain the [[: | ||
- | |||
- | 設定の章で示した通り、'' | ||
- | |||
- | * module_procmem | ||
- | * module_freedisk | ||
- | * module_freepercentdisk | ||
- | * module_cpuproc | ||
- | * module_proc | ||
- | * module_procmem | ||
- | * module_cpuusage | ||
- | * module_freememory | ||
- | * module_freepercentmemory | ||
- | |||
- | It is possible to modify the operation of these modules by directly editing the agent executable (''/ | ||
- | |||
- | これらのモジュールの動作は、エージェントの実行ファイル (デフォルトでは ''/ | ||
- | |||
- | Search for the '' | ||
- | |||
- | コマンド名で検索することにより、内部コマンドを含むコードを見つけます。システムに合わせて変更する場合は、修正を行います。 | ||
- | |||
- | < | ||
- | |||
- | # Commands to retrieve total memory information in kB | ||
- | use constant TOTALMEMORY_CMDS => { | ||
- | linux => 'cat / | ||
- | | ||
- | hpux => ' | ||
- | }; | ||
- | |||
- | # Commands to retrieve partition information in kB | ||
- | use constant PART_CMDS => { | ||
- | # total, available, mount point | ||
- | linux => 'df -P | awk \' | ||
- | solaris => 'df -k | awk \' | ||
- | hpux => 'df -P | awk \' | ||
- | aix => 'df -kP | awk \' | ||
- | }; | ||
- | |||
- | </ | ||
- | |||
- | To change any of the predefined values to get the information, | ||
- | |||
- | 情報取得のための定義済の値を変更するには、コマンドを編集するだけですが、以下に注意します。 | ||
- | |||
- | - Check that blocks '' | ||
- | - Check that commands are between '' | ||
- | - In turn, within said simple quotation marks, you may need additional ones, like '' | ||
- | - Check that any simple quotation mark that you may want to use in the command is preceded by '' | ||
- | |||
- | - ブロックの終わりに '' | ||
- | - コマンドが '' | ||
- | - シングルクォーテーションを使う場合は、'' | ||
- | - コマンドで使用するシングルクォーテーションの前に '' | ||
- | < | ||
- | |||
- | df -P | awk ' | ||
- | |||
- | </ | ||
- | |||
- | 上記は以下のようになります。 | ||
- | < | ||
- | |||
- | df -P | awk \' | ||
- | |||
- | </ | ||
- | |||
- | ===== Pandora FMS Windows エージェント ===== | ||
- | |||
- | ==== Pandora FMS Windows エージェントの設定 ==== | ||
- | |||
- | The fundamental paths and directories in the Windows agent installation will be found in the directory where the agent is installed, by default '' | ||
- | |||
- | Windows エージェントの基本的なパスやディレクトリは、エージェントをインストールした場所になります。デフォルトでは '' | ||
- | |||
- | {{ : | ||
- | |||
- | 理解しておきたい基本的なファイルは次の通りです。 | ||
- | |||
- | **'' | ||
- | |||
- | Where Pandora FMS agent, its executable and its directories are installed. | ||
- | |||
- | Pandora FMS エージェントの実行ファイルやディレクトリがあるインストール先です。 | ||
- | |||
- | **'' | ||
- | |||
- | Agent configuration main file. Local execution modules and agent plugins are configured here. | ||
- | |||
- | エージェントの設定ファイルです。実行モジュールおよびエージェントプラグインの設定はここにあります。 | ||
- | |||
- | **'' | ||
- | |||
- | Executable agent binary. | ||
- | |||
- | エージェントの実行バイナリです。 | ||
- | |||
- | **'' | ||
- | |||
- | Tentacle executable binary for transferring files to the server. | ||
- | |||
- | サーバへファイルを転送するための Tentacle 実行バイナリです。 | ||
- | |||
- | **'' | ||
- | |||
- | Pandora FMS agent start/ | ||
- | |||
- | Pandora FMS エージェントの起動・停止・再起動スクリプトです。 | ||
- | |||
- | **'' | ||
- | |||
- | Text file where Pandora FMS agent activity is saved, when the agent is executed in debug mode. | ||
- | |||
- | Pandora FMS エージェントがデバッグモードで実行されたときに出力されるログファイルです。 | ||
- | |||
- | **'' | ||
- | |||
- | Directory containing the agent plugins. | ||
- | |||
- | エージェントプラグインを含むディレクトリです。 | ||
- | |||
- | **'' | ||
- | |||
- | Directory containing the agent' | ||
- | |||
- | エージェントのコレクションを含むディレクトリです。 | ||
- | |||
- | ===== ソフトウエアエージェントの自動デプロイ ===== | ||
- | |||
- | You may deploy software agents by using the **deployment central** through the Discovery system, more information in [[: | ||
- | |||
- | 自動検出システムを通したデプロイの仕組みを使ってソフトウエアエージェントをデプロイすることができます。より詳細は、 [[: | ||
- | |||
- | |||
- | ===== ソフトウエアエージェントの自動アップグレード ===== | ||
- | |||
- | ファイルコレクションと pandora_update ツールを使って、ソフトウエアエージェントは自分自身の更新ができます。 | ||
- | |||
- | <WRAP center round tip 60%> Pandora_update ツールは、Perl の Digest:MD5 モジュールが必要です。Perl 5.14 からはデフォルトで含まれていますが、古いバージョンでは手動でインストールしておく必要があります。 </ | ||
- | |||
- | これは、次のように動作します。 | ||
- | |||
- | 1. エージェントが、例えば次のようなファイルコレクションの incoming ディレクトリに新たなバイナリを受信します。 | ||
- | |||
- | Windows の例: | ||
- | < | ||
- | |||
- | c:\program files\pandora_agent\collections\fc_1\PandoraAgent.exe | ||
- | |||
- | </ | ||
- | |||
- | Linux の例: | ||
- | |||
- | < | ||
- | / | ||
- | |||
- | </ | ||
- | |||
- | 2. エージェントは、pandora_update プラグインを実行します。このプラグインは、コレクションの短い名前をパラメータとして受け取ります(この例では // | ||
- | |||
- | 異なるアーキテクチャのアップデートを行うには、それぞれ異なるコレクションを用意する必要があります。例えば、32bit および 64bit の Windows エージェントをアップデートする必要がある場合は、2つのコレクションを作成し、それぞれに対応した // | ||
- | |||
- | 3. Pandora_update はまた、async_string モジュールを使うことによって、次の実行タイミングでユーザに通知を出せるように、エージェントのアップデートプロセスに関するアップデートイベントログを出力します。 | ||
- | |||
- | 以下がアップデートプロセスで使うモジュールです。間隔は長めに設定します。 | ||
- | |||
- | **Unix 通常インストール** | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | **Unix カスタムインストール** | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | 注意: pandora_update コマンドの 2つ目のパラメータは、Pandora FMS のインストールパスです。このパラメータは、デフォルトのパスとは異なる場所に Pandora FMS をインストールした場合にのみ必要です。 | ||
- | |||
- | **Windows** | ||
- | |||
- | < | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | </ | ||
- | |||
- | ===== XML ファイルからのエージェント・モジュールの自動作成 / 学習モード ===== | ||
- | |||
- | エージェントは、コンソールから 3つの動作モードを設定できます。 | ||
- | |||
- | * **学習モード(Learning mode)**: ソフトウエアエージェントから新たなモジュールを含む XML を受け取ると、それらが自動的に作成されます。これがデフォルト動作です。 | ||
- | * **通常モード(Normal mode)**: コンソールに存在しない新たなモジュールを XML で受け取っても作成しません。 | ||
- | * **自動無効化モード(Autodisable mode)**: 学習モードに似ていますが、すべてのモジュールが不明状態になった場合にエージェントを自動的に無効化します。新たな情報を受け取ったときに改めて自動化します。 | ||
- | [[: | ||
- | |||
- | ==== エージェント作成時に XML からロードされるデータ ==== | ||
- | |||
- | XML を受け取ったときにエージェントの作成とともに自動的に取り込まれるデータは次の通りです。 | ||
- | |||
- | * エージェント名 | ||
- | * エージェントのIPアドレス | ||
- | * エージェントの説明 | ||
- | * エージェントの親 | ||
- | * タイムゾーンオフセット | ||
- | * グループ | ||
- | * OS | ||
- | * エージェントの実行間隔 | ||
- | * エージェントのバージョン | ||
- | * カスタムフィールド | ||
- | * カスタムID | ||
- | * URL アドレス | ||
- | * エージェントモード: | ||
- | |||
- | ==== XML を受け取ったときに修正されるデータ (学習モード有効時) ==== | ||
- | |||
- | * エージェントの IP アドレス | ||
- | * エージェントの親 | ||
- | * OSバージョン | ||
- | * エージェントのバージョン | ||
- | * タイムゾーン | ||
- | * カスタムフィールド | ||
- | |||
- | <WRAP center round tip 60%> GIS データは(GIS が有効の場合)、学習モードが有効であるか無効であるかに関わらず、常に更新されます。 </ | ||
- | |||
- | 加えて、学習モードが有効の場合、XML ファイルで受け取った新たなモジュールは、Pandora で作成されます。 | ||
- | |||
- | ==== 作成時にモジュールに追加されるデータ ==== | ||
- | |||
- | 初回の各モジュールの XML 受信時に反映されるデータは次の通りです。 | ||
- | |||
- | * 名前 | ||
- | * タイプ | ||
- | * 説明 | ||
- | * フィルタの最大・最小値 | ||
- | * 保存倍率 | ||
- | * モジュール実行間隔 | ||
- | * 障害の最大・最小値 | ||
- | * 警告の最大・最小値 | ||
- | * 無効化モジュール | ||
- | * 単位 | ||
- | * モジュールグループ | ||
- | * カスタムID | ||
- | * 文字列の警告・障害 | ||
- | * 障害時手順 | ||
- | * 警告時手順 | ||
- | * 不明時手順 | ||
- | * タグ | ||
- | * 障害反転モード | ||
- | * 警告反転モード | ||
- | * 静観モード | ||
- | * 連続抑制回数 | ||
- | * アラートテンプレート | ||
- | * Crontab | ||
- | |||
- | ==== モジュールがすでに存在する場合に反映されるデータ ==== | ||
- | |||
- | すでに存在するモージュールのデータを XML で受け取った場合は、モジュールのデータに加えて説明および拡張情報のみ更新されます。 | ||
- | |||
- | [[: | ||