一括操作

Pandora FMS ドキュメント一覧に戻る

Massive operations allow you to carry out actions on agents, modules, users, alerts, policies, SNMP, satellite or plugins in a massive way. The importance of massive operations have grown in large-volume environments. This feature has been designed to make administrators' work easier in situations in which they have to deal with systems that contain a large amount of components.

一括操作では、エージェント・モジュール・ユーザ・アラート・ポリシー・SNMP・サテライト・プラグインに対してまとめて操作をすることができます。一括操作は、大きなシステムで重要です。この機能は、大量のコンポーネントがあるシステムを扱う管理者を手助けするために開発しました。

You may access massive operations by clicking on Configuration > Bulk Operations:

一括操作は、設定(Configuration) > 一括操作(Bulk operations) からアクセスできます。

タイムアウトを設定するには、'php.ini' ファイルを開き、タイムアウトパラメータを正しく設定します。

sudo vi /etc/php5/apache2/php.ini;

 max_execution_time = 0 
 max_input_time = -1

'エージェント一括編集' サブメニューでは、グループとステータスでフィルタリングし、変更するものを指定することができます。

いくつか選択すると、いくつかのパラメータを編集できます。

• Cascade protection: Parameter with which alert overload can be avoided. It is possible to choose an agent or an agent module. In the first case, when the chosen agent is in critical state, the agent will not generate alerts. In the second case, only when the specified module is critical state, the agent will not generate alerts.
• Add secondary groups: To add secondary groups if it do not have them.
• Remove secondary groups: To remove secondary groups if it has them.
• Module definition: Three work modes can be selected.
  • Learning mode: If an XML arrives with new modules, they will be created automatically (by default).
  • Normal mode: If an XML arrives with new modules, they will not be created unless they are already declared in the console.
  • Auto-disable mode: Same as learning mode, but if all modules go into unknown, the agent will be disabled until new information arrives again.

• 関連障害抑制(Cascade protection): アラートの大量発生を回避することができるパラメータ。 エージェントまたはエージェントのモジュールを選択することが可能です。 前者の場合、選択されたエージェントが障害状態にあると、エージェントはアラートを生成しません。 後者の場合、指定されたモジュールが障害状態の場合は、エージェントはアラートを生成しません。
• セカンダリグループ追加(Add secondary groups): セカンダリグループが無い場合に、それを追加します。
• セカンダリグループ削除(Remove secondary groups): セカンダリグループがある場合に、それを削除します。
• モジュール定義(Module definition): 3つの動作モードを選択できます。
  • 学習モード(Learning mode): 新たなモジュールの XML を受信すると、自動的にそれが作成されます。(デフォルト)
  • 通常モード(Normal mode): 新たなモジュールの XML を受信すると、コンソールであらかじめ定義されていない限り作成を行いません。
  • 自動無効化モード(Auto-disable mode): 学習モードと同じですが、全モジュールが不明になるとデータを再度受信するまでエージェントが無効化されます。

一括エージェント削除では、グループでフィルタリングすることができます。

モジュール削除は、次の 2つの方法で編集するモジュールを選択できます。

• モジュール選択: モジュールによる検索を選択した場合は、モジュールタイプ、タグ、モジュールの状態でフィルタリングし、最後のセクションで、フィルタリングされたモジュールを削除するエージェントを選択します。

• エージェント選択: エージェントによる検索を選択すると、エージェントグループ、エージェントの状態、モジュールの状態、およびタグによってフィルタリングできます。 フィルタリングされたら、削除したいモジュールを含むエージェントを選択します。

モジュールを編集する場合、モジュールの選択には 2つの方法があります。

• エージェント選択: エージェントによる検索を選択すると、グループ、モジュールの状態、エージェントの状態、タグ、編集したいモジュールを含むエージェントによってフィルタリングできます。 最後にモジュールを選択します。

• モジュール選択: モジュールによる検索を選択すると、モジュールタイプ、状態、タグ、編集したいモジュールによってフィルタリングできます。最後にモジュールの編集をしたいエージェントを選択します。

実行したら、モジュールのパラメータを調整できるメニューが表示されます。

• Post process: Parameter by which the data received by the module can be converted. It is disabled with the value 0 by default.

• 保存倍率(Post process): モジュールが受信したデータを指定の倍率で保存するパラメータ。 デフォルトでは値 0 で無効になっています。

• FF threshold: FlipFlop (FF) is known as a common phenomenon in monitoring: when a value fluctuates frequently between alternative values (RIGHT/WRONG), which makes it difficult to interpret. When this happens, a “threshold” is usually used so that in order to consider something as having changed status, it has to “stay” more than X intervals in a state without changing. In Pandora FMS terminology this is called: “FF Threshold”.
• FF interval: If the flip-flop threshold is enabled and there is a state change, the module interval will be changed for the next execution.

• 連続抑制回数(FF threshold): 障害と復旧の繰り返しは、監視における一般的な現象として知られています。値が正常・障害の間で頻繁に変動する場合、扱いが難しくなります。 これが発生すると、通常 “しきい値” に従って状態が変化してしまうため、一定回数連続して障害状態になった場合のみ障害としたい場合があります。 これを Pandora FMS の用語では “連続抑制回数(FF threshold)” と呼びます。
• 連続抑制間隔(FF interval): 連続抑制が有効で状態の変化があった場合、次のモジュール実行の間隔が変更されます。

• TCP送信文字列(TCP send): TCP ポートに送信されるパラメータを設定するためのフィールド。 改行の送信には '^M' を利用できます。複数の文字列を送信/応答形式で連続して送信するには、それらを “:” で区切る必要があります。
• TCP受信文字列(TCP receive): TCP 接続監視で受信することを期待するテキスト文字列を設定するためのフィールド。 いくつかのステップで送受信する場合は、各ステップを '|'(パイプ文字)で区切る必要があります。
• WMIクエリ(WMI Query): WMIクエリです。SQL の書式に似ています。
• プラグイン(Plugin): プラグインを選択すると、次のマクロを利用できます。
  • _agent_: アラートを発報したエージェント名。
  • _agentdescription_: モジュールが属するエージェントの説明。
  • _agentstatus_: モジュールが属する現在のエージェントの状態。
  • _address_: モジュールが属するエージェントのアドレス。
  • _module_: モジュール名。
  • _modulegroup_: モジュールグループ名。
  • _moduledescription_: モジュールの説明。
  • _modulestatus_: モジュールの状態。
  • _moduletags_: モジュールに関連付けられたタグ。
  • _id_agent_: エージェント ID。Pandora FMS コンソールの該当ページに直接アクセスする URL を生成するのに便利です。
  • _id_module_: モジュール ID。
  • _policy_: モジュールが属するポリシー名。(適用されている場合)
  • _interval_: モジュールの実行間隔。
  • _target_ip_: モジュールの対象 IP アドレス。
  • _target_port_: モジュールの対象ポート番号。
  • _plugin_parameters_: モジュールのプラグインパラメータ。
  • _email_tag_: モジュールタグに関連付けられたメールアドレス。
• ウェブチェック(Web Checks): この項目は、実行されるウェブチェックを定義します。 これは 1つ以上のステップ、またはシンプルなリクエストで定義されます。 これらのシンプルなリクエストは、ウェブチェックフィールドに特別な形式で記述する必要があります。 チェックはタブページ task_begin で始まり、タブページ task_end で終わります。

モジュールコピーで、1つまたは複数のモジュールを選択し、指定したエージェントにコピーすることができます。 これを行うには、グループ、状態、エージェントごとにフィルタリングします。タグが含まれるモジュールを選択するフィルタを表示することもできます。また、アラートをコピーすることもできます。

下の方で、モジュールとアラートをコピーする対象のエージェントを選択します。グループおよび状態でフィルタリングできます。

Choose a plugin, the agents that have it and the data you wish to change. Given the case that no module is used uding the selected plugin, a dialogue box will appear informing about that; the module list and the Update button will be disabled.

プラグイン、プラグインを含むエージェント、および変更するデータを選択します。 選択したプラグインがモジュールで使用されていない場合は、そのことを通知するダイアログボックスが表示されます。 モジュール一覧と更新(Update)ボタンは無効になります。

To add new profiles, choose the profile from the Profile name list, the group on which to apply permissions and finally the user or users these permissions will be assigned to.

新たなプロファイルを追加するには、プロファイル名一覧からプロファイル、アクセス許可を適用するグループ、最後に、これらのアクセス許可が割り当てられる 1つまたは複数のユーザを選択します。

In order to delete profiles, filter them by profile and group and you will be shown the users that meet those criteria. You may delete them by checking the ones you wish and then clicking on Delete.

プロファイルを削除するには、プロファイルとグループでプロファイルをフィルタリングし、それらの条件を満たすユーザを表示します。必要なものをチェックしてから削除(Delete)をクリックするとそれらを削除できます。

After selecting Edit users in bulk from the drop-down list, you must select at least one user to be modified, several or even all of them by clicking the All button.

ドロップダウンリストから ユーザ一括編集(Edit users in bulk) を選択した後、変更するユーザを少なくとも 1 人、複数、または、すべて(All) ボタンを押してすべて選択する必要があります。

Once you have selected the user(s) to be massively modified, the edit box of elements to be changed will appear.

一括変更するユーザを選択すると、変更する要素の編集ボックスが表示されます。

• By default all fields are marked as No change, so when saving, if an item has this option enabled, it will be skipped.
• The values you choose to change will overwrite those set for the selected users.

• デフォルトでは、すべてのフィールドは 変更なし としてマークされており、保存時にこのオプションが有効になっている項目はスキップされます。
• 変更する値を選択すると、選択したユーザに設定された値が上書きされます。

The modifiable fields of the users in Pandora FMS are the following:

Pandora FMS のユーザ の変更可能なフィールドは次のとおりです。

• Language: Language, you can also select Default for users to use the same language as the Web Console.
• Block size for pagination: the numerical value of the Web Console will appear, by default 20.
• Home screen: Change the default screen the user enters after logging into the Web Console.
• Event filter: Allows defining the default event filter that the user will have when entering the event view. For ACL security reasons, any user may not be assigned the selected filter.
• Autorefresh: Allows you to specify the pages that will be reloaded every certain period of time. By default the No change option is checked but there is a special option called None to delete all pages set by the users. When adding any of the pages both options disappear from the list and when removing all added pages they will reappear.
  Time autorefresh: Time value for Autorefresh.
• Timezone: Field to set the time slot of the Web Console for displaying different elements.
• Status: Allows you to activate or deactivate users.

• 言語(Language): 言語、ユーザが Web コンソールと同じ言語を使用するようにデフォルトを選択することもできます。
• ページ毎の表示件数(Block size for pagination): Web コンソールに表示されるページごとの件数です。デフォルトは 20 です。
• ホーム画面(Home screen): ユーザが Web コンソールにログインした後のデフォルト画面です。
• イベントフィルタ(Event filter): ユーザがイベント画面に入るときのデフォルトのイベントフィルタを定義できます。ACL セキュリティの理由により、選択した全てのユーザに選択したフィルタを適用できるわけではありません。
• 自動更新(Autorefresh): 一定時間ごとにリロードするページを指定できます。 デフォルトでは 変更なし(No change) オプションがチェックされていますが、ユーザが設定したすべてのページを削除する None という特別なオプションがあります。 いずれかのページを追加すると、両方のオプションがリストから消え、追加されたすべてのページを削除すると、再び表示されます。
  自動更新時間(Time autorefresh)は、自動更新(Autorefresh) の時間です。
• タイムゾーン(Timezone): さまざまな要素を表示する Web コンソールのタイムゾーンを設定するフィールド。
• 状態(Status): ユーザを有効化または無効化できます。

select the agent or agents, either by filtering by group. If you select several agents, you have the option of showing all agent modules or only those that match. Once the modules have been selected, in the list Alert template, select an alert template and finally click Add to apply it.

グループでフィルタリングして、1つまたは複数のエージェントを選択します。 複数のエージェントを選択した場合は、すべてのエージェントモジュールを表示するか、一致するものだけを表示するかを選択できます。 モジュールを選択したら、アラートテンプレート 一覧でアラートテンプレートを選択し、最後に追加(Add)をクリックして適用します。

To delete alerts, select the template in Alert template and the group. You may show alerts in modules disabled with Show alerts on disable modules, you may select the soubgroups with Group recursion. Select and finally click Delete.

アラートを削除するには、アラートテンプレートでテンプレートとグループを選択します。 無効化されたモジュールのアラートを表示で無効化されたモジュールのアラートを表示できます。グループ再帰で子グループを選択できます。 選択後、削除(Delete)をクリックします。

To add actions to the alerts, select one or more Agents with templates then select the desired Alert template and next the action to add (Action). The modules will be shown in the list to the right of When selecting agents.

アラートにアクションを追加するには、1つ以上のテンプレートを持つエージェントを選択してから、目的のアラートテンプレートを選択し、次に追加するアクションを選択します。 モジュールは、エージェントを選択するときの右側の一覧に表示されます。

• You may filter agents through a group from the Group drop-down list and also include its subgroups by means of the option Group recursion.
• You may filter modules throught the list When selecting agents:
  • All modules from selected agents (Show all modules).
  • Show only matching modules among selected agents.
  • Show only non-initialized modules or unknown modules (in any of those two statuses).

• グループドロップダウンリストからグループを介してエージェントをフィルタリングし、オプション子グループを含める(Group recursion)を使用してその子グループを含めることもできます。
• エージェントを選択する場合、一覧からモジュールをフィルタリングできます:
  • 選択したエージェントのすべてのモジュール(すべてのモジュールを表示)
  • 選択したエージェント間で一致するモジュールのみを表示
  • 未初期化モジュールまたは不明モジュール(これら2つの状態のいずれか)のみを表示

Finally add the desired action to the modules you have checked and click Create to finish.

最後に、チェックしたモジュールに目的のアクションを追加し、作成(Cretate) をクリックして終了します。

In order to delete alert actions, filter by group in Group. Select agents in Agents with templates, the alert templates that will filter the modules and the actions you intend to delete. Click Delete to finish.

アラートアクションを削除するには、グループでグループでフィルタリングします。テンプレートを使用するエージェントでエージェントを選択します。モジュールをフィルタリングしたアラートテンプレートと、削除するアクションが表示されます。 削除(Delete)をクリックして終了します。

In order to enable or disable alerts, filter by group, select agents, alert template and you will be shown the alerts within the enabled or disabled alert board. You may move those alerts to the desired board.

アラートを有効化・無効化するには、グループでフィルタリングし、エージェント、テンプレートおよび、有効化または無効化するアラートを指定する 2つのカラムで対象を選択します。

In order to assign a stand-by state to an alert, filter by group, select the agents, alert templates and you will be shown the existing alerts. Move them from the board Stand-by alerts to those active in Alerts without stand-by and the other way around.

アラートのスタンバイ状態を変更するには、グループでフィルタリングし、エージェント、アラートテンプレートを選択します。既存のアラートが表示されるので、それらをスタンバイアラートから非スタンバイアラートへ移動させます。その逆も同様です。

アラートを追加するには、対象のポリシー、追加するテンプレート、ポリシーエージェントにマッチする正規表現および、ポリシーのモジュールを入力します。

ポリシーアラートを削除するには、対象のポリシー、削除するテンプレート、ポリシーエージェントにマッチする正規表現および、ポリシーモジュールを入力します。

ポリシーモジュールにタグを追加するには、ターゲットポリシーとそのモジュールを記入し、追加するタグのリストからタグを選択する必要があります。

タグにモジュールを追加するには、ターゲットポリシーとそのタグを入力し、追加するモジュールのリストから選択します。

To add modules from a certain agent to the desired policy or policies, first select the source agent, using filters based on the group and/or module status. Then choose from your module list those you want to copy and then select the policy you wish as backup destination. Click Copy to finish.

ポリシーに特定のエージェントのモジュールを追加するには、まずはソースエージェントをフィルタを使用して検索して選択する必要があります。 次に、モジュールのリストから対象を選択し、追加対象となるポリシーをリストから選択する必要があります。コピー(Copy)をクリックして終了します。

特定のポリシーのモジュールを編集するには、まず、必要なポリシーを選択する必要があります。 モジュールのリストから編集したいものを選択してから、変更したい機能を入力します。

• 連続抑制回数(FF threshold): 障害と復旧の繰り返しは、監視における一般的な現象として知られています。値が正常・障害の間で頻繁に変動する場合、扱いが難しくなります。 これが発生すると、通常 “しきい値” に従って状態が変化してしまうため、一定回数連続して障害状態になった場合のみ障害としたい場合があります。 これを Pandora FMS の用語では “連続抑制回数(FF threshold)” と呼びます。
• 保存倍率(Post process): モジュールが受け取ったデータを指定の倍率で保存することができます。デフォルトは 0 で無効です。
• 連続抑制間隔(FF interval): 連続抑制が有効で状態の変化があった場合、次のモジュール実行の間隔が変更されます。
• TCP送信文字列(TCP send): TCP ポートに送信されるパラメータを設定するためのフィールド。 改行の送信には '^M' を利用できます。複数の文字列を送信/応答形式で連続して送信するには、それらを “:” で区切る必要があります。
• TCP受信文字列(TCP receive): TCP 接続監視で受信することを期待するテキスト文字列を設定するためのフィールド。 いくつかのステップで送受信する場合は、各ステップを '|'(パイプ文字)で区切る必要があります。
• WMIクエリ(WMI Query): WMIクエリです。SQL の書式に似ています。
• プラグイン(Plugin): プラグインを選択すると、次のマクロを利用できます。
  • _agent_: アラートを発報したエージェント名。
  • _agentdescription_: モジュールが属するエージェントの説明。
  • _agentstatus_: モジュールが属する現在のエージェントの状態。
  • _address_: モジュールが属するエージェントのアドレス。
  • _module_: モジュール名。
  • _modulegroup_: モジュールグループ名。
  • _moduledescription_: モジュールの説明。
  • _modulestatus_: モジュールの状態。
  • _moduletags_: モジュールに関連付けられたタグ。
  • _id_agent_: エージェント ID。Pandora FMS コンソールの該当ページに直接アクセスする URL を生成するのに便利です。
  • _id_module_: モジュール ID。
  • _policy_: モジュールが属するポリシー名。(適用されている場合)
  • _interval_: モジュールの実行間隔。
  • _target_ip_: モジュールの対象 IP アドレス。
  • _target_port_: モジュールの対象ポート番号。
  • _plugin_parameters_: モジュールのプラグインパラメータ。
  • _email_tag_: モジュールタグに関連付けられたメールアドレス。
• ウェブチェック(Web Checks): この項目は、実行されるウェブチェックを定義します。 これは 1つ以上のステップ、またはシンプルなリクエストで定義されます。 これらのシンプルなリクエストは、ウェブチェックフィールドに特別な形式で記述する必要があります。 チェックはタブページ task_begin で始まり、タブページ task_end で終わります。

最初に、アラートをテキスト、タイプ、優先度でフィルタする必要があります。

アラートを選択したら、任意のパラメータを変更します。

最初に、アラートをテキスト、タイプ、優先度でフィルタする必要があります。そして、削除したいアラートを選択します。

Critical status and warning status fields of modules generated in agents that have been created through Satellite server can be edited.

サテライトサーバを介して作成されたエージェントで生成されたモジュールの障害状態および警告状態フィールドを編集できます。

一括サービス作成では、同時に複数の要素を追加することにより新しいサービスを作成できます。 これは、同じ優先度レベルを持つ多くの要素で構成される新しいサービスを作成する際に非常に便利なツールです。

• サービス定義: これには、手動でサービスを作成する場合と同じフィールドが含まれます：サービス名、サービスによって作成されたモジュールが保存されるエージェント、モード、障害および警告のしきい値、SLA 計算、アラート割り当てなど…

手動でサービスを作成する場合と異なるフィールドは次の通りです。

• 要素ごとにサービスを作成(Create a service per item): 有効にすると、下部のリストで選択した要素ごとにサービスが作成されます。これは、重要な要素(リンクの可用性 SLA など)に関する SLA 計算を一定に保つのに非常に役立ちます。有効にすると、'サービスヘッダ(Services Header)' という新しいフィールドが表示され、各要素に対して作成されるすべてのサービスに共通のヘッダーテキストを設定できます。

• 要素定義(Item(s) definition): ここで、作成するサービスに追加する要素(エージェント、モジュール、またはその他のサービス)を選択します。 それらを追加するには、追加したい要素を選択し、'選択した要素を追加(Add selected)' をクリックします。

• サービス要素概要(Service items summary): 追加するすべての要素を含むウエイトを選択します。特定の要素に対して特定のウエイトを変更する必要がある場合は、追加した後でサービス内で設定する必要があります。これらのウエイトは、使用するか(手動モード)、使用しないか(スマートモード)に関係なく保存されます

最後に、'サービス作成(Create services)' をクリックします。

This option allows adding several elements at once to the selected service. If it is a service in Manual mode, all elements with the same weight will be added.

このオプションを使用すると、選択したサービスに一度に複数の要素を追加できます。 手動モードのサービスの場合、同じ重みのすべての要素が追加されます。

• Select service to be modified: List where the service to add the elements to must be selected.
• Item type to be added: Type of element to be added to the service. It is possible to select among Agents, Modules and Services. It is possible to select more than one type of element in the same operation.

All selected elements will appear as a summary in the corresponding lists at the end of the page ( “Selected services”, “Selected agents”, “Selected modules” ). After selecting all the necessary items to add to the selected service, click Add elements and they will be added with the weights configured in section Service items summary.

• 変更するサービスの選択(Select service to be modified): 要素を追加するサービスを選択する一覧です。
• 追加するアイテムタイプ(Item type to be added): サービスに追加する要素のタイプです。エージェント、モジュール、サービスから選択することができます。同じ操作で複数のタイプの要素を選択することができます。

選択したすべての要素(“選択したサービス“、”選択したエージェント“、”選択したモジュール”)は、ページの最後にある対応する一覧に概要として表示されます。選択したサービスに追加する必要なすべてのアイテムを選択した後、要素の追加(Add elements)をクリックすると、それらはサービスアイテムの概要で設定した重みで追加されます。

This option allows editing weights from several elements at once to the selected service.

このオプションを使用すると、複数の要素から選択したサービスの重みを一度に編集できます。

After selecting the service that contains the elements to be edited by means of the list Select service to be modified, all the elements that service contains will be loaded in the selection lists at the end of the page. Only elements whose weights are to be edited must be selected and the new values must be edited and configured in the weight fields from section Service items summary. After clicking Update selected service elements, selected element weights will be updated to those configured.

変更するサービスを選択の一覧を使用して編集する要素を含むサービスを選択すると、サービスに含まれるすべての要素がページの最後にある選択リストに読み込まれます。重みを編集する要素のみを選択する必要があり、サービスアイテムの概要の重みフィールドで新しい値を編集および設定する必要があります。 選択したサービス要素の更新(Update selected service elements)をクリックすると、選択した要素の重みが設定したものに更新されます。

This option allows to delete several elements at once from the selected service.

このオプションを使用すると、選択したサービスから複数の要素を一度に削除できます。

After selecting the service that contains the elements you wish to delete from the list Select service to be modified, all elements that service contains will be loaded in the selection lists at the end of the page. Once selected, click Remove selected.

変更するサービス選択から削除したい要素を含むサービスを選択すると、サービスに含まれるすべての要素がページの最後にある選択リストにロードされます。 選択したら、選択を削除(Remove selected)をクリックします。

Pandora FMS システムで作成されたすべてのサービスの一覧が表示されます。いくつかのサービスを選択し、'削除(delete)' をクリックして削除できます。 これにより、削除するサービスによって作成されたモジュールも削除されます。

Pandora FMS ドキュメント一覧に戻る