====== ポリシーを使った監視 ======
{{indexmenu_n>2}}
[[:ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]
===== ポリシー =====
==== 概要 ====
{{:wiki:icono-modulo-enterprise.png |Enterprise 版}}
ポリシーシステムは、大規模な監視環境の管理を容易にすることを目的としています。 これは、リモート設定機能 [[:ja:documentation:pandorafms:monitoring:02_operations#エージェント設定|エージェント設定]] を使用して設定ファイルを変更することにより、モジュール、アラート、外部アラート、プラグイン、リモートインベントリおよびコレクションを一元化された方法でエージェントに伝播できます。ビデオチュートリアル [[https://www.youtube.com/watch?v=nNBrXrsZS4I|«Pandora FMS policies. Centralized monitoring. Workshop.»]] もご覧ください。
ポリシーに加えた変更を適用するには、対応する画面で **ポリシーの適用(apply the policy)** ([[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#policy_queue_management|キューへの挿入]]) を行います。
ポリシー管理は、次のように Pandora FMS Web コンソールの左側のメニューの **設定(configuration)** > **ポリシー管理(Manage Policies)** をクリックします。
[[:wiki:pt11.png?id=ja:documentation:pandorafms:complex_environments_and_optimization:02_policy&media=wiki:pt11.png|{{ :wiki:pt11.png?nolink&400 }}]]
クイックガイド "[[:ja:quickguides:templates_policies_massives#differences_between_templates_policies_and_massive_operations|テンプレート、ポリシー、一括操作の違い]]" でも詳細を確認できます。
==== ポリシー管理 ====
=== ポリシーの検索 ===
[[:ja:documentation:pandorafms:command_center:01_introduction|メタコンソール]]とノードの両方の検索ヘッダから、Pandora FMS のポリシーを検索できます。 例:
{{ :wiki:newsearch2.png?700 }}
メタコンソールでの検索では、2つのタイプの結果を返します。
* **一元化検索(Centralized search)**: 表示されるポリシーは、メタコンソール自体のポリシーです。 表には、データがメタコンソール自体から取得されていることを示すダッシュが入力された サーバ フィールドが表示されます。
{{ :wiki:newsearch3.jpg?400 |newsearch3.jpg}}
{{ :wiki:newsearch4.jpg?700 |newsearch4.jpg}}
* **非一元化検索(Non-centralized search)**: 表示されるポリシーは、各ノードから直接取得されたポリシーです。 表には、各ノードの名前が入力されたサーバの名前が表示されます。
{{ :wiki:newsearch5.jpg?650 |newsearch5.jpg}}
{{ :wiki:newsearch6.jpg?640 |newsearch6.jpg}}
=== ポリシーの追加 ===
システム管理メニューの ポリシー管理(Manage policies) をクリックすると、定義されている全ポリシーが表示されます。
{{ :wiki:pt12.png?700 }}
新たにポリシーを作成するには、"作成(Create)" ボタンをクリックします。以下に新たなポリシーの作成画面を示します。ここでは、名前、所属するグループおよびオプションで説明を入力します。
{{ :wiki:pt13.png?700 }}
=== ポリシーの複製 ===
ポリシーの操作ボタンの中には、ポリシーを複製するボタンもあります。
{{ :wiki:pt15.png?550 }}
コピー元のポリシーの状態に関係なく、ポリシーがコピーされ表示されます。
=== ポリシーの削除 ===
ポリシーを削除するには、関連づけられたものが無い状態である必要があります。
ポリシーにエージェントがある場合、削除ボタンは無効になり、全エージェントの削除ボタンが表示されます。
{{ :wiki:pt14.png?500 }}
このボタンは削除処理をキューに追加します。処理が完了すると、ポリシーの削除ボタンが再び有効になります。
==== ポリシーの設定 ====
ポリシーを設定するには、システム管理メニューの ポリシー管理(Manage policies) でポリシー名をクリックするか、設定変更したいポリシーの上にマウスカーソルをもっていきリンクをクリックします。
{{ :wiki:pt16.png?450 }}
ポリシーの設定では、次のウインドウがあります。
* エージェント(Agents)
* モジュール(Modules)
* インベントリモジュール(Inventory Modules)
* アラート(Alerts)
* 外部アラート(External alerts)
* コレクション(Collections)
* リンク(Linking)
* キュー(Queue)
* エージェントプラグイン(Agent plugins)
* エージェントウィザード(Agent wizards)
{{ :wiki:pt17.png?750 }}
ポリシーのオプションは次の通りです。
* 1 つまたは複数の既存のポリシー エージェントの追加/削除。
* モジュールの作成/編集/削除。
* エージェントプラグインの定義/編集/削除。
* アラートの作成/編集/削除。
* 外部アラートの作成/編集/削除。
* 既存のコレクションの追加/削除。
* 既存のインベントリモジュールの追加/削除。
* ポリシーを 1 つまたは複数の関連モジュールにリンク。
* ポリシーに変更を適用。
実行可能な異なるアクションはポリシーが適用されるまで適用されません。たとえば、エージェントをポリシーに追加する場合は、複数のモジュールおよびアラートを作成することができますが、適用するまでは反映されません。
同様に、一つのポリシーを適用し、かつ要素を編集や削除した場合は、次の実行まで変更は反映されません。
すべての変更は、"キュー(Queue)" ウインドウに表示されます。また、そこでプロセスキューにポリシーを投入できます。また、そこで適用されるのを待ちます。
=== ポリシーキュー管理 ===
ポリシー操作キューには、最後に適用してから変更があった要素のまとめがあります。
{{ :wiki:policy_queue2.png?800 }}
この一覧には、更新する必要のある要素と、削除がペンディング状態の要素があります。
* 更新がペンディング
* エージェント
* グループ
* リンクがペンディングになっているモジュール
* リンク解除がペンディングになっているモジュール
* 削除がペンディング
* エージェント
* グループ
* モジュール
* インベントリモジュール
* アラート
* 外部アラート
* プラグイン
このサマリは、ポリシーを適用すべきかどうかを示しています。時々、エージェントの隣のアイコンで、適用がペンディングになっているものを適用するボタンがあります。
ペンディングとなっている変更(例ではアラートの変更)は、データベースにのみ記録されます。このボタンはこのレベルにおいてのみの変更です。そのため適用は早いです。
{{ :wiki:queue_onlydb.png?550 }}
しかし、設定ファイルに適用する変更を行う(例えばコレクションやローカルモジュールの編集)と、処理が完了します。
{{ :wiki:queue_onlydbconf.png?550 }}
サマリでは、修正がペンディング状態であるかに関わらず、すべてを適用するボタンがあります。
{{ :wiki:queue_applyall.png?700 }}
適用を選択した場合、処理キューにポリシーエージェントを追加します。Pandora FMS サーバは、キューに入っているペンディングポリシーの適用を行います。画面を再読み込みすると、処理の進行状況を確認することができ、処理が完了したか、いつ完了したかがわかります。
{{ :wiki:queue_progress.png?700 }}
=== エージェントとグループ ===
この画面では、エージェントやグループでフィルタリングして、ポリシーにエージェントを追加したり削除したりします。
== エージェント ==
エージェントをポリシーに追加するには、上部のフィルタリングオプションで ''Ctrl'' または ''Shift'' キーを押しながら必要なエージェントを一括で選択します。
{{ :wiki:pt18.png?800 }}
下には、ポリシーに関連付けられたすべてのエージェント一覧が表示されます。また、ポリシーからの削除待ちのエージェントも表示されます。
{{ :wiki:pt19.png?700 }}
エージェント一覧は、グループ、文字列、状態でフィルタできます。
{{ :wiki:pt20.png?800 }}
表示される要素の一覧:
**名前(Name)**
エージェント名
**R.**
モート設定
**S.**
ポリシーにおけるエージェントの状態
**U.**
エージェントで未リンク状態のモジュール数
**A.**
エージェントを適用するキューに入れるためのボタン
**グループ(Group)**
エージェントがポリシーグループから適用されたかどうかを知るためのアイコングループ
**最新の適用(Last application)**
ポリシーが適用された最新の日時
**D.**
削除/削除取消ボタン
エージェントが削除されると、その名前は取り消し線で表示され、削除ボタンは元に戻すボタンになります。エージェントは再びポリシーにリンクされます。
{{ :wiki:pt21.png?500 }}
もちろん、ポリシーが //キュー// ページで適用されると、ポリシーエージェントの追加または削除が有効化されます。
== グループ ==
\\
バージョン 760 以降、このオプションで設定されたグループのいずれかに新しいエージェントが割り当てられると、それらのエージェントは自動的にポリシー設定を受け取ります。
上にはグループの再帰オプションがあります。オンにすると、すべての子グループもポリシーに追加されます。 目的のグループは、''Ctrl'' キーまたは ''Shift'' キーを使用して選択できます。
{{ :wiki:pt22.png?800 }}
下には、ポリシーに関連付けられたすべてのグループ一覧が表示されます。また、ポリシーからの削除待ちのエージェントも表示されます。
{{ :wiki:pt23.png?600 }}
グループ一覧は以下の情報を表示します。
{{ :wiki:pt24.png?500 }}
**名前(Name)**
グループ名
**S.**
ポリシーグループ状態
**A.**
適用するためにそのグループをキューに追加するためのボタン
**T.**
グループエージェントの総数に対する、そのポリシーが適用されているそのグループに属するエージェントの数
**最終適用(Last application)**
ポリシーが最後に適用されたタイムスタンプ
**D.**
削除/取り消しボタン
グループが削除されると、その名前は取り消し線で表示され、削除ボタンはそれを取り消してグループをポリシーに再度リンクするボタンに置き換えられます。 そのグループに属するエージェントも消されて表示されます。
{{ :wiki:pt25.png?450 }}
もちろん、削除するポリシーグループの追加は、これが適用されるまで有効になりません。
=== モジュール ===
モジュールメニューでは、ポリシーに追加するモジュールの設定ができます。
{{ :wiki:pt26.png?800 }}
モジュールを追加するには、メニューからモジュールの種類を選択します。6つのモジュール (データサーバ、ネットワーク、プラグイン、WMI、予測および、ウェブ) から 1つを選択し、作成(Create) ボタンをクリックします。
{{ :wiki:pt27.png?800 }}
これは、エージェント内でモジュールを作成するのと同じ手順です。
== データサーバモジュールの作成 ==
データサーバモジュールは、ソフトウエアエージェントへ追加するモジュールです。このモジュールが動作するようにするためには、エージェントでリモート設定が有効になっている必要があります。
データサーバモジュールを作成するには、"データサーバモジュールの新規作成(Create a new data server module)" を選択し、作成(Create) ボタンをクリックします。
{{ :wiki:windows8.jpg?800 |windows8.jpg}}
すると、モジュールの全フィールドを設定できる新たな画面が表示されます。
{{ :wiki:windows9.jpg?800 |windows9.jpg}}
拡張オプション(Advanced Options) をクリックし、拡張オプションにアクセスします。
{{ :wiki:windows10.jpg?800 |windows10.jpg}}
これらの機能の説明は、[[:ja:documentation:pandorafms:management_and_operation:03_templates_and_components|**テンプレートとコンポーネント**]] を参照してください。 フィールドを入力するか、ローカルであらかじめ定義したものを使うか、2つのオプションがあります。[[:ja:documentation:pandorafms:management_and_operation:03_templates_and_components#local_components|ローカルコンポーネント]] を参照してください。
== ネットワークサーバモジュールの作成 ==
ネットワークサーバモジュールを作成するには、'ネットワークサーバモジュールの新規作成(Create a new Network Server Module)' を選択し、"作成(Create)" をクリックします。
{{ :wiki:grafic1.jpg |grafic1.jpg}}
すると、モジュールの全フィールドを設定できる新たな画面が表示されます。
{{ :wiki:grafic2.jpg?800 |grafic2.jpg}}
拡張オプション(Advanced Options) をクリックし、拡張オプションにアクセスします。
{{ :wiki:grafic3.jpg?800 |grafic3.jpg}}
この画面のフィールドの説明は、テンプレートとコンポーネントの章に記載しています。
フィールドの入力を完了したら、"作成(Create)" をクリックします。
ほとんどの場合モジュールは繰り返し使われるため、毎回フィールドを入力して追加するより、事前にコンポーネントを定義してそれを使う方が良いです。
コンポーネントを使うには、"モジュールコンポーネント(Using module component)" からコンポーネントグループを選択します。
{{ :wiki:grafic4.jpg?800 |grafic4.jpg}}
グループを選択すると、利用したいコンポーネントを選択できるようになります。
{{ :wiki:grafic5.jpg?800 |grafic5.jpg}}
この例では、Cisco Mibs グループの "Catalyst CPU Usage" というコンポーネントを選択しています。
{{ :wiki:grafic6.jpg?800 |grafic6.jpg}}
コンポーネントを選択すると、それを編集することができます。フィールドの入力が完了したら、"作成(Create)" をクリックします。
== プラグインサーバモジュールの作成 ==
プラグインサーバモジュールは、プラグインサーバで管理されるモジュールです。
プラグインサーバモジュールを作成するには、"プラグインサーバモジュールの新規作成(Create a new Plugin Server Module)" を選択して、"作成(Create)" をクリックします。
{{ :wiki:pt32.png?400 }}
モジュールの全フィールドを設定できる新たな画面が表示されます。
{{ :wiki:pt41.png?800 }}
拡張オプション(Advanced Options) をクリックし、拡張オプションにアクセスします。
{{ :wiki:pt42.png?800 }}
フィールドに入力するか、事前に定義した[[:ja:documentation:pandorafms:management_and_operation:03_templates_and_components#ローカルコンポーネント|ローカルコンポーネント]]を選択します。フィールドの詳細に関しては、[[:ja:documentation:pandorafms:management_and_operation:03_templates_and_components|テンプレートとコンポーネント]]を参照してください。
フィールドの入力を完了したら、"作成(Create)" をクリックします。
ほとんどの場合モジュールは繰り返し使われるため、毎回フィールドを入力して追加するより、事前にコンポーネントを定義してそれを使う方が良いです。コンポーネントの利用については、ネットワークモジュールの作成で説明しています。
エージェントの IP アドレスなど、動的パラメータを設定するにはマクロを利用します。存在するマクロの一覧を見るには、**Plugin(?)** でヘルプボタンをクリックします。
{{ :wiki:pt1.png?803 }}
== WMI サーバモジュールの作成 ==
WMI サーバモジュールを作成するには、"WMI サーバモジュールを新規作成する(Create a new WMI Server Module)" をクリックし、"作成(Create)" をクリックします。
{{ :wiki:pt34.png }}
全てのモジュールフィールドを定義します。
{{ :wiki:pt43.png?800 }}
"高度なオプション(Advanced Options)" をクリックすることにより、高度なオプションへアクセスできます。
{{ :wiki:pt44.png?800 }}
フィールドについては、[[:ja:documentation:pandorafms:management_and_operation:03_templates_and_components|**テンプレートとコンポーネント**]] の説明を確認してください。
正しく全フィールドに記入したら、"作成(create)" をクリックします。
モジュールはほとんどの場合繰り返し利用されることに注意してください。 モジュールを追加するたびに常にフィールドに入力する代わりに、オプションとしてモジュールをコンポーネントとして事前に定義し、それを使用するのが良いです。 コンポーネントの使用については、「ネットワークモジュールの作成」というセクションでさらに説明します。 詳細については、[[:ja:documentation:pandorafms:monitoring:03_remote_monitoring#wmi_でのリモート_windows_モニタリング|WMI を介した Windows リモート監視]] を参照してください。
== ウェブサーバモジュールの作成 ==
ウェブサーバモジュールを作成するには、"ウェブサーバモジュールの新規作成(Create a new Web Server module)" を選択し、//作成(Create)// をクリックします。
{{ :wiki:pt35.png }}
モジュールの全フィールドを設定します。
{{ :wiki:pt45.png?800 }}
"高度なオプション(Advanced Options)" をクリックして、高度なオプションへアクセスします。
{{ :wiki:pt46.png?800 }}
フィールドの説明については、[[:ja:documentation:pandorafms:management_and_operation:03_templates_and_components|**テンプレートとコンポーネント**]] を参照してください。
全てのフィールドを正しく入力したら、"作成(Create)" をクリックします。
ウェブモジュールの場合、コンポーネントはありません。
ウェブモジュールについてのより詳細は、[[:ja:documentation:pandorafms:monitoring:13_user_monitorization|ウェブモニタリング]] を参照してください。
== 作成済モジュールの編集 ==
ポリシーに割り当てられたモジュールは編集することができます。
{{ :wiki:rama1.jpg?400 |rama1.jpg}}
モジュール名をクリックすると、モジュール設定オプションが表示されます。
修正したら、更新(Update) ボタンをクリックします。
{{ :wiki:pt47.png?800 }}
ポリシーモジュールの名前を変更すると、ポリシーが適用されたときの他のフィールドの名前が変更されます。
ポリシーモジュールの名前を変更し、エージェント内に新しい名前のモジュールが存在すると、そのモジュールに適用され、古い名前のモジュールは削除されます。
== 作成済モジュールの削除 ==
ポリシーからモジュールを削除し、エージェントからも削除するには、モジュール名の左側のごみ箱をクリックします。実行するとモジュールの表示は残っていますが、打消し線が引かれ、削除ボタンが取消に置き換わります。
複数のモジュールを削除したい場合は、ごみ箱アイコンの右側のチェックボックスを選択して、"削除(Delete)" をクリックします。
{{ :wiki:pt48.png?400 }}
=== インベントリモジュール ===
{{:wiki:icono-modulo-enterprise.png |Enterprise 版}}システムに存在するインベントリ、間隔、および権限を選択することで、ポリシーにインベントリモジュールを作成することもできます。
{{ :wiki:pt49.png?800 }}
他のポリシーの要素と同じように、インベントリモジュールを削除すると、削除ボタンの代わりに取り消し線と 取り消しアイコンが表示されます。
{{ :wiki:policy_inventory_modules_undo.png?300 }}
リモートインベントリモジュールの追加に関しての詳細は、[[:ja:documentation:pandorafms:management_and_operation:04_inventory#インベントリモジュール|インベントリモジュール]] を参照してください。
=== ポリシーモジュールの状態 ===
ポリシーが適用されることによってモジュールが作成されると、そのモジュールはポリシーアイコンで参照されます。 これらのポリシーモジュールにはいくつかの状態があります。
* リンク済(Linked)
* リンク解除(Unlinked)
* 適用済(Adopted)
* リンク・適用済(Linked adopted)
{{ :wiki:pt57.png?700 }}
== リンク済モジュール ==
これらは、ポリシーで作成されるモジュールです、適用されるとエージェント内にも作成されます。これらは、ポリシーで作成される通常のモジュールです。
{{ :wiki:pt58.png?700 }}
このボタンをクリックして、モジュール設定ページからモジュールをリンクおよびリンク解除できます。
{{ :wiki:pt56.png?800 }}
== リンク解除モジュール ==
リンクされていないモジュールは、ポリシーに属しているが、ポリシーの変更の影響を受けないモジュールです。 特定のポリシーに属するモジュールに対して //個別の例外// を作ることができるため便利です。これにより、ポリシーから特定のエージェントモジュールを "カスタマイズ" することができます。
{{ :wiki:pt59.png?700 }}
ポリシーの変更は、モジュールが再びリンクされたときにのみ適用されます。
== 適用済モジュール ==
このモジュールは、エージェント内の既存のモジュールと同じ名前でポリシー内に作成されたものです。 ポリシーを適用する場合、Pandora FMS は新しいモジュールを作成する代わりに既存のモジュールのデータを使用し、エージェントから管理され続けます。
このタイプのモジュールは、ポリシーで行われた変更の影響を受けません。
{{ :wiki:pt60.png?700 }}
ポリシーを削除しても、適用済モジュールはエージェントから削除されず、ローカル定義を再度使用します。
== リンク・適用済モジュール ==
適用済モジュールをリンクして、ローカルの代わりにポリシーで設定された定義を使用できます。これにより、ポリシーからモジュールを管理するときに、何らかの変更があるとモジュールも変更されます。
{{ :wiki:pt61.png?700 }}
ポリシーを削除すると、リンク・適用済モジュールは、ローカルの定義利用に戻ります。
ポリシーからエージェントを削除すると、リンク済モジュールは削除され、リンク・適用済モジュールのみが保持されます(ポリシーの前のローカル定義とともに)。
=== アラート ===
アラートメニューでは、ポリシーに追加するアラートの設定ができます。
{{ :wiki:pt50.png?800 }}
== アラートの追加 ==
アラートを追加するには、**アラートテンプレート**を事前に定義したポリシーのモジュールに割り当てて **追加(Add)** をクリックします。
{{ :wiki:alertasnodo2.jpg?700 |alertasnodo2.jpg}}
== アラートの編集 ==
アラートの追加はとても簡単で、若干の設定があるだけであるため、アラートの編集機能はありません。アラートを編集するには、削除してから新たに作成してください。
== アラートの削除 ==
ポリシーからアラートを削除し、設定されたエージェントから削除するには、アラートの行の X をクリックします。これを実行するとアラートは一覧には残りますが、名前が取り消し表示となり、削除ボタンが取り消しボタンに変わります。
{{ :wiki:brocha2.png?500 }}
=== 外部アラート ===
外部アラートは、アラートに似ていますが、アラートをポリシーモジュールのメインリストには無いエージェントモジュールにリンクできる点が異なります。これは、すべてのモジュールではなく、いくつかのエージェントモジュールにアラートを割り当てる場合にとても便利です。
== 外部アラートの追加 ==
新たな外部アラートを作成するには、以下のフィールドを入力する必要があります。
{{ :wiki:alertasmeta1.jpg?800 |alertasmeta1.jpg}}
最初のフィールドは、エージェントのモジュールを選択するためのものです。 ポリシーに含まれていないもののみです。 2 番目のフィールドは、適切なアラートテンプレートを選択するためのものです。 **追加(Add)** をクリックします。
この機能は、メタコンソールとノードの両方にあります。
== 外部アラートの編集 ==
外部アラートの追加はとても簡単で、ごくわずかな設定のみであるため、外部アラートの編集機能はありません。外部アラートを編集したい場合は、一度削除してから新たに作成します。
== 外部アラートの削除 ==
外部アラートをポリシーから削除し、割り当てられたエージェントから削除するには、外部アラートの右にあるごみ箱ボタンをクリックします。
{{ :wiki:pt53.png?500 }}
削除の仕組みは通常のアラートと同じです。 ポリシーが適用されるまで、削除は有効になりません。 その瞬間まで、ポリシーは引き続き表示されますが、取り消し線が引かれ、"削除" ボタンはアクションを元に戻すための "元に戻す" ボタンに置き換えられます。
== 複数のポリシーからの外部アラート ==
バージョン NG 766 以降
1 つまたは複数のモジュールに、さまざまなポリシーからのさまざまなアクションを設定できます。
**例えば**、エージェントモジュール:
* 2 つの個別のポリシーの[[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#ポリシーの追加|作成]]に進み、モジュールエージェントを含めます。
{{ :wiki:pfms-external_alerts-different_policies-01.png }}
* **各ポリシー**で外部アラートの[[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#外部アラートの追加|作成]]に進みます。 選択したエージェントモジュールを追加します。
{{ :wiki:pfms-external_alerts-different_policies-02.png }}
* [[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#ポリシーキュー管理|変更]]を適用します。
* 選択したエージェントのモジュール表示に移動すると、2 つのポリシーの外部アラート (テンプレート、モジュール、およびポリシーごとに 1 つのアラート) を表示できます。
{{ :wiki:pfms-external_alerts-different_policies-03.png }}
**高度な例**として、どのポリシーにも属さないアラートを同じモジュールに追加できます。
{{ :wiki:pfms-external_alerts-different_policies-04.png }}
これにより、モジュールの状態が指定された状態に変わると、3 つの異なるアラートが生成されます (最後の 2 つはポリシーに対応します)。
{{ :wiki:pfms-external_alerts-different_policies-05.png }}
この機能はメタコンソールにもあります。
=== エージェントプラグイン ===
ポリシープラグインを追加するためのプロセスは、エージェントのそれと同じです。//[[:ja:documentation:pandorafms:monitoring:02_operations#e382bde38395e38388e382a6e382a8e382a2e382a8e383bce382b8e382a7e383b3e38388e381a7e381aee38397e383a9e382b0e382a4e383b3e381aee588a9e794a8|ソフトウエアエージェントでのプラグインの利用]]// を参照してください。
エージェントプラグインがポリシーによって適用されるには、プラグインがエージェントによって指定されたパスに存在している必要があります。
プラグインの開発に関する詳細は、//[[:ja:documentation:pandorafms:technical_reference:06_anexo_agent_plugins|エージェントプラグイン開発]]// を参照してください。
{{ :wiki:pt54.png?750 }}
==== ファイルコレクション ====
[[https://pandorafms.com/en/prices/?o=dwpfms|{{:wiki:icono-modulo-enterprise.png?23x23 |Enterprise 版}}]]これらは通常、[[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#ファイルコレクションとソフトウエアエージェント|ソフトウエアエージェント]]、エージェントの[[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#ファイルコレクションと監視ポリシー|監視ポリシー]]、および、[[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#サテライトサーバファイルコレクション|サテライトサーバ]] で、スクリプトまたはプラグインを一括展開するために使用されます。**設定(Configuration)** → **コレクション(Collections)** メニューからアクセスします。
{{ :wiki:pfms-configuration-collection-manage_collection.png }}
新しいファイル コレクションを作成するには、**作成(Create)** ボタンをクリックします。
{{ :wiki:pfms-configuration-collection-create_new_collection.png }}
名前、グループ、短い名前、および説明を入力し、**作成(Create)** をクリックします。
リソースをコレクションに追加するには、コレクション一覧に戻り、リソースを追加するコレクションの名前をクリックします。
{{ :wiki:pfms-configuration-collection-manage_collection-add_file_directory_text.png }}
上の画像で強調表示されている 3 つのアイコンでは、左から右に、ディレクトリの作成、テキストの作成 (後で編集可能)、または新しいファイルの保存を行うことができます。
リソースが追加されたら、コレクションのリストと黄色の三角形のアイコンに戻ります。ここをクリックすると、変更を Pandora FMS のさまざまな要素 (エージェント、ソフトウェアエージェント、監視ポリシー、サテライトサーバ) と同期できます。
{{ :wiki:pfms-configuration-collection-manage_collection-apply_changes.png }}
各コレクションには独自のベースディレクトリがあります。 Web コンソールでは、これらはディレクトリ ''/pandora_console/attachment/collection'' に ''fc_XXX'' のような名前で保存されます。ここで、XXX はコレクションの数値 ID です。 ファイルコレクションには、サブディレクトリを含めることができます。 ファイルコレクションは、[[:ja:documentation:pandorafms:technical_reference:09_tentacle|Tentacle]] 経由で ZIP (圧縮) ファイルとしてエージェントに転送されます。 ファイルコレクションは、Tentacle 転送モードでのみサポートされます。
=== ファイルコレクションとソフトウエアエージェント ===
**リソース(Resources)** → **エージェント管理(Manage agents)** へ行き、ソフトウエアエージェントの名前をクリックします。**コレクション(Collection)** タブをクリックします。次のような定義済のコレクション一覧が表示されます。
{{ :wiki:pfms-software_agent-collection-01.png }}
ソフトウエアエージェントの [[:ja:documentation:pandorafms:monitoring:02_operations#リモート設定|リモート設定]]が無効化されている場合は、次の警告が表示されます。{{ :wiki:pfms-software_agent-collection-02.png }}
コレクションを追加するには、**追加(Add)** 列の合計アイコンをクリックします:\\
{{ :wiki:pfms-software_agent-collection-03.png }}
**状態(Status)** 列に黄色の警告三角形のアイコンが表示される場合は、コレクションが空であるか、コレクションが同期されていません。 コレクションにファイルまたはディレクトリが含まれている場合は、黄色のアイコンをクリックします。 変更を適用すると、コレクションのステータスが同期の成功を示します。
{{ :wiki:pfms-software_agent-collection-04.png }}
数分後、**設定(Configuration)** → **コレクション(Collections)** に移動し、追加したコレクションの名前をクリックします。 新しく追加されたソフトウェアエージェントがエージェントタブに表示されます。
{{ :wiki:pfms-software_agent-collection-05.png }}
== ソフトウエアエージェントにおけるコレクションの場所 ==
それぞれのファイルコレクションは、短い名前を持っています。この例では、''fc_1383033439'' です。ユーティリティ、スクリプトや、実行ファイルなどを含んだコレクションが以下に置かれることを意味しています。
%ProgramFiles%\pandora_agent\collections\fc_13830334393
コレクションは圧縮された形式でソフトウエアエージェントに送信されるため、ソフトウエアエージェントには、ファイルを解凍するための **unzip.exe** ツールが含まれている必要があることに注意してください。 エージェントバージョン 3.2 以降、このツールは以下にインストールされています。
%ProgramFiles%\pandora_agent\utils
完全な "実際の"パスを指定して、これらのファイルを利用してモジュールが動くようにする必要があることを理解してください。各コレクションファイルは異なる場所に保存され、異なるコレクションファイルが互いに上書きまたは競合するのを防ぎます。
コレクション制御システムは **md5** ハッシュに基づいており、エージェント設定ファイルの管理と同様です。 Pandora FMS ウェブコンソールでコレクションを作成すると、**md5** ハッシュが作成され、ソフトウェアエージェントに送信されます。 この **md5** は、ソフトウェアエージェントではなく、Pandora FMS ウェブコンソール側のコレクションに変更がある場合にのみ更新されます。 したがって、エージェントでローカルに行われたコレクションの変更は、コレクションがウェブコンソールで変更されない限りそのまま残ります。
ウェブコンソール側でコレクションに変更が加えられると、md5 が再計算され、エージェント内の既存の設定と一致しない場合は、コレクションの最後の設定が適用され、以前の設定が上書きされ、コレクションに対してローカルで行った変更は破棄されます。
コレクションに含まれるファイルを使用するモジュールを使用する場合は、その固定識別子を使用して、コレクションを含むディレクトリのみを参照してください。 これは [[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#エージェントプラグイン|プラグインモジュール]] を使用した例です:
{{ :wiki:collection_module_usage_plugin.png }}
=== ファイルコレクションと監視ポリシー ===
個々のエージェントコレクションと同じように機能しますが、コレクションを特定のエージェントに適用する代わりに、ポリシーに適用します。
{{ :wiki:pfms-configuration-manage_policies-collection.png }}
コレクションを管理および同期するには、[[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#ファイルコレクション|こちらを参照してください]]。
=== サテライトサーバファイルコレクション ===
[[https://pandorafms.com/es/precios-de-pandora-fms/?o=dwpfms|{{:wiki:icono-modulo-enterprise.png?nolink&23x23 |Enterprise 版}}]]**サーバ(Servers)** → **サーバ管理(Manage servers)** メニューをクリックし、コレクションが追加されるサテライトサーバのリモート設定アイコンをクリックします。 **コレクション(Collections)** タブをクリックし、使用可能なコレクションの一覧で、**アクション(Actions)** 列の + アイコンをクリックして、それぞれのコレクションを追加します。ごみ箱アイコンをクリックして、追加したコレクションを削除することもできます。
{{ :wiki:pfms-servers-manage_servers-edit_satellite_remote_config-01.png }}
変更を保存すると、数分後に、追加されたコレクションとそれぞれの短い名前で作成された新しいセクションが設定ファイルに表示されます。
{{ :wiki:pfms-servers-manage_servers-edit_satellite_remote_config-02.png }}
[[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#ファイルコレクション|コレクションの管理と同期はこちらの章を参照してください。]]
=== メタコンソールでのファイルコレクション ===
Pandora FMS 729 OUM からは、[:ja:documentation:pandorafms:command_center:01_introduction|メタコンソール]]からコレクションの中央管理ができます。それには、**中央管理(Centralized management)** → **エージェント管理(Agent management)** メニューに移動し、**コレクション(Collections)** タブをクリックします。
{{ :wiki:pfms-configuration-collection-manage_collection-metaconsole.png }}
ウェブコンソールと同じようにコレクションを管理および同期するには、[[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#ファイルコレクション|こちらの章を参照してください。]]
==== メタコンソールからのポリシー管理 ====
{{ :wiki:p_meta_summary.png }}
メタコンソールからポリシーを管理することができます。すべてのノードへ情報を適用する役割を持つ各サーバへ、情報を配布する処理を行います。この情報の配布は、すべてのノードがメタコンソールと同じデータを持つことが重要であるため、複雑です。
=== 設定と中央管理モード ===
メタコンソールには中央管理モードがあります。つまり、ポリシーに関しては管理はメタコンソールから行われ、ノードでは実行しません。メタコンソールでは、一般設定からこのモードを選択します。
{{ :wiki:p_meta_central.png?800 }}
ノードが中央管理モードに設定されていることを確認するには、ライセンス画面に移動して同期します。 そうすれば、すべてのポリシー管理ページは情報のみ、つまり読み取り専用モードで利用できるようになります。 追加される新しいノードは、このモードで自動的に設定されます。
{{ :wiki:p_meta_licence.png?800 }}
ノードが中央管理モードであるかを確認してください。この場合、ポリシー画面に警告メッセージが表示されます。
{{ :wiki:p_node_warninig.png?800 }}
=== メタコンソールにおけるポリシーキュー ===
メタコンソールにおけるポリシーキューは、ノードとは異なります。ノードでは、状態表示画面で適用が完了していないポリシーおよび適用済ポリシーの履歴を見ることができましたが、メタコンソールでは後者が削除されました。**適用されていない、または進行中のポリシーだけが、それが属するノードと共に表示されます。**
ただし、履歴を確認したい場合はノードで見ることができます。リードオンリーになっている中で、唯一これだけがノードで管理できる部分です。
=== データの整合性 ===
ノードとメタコンソールでポリシーのデータは同じでなければいけません。モジュール、アラート、インベントリモジュール、コレクションなどが関連します。メタコンソールからポリシーを適用したときに、これらのすべてのデータはノードにコピーされます。
これは、非常に多様で非常に機密性の高い情報です。データのコピー時にエラーが発生するかもしれません。その場合は、コンソールにエラーが表示され、ノードは前のデータに戻されます。クリーンインストールでは問題は発生しませんが、ノードで手動で作成した以前のポリシー構成を削除し、メタコンソールに渡して後でそれらを同期させることをお勧めします。
[[:ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]