Difference between pages "Pandora: Documentation en: Data Presentation/Reports" and "Pandora: Documentation ja: Remote Monitoring"

From Pandora FMS Wiki
(Difference between pages)
Jump to: navigation, search
(Alert Report Module)
 
(SNMP インタフェースウィザード)
 
Line 1: Line 1:
[[Pandora:Documentation_en|Go back to Pandora FMS Documentation Index]]
+
[[Pandora:Documentation_ja|Pandora FMS ドキュメント一覧に戻る]]
  
{{WIP}}
+
= リモートモニタリング =
  
== Reports ==
+
== 概要 ==
  
Pandora FMS offers you the possibility of presenting the monitored data sorted out through reports.
+
Pandora FMS ネットワークサーバは、集中的にリモートからテストを実行することができる重要な要素です。データサーバとは逆に、ネットワークサーバは複数のプロセスキューを通してタスクを実行します。ネットワークサーバはまた、他のネットワークサーバと共にバランシング動作をしたり、他のネットワークサーバがダウンした時に、そのサーバと同等の処理を実行する代替えとして動作することができます。Pandora における HA の詳細については、それに関する章を参照してください。
  
Within a report, the information to be presented is organized in '''report elements''. There are many different types of elements, which perform calculations and present the information in very different ways. For example, you may choose a "simple graph" type element that makes individual graphs or an "SLA" type element that shows the degree of compliance of a number of monitors.
+
ネットワークサーバは、それに割り当てられたモジュールのみと動作します。もちろん、ネットワークテストなので、ネットワークサーバはテストをする対象がネットワーク的に通信できないといけません (IPアドレスやポート)。対象システムのポートが開いて無かったりルーティングがない場合は、モニタできません。ファイアーウォールの存在やネットワークのルーティングに関しては、Pandora FMS では何ともできません。これらの理由により発生する問題は、Pandora FMS の特別な設定で解決するわけでもありません。
  
Although they generally have a very similar configuration form, each type of element will be configured independently.
+
ネットワークサーバのほかにも、様々なリモートテストを実行する Pandora FMS サーバサブタイプがあります。 この章では、ネットワークサーバ、リモートプラグインサーバー、および Windows マシンに対してリモートテストを実行するサーバ(WMIサーバ)について説明します。 WEB テストサーバ(WEBサーバまたは Goliat サーバ)としてリモートテストを実行する他のサーバには、それ専用のドキュメントの章があります。
  
You may have as many elements as you want, of the type of your choosing.
+
[[File:Remote-monitoring.jpg|500px|center]]
  
=== Creating a Report ===
+
== 基本的なネットワーク監視 ==
  
In order to add a report, click on ''Reporting > Custom reports''.
+
Pandora FMS のネットワークモジュールは、リモートモニタリングタスクを実行します。リモートで実行するタスクは、次の 3つに分類されます。
  
<center>
+
'''ICMP テスト'''
[[image:report_menu.png]]
 
</center>
 
  
It will show a list containing all the reports. In order to create a report, click on "Create Report".
+
''Ping'' に答えるか (''remote_icmp_proc'') または、ミリ秒での応答があるか (''remote_icmp'') どうかをテストします。両方のテストは、ネットワークモジュールが割り当てられたエージェントに対して、ネットワークサーバで実行されます。
  
<center>
+
'''TCP テスト'''
[[image:pre18.png|800px]]
 
</center>
 
  
There is a form where to enter the name of the report, select the group it belongs to, whether it is private or not and add its description.
+
モジュールで設定された TCP ポートが開いているかをリモートからチェックします。加えて、テキスト文字列を送信し、応答文字列が正しかどうかをチェックすることができます。
  
Once the fields have been filled out, click on "Create".
+
例えば、"GET / HTTP/1.0^M^M" という文字列を送信し、"200 OK" を受信することでウェブサーバが稼働しているかどうかをチェックできます。("^M" は、改行を意味します)
  
<center>
+
''' SNMP テスト'''
[[image:pre19.png|800px]]
 
</center>
 
  
Once done, a blank report will appear, where you may edit it including new elements.
+
SNMP が有効になっていて、インタフェースの状態やネットワークトラフィックなどの状態を取得できるるようになっている場合、リモートから SNMP ポーリングを行うことができます。
 
+
詳細は、Pandora FMS での SNMP の説明を参照ください (以降にあります)。
=== Editing a report ===
 
 
 
In order to edit a report, click on ''Reporting > Custom reports''. It contains a list with all the created reports. In order to edit a report, click on the report's name.
 
  
 
<center>
 
<center>
[[image:pre43.png|700px]]
+
[[Image:Network-data-server-arq.png|center|700px]]
 
</center>
 
</center>
  
=== Deleting a report ===
+
まとめると、ネットワークサーバは、それぞれのエージェントに割り当てられた異なるネットワークテストを実行します。それぞれのエージェントはネットワークサーバに割り当てられ、実行結果は Pandora FMS システムのデータベースに保存されます。
  
In order to delete a report, click on ''Reporting'' > ''Custom reports''. It contains a list where all the reports up to that moment are listed. In order to delete a report, click on the trash icon located at the right side of the report's name.
+
=== ネットワークモニタリングのための一般的なモジュールの設定 ===
 
 
<center>
 
[[image:pre44.png|800px]]
 
</center>
 
  
=== Tabs ===
+
リモートからサービス (FTP、SSH など) をモニタするためには、最初にサービスをモニタするための通信を行うエージェントを作成します。
  
==== Main tab ====
+
{{Tip|エージェントの作成は、対象のマシンのソフトウエアエージェントをインストールする必要はなく、Pandora FMS コンソールで行えばよいです。}}
  
The main tab is the only one available within a new report, since there one defines the report's basic data (name, access group and description). After saving it properly, you may access the rest of the tabs.
+
Pandora FMS コンソールにて、管理メニューの '''リソース(Resources)''' > '''エージェント管理(Manage agents)''' を使います。
  
 
<center>
 
<center>
[[image:Main tab reporting builder.png|800px]]
+
[[image:anvi.jpg|center]]
 
</center>
 
</center>
  
The fields belonging to this particular tab are the following:
+
次の画面で、'''エージェントの作成''' ボタンをクリックします。
 
 
* '''Name:''' Intended to define the name of the form.
 
* '''Group:''' Intended to define the access group displayed within the report.
 
* '''Description:''' Intended for providing more report information to the users (which will be shown within the report's list). It will also be displayed on the report in XML and PDF formats.
 
 
 
==== The 'List Items' tab ====
 
 
 
In this tab, you have a global view of all items the report is made up by. The items contained in the list will be displayed in the same order  as in the report later on. This tab provides the following options:
 
 
 
* Modifying the item (by clicking on the wrench).
 
* Modifying the order with the right side boxes and the drop-down "Sort items".
 
* Modifying the order manually through the green arrows on the left.
 
* Deleting the item by clicking on the red x-shaped icon.
 
 
 
If it is a long report that contains several items, it has a form at the top in order to filter the items by different criteria.
 
  
 
<center>
 
<center>
[[image:List items tab reporting builder.png|800px]]
+
[[image:bibi.jpg|750px|center]]
 
</center>
 
</center>
  
The columns belonging to this particular tab are the following:
+
新しいエージェントの情報を入力して、'''エージェントの作成''' をクリックします。
  
* '''P.:''' The items appear exactly in this column's order within the report.
 
* '''Type:''' The column where the item's type appears.
 
* '''Agent:''' The column that contains the agent's name. It can be empty for item types like SLA, custom graph, import texts from URL, SQL queries, simple graphs and texts.
 
* '''Module:''' The column that contains the name of the module from which data will be obtained in order to generate the report. It may also be empty for item types like detailed agent view, alert report agent, custom graph, event report agent, import text from URL, SLA, SQL queries and text.
 
* '''Period:''' The time period based on which the report is generated.
 
* '''Description:''' The column displaying the description given to the item in order to make the work with it a little easier.
 
* '''Options:''' The column that displays the buttons and icons to edit or to delete it.
 
 
==== Item Editor tab ====
 
 
Item Editor tab is more complex than the others, because there you will be able to create the form items or edit them. The form is dynamically designed, according to the type of item you intend to create. In the editing process, all fields except the type are editable. If you need to change the type, the way to do it is to delete the current one and generate a new one along with the same configuration.
 
 
The common fields for all types are the following:
 
 
* '''Type:''' Drop-down list containing the types of items intended for the report, which determines the appropriate fields to configure this type of item by selecting the type: Agents, Modules, Agent Detailed View, Alert Report Agent, Alert Report Module, Avg. Value, Custom Graph, Event Report Agent, Event Report Module, Import text from URL, MTBF, MTTR, Max. Value, Min. Value, Monitor Report, SLA, SQL query, Serialized Data, Simple Graph, Summary, TTO, TTRT and Text
 
 
* '''Description:''' Text box intended for a description of the report item.
 
 
==== Types of Items ====
 
 
You may add different items to the report, which can be:
 
 
===== Graph Items =====
 
 
====== Simple graph ======
 
It shows the simple graph of a module.
 
 
<center>
 
<center>
[[image:Simple graph - item editor tab - reporting builder.png]]
+
[[image:Raro.jpg|750px|center]]
 
</center>
 
</center>
<br><br>
 
  
This form's fields are:
+
エージェントを作成したあと、上のプルダウンメニューからモジュールを選択します。ここで、「ネットワークサーバモジュールの新規作成」を選択し、'''作成''' ボタンを押します。
* ''Name'': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in the report item.
 
** _agentgroup_ : Agent group selected in the report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : Name of the module selected in report item.
 
** _moduledescription_ : Description of the module selected in report item.
 
* ''Period'': Time interval over which the report will be calculated (from the current point in time).
 
* ''Agent'': Intelligent control to choose the agent for that item.
 
* ''Module'': Drop-down list that is dynamically loaded with the modules of the agent selected in the previous control.
 
* ''Time comparison (overlapped)'': It shows the module graph overlapped in that time range, for example if the graph shows a 1 month span, the overlapped graph over it is the previous month.
 
* ''Label'': Label you can assign to an element. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
 
 
 
 
Example of this type of report:
 
  
 
<center>
 
<center>
[[image:pre39.png]]
+
[[image:Sasa.jpg|650px|center]]
 
</center>
 
</center>
<br><br>
 
  
====== Simple baseline graph ======
+
以下のフォームで、ネットワークコンポーネントモジュールを選択し、右側のドロップダウンメニューで必要なチェックを見つけます。この例では、Host Alive (ping 疎通確認) を選択しています。これはマシンがネットワークに接続されているかどうかを確認するために、ping 応答をチェックします。
 
 
With this type of graph, you may see future estimation values for the selected module.Suppose you select a period of a week and today is Tuesday, this particular graph provides real data from Monday through Tuesday and estimation values for all other days within the selected week.
 
  
 
<center>
 
<center>
[[image:baseline-form.png|800px]]
+
[[image:Alive.jpg|center|800px]]
 
</center>
 
</center>
  
The fields belonging to this particular form are the following:
+
拡張オプションはのちほど説明します。モジュールは、エージェントの IP アドレスを取得しています。変更もできます。モジュールの定義が完了したら、'''作成'''ボタンをクリックしてください。
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in the report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : Name of the module selected in report item.
 
** _moduledescription_ : Description of the agent module selected in report item.
 
* '''Period:''' Time interval on which the report is calculated (from now onwards).
 
* '''Agent:''' Intelligent control for selecting the appropriate agent for this item.
 
* '''Module:''' A drop-down list which is dynamically loaded with the agent's modules selected in the control above.
 
* '''Label''': Label you can assign to an element. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
  
 
+
以下の画面では、エージェントのモジュールが表示されています。既存の Keepalive モジュール(エージェントと共に作成)と、追加した 'Host Alive' モジュールがあります。
Example view of this type of report:
 
  
 
<center>
 
<center>
[[image:baseline-result.png|800px]]
+
[[image:Kiji.jpg|center|800px]]
 
</center>
 
</center>
  
 +
見ての通り、モジュールでワーニングが出ています。ワーニングは、モジュールが追加されたばかりで、まだデータを受信していないということを意味しています。一度データを受信すると、ワーニングは消えます。
  
{{warning|This type of graph has the potential to '''overload''' Pandora FMS if you use too much data to generate future estimations.}}
+
作成したモジュールのデータを見るには、上の方にある参照メニューをクリックします。収集した情報が表示されます。
 
 
====== Custom graph ======
 
 
 
It is a user-defined combined graph. A field is added with a combo to select the graph intended to add.
 
  
 
<center>
 
<center>
[[image:Custom graph - item editor tab - reporting builder.png|800px]]
+
[[image:keso.jpg|center|800px]]
 
</center>
 
</center>
  
The fields within this form are the following:
+
他の種類のネットワークチェックを追加するには、上記と同じ要領で他の種類のモジュールを選択してください。
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : Name of the module selected in report item.
 
** _moduledescription_ : Description of the module selected in report item.
 
* '''Period:''' The time interval on which the report is generated.
 
* '''Custom Graph:''' A deployable list containing the user-defined graphs. In order to create theses graphs, click on ''Administration'' > ''Manage Reports'' > ''Graph Builder''.
 
  
An example view of this type of report:
+
=== ICMP モニタリング ===
  
<center>
+
前述の例は、ICMP モニタリングの例でしたが、重要で正確な情報を提供する、より基本的かつ簡単なチェック手法があります。ICMP チェックには次の 2つの種類があります。
[[image:pre26.png|800px]]
 
</center>
 
  
====== Graphs defined from SQL ======
+
'''icmp_proc''' は、IP アドレスが応答するかどうかの (ping) チェックを行います。
  
This type of report element allows custom graphs to be defined for use in reports. These graphs will be created using SQL code entered by the user. This SQL code should always return a variable called '''"label"''' for the text labels or name of the elements to be displayed and a field called '''"value"''' to store the numerical value to be represented. This is an example of SQL used to create graphs of this type:
+
'''icmp_data''' は、応答遅延のチェックを行います。IP アドレスに対して ICMP 応答にミリ秒単位でどれだけかかったかを確認します。
  
SELECT a.name as `label`, count(st.id_agente_modulo) as `value`
+
=== TCP モニタリング ===
FROM tagent_status st, tagent to
 
WHERE a.id_agent=st.id_agent AND (unix_timestamp(now()) - st.utimestamp) > st.current_interval * 2 group by 1;
 
  
For this example, there is this graph displayed where the number of modules in unknown status per agent is shown. It is quite similar to an SQL query, but it does not use headers, and it just needs the SQL code:
+
TCP チェックは、ポートの状態や TCP サービスの状態を確認することができます。
  
<center>
+
このタイプのモジュールの主なパラメータは対象のポート番号、IP、TCP での送受信データです。
[[image:Sql_graph_pie.png]]
 
</center>
 
<br><br>
 
  
 +
TCP のチェックは、デフォルトでは単純にポートが開いているかどうかを確認します。オプションで、TCP 送信文字列および、TCP 受信文字列フィールドを使って、テキスト文字列の送信と、それの応答確認を行うことができます。
  
These are some examples of each of the three types of graphs that can be drawn with this tool: pie graphs, vertical bar graphs and horizontal bar graphs. In this example, several UTF (western latin, Japanese and Arabic) alphabet sets are used simply to show the multi-language capabilities of Pandora FMS.
+
通信が正常に行われているかをチェックするために、テキスト文字列を送り ("^M" は、改行を表します) その応答を確認することができます。これにより簡単なプロトコルチェックが可能です。例えば、ウェブサーバに次の文字列を送信し、
  
{{warning|Due to security restrictions, there are some blocked words that cannot be used : *, DELETE, DROP, ALTER, MODIFY, password, pass, INSERT or UPDATE.}}
+
  GET / HTTP/1.0^M^M
  
{{tip|This type of items must be handled with care, since they can overload Pandora FMS.}}
+
次の応答を確認するとで、正常かどうかの確認ができます。
  
====== SQL pie graph ======
+
200 OK
  
Example of pie graph for reports based on SQL query.
+
これらは、TCP 送信文字列および、TCP 受信文字列フィールドに定義します。
<center>
 
[[image:Report_piegraph.png]]
 
</center>
 
<br><br>
 
  
====== SQL Vertical bar graph ======
+
'''TCP 送信文字列'''
  
Example of vertical bar graph for reports based on SQL query.
+
TCP ポートに送信するパラメータを設定します。^M は、改行コードの送信を意味します。複数の送信・応答文字列を定義するには、"|" で区切ってください。
  
 +
'''TCP 受信文字列'''
  
<center>
+
TCP 接続で受信する応答文字列を設定します。複数の送信・応答文字列を定義する場合は、それぞれを "|" 文字で区切ってください。
[[image:Report_vgraph.png|800px]]
 
</center>
 
<br><br>
 
  
====== SQL horizontal bar graph ======
+
Pandora FMS の TCP チェックでできるのは、ポートが開いているかどうかや応答があるかどうかだけではありません。複数ステップで、データを送信し、それの応答文字列を見ることができます。すべての手順が正しい場合に、正常と判断させることができます。
  
Example of horizontal bar graph for reports based on SQL query.
+
複数ステップで Pandora FMS の応答チェックの仕組を利用するには、各ステップの文字列を | で区切ります。
  
 +
SMTP 接続の例を以下に示します。
  
<center>
+
R: 220 mail.supersmtp.com Blah blah blah
[[image:Report_hgraph.png|800px]]
+
S: HELO myhostname.com
</center>
+
R: 250 myhostname.com
<br>
+
S: MAIL FROM:
 +
R: 250 OK
 +
S: RCPT TO:
 +
R: 250 OK
 +
S: DATA
 +
R: 354 Start mail input; end with .
 +
S: .......your mail here........
 +
S: .
 +
R: 250 OK
 +
S: QUIT
 +
R: 221 mail.supersmtp.com Service closing blah blah blah
  
====== Availability graph ======
+
これをチェックしたい場合、各フィールドに次のように定義します。
  
The availability report shows in detail the reached status of a module in a given time interval.
+
''TCP 送信文字列''
  
It will indicate all the relevant information about the time that this module has been available.
+
HELO myhostname.com^M|MAIL FROM: ^M| RCPT TO: ^M
  
The time range you want the report about can be chosen (for example, the last month) and the ''working time'' if for example you need to indicate that you are only interested in the state of your module in a certain schedule (for example, 8x5, from 8:00 to 16:00 from Monday to Friday).
+
''TCP 受信文字列''
  
It is also possible to determine a prioritization mode. When choosing the OK prioritization mode, if data in the SLA compliance range overlap in time and some other state (such as a planned stop), it will paint that stretch green. If the unknown prioritization mode option is chosen, the color corresponding to the other state will always be displayed.
+
250|250|250
  
[[File:availability_builder.png]]
+
最初の 3つのステップが OK (コード 250) であれば、SMTP は正常です。メールを実際に送信する必要はありません (必要であればそのような設定も可能です)。これにより、プレーンテキストを用いたプロトコルに対する TCP チェックが実現できます。
  
 +
=== リモート実行モジュール ===
  
After saving the report element data, add the desired modules at the bottom:
+
バージョン 741 以降、以下の <b>Enterprise</b> ネットワークサーバモジュールがあります。
  
[[File:availability_builder_item.png]]
+
* Remote execution data
 +
* Remote execution data proc
 +
* Remote execution data string
 +
* Remote execution data inc
  
<b>Note:</b> You can use the SLA min. and max. (value) to indicate that the calculations are made in relation to the values reached by the module in that range. SLA limit % will indicate the acceptable minimum (within that range).
+
これらのモジュールを正常に使用するには、監視するエージェントの接続認証データが必要です。それには、[https://pandorafms.com/docs/index.php?title=Pandora:Documentation_ja:Managing_and_Administration#.E8.AA.8D.E8.A8.BC.E6.83.85.E5.A0.B1.E3.82.B9.E3.83.88.E3.82.A2|<b>認証ストア</b>] に接続データを登録します。
  
If you do not specify a minimum or maximum for the value, the values of thresholds defined in the module (dynamic limits) will be used by default.
+
<center>
 +
[[image:remotexec9.PNG|center]]
 +
</center>
  
 +
認証情報を登録したら、モジュールの定義に利用します。
  
Viewing the report, you will see the availability graph of the chosen module in the selected time range:
+
新たなネットワークサーバモジュールを作成します。
  
 +
<b>モジュールタイプ</b>からオプションを一つ選択します。
  
[[File:availability_graph.png]]
+
<center>
 
+
[[image:remotexec2.png|center]]
'''Failover mode'''
+
</center>
 
 
This feature is used to assign failover or backup modules to the main module on which the calculation of availability must be made. That is to say, if a module has one or several failover modules assigned, the calculation of availability for a determined period will be done considering these modules.
 
 
 
When the measured main module falls, if there are one or several operative backup modules, these will be taken into account for the SLA calculation. That way it shows only the real service failure where primary and backups do not work.
 
<br>
 
<br>
 
<br>
 
'''How to add failover or backup modules:'''
 
 
 
It is done in the edition of the module on which the calculation of availability must be made, in the '''Module relations''' section:
 
 
 
[[File:Failover1.png]]
 
 
 
Select the module that will work as failover and select the type of relation that in this case is failover type.
 
 
 
Once the modules are assigned in the report, activate the option "failover mode":
 
 
 
[[File:Failover2.png]]
 
 
 
There are two types of visual representation:
 
 
 
* Normal: It will show the graph of the main module, as well as all its failover or backup modules and the graph result.
 
 
 
[[File:Failover3.png]]
 
 
 
* Simple: It will only show a graph that will be the result of the availability calculation of these modules.
 
 
 
[[File:Failover4.png]]
 
  
In the '''simple''' type "availability graph" reports, add the possibility of adding a failover module directly to the report as a simulation, this will work exactly the same as the previous ones.
+
リモート実行の場合、次のタイプのデータが有効です。
  
{{Warning|This is not applicable in the wizard or in the template reports.}}
+
* remote_execution_data: 数値
 +
* remote_execution proc: 二値 (0 <b>障害</b>, 0 以外 <b>正常</b>)
 +
* remote_execution_data_string: 文字列
 +
* remote_execution_data_inc: 増分データ(比)
  
[[File:Failover5.png]]
+
以下を定義します。
  
====== Module Histogram graph ======
+
# 接続に利用する認証
 +
# オプションで対象の IP (設定しないとエージェントのそれが利用されます)
 +
# オプションで対象の OS (設定しないとエージェントのそれが利用されます)
 +
# オプションで接続ポート番号 (Linux であれば 22、Windows であれば何でも)
 +
# 監視プロセスを実行するためのコマンド
  
It will show a graph with the status histogram of the chosen module.
+
例:
  
Example of module definition:
 
 
[[File:histogram_build.png]]
 
 
Display example:
 
 
[[File:histogram_sample.png]]
 
 
<br>
 
<br>
  
===== Items ITIL =====
 
 
====== TTRT ======
 
It is the total time in inoperative state (the sum of time that the monitor has not been OK).
 
 
<center>
 
<center>
[[image: TTRT - item editor tab - reporting builder.png]]
+
[[image:remotexec8.png|center]]
 
</center>
 
</center>
<br>
 
 
The fields of this form are:
 
* Name: The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : Name of the module selected in report item.
 
** _moduledescription_ : Description of the module selected in report item.
 
* Period: The time period selected backwards in the temporal point where the report is generated.
 
* Agent: Agent the module is chosen from.
 
* Module: Drop-down list that is dynamically loaded with the modules of the agent selected in the previous control.
 
* Label: Label that can be assigned to an element. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
 
Display example:
 
 
[[image:ttrt_res.png]]
 
  
 
<br>
 
<br>
  
====== TTO ======
 
It is the sum of all the times where the monitor has been OK.
 
 
<center>
 
<center>
[[image: TTO - item editor tab - reporting builder.png]]
+
[[image:remotexec3.png|center]]
 
</center>
 
</center>
<br><br>
 
  
The fields of this form are:
+
<br>
* Name: The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : Name of the module selected in report item.
 
** _moduledescription_ : Description of the module selected in report item.
 
* Period: Time period that it will take backwards in the temporal point where the report is generated.
 
* Agent: Agent the module is chosen from.
 
* Module: Drop-down list that is dynamically loaded with the modules of the agent selected in the previous control.
 
* Label: Label assigned to an element. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
  
 +
システムはリモートマシンに対してコマンドを実行し、一時作業ディレクトリ内のファイル数を受け取ります。
  
View example:
+
<br>
 
 
[[image: tto_sample.png]]
 
  
====== MTBF ======
 
Average time between failures
 
* It is calculated: MTBF= TTO / #F
 
:* Where:
 
::TTO=Total operating time in the period.
 
:: #F= total number of faults.
 
* It provides the average normal operating time between failures.
 
* RELIABILITY indicator.
 
 
<center>
 
<center>
[[image: MTBF - item editor tab - reporting builder.png]]
+
[[image:remotexec4.png|center]]
 
</center>
 
</center>
<br><br>
 
 
The fields of this form are:
 
* Name: The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in report item.
 
** _module_ : Name of the agent module name selected in report item.
 
** _moduledescription_ : Description of the module selected in report item.
 
* Period: The period of time that it will take backwards in the temporal point when the report is generated.
 
* Agent: Agent from which the module is chosen.
 
* Module: Drop-down list that is dynamically loaded with the modules of the agent selected in the previous control.
 
* Label: Label you can asign to an element. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
  
 
<br>
 
<br>
  
Display example
+
文字列のタイプを選択して、コマンドの出力を表示することもできます。
 
 
[[image: mtbf_res.png]]
 
 
 
====== MTTR ======
 
It is the average time to restore the function of a piece of equipment, machinery, line or process after a functional failure.
 
* It includes time to analyze and diagnose the error, time to get the spare part, planning time, etc.
 
* It is a measurement of the maintainability of an equipment.
 
* It is the interval of time obtained dividing the total time of the repairs by the total number of failures in a system.
 
<center>
 
[[image: MTTR - item editor tab - reporting builder.png]]
 
</center>
 
<br><br>
 
 
 
The fields of this form are:
 
* Name: The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : Name of the  agent module selected in report item.
 
** _moduledescription_ : Description of the agent module selected in report item.
 
* Period: The period of time that it will take backwards in the temporal point where the report is generated.
 
* Agent: Agent from which the module is chosen.
 
* Module: Drop-down list that is dynamically loaded with the modules of the agent selected in the previous control.
 
* Label: Label assigned to an element. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
  
 +
モジュール設定:
  
 
<br>
 
<br>
 
Display example
 
 
[[image: mttr_res.png]]
 
 
===== SLA items=====
 
 
All SLA reports show information about the fulfillment of a metric, that is, they indicate the percentage of time that the module has had a known valid value.
 
 
All SLAs understand as valid the <b> unknown </b> periods, since Pandora cannot guarantee the module status if it does not have module data. Also, all periods in <b> planned stop </b> are considered valid (since in a planned stop situation, it is assumed that the module situation is controlled and accepted) and periods in <b> warning status </b> (the ''service'' is still provided in a non-optimal state).
 
 
As it will be seen later, some of the SLA reports present data grouped by time periods and the general status of these periods is calculated. When dealing with long periods, the module the report is being made on may have gone through many states: unknown, planned stop... In these reports, there is a configuration parameter called <b>prioritization mode </b> that determines which states have preference when summarizing. There are two options:
 
 
* '''OK prioritization mode''': The SLA compliance value prevails over the report non-run time, planned shutdowns, unknown time, and not started time.
 
 
* '''Unknown prioritization mode''': Any value other than OK will prevail. That way, you will see the non-operation times of the report, planned stops, unknown time and not started even if there is some data that makes the SLA comply.
 
 
Of course, if at any time the SLA compliance value is not reached, it will be painted red in any of the modes.
 
 
====== SLA ======
 
 
It allows you to measure the Service Level Agreement of any Pandora FMS monitor.
 
  
 
<center>
 
<center>
[[image: S.L.A. - item editor tab - reporting builder.png|800px]]
+
[[image:remotexec5.png|center]]
 
</center>
 
</center>
  
The fields belonging to this particular form are the following:
+
<br>
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : Name of the agent module selected in report item.
 
** _moduledescription_ : Description of the agent module selected in report item.
 
* '''Period:''' The time frame on which the report is generated (from the present time).
 
* '''Working time''': The time frame during which the SLA will be working. The graph will be fully shown, but it will only be calculated with the data within said working time frame. The SLA will be unknown (N/A) if the interval to be shown is excluded from the work interval.
 
* '''Show graph, table or both''': Select whether a SLA graph, a status summary or both elements will be shown.
 
* '''Order''': Order SLA items according to the chosen criteria.
 
  
Once these options have been selected, add each of the target modules based on which the SLA must be calculated:
+
対象となるエージェントの運用システムを継承するように、<b>対象 OS</b>パラメータを設定することができます。
  
<center>
+
結果:
[[image:availability_builder_item.png]]
 
</center>
 
* '''Agent:''' A combo box intended to select the agent to use in the SLA.
 
* '''Module:''' A combo box intended to select the module to use in the SLA.
 
* '''SLA min (value):''' A field intended to determine the SLA's minimum value. The minimum values will trigger the SLA. This field can be empty to use the acceptable minimum module normal values.
 
* '''SLA max (value):''' An optional field intended to determine the SLA's maximum value. The maximum values will also trigger the SLA. It can be empty to use the acceptable maximum module normal values.
 
* '''SLA Limit (%):''' A field intended to set the correct time percentage for the SLA. If the module has been within the minimum and maximum limit values during this particular time percentage, the SLA will be shown as correct and as wrong if not.
 
  
It is also possible to add new modules to the SLA to create combined-module SLAs from the same or different systems.
+
<br>
 
 
 
 
{{Warning|In case of combined SLAs, SLA compliance will depend '''heavily''' on the performance of all the SLAs configured so far.}}
 
 
 
The SLA value will take into account only the <b>critical status of the selected module</b> and they will be labeled as valid.
 
 
 
* Time in unknown.
 
* Time in scheduled downtime
 
* Time in warning status.
 
* Time in OK status.
 
 
 
''Why accept unknowns? ''
 
 
 
Unknown status is reached when Pandora FMS does not receive information from a certain target. In this situation, Pandora FMS cannot guarantee whether the service was provided as usual or not, so in the face of an unknown it is accepted.
 
 
 
 
 
 
 
When taking into account the SLA calculation shown in the report, you may configure scheduled downtimes (past or future) so that it does not take into account possible failures that could possibly take place during that interval of the scheduled downtimes. The value it will take in all the intervals where the scheduled downtimes is enabled is OK, as if during that intervals no incorrect data was received.
 
  
 
<center>
 
<center>
[[image: SLA_2.png]]
+
[[image:remotexec6.png|center]]
 
</center>
 
</center>
  
In this example it can be seen better. In the first image, there is a module data history with two intervals in critical status. Without scheduled downtime the SLA value is 93%.
+
<br>
 
 
<center>
 
[[image: SLA_sinsch.png|600px]]
 
</center>
 
 
 
After seeing that the first module downfall was due to external problems, ta scheduled task that covers that interval is added. When adding the scheduled task, the final estimation will take it as if the module's status was correct all along.
 
  
 
<center>
 
<center>
[[image: SLA_consch.png]]
+
[[image:remotexec7.png|center]]
 
</center>
 
</center>
 
 
<b>Note:</b> If you forgot to create a scheduled downtime, you can create past scheduled downtimes given that''the console administrator has enabled it''.
 
  
 
<br>
 
<br>
  
====== Monthly SLA ======
+
{{Warning|アラートの割り当て、イベントの生成、レポートの表示におけるモジュールの操作は他と同じです。}}
  
This feature is only available for Pandora FMS Enterprise versions. It is a variation of the '''SLA''' feature. Instead of measuring the service level periodically, it does it every day during the months in this period.
+
{{Warning|Pandora FMS バージョン <b>743</b>以降では、<b>pandora_server.conf</b> でリモート実行モジュールパラメータに関連する次のトークンが利用できます。: <b>ssh_launcher</b>、<b>rcmd_timeout</b> および <b>rcmd_timeout_bin</b>}}
  
Examples:
+
=== SNMP モニタリング ===
* In a report of May 5th, it will calculate the SLA of every day in May.
 
* In a report between February 13th and April 4th, it will calculate the SLA of every day in February, March and April.
 
  
Each module on each month will contain the same data of a standard SLA, except that its compliance will not be at month level. It will be the percentage of days that accomplish it. There is also a bar that will display all days of the month by the following color code:
+
==== SNMP モニタリングの概要 ====
  
* '''Green:''' The SLA met.
+
SNMP モニタリングに関して話をする場合、ポーリングとトラップは区別することが重要です。SNMP ポーリングは、Pandora がルータやスイッチ (また、snmp エージェントをインストールしたサーバ) など SNMP デバイスに対して snmpget コマンドを実行することにより実施されます。これは、(指定した秒間ごとに )定期的に実行される処理です。
* '''Red:''' The SLA met.
 
* '''Gray:''' Unknown. There is not enough data on that day.
 
<br>
 
{{tip|Days in unknown will be taken into account as valid data for the percentage of days that meet the SLA.}}
 
  
If there are days that do not meet the SLA, they will be detailed in a summary table.
+
それに対して、SNMP トラップの受信は(変化の発生に基づく)非同期処理です。一般的には、デバイスからの "アラート" を受信するのに使われます。例えば、スイッチのポートダウンや、筐体の温度上昇が発生したような場合が該当します。
  
<center>
+
ポーリングによる SNMP 監視は、Pandora FMS における通常のネットワークモジュールで実行されます。
[[image: S.L.A. Monthly - view.png|600px]]
 
</center>
 
  
====== Weekly SLA ======
+
SNMP トラップの利用は全く異なります。Pandora FMS における SNMP コンソール以外の設定は何も必要なく、デバイスからのトラップを受信することができます。SNMP コンソールに受け取ったすべてのトラップが表示されます。アラートは、フィルタリングルールを通して設定できます。
  
It displays the SLA of the modules chosen by weeks along the selected period (current month by default).
+
Pandora FMS は、SNMP に個別の OID を利用します。Pandora FMS での個々の OID は、ネットワークモジュールとして定義することになります。例えば、24ポートの Cisco Catalyst スイッチをモニタする場合、各ポートの状態、入力トラフィック、出力トラフィックで、計 72 個のモジュール (24 x 3) を定義することになります。
  
[[image: sla_weekly.png]]
+
SNMP デバイスを扱うは次に示す項目が必要です。
  
 +
* SNMP プロトコルがどのようなもので、どのように動作するかを知る必要があります。詳細は、IETF から公開されている RFC3411 に示されています。
 +
* リモートデバイスの IP および SNMP コミュニティを知る必要があります。
 +
* ネットワークサーバが SNMP アクセスできるように、デバイスの SNMP 管理を有効にする必要があります。このネットワークサーバは、ネットワークモジュールが定義されるエージェントによって割り当てられる必要があります。 割り当てられたサーバに障害が発生した際に他のネットワークサーバが監視を実行するようにした場合、これらの監視は別の IPアドレスで実行されることに注意してください。
 +
* リモートデバイスのチェックをしたい特定の OID を知る必要があります。(Pandora FMS ウィザードや SNMP OID ブラウザを使うこともできます)
 +
* デバイスが返す値をどのように扱えばよいかを知る必要があります。SNMP デバイスは、それぞれ異なるファーマットでデータを返します。Pandora FMS は、ほとんどすべてのデータを扱うことができます。カウンタデータは、Pandora が remote_snmp_inc として管理する特別重要なものです。それは、数値データとしてではなく、カウンタとして認識されます。多くの SNMP データはカウンタ値になっています。それをモニタするためには、remote_snmp_inc として設定する必要があります。
  
It allows to edit the working time in case you have a custom service schedule (e.g. 8x5)
+
==== SNMP のネットワークモジュールでのモニタリング ====
  
At the bottom, you may add multiple modules to this item.
+
SNMP でのモニタリングを出来るようにするためには、少なくとも対象の IP アドレスと SNMP コミュニティを知らなくてはいけません。モニタ項目の OID を知ることも重要ですが、それぞれの OID が何であるかを snmpwalk によって得ることができます。ただし、これは簡単なタスクではありません。
  
View example:
+
SNMP でのモニタリングを行うためには、まず最初にそれのエージェントを作成する必要があります。すでに存在するエージェントに対しては、前述の方法に従って新たなネットワークモジュールを追加します。
  
[[image: sla_weekly_sample.png]]
+
モジュールを作成したあとは、モジュールの設定にて SNMP のデータの種類を選択します。
 
 
====== Hourly SLA ======
 
 
 
It displays the SLA of the modules chosen by hour along the selected period (current month by default).
 
 
 
[[image: sla_hourly.png]]
 
 
 
 
 
It allows to edit the working time in case you have a custom service schedule (e.g. 8x5)
 
 
 
At the bottom, you may add multiple modules to this item.
 
 
 
View example:
 
 
 
[[image: sla_hourly_sample.png]]
 
 
 
====== Service SLA ======
 
It allows to measure the Service Level Agreement of any service created in Pandora FMS
 
  
 
<center>
 
<center>
[[image: S.L.A_servicios.png|600px]]
+
[[image:Cap5_snmp_1.png|center|600px]]
 
</center>
 
</center>
  
The fields found in this particular form are the following:
+
モニタしたいデータの種類に合った SNMP の定義を選択します。
* Name: The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : Name of the agent module selected in report item.
 
** _moduledescription_ : Description of the module selected in report item.
 
* Period: Time frame based on which the the report will be evaluated from the present time backwards.
 
* Working Time: Time to be taken into account for the SLA calculation (e.g. for working schedules like 8x5).
 
 
 
Since Pandora FMS services come with their own SLA readings, calculations for the report are different according to the standard performance.
 
  
In this case, you may only choose the service whose SLA you wish to receive from those services you have configured in your Pandora FMS console. The SLA validity limit values are recovered automatically from the definition of the service itself.
+
SNMP のデータの種類を選択すると、SNMP の追加フィールドがフォームに現れます。
  
 
<center>
 
<center>
[[image: S.L.A_servicios2.png|600px]]
+
[[image:Cap5_snmp_2.png|center|600px]]
 
</center>
 
</center>
 +
次に、フィールドの設定を行います。
  
You can always set planned downtimes to adjust the compliance levels whenever you need so, so that possible downfalls are not taken into account.
+
'''SNMP コミュニティ'''
  
These scheduled downtimes may be assigned to the modules that make the service whose report you wish to obtain, or its sub-services. In all intervals affected by downtimes, the states that the service could have reached will be overlooked, and that period will not be taken into account for the the final SLA calculation.
+
SNMP コミュニティです。モニタリングに必要なパスワードのようなものです。
  
 +
'''SNMP バージョン'''
  
<center>
+
デバイスの SNMP プロトコルバージョンを設定します。1, 2, 2c および 3 を選択できます。バージョン 3 は通信の暗号化と安全な認証を含んでいます。ただし、設定が複雑で、Pandora FMS ネットワークサーバのポーリングパフォーマンスは低くなります。
[[image: S.L.A_total.png|600px]]
 
</center>
 
  
In this example, you can see an outline of the final calculation of the service, depending on the scheduled downtimes (orange) and the critical states (red) of the modules on which the state of the final service for SLA calculation depends.
+
'''SNMP OID'''
  
Looking at the image, when any of the modules have a downtime that directly affects the final service and this interval is omitted for final calculation.
+
モニタする OID を設定します。数値およびドットで表現されます。システムに対応する MIB がインストールされている場合は、より読みやすい文字列に変換されます。MIB は、OID をより記述的な文字列に変換するのに役立つメーカーのライブラリです。
  
===== Prediction Items =====
+
文字で表した OID は次のような形式になります。
====== Prediction Date ======
+
iso.org.dod.internet.private.transition.products.chassis.card.slotCps.cpsSlotSummary.cpsModuleTable.cpsModuleEntry.cpsModuleModel.3562.3
  
This type of item returns the date when module reaches its interval using a data projection of a module to the future.
+
数値では次のようになります。
  
To do the calculations, the [http://en.wikipedia.org/wiki/Least_squares '''Least Squares Method'''] is used.
+
  1.3.6.1.4.868.2.4.1.2.1.1.1.3.3562.3
  
In order to configure this item, you're required to provide the information shown below.
+
Pandora FMS は、直接利用することが可能ないくつかの OID をデータベースに保持しています。例えば、モジュールを作成したときに、Cisco MIB を選択すると、Cisco の MIB 一覧を表示します。
 
 
To configure this type of item, the following data must be provided:
 
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : Name of the module name selected in report item.
 
** _moduledescription_ : Description of the module that you selected in report item.
 
* '''Period''': The time period that wors as basis for the estimation.
 
* '''Data Range:''' The interval where module data must be to return the date.
 
* '''Label''': Label the element can be assigned. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
 
 
For instance, to check the moment a disk usage value between 60 and 100% for the mounting point /var will be reached, the following definition is used.
 
  
 
<center>
 
<center>
[[image: Projection_graph5.png|750px]]
+
[[image:Cap5_snmp_4.png]]
 
</center>
 
</center>
<br><br>
 
  
 
+
このコンポーネントを選択すると、その中に存在する MIB を選択することができます。
That will generate the following output in this case:
 
  
 
<center>
 
<center>
[[image: Projection_graph3.png]]
+
[[image:Cap5_snmp_5.png|center|600px]]
 
</center>
 
</center>
  
<br>
+
こうすることによって、フィールドに必要な情報を埋めることができます。
  
====== Projection Graph ======
+
エンタープライズ版の Pandora FMS には、ほかのデバイス向けのより多くの MIB パッケージが含まれています。
 +
データを取り込むには、'''作成''' ボタンをクリックします。
  
This type of allows to asses the values a module will take in the future.
+
作成したばかりのモジュールのデータを見るには、 '''参照''' という名前の上部のタブをクリックして、ページの一番下を見ます。そこには、開始してから受け取っているデータが表示されます。これにより、リアルタイムの SNMP グラフを見ることができます。
  
This estimation is based on [http://en.wikipedia.org/wiki/Linear_regression '''Linear Regression'''] and is implemented by means of the [http://en.wikipedia.org/wiki/Least_squares '''Least Squares Method'''].
+
<center>
 +
[[image:SNMP_nueva.png]]
 +
</center><br>
  
Configure the following parameters accurately to get relevant results:
+
==== エージェントからの SNMP モニタリング====
The fields in this form are:
 
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : Module name that you selected in report item.
 
** _moduledescription_ : Description of the agent module selected in report item.
 
* '''Period:''' The time period taken as basis for the estimation.
 
* '''Projection Period:''' The future time period where data will be projected.
 
* '''Label:''' Label you can assign to an element. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
  
<center>
+
Windows のソフトウエアエージェントは SNMP の情報を取得するユーティリティを含んでいます。Unix/Linux では、snmpget が元々存在し、module_exec から呼び出すことができます。
[[image: Projection_graph_periods.png|800px]]
 
</center>
 
  
In the example image, the area name ''period'' represents the evolution of module data during the selected time interval.
+
我々は、Windows エージェントにデフォルトで snmpget.exe (net-snmp プロジェクトの一部で BSD ライセンスです) を組み込み、基本的な MIB および snmpget.exe ユーティリティを呼び出すためのラッパースクリプトを追加しています。
  
On the other hand, ''projection period'' shows the possible evolution of the module along the selected time.
+
これを利用することにより、エージェントから SNMP でエージェントからアクセスできるリモートシステムの情報を取得することができます。これは、"サテライトエージェント" や "プロキシエージェント" と(マニュアルでは)呼んでいます。
  
A definition example, complementary to the previous case is the evolution of the usage of the disk mounted on /var.
+
Windows における実行の書式は次の通りです。
  
<center>
+
module_exec getsnmp.bat <comunidad_SNMP> <ip de destino> <OID>
[[image: Projection_graph6.png|750px]]
 
</center>
 
  
 +
Windows エージェントで実行する SNMP モジュールの例を以下に示します。
  
Obtaining the following results:
+
module_begin
 +
module_name SNMP_if3_in
 +
module_type generic_data_inc
 +
module_exec getsnmp.bat public 192.168.55.1 .1.3.6.1.2.1.2.2.1.10.3
 +
module_end
  
<center>
+
module_begin
[[image: Projection_graphs.png|750px]]
+
module_name SNMP_if3_desc
</center>
+
module_type generic_data_string
 +
module_exec getsnmp.bat public 192.168.55.1 IF-MIB::ifDescr.3
 +
module_end
  
===== Module Items =====
+
module_begin
====== Avg. Value ======
+
module_name SNMP_Sysup
 +
module_type generic_data
 +
module_exec getsnmp.bat public 192.168.55.1 DISMAN-EVENT-MIB::sysUpTimeInstance
 +
module_end
  
It is the average value for a module within a predefined period. This period is calculated when viewing the report. Within the configuration menu, the fields for the Source Agent are added, where the agent and modules are selected. Eventually, the module's average value is shown.
+
Unix エージェントでの同様の実行例です。
  
<center>
+
module_begin
[[image: Avg value - item editor tab - reporting builder.png|800px]]
+
module_name SNMP_if3_in
</center>
+
module_type generic_data_inc
 +
module_exec snmpget -v 1 -c public 192.168.55.1 .1.3.6.1.2.1.2.2.1.10.3
 +
module_end
  
The fields pertaining to this particular form are the following:
+
module_begin
* '''Name''': The following macros can be used:
+
module_name SNMP_Sysup
** _agent_ : Name of the agent selected in report item.
+
module_type generic_data
** _agentdescription_ : Description of the agent selected in report item.
+
module_exec snmpget -v 1 -c public 192.168.55.1 DISMAN-EVENT-MIB::sysUpTimeInstance
** _agentgroup_ : Group of the agent selected in report item.
+
module_end
** _address_ : Address of the agent selected in report item.
 
** _module_ : Name of the agent module selected in report item.
 
** _moduledescription_ : Description of the module selected in report item.
 
* '''Period:''' The time period takes backwards from the time point when the report is generated.
 
* '''Agent:''' The intelligent control to choose the appropriate agent for this item.
 
* '''Module:''' A drop-down list which is dynamically loaded with the agent's modules selected in the previous control.
 
* '''Calculate for custom intervals''': It shows the average data in custom intervals.
 
* '''Table / Graph options''': Show table, graph or both.
 
* '''Label:''' Label that can be assign to an element. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
  
Within the HTML version of the report, an item of this type is generated as seen below.
+
基本的な OID は、数値にも置き換え可能で、常に数字の OID を使うことをお勧めします。ツールが変換できるかどうか分からないためです。多くの場合、MIB は Windows Wdeareba /util/mibs ディレクトリに、Linux であれば、/usr/share/snmp/libs ディレクトリにあります。
  
<center>
+
=== Pandora FMS SNMP MIB ブラウザ ===
[[image:pre24.png|800px]]
 
</center>
 
  
====== Max. Value ======
+
''監視(Monitoring)'' > ''SNMP'' > '''SNMPブラウザ(SNMP Browser)''' メニューから、MIB ブラウザにアクセスすることができます。
  
It is the maximum value of a module within a predefined period. This period is calculated at the moment of the report's viewing.
+
<b>Pandora FMS</b> バージョン <b>744</b> から、新たにポリシーおよびエージェントに追加する操作ができます。この機能は、Pandora FMS Enterprise 版にのみ存在します。
 
<center>
 
[[image: Max. Value - item editor tab - reporting builder.png|800px]]
 
</center>
 
  
The fields of this particular form are the following:
+
最初に理解しなければならないことは、Pandora FMS が MIB ツリーの完全なパスを作っていることです。(スイッチのように)ツリーが大きい場合は、この操作に数分かかることがあります。 1つのサブツリーのみを探索することもできます。これにより、多くの時間を節約できます。
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in report item.
 
** _address_ : Address of the agent that you selected in report item.
 
** _module_ : Name of the agent module selected in report item.
 
** _moduledescription_ : Description of the module selected in report item.
 
* '''Period:''' The time frame taken backwards from the time point when the report is generated.
 
* '''Agent:''' An intelligent control for selecting the appropriate agent for the item.
 
* '''Module:''' A deployable list dynamically loaded with the agent's modules selected in the previous control.
 
* '''Calculate for custom intervals''': It enables the possibility of showing the report in multiple sub-intervals.
 
* '''Time lapse intervals''': Lifespan of each sub-interval.
 
* '''Table | graph | both''': Show data of each value of each sub-interval on a graph or a table or both.
 
* '''Label:''' Label an element can be assigned. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
  
Viewing example:
+
たとえば、Cisco デバイスの enterprise サブ MIB ツリーの情報のみを取得するには、次のような OID を利用します。
  
<center>
+
  .1.3.6.1.4.1.9
[[image:pre29.png|800px]]
 
</center>
 
  
====== Min. Value ======
+
ブラウザを使用して操作します。各ブランチをクリックすることにより値を取得します。システムは情報を問い合わせ、指定された OID 情報(利用可能な場合)を表示します。 デバイスの OID に関する情報がない場合は、これは数値形式でのみ表示されます。OID に関する説明は MIB にあります。[http://en.wikipedia.org/wiki/Management_information_base] 探査したいデバイスの MIB がない場合、Pandora FMS が表示する情報の中から、複雑で時間がかかる "情報の断片" を探す必要があるかもしれません。
  
The minimum value of a module within a predefined period. This period is calculated right when the report is seen.
+
Pandora FMS SNMP ブラウザでは、取得した OID の値と翻訳された OID の値(利用可能な場合)の両方でテキスト文字列を検索できます。既知の特定の文字列を探し、それらの OID を見つける場合に特に役立ちます。複数のエントリが見つかった場合は、1つのエントリから別のものに移動でき、黄色で強調表示されます。
  
 
<center>
 
<center>
[[image: Min. Value - item editor tab - reporting builder.png|800px]]
+
[[file:snmp_browser_module_creator.png]]
 
</center>
 
</center>
  
The fields belonging to this particular form are the following:
+
<b>Enterprise 版</b> バージョン<b>744</b> から、複数の OID を選択し、"エージェントモジュールの作成(Create agent modules)" をクリックすることによりエージェントに追加することができます。
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in the report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : Name of the agent module selected in report item.
 
** _moduledescription_ : Description of the agent module selected in report item.
 
* '''Period:''' Time interval taken based on which the report is calculated (from the present moment).
 
* '''Agent:''' An intelligent control for selecting the appropriate agent for this item.
 
* '''Module:''' Drop-down list which is dynamically loaded by the agent's modules selected in the previous control.
 
* '''Calculate for custom intervals''': It enables the possibility of showing the report in multiple sub-intervals.
 
* '''Time lapse intervals''': Lifespan of each sub-interval.
 
* '''Table | graph | both''': Show the data od each sub-interval on a table, a graph or both.
 
* '''Label:''' Label an element can be assigned. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
 
 
Viewing example:
 
  
 
<center>
 
<center>
[[image:pre30.png|800px]]
+
[[File:SNMP1.png]]
 
</center>
 
</center>
 
====== Monitor Report ======
 
 
It shows the time percentage a module has been correct or incorrect within a predefined period.
 
  
 
<center>
 
<center>
[[image: Monitor report - item editor tab - reporting builder.png|800px]]
+
[[File:SNMP12.png]]
 
</center>
 
</center>
  
The fields pertaining to this particular form are the following:
+
また、複数の OID を選択し、"ポリシーモジュール作成(Create policy modules)" ボタンを使うことにより、ポリシーへ追加することもできます。
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in the report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : Name of the agent module selected in report item.
 
** _moduledescription_ : Description of the agent module selected in report item.
 
* '''Period:''' Time interval taken based on which the report is calculated (from the present moment).
 
* '''Agent:''' An intelligent control for selecting the appropriate agent for this item.
 
* '''Module:''' Drop-down list which is dynamically loaded by the agent's modules selected in the previous control.
 
* '''Calculate for custom intervals''': It enables the possibility of showing the report in multiple sub-intervals.
 
* '''Time lapse intervals''': Lifespan of each sub-interval.
 
* '''Table | graph | both''': Show the data od each sub-interval on a table, a graph or both.
 
* '''Label:''' Label an element can be assigned. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
 
 
Within the HTML version of the report, an item of this type is generated as you can see below.
 
  
 
<center>
 
<center>
[[image:pre32.png|800px]]
+
[[File:SNMP21.png]]
 
</center>
 
</center>
  
====== Serialize Data ======
+
これらの OID のモジュール設定を追加したポリシーをすべて選択します。これらの OID の新たなポリシーを作成したい場合は、"新規ポリシーの作成(Create new policy)" をクリックします。
 
 
It displays an item in table format report from the data stored within the table named 'tagente_datos_stringin' the Pandora FMS Database. For it, the agent should serialize the data separating them with a line-separating character and another which separates the fields. All lines should contain all fields. This type of item is e.g. used for the agent which is designed to extract management data from the [http://en.wikipedia.org/wiki/SAP_AG '''SAP Platform'''].
 
  
 
<center>
 
<center>
[[image: Serialize data - item editor tab - reporting builder.png|800px]]
+
[[File:SNMP3.png]]
 
</center>
 
</center>
  
The fields pertaining to this particular form are the following:
+
名前、グループ、ポリシーの説明のフィールドに入力し、"ポリシーの作成(Create policy)" をクリックします。
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in the report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : Name of the agent module selected in report item.
 
** _moduledescription_ : Description of the agent module selected in report item.
 
* '''Period:''' Time interval taken based on which the report is calculated (from the present moment).
 
* '''Agent:''' An intelligent control for selecting the appropriate agent for this item.
 
* '''Module:''' Drop-down list which is dynamically loaded by the agent's modules selected in the previous control.
 
* '''Serialized Header:''' A text field where the table headers shown in the report are separated by the '|' (pipe) character. There is one for each column created when separating the assembled field.
 
* '''Field Separator:''' A separator intended for different fields within the serialized text chain.
 
* '''Line Separator:''' A separator intended for different lines (made up by different fields) of the serialized text strings.
 
* '''Label:''' Label assigned to an element. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
  
 +
すると、ポリシーに画面に反映されます。
  
 +
この設定をポリシーに適用するには、右側のボックスに追加し、"モジュール追加(Add modules)" をクリックします。
  
The module that generates the following report returns lines with the following contento:
 
 
Some text sample|some value#this is a new row|and another value
 
 
When generating a report from that content, the output is the following:
 
 
<center>
 
<center>
[[image: serialize_sample.png|650px]]
+
[[File:SNMP31.png]]
 
</center>
 
</center>
<br>
 
 
====== Summatory ======
 
 
It displays the '''sum''' of a single module's values within a specific time frame.
 
 
 
<center>
 
<center>
[[image:Sumatory - item editor tab - reporting builder.png|800px]]
+
[[File:SNMP32.png]]
 
</center>
 
</center>
  
The fields of this form are:
+
<b>Pandora FMS Enterprise</b> バージョン <b>744</b> からは、特定の OID を選択する場合は、OID の詳細から "エージェントモジュール作成(Create agent module)" ボタンを使用できます。 このボタンをクリックすると、特定のエージェントを選択できるようになり、選択したすべての SNMP データがそのエージェント内のモジュールの作成にリダイレクトされます。
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in the report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : Name of the agent module selected in report item.
 
** _moduledescription_ : Description of the agent module selected in report item.
 
* '''Period:''' Time interval taken based on which the report is calculated (from the present moment).
 
* '''Agent:''' An intelligent control for selecting the appropriate agent for this item.
 
* '''Module:''' Drop-down list which is dynamically loaded by the agent's modules selected in the previous control.
 
* '''Label:''' Label an element can be assigned. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
 
 
This is a display example:
 
 
 
  
 
<center>
 
<center>
[[image:pre40.png|800px]]
+
[[File:SNMP41.png]]
 
</center>
 
</center>
  
====== Historical Data ======
+
SNMP モジュールエディターから、ネットワークモジュールを作成または編集するときは、"SNMPブラウザ(SNMP Browser)" をクリックして SNMP ブラウザーを起動します。ポップアップウィンドウで開きます。
 
 
This type of element will serve to receive a dump of the stored data of the module indicated in the configuration of the report.
 
  
Configure the following fields:
+
探している OID を選択したら、フィルターアイコンをクリックしてその OID を選択すると、エージェントで使用されるモジュール定義の対応するフィールドに自動的に反映されます。
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in the report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : Name of the agent module selected in report item.
 
** _moduledescription_ : Description of the agent module selected in report item.
 
* '''Period:''' Time interval taken based on which the report is calculated (from the present moment).
 
* '''Agent:''' An intelligent control for selecting the appropriate agent for this item.
 
* '''Module:''' Drop-down list which is dynamically loaded by the agent's modules selected in the previous control.
 
* '''Label:''' Label an element can be assigned. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
  
 
<center>
 
<center>
[[image:historical.png]]
+
[[File: Snmp browser from module creation.jpg]]
 
</center>
 
</center>
  
Example of report display:
+
=== MIB 管理 ===
 +
 
 +
MIB をアップロードし、Pandora FMS で管理することができます。新しい MIB を追加したり MIB を削除したりできます。これらの MIB は、Pandora でのみ利用されます。Pandora では、システムの MIB (/usr/share/snmp/mibs にあるもの) も使えます。Pandora FMS での MIB ファイルの保存先は、{PANDORA_CONSOLE}/attachment/mibs です。
  
 
<center>
 
<center>
[[image:historical_sample.png]]
+
[[file:new_snmp_browser_mibmanager.png|350px]]
 
</center>
 
</center>
  
====== Increment ======
+
Pandora の MIB マネージャは、ポーリングの MIB のみ管理し、SNMP trap の MIB に対しては何もしないことに注意してください。trap に関しては、Enterprise 版の Pandora FMS 専用の別のマネージャがあります。
  
This type of report element is used to show a brief analysis where the value variation of the indicated module is detailed.
+
=== Pandora FMS SNMP ウィザード ===
  
Configure the following fields:
+
エージェント管理画面に、リモートからモジュールを作成するツール、エージェントウィザードがあります。
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in the report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : Name of the agent module selected in report item.
 
** _moduledescription_ : Description of the agent module selected in report item.
 
* '''Period:''' Time interval taken based on which the report is calculated (from the present moment).
 
* '''Agent:''' An intelligent control for selecting the appropriate agent for this item.
 
* '''Module:''' Drop-down list which is dynamically loaded by the agent's modules selected in the previous control.
 
  
 
<center>
 
<center>
[[image:increment.png]]
+
[[file:agent_wizard.png]]
 
</center>
 
</center>
  
Example of report display:
+
==== SNMP ウィザード ====
  
 
<center>
 
<center>
[[image:increment_sample.png]]
+
[[file:agent_wizard_snmp_wizard.png]]
 
</center>
 
</center>
  
===== Grouped Items =====
+
ホストに snmpwalk するために、対象の IP アドレス、コミュニティ、その他オプションパラメータ (SNMP v3 をサポートしています) を設定する必要があります。
====== General ======
 
 
 
Shows values from different modules sorted (ascendingly, descendingly or by agent name) or/and grouped by agent.
 
 
 
We will configure the following fields:
 
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in the report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : Name of the agent module selected in report item.
 
** _moduledescription_ : Description of the agent module selected in report item.
 
* '''Time lapse''': Interval of time on which the report will be calculated (from the current moment).
 
* '''Last value''': Show only the last reading of the chosen modules.
 
* '''Agent''': The intelligent control to choose the agent for this item.
 
* '''Module''': drop-down list that is dynamically loaded with the modules of the agent selected in the previous control.
 
* '''Group by agent''': Group report metrics by agent.
 
* '''Order''': Order in which the metrics will be shown.
 
* '''Show summary''': Display a final summary with the average, maximum and minimum values.
 
* '''Show in the same row''': Show all operations (max, min, avg or sum) in the same row.
 
  
 
<center>
 
<center>
[[image:grouped_general.png]]
+
[[file:snmp_wizard_form.png|750px]]
 
</center>
 
</center>
  
Example of report display:
+
データを受信すると、モジュール作成のフォームが表示されます。
  
 
<center>
 
<center>
[[image:grouped_general_sample.png]]
+
[[file:snmp_wizard_module_creator.png|750px]]
 
</center>
 
</center>
  
====== Group Report ======
+
SNMP ウィザードでは、さまざまな種類の SNMP データからモジュールの作成が可能です。
  
It displays a table containing the below mentioned information of a predefined group:
+
* '''デバイス(Devices)'''
 +
* '''プロセス(Processes)'''
 +
* '''ディスク空き容量(Free space on disk)'''
 +
* '''温度センサ(Temperature sensors)'''
 +
* '''その他 SNMP データ(Other SNMP Data)'''
  
* '''Agents'''
+
モジュールの種類を選択し、左のウインドウから右へ必要なものをもっていきます。終わったら、モジュール作成(Create modules)ボタンをクリックします。
** The total number of agents.
 
** The number of agents holding 'unknown' status.
 
  
* '''Modules'''
+
このウィザードは、以下の 2つの種類のモジュールを作成します。
** The total number of modules.
 
** The number of modules holding 'normal' status.
 
** The number of modules holding 'critical' status.
 
** The number of modules holding 'warning' status.
 
** The number of modules holding 'unknown' status.
 
** The number of modules holding 'not initiated' status.
 
  
* '''Alerts'''
+
* '''固定の OID をもったデータのための SNMP モジュール''' (センサー、メモリデータ、CPUデータなど)
** The number of defined alerts.
+
* '''動的な OID または計算したデータのためのプラグインモジュール''' (プロセス、ディスク空き容量、メモリ使用率など)
** The number of triggered alerts.
 
  
* '''Events'''
+
{{warning|すべてのプラグインモジュールでは、SNMP リモートプラグインを利用します。このプラグインがシステムにインストールされていないと、これらの機能は無効になります。プラグインは、 "snmp_remote.pl" という名前である必要があります。置き場所はどこでも構いません。}}
** The number of this group's events within the last 8 hours.
 
  
<center>
+
SNMP ウィザードがリモートコンポーネントを使って SNMP デバイスからデータを取得できるようにするには、2つの要件を満たす必要があります。
[[image:Group-report-from.png|800px]]
+
  - Pandora FMS にデバイス製造元のプライベートエンタープライズ番号(PEN)を登録する。
</center>
+
  - Pandora FMS でデバイス製造元の SNMP ウィザードコンポーネントを登録して有効にする。
  
The fields belonging to this particular form are the following:
+
スキャンしたデバイスがこれらの要件を満たしている場合、データを取得できた可能性のあるすべてのモジュールが表示され、作成するモジュールと作成しないモジュールを選択できます。
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : NAme od the agent module selected in report item.
 
** _moduledescription_ : Description of the module selected in report item.
 
* '''Group:''' Combo intended to select the group.
 
* '''Recurse''': Analyze recursively the child groups of the choosen group.
 
Report view example:
 
<center>
 
[[image:Group-report-result.png|800px]]
 
</center>
 
  
====== Exception ======
+
これらのモジュールは、それらを生成したウィザードコンポーネントが属するグループに基づいて、ブロックで表示されます。
  
It shows values of several modules that comply with logical operations (higher or equal, lower, OK or Not OK).
+
すべてのブロックは、参照を容易にするために、最初は圧縮されて表示されます。そうすることで、選択範囲やデータを変更するように拡張できます。さらに、モジュールが作成対象としてマークされている各ブロックでは、これを示す情報アイコンが表示されます。
  
 
<center>
 
<center>
[[image:report_last_value_exc.png|750px]]
+
[[image:IMG8_wizard_components.png]]
 
</center>
 
</center>
  
The following fields can be configured:
+
ブロックをデプロイする場合、追加するモジュールと追加しないモジュールを選択できます。また、各モジュールの名前、説明、またはしきい値を個別に変更するオプションも選択できます。
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : NAme od the agent module selected in report item.
 
** _moduledescription_ : Description of the module selected in report item.
 
* '''Time lapse''': Interval of time based on which the report will be calculated (from the present moment).
 
* '''Last value''': Show only the last reading of the chosen modules.
 
* '''Order''': Order in which metrics will be show.
 
* '''Value''': Value considered with the chosen condition.
 
* '''Condition''': Condition under which to filter the report data. "Everything" ignores filtering.
 
* '''Show summary''': Display a final summary with the average, maximum and minimum values.
 
* '''Show in the same row''': Show all operations (max, min, avg or sum) in the same row.
 
 
 
You may add at the bottom as many modules as you need once the report element is saved:
 
 
 
* '''Agent''': Intelligent control to choose the agent for this item.
 
* '''Module''': Drop-down list that is dynamically loaded with the modules of the agent selected in the previous control.
 
 
 
Example of report display:
 
  
 
<center>
 
<center>
[[image:Exception_-_item_editor_tab_-_reporting_builder.png|750px]]
+
[[image:IMG9_wizard_components.png]]
 
</center>
 
</center>
  
====== Agents / Modules ======
+
''モジュールの作成(Create modules)'' をクリックすると、選択したモジュールとその設定の概要一覧が表示されます。この一覧には、エージェントにすでに存在するか、同じ名前で 2つ以上のモジュールがウィザード自体で設定されていることで作成できなかったモジュールが表示されます。
  
It displays a matrix of agents and modules of a specific module group along with its associated states.
+
すべての変更を行ったあと、それらがエージェントに追加される前に、それらのモジュールの作成を確認するか、それをキャンセルしてウィザードの結果を変更し続けるかの最後の選択があります。
  
 
<center>
 
<center>
[[image: Agents-modules_-_item_editor_tab_-_reporting_builder.png‎|800px]]
+
[[image:IMG10_wizard_components.png]]
 
</center>
 
</center>
  
====== SQL queries ======
 
  
This item shows in Pandora FMS DB data reports, a table to keep custom data retrieved directly from the DB.
+
モジュールの作成が確認されると、確認している間に同じモジュールが別の方法で作成された場合にモジュールが重複しないように、作成できるかどうか 1つずつ再評価されます。
  
{{warning|This type of items must be carefully used, since they can overload Pandora FMS.}}
+
プロセスが正常に完了したか、作成できなかったモジュールがあるかどうかが通知されます。
 
 
The fields of this form are:
 
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : NAme od the agent module selected in report item.
 
** _moduledescription_ : Description of the module selected in report item.
 
* '''SQL Query''': Text box where to write the SQL query to retrieve data from Pandora FMS DB.
 
* '''Serialized header''': Text field where to put separated by '''|''' the headers of the table that will be shown in the report, for each column that came out as a result in the SQL query.
 
* '''Custom SQL template''': A drop-down list containing SQL templates of saved queries for easy use. These can be managed through ''Administration'' > ''Manage reports'' in Custom SQL.
 
* '''Query History Database''': Checkbox that when checked will make the edited SQL query also collect data from the historical database.
 
 
 
The queries that will appear in the report can be customized by choosing one of the following options:
 
 
 
* Type in manually the query to perform in the text field.
 
 
 
<b>Note:</b> Due to security restrictions, there are some reserved words that cannot be used:  DELETE, DROP, ALTER, MODIFY, password, pass, INSERT or UPDATE.
 
  
 +
==== SNMP インタフェースウィザード ====
  
 
<center>
 
<center>
[[image: custom_sql_report.png]]
+
[[file:agent_wizard_snmp_interfaces_wizard.png]]
 
</center>
 
</center>
  
 +
エージェントウィザードにおいては、インタフェースのブラウズのための作成された SNMP ウィザードがあります。
  
 +
このウィザードは、SNMP の '''IF-MIB::interfaces''' ブランチをブラウズし、さまざまなインタフェースを複数選択し、複数のモジュールの作成を可能にします。
  
* Or, you may select a query from the list using the ''Custom SQL template'' drop-down:
+
SNMP ウィザードのように、対象の IP やコミュニティなどを選択してから行います。システムは、対象ホストに対して SNMP クエリを実施し、モジュール作成フォームを表示します。
  
 +
これを利用することにより、左側のウインドウから一つもしくは複数のインタフェースを選択することができます。そして、右側には共通の要素 (説明、速度、In/Outトラフィックなど) が表示されます。この画面から複数の要素を選択し、モジュール作成をクリックすることにより、左側の画面で選択したインタフェースのモジュールが作成されます。
 +
 
<center>
 
<center>
[[image: custom_sql_template_report.png]]
+
[[file:agent_wizard_snmp_interfaces_creation.png|700px]]
 
</center>
 
</center>
  
 +
SNMP インターフェイスウィザードが SNMP デバイスからデータを取得するには、1つの要件を満たす必要があります。
  
 +
  - SNMP デバイスは、''IF-MIB'' ブランチのデータを返す。
  
Example of report display:
+
この要件が満たされている場合、監視に追加するモジュールをデバイスのネットワークインターフェイスごとに選択できます。
 
 
[[image:Custom_sql_report_sample.png]]
 
  
 
+
追加可能なモジュールを備えた、デバイスで選択したすべてのインターフェースの概要を示す設定ブロックが表示されます。このブロックで選択されたモジュールとそのしきい値は、ネットワークインターフェイスに行われるデフォルト設定になります。 インターフェイスに一般的な監視を追加しないように、このブロックを無効にすることができます。
 
 
<br>
 
 
 
<b>Note:</b> You may define your own templates in the menu ''Reporting > Custom SQL''.
 
  
 
<center>
 
<center>
[[image:custom_sql_menu.png]]
+
[[image:IMG11_wizard_components.png]]
 
</center>
 
</center>
  
 
+
また、ネットワークインターフェースごとに特定のブロックがあり、監視するインターフェースを選択できます。さらに、前のブロックで一般的な監視が設定されている場合、チェックされたすべてのインターフェイスがそれらの設定を使用します。
In the query list view, you can create your new stored query by pressing the button ''Create custom SQL'':
 
  
 
<center>
 
<center>
[[image:custom_sql_list.png]]
+
[[image:IMG12_wizard_components.png]]
 
</center>
 
</center>
  
Define your query and a name to identiy it and press "Save" for it to appear on the list:
+
各インターフェイスブロックでは、インターフェイスの特定の設定を指定することもできます。つまり、一般的な監視ブロックに含まれていない特定のモジュールを追加したり、特定のケースでそれらの設定を別の設定で上書きしたりできます。
 +
特定のケースごとにモジュールの名前と説明を変更することもできます。特定の設定が有効になるように、インターフェイスブロックを監視対象としてマークする必要があります。
  
 
<center>
 
<center>
[[image:custom_sql_new.png]]
+
[[image:IMG13_wizard_components.png]]
 
</center>
 
</center>
  
====== Top N ======
+
すべてのブロックは、参照を容易にするために、最初は圧縮されて表示されます。選択やデータを変更するために展開できます。 さらに、モジュールが作成対象としてマークされている各ブロックには、それを示す情報アイコンが表示されます。
  
It displays N values sorted out by maximum, minimum or average redarding the selected modules, ordered upward, downward or by name.
+
''モジュールの作成(Create modules)'' をクリックすると、選択したモジュールとその設定の概要一覧が表示されます。この一覧には、エージェントにすでに存在するか、ウィザードで同じ名前のモジュールが 2つ以上構成されているために作成できないモジュールが表示されます。
<center>
 
[[image: report_topn.png|815px]]
 
</center>
 
  
Report view example:
+
すべての変更を行ったのち、それらがエージェントに追加される前に、それらのモジュールの作成を確認するか、それをキャンセルしてウィザードの結果を変更し続けるかを最後に選択します。
  
 
<center>
 
<center>
[[image:report_topn_sample.png]]
+
[[image:IMG14_wizard_components.png]]
 
</center>
 
</center>
  
====== Network interfaces ======
+
モジュールの作成が確認されると、モジュールが 1つずつ再評価され、作成できるかどうかが確認されます。確認時間内に同じモジュールが別の方法で作成された場合にモジュールが重複しないようにします。
  
This type of report element will generate the interface graphs of all those devices that belong to the selected group.
+
プロセスが正常に完了したか、作成できなかったモジュールがあるかどうかが通知されます。
  
<center>
+
=== ネットワークモジュールの共通拡張機能===
[[image:report_net_interfaces.png]]
 
</center>
 
  
 +
以下の画面では、ネットワークモジュールの拡張機能を表示しています。
  
You may indicate:
+
<br>
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : NAme od the agent module selected in report item.
 
** _moduledescription_ : Description of the module selected in report item.
 
* '''Time lapse''': Time range taken backwards over which the report will be made (e.g. one month from the chosen date).
 
* '''Group''': Group where agents with interface traffic modules will be searched.
 
* '''Full resolution graph (TIP)''': Use the TIP real data drawing system instead of the standard motor.
 
 
 
 
 
<b>Note:</b> An agent shall be considered to have interface traffic data when it has modules with the following format:
 
 
 
* Name of interface_ifInOctects
 
* Name of interface_ifOutOctects
 
* Name of interface_ifOperStatus
 
 
 
<b>Note:</b> Input/output octet counters can also be collected from HC counters (hcOctets).
 
 
 
 
 
 
 
Example of report display:
 
 
<center>
 
<center>
[[image:report_net_interfaces_sample.png]]
+
[[image:Cap5_snmp_8.png|center|800px]]
 
</center>
 
</center>
 +
<br>
  
====== Availability ======
+
'''説明(Description)'''
The feature of this type of report has been widely improved, so that now the data it represents are not approximations but an accurate reflection of the module situation throughout the selected period.
+
モジュールの説明です。デフォルトの説明は変更できます。
  
This item shows a table with the availability data of a selected list of agents and modules.
+
'''カスタムID(Custom ID)'''
  
It also offers the possibility of showing a summary including those modules with higher and lower availability as well as an average analysis.
+
エージェントの情報と共にサーバがメッセージを送信する場合に必要なカスタムIDです。また、Pandora FMS と構成データベースなど外部のデータを統合するのに利用できます。
  
<center>
+
'''間隔(Interval)'''
[[image:report_availability.png]]
 
</center>
 
  
 +
モジュールの実行間隔です。エージェントとは異なります。
  
The following fields can be customized:
+
表示される値は、"設定 > 画面設定(Visual Styles)" の "間隔値" の設定に依存します。
  
The fields of this form are:
+
管理者ユーザは、モジュール作成または編集時にカスタム間隔を設定することができます。通常のユーザは、あらかじめ定義された間隔のみです。画面設定(Visual Styles)で定義されていない場合は、デフォルトが表示されます。
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : NAme od the agent module selected in report item.
 
** _moduledescription_ : Description of the module selected in report item.
 
* '''Period''': Time interval based on which the report will be calculated (from the present moment).
 
* '''Working time''': Time period the module should have been working. The graph will be complete, but it will only be calculated based on the working time data. Availability will be unknown (N/A) if the interval to show is out of the working interval.
 
* '''Show address instead of module name.Show the agent's main address.''': It will show the agent's main IP instead of the name.
 
* '''Show summary''': Show a final summary.
 
* '''Orden''': Order the availability items according to the selected criteria.
 
* '''Hide not init agents''': Hide from the view non-initiated agents.
 
  
 +
'''保存倍率(Post process)'''
  
Once these options have been selected, add each of the target modules over which the SLA must be calculated:
+
モジュールの事後処理です。モジュールの値に掛け算や割り算を行うのに便利です。例えば、バイト単位のデータをメガバイトで表示したい場合などです。
  
<center>
+
'''最小値(Min. Value)'''
[[image:report_availability_add_module.png]]
 
</center>
 
  
* '''Agent''': Combo where to indicate the agent to which the report must be applied.
+
モジュールの最小値です。これより小さな数値は、不正とみなして破棄されます。
* '''Module''': In a combo, the module of the previously set agent over which the SLA will be calculated.
 
  
 +
'''最大値(Max. Value)'''
  
 +
モジュールの最大値です。これより大きな数値は、不正とみなして破棄されます。
  
Report view example:
+
'''エクスポートターゲット(Export target)'''
  
<center>
+
モジュールから返される値をエクスポートサーバへ渡すのに便利です。Pandora FMS Enterprise版にのみにあり、エクスポートサーバを事前に設定する必要があります。詳細はエクスポートサーバの説明を参照してください。
[[image: report_availability_sample.png]]
 
</center>
 
  
 +
'''Cron'''                                                                                                                                                                                                                     
 +
                                                                                                                                                     
 +
''Cron 開始(Cron from)'' が設定されているとモジュールの実行間隔は無視され、モジュールは ''Cron 開始(Cron from)'' で指定した日時に実行されます。例えば、次の設定ではモジュールは毎週月曜 6:30 に実行されます。
  
 +
<center>                                                                                                                                                                                                                                 
 +
[[image:cron_from_ex1.png|750px]]                                                                                                                                                                                                       
 +
</center>                                                                                                                                                                                                                               
 +
                                                                                                                                                                                                                                         
 +
''Cron 開始(Cron from)'' と ''Cron 終了(Cron to)'' の両方が設定されていると、モジュールは、''Cron 開始(Cron from)'' と ''Cron 終了(Cron to)'' の間の時間に 一度実行されます。例えば、次の設定では、毎日 6時と 7時の間に実行されます。
 +
                                                                                                                                                                                                                                   
 +
<center>                                                                                                                                                                                                                                 
 +
[[image:cron_from_ex2.png|750px]]                                                                                                                                                                                                       
 +
</center>                                                                                                                                                                                                                               
 +
                                                                                                                                                                                                                                         
 +
ローカルモジュールでは、エージェント設定ファイルに ''module_crontab'' を設定することで対応します。
 +
詳細は、[https://wiki.pandorafms.com/index.php?title=Pandora:Documentation_ja:Operations#.E6.8C.87.E5.AE.9A.E6.99.82.E9.96.93.E3.83.A2.E3.83.8B.E3.82.BF.E3.83.AA.E3.83.B3.E3.82.B0 指定時間モニタリング] を参照してください。
  
It shows the following information:
+
'''カテゴリ(Category)'''
* '''Agente''': Agent.
 
* '''Module''' / '''IP address''': When configuring the item, you may choose whether to see the agent's main IP instead of that of the module. Very useful for reports that contain a list of agents and IPs instead of agents and ping modules.
 
* '''Total time''': Total time to anaylize.
 
* '''Time failed''': Time in critical status.
 
* '''Time OK''': Time in OK or warning status.
 
* '''Time Unknown''': Time in unknown status.
 
* '''Time Not init''': Non-initiated time.
 
* '''Time downtime''': Time in scheduled downtime.
 
* '''%OK''': Correct status time percentage.
 
  
* '''Total checks''': Total checks done during the time lapse configured in the report.
+
この分類は、通常のユーザーインターフェイスには影響を与えません。メタコンソールと共に使用することを意図したものです。
* '''Checks failed''': Number of failed checks (critical).
 
* '''Checks OK''': Number of correct checks.
 
* '''Checks Unknown''': Approximation based on events and Pandora FMS logic that allows to point out the number of checks that <b>should</b> have been carried out, but from which there is no answer.
 
  
===== HTML and Text Items =====
+
== WMI でのリモート Windows モニタリング==
====== Text ======
 
  
This item displays a formatted text within the reports to add e.g. more information of the company to the report.
+
WMI は、Windows OS を実行するコンピュータのリモート情報取得用のマイクロシステムであり、Windows XP 以降のバージョンで利用できます。 WMI を使用すると、OS、アプリケーション、さらにはハードウェアのすべての種類の情報を取得できます。 WMI クエリは、ローカルでの実行(実際には、Pandora のエージェントは内部的にオペレーティングシステムの API を呼び出し WMI サブシステムに問い合わせます)または、リモートで実行することができます。 一部のシステムでは、WMI へのリモートアクセスは有効になっておらず、外部からの利用のためには有効にする必要があります。
  
<center>
+
Pandora FMS は、WMI クエリによって Windows をリモート監視することができます。そのためには、Pandora FMS サーバの設定ファイルにて ''wmiserver'' を有効化する必要があります。
[[image: Text report module - item editor tab - reporting builder.png|800px]]
 
</center>
 
  
The fields of this particular form are the following:
+
# wmiserver : '1' or '0'. Set to '1' to activate the WMI server in this setup.
* '''Name''': The following macros can be used:
+
# DISABLED BY DEFAULT
** _agent_ : Name of the agent selected in report item.
+
  wmiserver 1
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : NAme od the agent module selected in report item.
 
** _moduledescription_ : Description of the module selected in report item.
 
* '''Text:''' A text box intended to format the text and add links and images from a remote server.
 
  
An example of the window where the link is added is shown below.
+
クエリは、オペレーティングシステムへの内部クエリ用の Microsoft 固有の SQL 言語の一種である WQL で行われ、WMI システムデータベースに表示されるクエリはすべて作成できます。
  
<center>
+
WMI を通してモニタリングを開始するには、サービスをモニタするための対応するエージェントを作成し、モジュールタブをクリックします。そこで、新たな WMI モジュールの作成を選択し、'''作成''' ボタンをクリックします。
[[image: Edit link - report builder.png]]
 
</center>
 
 
 
Screenshot example of the window where to add the image:
 
  
 
<center>
 
<center>
[[image: Edit image - report builder.png]]
+
[[image:Feo.jpg|center|400px]]
 
</center>
 
</center>
  
You may add any html content to this element.
+
いくつかのフィールドは WMI 特有のもので、短い表記を使います。
  
Report view example:
+
'''名前空間(Namespace)'''
 
 
<center>
 
[[image:html_text_sample.png]]
 
</center>
 
 
 
<br>
 
<br>
 
  
====== Import text from an URL ======
+
WMI のネームスペースを設定します。いくつかのクエリにおいて、このフィールドが空でなければ (デフォルト)、アプリケーションに依存した情報がモニタされます。
  
This item shows the text retrieved from an external server to which the Pandora FMS Console has access to. In the HTML report format, it will be displayed as it is, but the PDF version of the report will show the text in plain-text format.
+
'''ユーザ名(Username)'''
  
<center>
+
administrator もしくは、リモートから WMI クエリを実行する権限があるユーザ名を設定します。
[[image:Import text from URL - item editor tab - reporting builder.png|800px]]
 
</center>
 
  
The fields belonging to this particular form are the following:
+
'''パスワード(Password)'''
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : NAme od the agent module selected in report item.
 
** _moduledescription_ : Description of the module selected in report item.
 
* '''URL:''' The text field intended to enter the external server address in order to extract the text.
 
  
===== Alert Items =====
+
administrator もしくは指定したユーザのパスワードを設定します。
====== Alert Report Agent ======
 
  
It displays a list containing the alerts triggered by the report group agents within a predefined period.
+
'''WMI クエリ(WMI Query)'''
  
<center>
+
WMI クエリは SQL に似ています。以下に例を示します。
[[image: Alert report agent - item editor tab - reporting builder.png|800px]]
 
</center>
 
  
The fields within this form are the following:
+
SELECT LoadPercentage from Win32_Processor WHERE DeviceID = "CPU0"
* '''Name''': The following macros can be used:
+
SELECT SerialNumber FROM Win32_OperatingSystem
** _agent_ : Name of the agent selected in report item.
+
SELECT AvailableBytes from Win32_PerfRawData_PerfOS_Memory
** _agentdescription_ : Description of the agent selected in report item.
+
SELECT DiskWriteBytesPersec from Win32_PerfRawData_PerfDisk_PhysicalDisk WHERE name = "_Total"
** _agentgroup_ : Group of the agent selected in report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : NAme od the agent module selected in report item.
 
** _moduledescription_ : Description of the module selected in report item.
 
* '''Period:''' The time frame taken backwards based on which the report is generated (e.g. one month from the seleted date).
 
* '''Agent:''' Intelligent control for selecting the appropriate agent for the item.
 
* '''Label:''' Label assigned to an element. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
  
Report example:
+
'''Key 文字列(Key string)'''
  
<center>
+
クエリにより返された文字列を比較するためのオプションです。結果は文字列ではなく、存在すれば 1、そうでなければ 0 で返ります。
[[image:pre23.png|800px]]
 
</center>
 
  
====== Alert report module ======
+
'''フィールド番号(Field number)'''
  
It displays a list containing the module's triggered alerts within a predefined period intended for the report.
+
返されるフィールドの数です。0 から開始する数字です (WMI クエリは、1つ以上のフィールドを返します)。ほとんどの場合は、0 か 1 です。
  
 
<center>
 
<center>
[[image: Alert report module - item editor tab - reporting builder.png|800px]]
+
[[image:Campos.jpg|center|550px]]
 
</center>
 
</center>
  
The fields contained in this particular form are the following:
+
正しいパラメータがわからない場合は、Pandora FMS データベースに設定されインストール済のものを選択することもできます。それには、WMI モジュールコンポーネントを選択してください。
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent selected in report item.
 
** _agentdescription_ : Description of the agent selected in report item.
 
** _agentgroup_ : Group of the agent selected in report item.
 
** _address_ : Address of the agent selected in report item.
 
** _module_ : NAme od the agent module selected in report item.
 
** _moduledescription_ : Description of the module selected in report item.
 
* '''Period:''' The time frame taken backwards based on which the report is generated (e.g. one month from the selected date).
 
* '''Agent:''' Intelligent control to select the appropriate agent for this item.
 
* '''Module:''' A drop-down list which is dynamically loaded by the agent's modules selected in the previous control.
 
* '''Label:''' Label the element can be assigned. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
 
 
====== Alert report group ======
 
Shows a list with the alerts launched in any element of the group defined in the report in the defined period.
 
  
 
<center>
 
<center>
[[image: ReportGroupAlert.png]]
+
[[image:Galleta.jpg|center|450px]]
 
</center>
 
</center>
<br><br>
 
  
We will configure the following fields:
+
その後、可能な WMI チェックを選択します。
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent that you selected in report item.
 
** _agentdescription_ : Description of the agent that you selected in report item.
 
** _agentgroup_ : Agent group name.
 
** _address_ : Address of the agent that you selected in report item.
 
** _module_ : Module name that you selected in report item.
 
** _moduledescription_ : Description of the module that you selected in report item.
 
* '''Time lapse''': the backward time range over which the report will be drawn up (e.g. one month from the chosen date).
 
* '''Group''': Group on which the alert triggering information will be analysed.
 
* '''Recursion''': Analyze the child groups of the recursively defined group.
 
  
 
<center>
 
<center>
[[image: ReportGroupAlertExample.png]]
+
[[image:Galletita.jpg]]
 
</center>
 
</center>
  
===== Event Items =====
+
ユーザ名とパスワード以外の必要な情報が自動的に入力されます。'''アドミニストレータ権限のユーザとパスワードが必要であることを忘れないでください。そうでないとモジュールは値を取得できません。'''
====== The Event Report Agent ======
 
 
 
It displays a list containing the events which occurred within the agents in the predefined time frame.
 
  
 
<center>
 
<center>
[[image:Event report agent - item editor tab - reporting builder.png|800px]]
+
[[image:otro.jpg|center|800px]]
 
</center>
 
</center>
  
The fields pertaining to this particular form are the following:
+
Pandora FMS Enterprise 版には、Windows 用の 400 以上の WMI リモート監視モジュールがあります。これらは、以下のデバイスやコンポーネント用です。
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent that you selected in report item.
 
** _agentdescription_ : Description of the agent that you selected in report item.
 
** _agentgroup_ : Agent group name.
 
** _address_ : Address of the agent that you selected in report item.
 
** _module_ : Module name that you selected in report item.
 
** _moduledescription_ : Description of the module that you selected in report item.
 
* '''Period:''' The time frame it takes to get back to the temporary point within which the report is generated.
 
* '''Agent:''' The intelligent control to select the appropriate agent for this item.
 
* '''Severity, event type, event status''': Selecct the types of events to see.
 
* '''Event graphs''': Show event summary graphs.
 
Within the HTML version of the report, an item of this type is generated as you can see below.
 
* '''Label:''' Label you can asign to an element. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
  
<center>
+
*Active Directory
[[image:pre27.png|800px]]
+
*BIOS
</center>
+
*System Information
 +
*Windows Information
 +
*Printers
 +
*MSTDC
 +
*IIS
 +
*LDAP
 +
*Microsoft Exchange
  
====== The Event Report Module ======
+
== WMI ウィザード ==
  
It displays a list containing the events occurred within an agent's module in the report of a predefined time frame.
+
エージェントウィザード(エージェントの管理画面のタブ)に、WMI ウィザードがあります。指定のエージェントにおいて WMI クエリでモジュールを参照したり作成したりするのに利用します。
  
 
<center>
 
<center>
[[image:Event report module - item editor tab - reporting builder.png|800px]]
+
[[file:agent_wizard_wmi_wizard.png]]
 
</center>
 
</center>
  
The fields pertaining to this particular form are the following:
+
最初の WMI クエリを作成するために、対象ホストの administrator ユーザ(もしくは WMI クエリの実行権限のあるユーザ)とパスワードを指定する必要があります。このデータは、WMI モジュールの作成に利用されます。
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent that you selected in report item.
 
** _agentdescription_ : Description of the agent that you selected in report item.
 
** _agentgroup_ : Agent group name.
 
** _address_ : Address of the agent that you selected in report item.
 
** _module_ : Module name that you selected in report item.
 
** _moduledescription_ : Description of the module that you selected in report item.
 
* '''Period:''' The time frame it takes to get back to the temporary point within which the report is generated.
 
* '''Agent:''' An intelligent control to select the appropriate agent for this item.
 
* '''Module:''' A deployable list that is dynamically loaded with the agent's modules selected in the control above.
 
* '''Severity, event type, event status''': Select the type of events to see.
 
* '''Event graphs''': Show event summary graphs.
 
* '''Label:''' Label you can asign to an element. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
  
 
<center>
 
<center>
[[image:report_module_events_sample.png]]
+
[[file:wmi_wizard_module_creator.png|800px]]
 
</center>
 
</center>
  
====== The Event Report Group ======
+
WMI ウィザードでは、次のようなさまざまな種類の WMI データからモジュールを作成することができます。
  
It displays a list containing the events which occurred in the report group's agents within a predefined time frame.
+
* '''Services''': サービスが稼働中であれば正常、停止していれば障害状態となる、ブーリアンの監視を作成します
 +
* '''Processes''': プロセスが稼動中のときにデータを受け取ります。そうでなければ不明状態になります。
 +
* '''Free space on disk''': ハードディスクの空き容量。
 +
* '''WMI components''': この場合、システムに登録された WMI コンポーネントを選択します。(管理 -> モジュール管理 -> ネットワークコンポーネント)
  
<center>
+
== サーバプラグインを使ったモニタリング==
[[image:Event-report-group-from.png|800px]]
 
</center>
 
  
The fields pertaining to this particular form are the following:
+
このタイプの監視は、Pandora FMS サーバからリモートでプラグインを実行して行います。いくつかのプラグインが利用可能な状態でデフォルトでインストールされています。また、必要なものを追加することもできます。
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent that you selected in report item.
 
** _agentdescription_ : Description of the agent that you selected in report item.
 
** _agentgroup_ : Agent group name.
 
** _address_ : Address of the agent that you selected in report item.
 
** _module_ : Module name that you selected in report item.
 
** _moduledescription_ : Description of the module that you selected in report item.
 
* '''Period:''' The time frame it takes to get back to the temporary point within which the report is generated.
 
* '''Group:''' A combo intended to select the group.
 
* '''Severity, event type, event status''': Select the type of events to see.
 
* '''Event graphs''': Show event summary graphs.
 
Within the HTML version of the report, an item of this type is generated as you can see below.
 
  
<center>
+
リモートプラグインはスクリプトまたは実行形式のファイルで、パラメータに応じて値を返します。プラグインを使用すると、開発したアプリケーションのように、任意のタイプの監視を自分で実装し、いくつかの入力パラメータを使用してカスタマイズすることができます。例えば、監視対象の IP をパラメータとして渡すことができます。結果は数値、ブーリアン値(0:障害、0より大きい:正常)であったり、文字列です。リモートプラグインの唯一の制限は、単一の値のみ返せるということです。
[[image:Event-report-group-result.png|800px]]
 
</center>
 
 
 
===== Inventory Items =====
 
====== Inventory ======
 
  
This item is contained in the Enterprise version of Pandora FMS. It displays the selected inventory of one or various hosts pertaining to a specific date or its last known data.
+
Pandora FMS にプラグインを登録するためには、コンソールの管理メニューへ行き、サーバの管理をクリックします。そして、''プラグイン管理(Manage plugins)'' をクリックします。
  
 
<center>
 
<center>
[[image:Inventory_item_form.png|800px]]
+
[[image:verdecito1.jpg]]
</center>
+
</Center>
  
The fields pertaining to this particular form are the following:
 
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent that you selected in report item.
 
** _agentdescription_ : Description of the agent that you selected in report item.
 
** _agentgroup_ : Agent group name.
 
** _address_ : Address of the agent that you selected in report item.
 
** _module_ : Module name that you selected in report item.
 
** _moduledescription_ : Description of the module that you selected in report item.
 
* '''Description:''' A text field intended for the item's description.
 
* '''Group:''' A combo which filters the agents appearing within the next field. It doesn't appear in the report, it's only a form tool.
 
* '''Agents:''' The agents of the hosts in which the inventory will be gathered. Only the agents which contain inventory modules are going to appear in this field.
 
* '''Modules:''' The common inventory modules of the selected agents.
 
* '''Date:''' The date of the displayed data. If the youngest date is selected here, only the latest inventory data of the selected modules will be gathered.
 
 
<center>
 
<center>
[[image:inventory_report_sample.png|750px]]
+
[[image:verdecito2.jpg|center|800px]]
</center>
+
</Center>
  
====== Inventory Changes ======
+
この我慢では、いくつかのプラグインがすでに登録されているのがわかります。ここで、あなたのプラグインを登録することができます。それがどのように動くかを説明するために、すでに登録済のプラグインを見てみましょう。リモートマシンに対して UDP の接続を監視する "UDP Plugin" というプラグインをクリックします。
 
 
This item displays the changes of the inventory registered in one of various hosts within a predefined time frame.
 
  
 
<center>
 
<center>
[[image:Inventory_changes_form.png|800px]]
+
[[Image:plugin_create_1.jpg]]
 
</center>
 
</center>
  
The fields pertaining to this particular form are the following:
+
'''プラグインタイプ (Plugin type)'''
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent that you selected in report item.
 
** _agentdescription_ : Description of the agent that you selected in report item.
 
** _agentgroup_ : Agent group name.
 
** _address_ : Address of the agent that you selected in report item.
 
** _module_ : Module name that you selected in report item.
 
** _moduledescription_ : Description of the module that you selected in report item.
 
* '''Description:''' A text field intended for the item's description.
 
* '''Period:''' A field to determine the interval for registering the changes.
 
* '''Group:''' A combo which filters the agents which appear within the next field. It doesn't appear in the report, it's only a form tool.
 
* '''Agents:''' The agents of the hosts in which the inventory will be gathered. Only the agents containing inventory modules are going to appear within this field.
 
* '''Modules:''' The common inventory modules of the selected agents.
 
  
 +
プラグインには、標準と Nagios の二種類があります。標準プラグインは、パラメータを受け取って処理を実行する通常のスクリプトです。Nagios プラグインは、その名が示す通り Nagios のプラグインで、Pandora FMS から実行することができます。主な違いは、Nagios プラグインは、テストが成功したかどうかをエラーレベルの戻り値で示し、追加情報を文字列で返す点です。文字列は数値データではありませんがモジュールの値として利用できます。この場合、モジュールの説明に入ります。
  
{{Tip|The data for this item is solely provided by inventory changing events. If they have a too large number of them, you may delete some of those events manually to reduce them.}}
+
この場合(例の UDP ポートチェックプラグイン)は、Nagios プラグインではないので、通常のプラグインを選択します。
<center>
 
[[image:inventory_changes_report_sample.png|750px]]
 
</center>
 
  
===== Configuration Items =====
+
'''最大タイムアウト (Max. timeout)'''
  
====== Agent Configuration ======
+
プラグインのタイムアウト値です。ここで指定した時間内に応答を得られなければ、モジュールは不明状態となり、データが更新されません。これは、プラグインでのモニタリングを実装する上で重要な要素です。プラグインの実行時間がこれより長い場合、全く値を取得できないことになります。この値は、プラグインとして実行するスクリプトが値を得るのにかかる時間より長い時間に設定する必要があります。何も設定しない場合、設定ファイルの ''plugin_timeout'' の値が利用されます。
  
This type of report will show us a picture of the agent status:
+
{{Tip|プラグインの実行には、サーバ、プラグイン、モジュールの 3つのタイムアウトがあります。サーバの設定が他よりも優先されます。二番目にプラグインです。サーバでのタイムアウト設定を 10秒、プラグインを 20秒、そしてモジュールの設定を 30秒としている場合、モジュールの実行タイムアウト時間は最短の 10秒になります。}}
  
<center>
+
この例では、15 を設定しています。
[[image:agent_configuration_report.png]]
 
</center>
 
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent that you selected in report item.
 
** _agentdescription_ : Description of the agent that you selected in report item.
 
** _agentgroup_ : Agent group name.
 
** _address_ : Address of the agent that you selected in report item.
 
** _module_ : Module name that you selected in report item.
 
** _moduledescription_ : Description of the module that you selected in report item.
 
* '''Label:''' Label you can asign to an element. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
  
 +
'''説明(Description)'''
  
Example of report display:
+
プラグインの説明です。Check a remote UDP port (by using NMAP) のように、簡単な説明を書きます (日本語も入力可能です)。IP アドレスとポートオプションを使用します。 説明は、プラグインのユーザーインターフェースに表示されるものなので、そのプラグインが何であるかの説明を記載してください。
  
 
<center>
 
<center>
[[image:agent_configuration_report_sample.png]]
+
[[Image:plugin_create_2.jpg]]
 
</center>
 
</center>
  
<br><br>
+
'''プラグインコマンド(Plug-in command)'''
  
====== Group Options ======
+
プラグインコマンドのパスです。標準のインストールでのデフォルトでは、''/usr/share/pandora_server/util/plugin/'' です。任意のパスを設定できます。このでの例では、''/usr/share/pandora_server/util/plugin/udp_nmap_plugin.sh'' を入力しています。独自のプラグインを利用する場合は、どこにプラグインを置いたかを確認し、実行権限(chmod 755)がついていることを確認してください。
This type of report will show us a picture of the status of the agents that belong to the selected group:
 
  
 +
'''プラグインパラメータ(Plug-in parameters)'''
  
<center>
+
コマンドのパラメータは、コマンドの後にスペース区切りで指定するものです。このパラメータには、_field1_ _field2_ ... _fieldN_ といったマクロが利用できます。これは、プラグインの操作の中で最も複雑な部分ですが、パニックにならないようにしてください。以降の例でも説明します。
[[image:group_configuration_report.png|750px]]
 
</center>
 
  
 +
'''パラメータマクロ(Parameters macro)'
  
 +
プラグインパラメータフィールドには、マクロを制限なく利用することができます。これらのマクロは、ユーザがプラグインモジュールを簡単に使用できるように、モジュール設定のテキストフィールドとして表示されます。 それは、プラグインが内部ではどういう動きをするかの詳細を知らなくても、ライブラリのようにフィールドを入力するだけでユーザが利用できるようにするものです。 マクロの定義によって、スクリプトの動作やスクリプトの呼び出し方法などを知らなくても、呼び出しパラメータを設定することができます。
  
Example of report display:
+
それぞれのマクロには、次の 3つのフィールドがあります。
<center>
 
[[image:group_configuration_report_sample.png|750px]]
 
</center>
 
  
===== Netflow Items =====
+
* 説明(Description): マクロの簡単な説明です。フィールドのラベルになります。
 +
* デフォルト値(Default value): デフォルトでフィールドに割り当てられる値です。
 +
* ヘルプ(Help): マクロの説明です。フィールドの設定例などを記載するとよいでしょう。
  
====== Netflow area chart ======
+
マクロ設定の例:
  
This report element will display a graph with the traffic analysis using filters already created in the Netflow view.
+
<center>
 +
[[image:macro_configuration.png|800px]]
 +
</Center>
  
 +
モジュールエディタでのマクロの例:
  
 
<center>
 
<center>
[[image:netflow_area.png|750px]]
+
[[image:macro_editor.png|800px]]
</center>
+
</Center>
 +
 
 +
===内部マクロ===
  
 +
アラートのように、プラグインの設定にも内部マクロを使うことができます。
  
Example of report display:
+
利用可能なマクロは次の通りです。
  
<center>
+
*_agent_ または _agentalias_: モジュールが属するエージェントの別名。
[[image:netflow_area_sample.png|750px]]
 
</center>
 
<br><br>
 
  
====== Netflow pie chart ======
+
*_agentname_: モジュールが属するエージェント名。
  
This element shows a pie chart with the results of applying the filter indicated by the user.
+
*_agentdescription_: モジュールが属するエージェントの説明。
  
<center>
+
*_agentstatus_: モジュールが属する現在のエージェントの状態。
[[image:netflow_pie.png]]
 
</center>
 
  
 +
*_address_: モジュールが属するエージェントのアドレス。
  
Example of report display:
+
*_module_: モジュール名。
  
<center>
+
*_modulegroup_: モジュールグループ名。
[[image:netflow_pie_sample.png]]
 
</center>
 
  
<br><br>
+
*_moduledescription_: モジュールの説明。
  
====== Netflow data chart ======
+
*_modulestatus_: モジュールの状態。
  
This element shows the data obtained by applying the filter indicated by the user in a table sorted by date and origin.
+
*_moduletags_: モジュールに関連付けられたタグ。
  
<center>
+
*_id_agent_: エージェントID。Pandora FMS コンソールへのリダイレクト URL を生成するのに便利です。
[[image:netflow_datachart.png]]
 
</center>
 
  
 +
*_id_module_: モジュールID。
  
Example of report display:
+
*_policy_: モジュールが属するポリシー名。(設定されている場合)
  
<center>
+
*_interval_: モジュールの実行間隔。
[[image:netflow_datachart_sample.png]]
 
</center>
 
  
<br><br>
+
*_target_ip_: モジュールの対象 IP アドレス。
  
====== Netflow statistics chart ======
+
*_target_port_: モジュールの対象ポート番号。
  
This report item will display a table with the grouped value of the traffic, using filters already created in the Netflow view.
+
*_plugin_parameters_: モジュールのプラグインパラメータ。
  
<center>
+
*_email_tag_: モジュールタグに関連付けられたメールアドレス。
[[image:netflow_statistics.png|750px]]
 
</center>
 
  
 +
=== リモートプラグインの内部 ===
  
Example of report display:
+
UDP プラグインのコードは、とてもシンプルで全体がどのように動作するのかの説明に適しています。
  
<center>
+
#!/bin/bash
[[image:netflow_statistics_sample.png|750px]]
+
# This is called like -p xxx -t xxxx
</center>
+
HOST=$4
<br><br>
+
PORT=$2
 +
nmap -T5 -p $PORT -sU $HOST | grep open | wc -l
  
====== Netflow summary chart ======
+
この Linux プラグインは、2つのパラメータを使います。対象の UDP ポート番号とアドレスで、-p および -sU オプションで指定します。プラグインを登録するときに 2つのマクロを定義します。一つはポート番号でもう一つは IP です。そのため、ユーザーがプラグインモジュールを作成するときには、それ以外のものは表示されません。
  
This report item will display a table with summarized traffic information that matches the Netflow filter specified in the Filter parameter.
+
プラグインを登録したらそれをエージェントで使うために、モジュールタブをクリックしてプラグインサーバモジュールを作成します。そこで新たなネットワークモジュールの作成を選択し、''作成(Create)'' ボタンをクリックします。
  
 
<center>
 
<center>
[[image:netflow_summary.png|750px]]
+
[[image:trescientos1.jpg|center|450px]]
</center>
+
</Center>
 
 
  
Example of report display:
+
以下のフォームで、未定義の部分を設定します。''generic numeric'' 等のモジュールの種類を選択し、
 +
モニタ対象の IP アドレスやポート番号を設定します。
  
 
<center>
 
<center>
[[image:netflow_summary_sample.png|750px]]
+
[[image:example1_edition_module.png|center|800px]]
</center>
+
</Center>
 
 
===== Log Items =====
 
 
 
  
====== Log Report ======
+
設定が終わったら、''作成 (Create)'' をクリックします。
  
This report type displays the log entries in the selected period.
+
以下の画面で、エージェントに作成した "UDP Port check" モジュールが表示されているのがわかります。
  
 
<center>
 
<center>
[[image:log_report_build.png|750px]]
+
[[image:udp_port_check_demo.jpg]]
</center>
+
</Center>
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent that you selected in report item.
 
** _agentdescription_ : Description of the agent that you selected in report item.
 
** _agentgroup_ : Agent group name.
 
** _address_ : Address of the agent that you selected in report item.
 
** _module_ : Module name that you selected in report item.
 
** _moduledescription_ : Description of the module that you selected in report item.
 
* '''Search''': text string to search.
 
* '''Log number''': Maximum number of log block entries to be shown when generating this report.
 
* '''Time lapse''': the time range going backwards over which the report will be drawn up (e.g. one month from the chosen date).
 
* '''Source''': Origin of logs.
 
* '''Agents''': Filtration Agents.
 
  
 +
=== 例 1: MySQL のプラグインモジュール ===
  
Example of report display:
+
プラグイン実装の一例をあげます。ここで紹介するのは、デフォルトでは Pandora に無い、MYSQL をチェックするプラグインです。
  
<center>
+
次の設定にて、MySQL のプラグインモジュールを作成します (システム管理メニュー(Administration)から、サーバ管理(Manage servers) -> プラグイン管理(Manage plugins) を実行)。
[[image:log_report.png|750px]]
 
</center>
 
  
===== Network items =====
+
*名前: MySQL
====== Network traffic Top N ======
+
*プラグインタイプ: Standard
 +
*最大タイムアウト: 10秒
 +
*説明:MySQL check plugin
  
This report shows a top-N of network consumption in the last X days of all IP analyzed by Pandora NTA:
+
チェック内容:
  
 +
このプラグインは、4つのチェックを行います。
  
[[File: Network_traffic_topN.png]]
+
Connections: 接続
* '''Name''': The following macros can be used:
+
Com_select: 開始からの select クエリ数
** _agent_ : Name of the agent that you selected in report item.
+
Com_update: 開始からの update クエリ数
** _agentdescription_ : Description of the agent that you selected in report item.
+
Innodb_rows_read: Innodb ファイル読み出し
** _agentgroup_ : Agent group name.
 
** _address_ : Address of the agent that you selected in report item.
 
** _module_ : Module name that you selected in report item.
 
** _moduledescription_ : Description of the module that you selected in report item.
 
* '''Time lapse''': the time range going backwards over which the report will be drawn up (e.g. one month from the chosen date).
 
* '''Quantity(n)''': Number of elements to be shown.
 
  
[[File: Pandora NTA sample report 1.png]]
+
*プラグインコマンド(Plugin command): /usr/share/pandora_server/util/plugin/mysql_plugin.sh
 +
*プラグインパラメータ(Plugin parameters): -s _field1_ -u _field2_ -p _field3_ -q _field4_
 +
*マクロ(Macro) _field1_:
 +
** 説明(Description): IP Address
 +
** デフォルト値(Default value): X.X.X.X
 +
*マクロ(Macro) _field1_:
 +
** 説明(Description): User
 +
** デフォルト値(Default value): User
 +
*マクロ(Macro) _field1_:
 +
** 説明(Description): Password
 +
** デフォルト値(Default value): Password
 +
*マクロ(Macro) _field1_:
 +
** 説明(Description): Check
 +
** デフォルト値(Default value): Connections
 +
** ヘルプ(Help): Possible values: Connections/Com_select/Com_update/Innodb_rows_read
  
==== The Wizard Tab ====
 
  
This tab is a feature of the Enterprise Version of Pandora FMS. It allows you to automatically combine several items containing common configurations all at once and by a few clicks which are getting applied to several agents and modules for a report.
+
画面は次のようになります。
 
 
Once the type, the period, the agents and the modules have been selected, all you need to do is to click on the 'Add' button and it's going to generate as many items as agents or modules have been selected for the report.
 
  
 
<center>
 
<center>
[[image:Wizard-tab-reporting builder.png|800px]]
+
[[image:plugin_mysql1.png|center|800px]]
</center>
+
</Center>
 
 
The fields pertaining to this particular form are the following:
 
* '''Name''': The following macros can be used:
 
** _agent_ : Name of the agent that you selected in report item.
 
** _agentdescription_ : Description of the agent that you selected in report item.
 
** _agentgroup_ : Agent group name.
 
** _address_ : Address of the agent that you selected in report item.
 
** _module_ : Module name that you selected in report item.
 
** _moduledescription_ : Description of the module that you selected in report item.
 
* '''Type:''' A deployable list in which you're able to select the type of item that's going to be massively generated. Not all item types are contained in here, because there are certain item types which require a more detailed configuration. The available item types within this form are the following: Alert Report Agent, Alert Report Module, AVG Module, Event Report Agent, Event Report Module, Monitor Report, Simple Graph and Availability
 
* '''Period:''' An intelligent control to provide the time period or data-time segment to represent the report item from the moment it's generated. If the time frame is e.g. 'one month' and you're generating the report in the current moment, the items are going to provide data from today to one month in the past.
 
* '''Agents:''' The list of agents you're allowed to access according your permission group. On this list, you may select one or several agents. The modules which are defined as common for the selected agents are shown within the module control for each selection.
 
* '''Modules:''' This common module list of the selected agents is available for one or several agents.
 
* '''Filter Group:''' A field intended to filter the agents by group.
 
* '''Elements to apply''': The list intended for the selected modules to add.
 
* '''Label''': Label you can asign to an element. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
* '''Name''': Name you can asign to an element. The following macros can be used: ''_agent_, _agentdescription_, _agentgroup_, _address_, _module_, _moduledescription_.''
 
* '''Time lapse''': the time range going backwards over which the report will be drawn up (e.g. one month from the chosen date).
 
 
 
Example of visualization of report (availability):
 
  
 
<center>
 
<center>
[[image:wizard_report_availability_sample.png]]
+
[[image:plugin_mysql2.png|center|800px]]
</center>
+
</Center>
 
 
<br><br>
 
 
 
==== The SLA Wizard Tab ====
 
This wizard allows us to create SLA report items automatically.
 
 
 
We can choose different SLA analyses:
 
 
 
* '''SLA:''' Displays a standard SLA reporting element, indicating the % of compliance in the selected period.
 
* '''Monthly SLA:''' will show a day by day analysis of the selected month, indicating the compliance %.
 
* '''Weekly SLA:''' will show an analysis of the compliance % week by week, indicating at all times the daily value.
 
* '''Hourly SLA:''' will display an hourly analysis of the selected period.
 
* '''Availability graph:''' a graph will be generated with the availability data of the selected modules.
 
* '''SLA services:''' a new reporting element representing the calculation of the SLAs of the selected services will be created.
 
 
 
 
 
You will be able to choose the ''validity'' value ranges of the modules to be selected. This feature will allow you to check the % of time that a module has maintained values within specific ranges.
 
 
 
If you do not define thresholds, they will be dynamically adjusted to the criticality thresholds of each module.
 
 
 
 
 
Other options can be found:
 
 
 
* ''Time lapse'': This is the range, or period of time over which the report renders the information for this report type. For example, a week means data from a week ago from now.
 
 
 
* ''Show graph'': only basic SLA; allows you to choose whether to display a table with the data, a graph, or both.
 
  
 
<center>
 
<center>
[[image:wizard_sla_skel.png|750px]]
+
[[image:plugin_mysql3.png|center|800px]]
</center>
+
</Center>
 
 
 
 
Example of report display:
 
  
 
<center>
 
<center>
[[image:report_avail1.png|750px]]
+
[[image:plugin_mysql4.png|center|800px]]
</center>
+
</Center>
<br><br>
 
 
 
==== The Global Tab ====
 
 
 
This tab is a feature of the Enterprise Version of Pandora FMS and allows us to create ''Exception'', ''General'' or ''Top N'' reports easily by a wizard.
 
  
* '''Exception''': This shows values of several modules that fulfill a logical operator.
+
このプラグインは、4つのチェックを行います。
  
* '''General''': Show values of several modules ordered (ascending, descending, by agent name) or/and grouped by agent.
+
*''-q Connections: 接続
 +
*''-q Com_select: 開始時点からの select クエリ数
 +
*''-q Com_update: 開始時点からの update クエリ数
 +
*''-q Innodb_rows_read: Innodb のファイルリード数
  
* '''Top N''': Shows N values discriminated by maximun, minimun or average over the total of modules selected, ordered ascending, descending or by agent name.
+
上記プラグインを使って、Pandora FMS がインストールされているシステムのエージェントにモジュールを作成してみます。名前は、''Mysql Connections'' 等で、''localhost'' において、Pandora データベースの pandora ユーザとそのパスワードで自身のデータベースをチェックします。''プラグインパラメータ(Plugin parameters)''には、''-q Connections'' を設定しています。
  
With this section you can add different modules from different agents, while you can also choose the operation to do in each module: addition, media, min and max.
+
作成後、モジュールは次のようになります。
  
 
<center>
 
<center>
[[image:global2.jpg|750px]]
+
[[image:plugin_mysql_module.png|center|800px]]
</center>
+
</Center>
 
 
 
 
Example of visualization of a report:
 
  
 
<center>
 
<center>
[[image:wizard_global_sample.png]]
+
[[image:mysql_module2.png|center|800px]]
</center>
+
</Center>
 
 
==== The Advanced Options Tab ====
 
  
This tab is a feature of the Enterprise Version of Pandora FMS. This tab was designed to make the reports much more customizable. Among other things, you're now able to select the font the PDF report is going to be generated with, to select the logo which will be shown in the PDF header, to edit the header and the PDF footer and the report's front page.
+
作成すると、プラグインモジュールとしてモジュール一覧に表示されます。(この場合、初期化待ち)
  
 
<center>
 
<center>
[[image: Advance options-tab-reporting builder.png|800px]]
+
[[image:fosforo3.jpg|center|800px]]
</center>
+
</Center>
  
The fields pertaining to this particular form are the following:
+
=== 例2: SMTP サーバリモートプラグイン ===
  
* '''Font Family:''' It's a deployable list, containing all the fonts you've installed within your Pandora Console in the directory '<pandoraconsole>/enterprise/include//mpdf50b/ttfonts'. The default font is 'Times New Roman'. If you want to make the font range bigger, it's important to consider that it's required to have read access to the apache group and the fonts are required to be in TTF format.
+
このプラグインは、リモートサーバを使ってメールを送信します。サーバの IP、ポート番号、ユーザ名、パスワードと、認証方式を指定し、また、メールの送信先を指定できます。動作していれば 1 を返し、そうでなければ 0 を返します。タイプは、generic_proc を利用します。
<br>
 
{{tip|If you intend to use Arabic, Chinese, Japanese or another UTF8 text within your PDF, you're required to utilize a supported TTF font for doing so. We're providing the 'code' font which actually contains all language characters.}}
 
  
* '''Custom Logo:''' It's a deployable list containing all possible logs which could be shown in the header of each PDF page. The logo images are stored under '<pandora_console>/images/custom_logo/'. The default image is 'pandora_logo.jpg'. You're able to see a preview in conjunction with your form by clicking on it.
+
このプラグインを利用したモジュール設定の画面を以下に示します。
 
 
* '''Header:''' It's a complete editor within which you're able to copy and paste the formatted text of an application into or to edit it by the 'box' button. This text is going to be the one shown in the header.
 
 
 
* '''First Page:''' Like the header field, this is another complete text editor, intended to create and to edit the PDF's front cover page.
 
 
 
* '''Footer:''' It's the same like the two other fields, but for editing and creating each PDF page's footers.
 
 
 
====== Macros ======
 
 
 
It's also possible to use macros within the first page, the header and footer. The available implemented macros are the following:
 
 
 
* '''(_DATETIME_):''' In the data format configured within the Pandora Console options, this value is replaced by the date in the moment the report is generated.
 
* '''(_REPORT_NAME_)''': This value is going to be replaced by the report's name.
 
* '''(_TIMEFROM_)''': This value will be replaced by the start date specified in the report.
 
 
 
==== The Preview Tab ====
 
 
 
This tab displays the report as if it's generated in HTML format to be able to easily review the results. It's going to display the report exactly as the one you're going to see if you click on 'Operation' and 'View Report' within the menu.
 
 
 
=== Visualizing a Report ===
 
 
 
In order to visualize an already created report, please click on ''Operation -> Reporting''.
 
<center>
 
[[image:report_menu.png]]
 
</center>
 
 
 
In this section you can see the created reports or create new.
 
  
 
<center>
 
<center>
[[image:report_list.png|850px]]
+
[[image:Pandora_plugin_SMTP5.png|center|800px]]
</center>
+
</Center>
 
 
Reports can be visualized in HTML, XML, CSV or PDF formats. Reports can be sent by email:
 
  
 
<center>
 
<center>
[[image:send_email.png|850px]]
+
[[image: smtp_module2.png|center|800px]]
</center>
+
</Center>
  
In order to see a report in the HTML format, please click on the [[image:pre46.png]] icon. Once the report is opened in HTML, it's possible to select the date and hour it was generated.
+
=== 例3: DNS サーバリモートプラグイン ===
  
<center>
+
このプラグインは、外部 DNS を参照して、指定したドメイン (artica.es など) の IP アドレスが変化していないかどうかをチェックします。これにより、不正なバランシングや DNS アタックなどがなく、ドメインが正しい IP を返しているかどうかを検証できます。正常であれば 1 を返し、そうでなければ 0 を返します。タイプは、generic_proc を利用します。
[[image:pre47.png|800px]]
 
</center>
 
  
In order to see a report in the XML format, please click on the [[image:pre48.png]]icon.
+
このプラグインを利用したモジュール設定の画面を以下に示します。
  
 
<center>
 
<center>
[[image:pre49.png|450px]]
+
[[image:Pandora_plugin_DNS5.png|center|800px]]
</center>
+
</Center>
<br><br>
 
 
 
In order to see a report in the PDF format, please click on the [[image:pre50.png]]icon.
 
  
 
<center>
 
<center>
[[image:pre51.png|800px]]
+
[[image:dns_module2.png|center|800px]]
</center>
+
</Center>
  
=== Automatic Report Scheduling ===
+
== リモート監視のためのカスタムフィールドマクロ ==
The Pandora FMS Enterprise version includes the CRON extension. This extension allows us to program different types of actions to be executed with a configurable periodicity.
 
  
Among the multiple options it offers, it allows us to configure the sending of reports in PDF format through e-mails.
+
リモートモジュールを設定するとき、エージェント特有の設定オプションを何度も入力しなければならないことは面倒です(例えば、SNMP コミュニティ文字列)。カスタムフィールドマクロを使うと、特定のモジュール設定オプションのマクロとして[[Pandora:Documentation_ja:Operations#カスタムフィールド | エージェントカスタムフィールド]] を使うことができます。
  
We will find this functionality in the menu entry ''Servers > Cron Jobs''.
+
以下の例では、コミュニティ文字列が異なる SNMP エージェント間で再利用できる SNMP ネットワークコンポーネントを作成します。
  
 +
* 最初に、Pandora FMS コンソールで ''リソース/カスタムフィールド(Resources/Custom fields)'' へ行き、SNMP コミュニティ文字列を保存するのに利用する新たなカスタムフィールドを定義します。ID は後でマクロの一部になるため、その ID を書き留めて、SNMP エージェントの適切なコミュニティ文字列を入力します。
  
 
<center>
 
<center>
[[image:cron_menu.png]]
+
[[image:snmp_custom_field.png|center]]
 
</center>
 
</center>
<br>
 
 
==== Automatic sending of a report by e-mail ====
 
To send a report via email on a scheduled basis, use the console extension ''enterprise'' CRON with the following options:
 
  
;Task: Select ''send custom report by e-mail''. It will allow us to program the generation and sending of an already existing report.
+
* そして、新たな SNMP [[Pandora:Documentation_ja:Templates_and_components#ネットワークコンポーネント|ネットワークコンポーネント]]を作成します。SNMP コミュニティ文字列として、_agentcustomfield_''n''_ を入力します。ここで、''n'' は、カスタムフィールドの ID です(今回の例では、''_agentcustomfield_11_'')。
;Scheduled: In this field we will specify the frequency with which the report will be sent.
 
;First Execution: In this field we will establish the date and time of the first execution.
 
;Report build: In this field we will select the report we want to send.
 
;Send to mail: This field contains the e-mail address to which the report will be sent.
 
  
 
<center>
 
<center>
[[image:pre52.png|650px]]
+
[[image:custom_field_network_component.png|center]]
 
</center>
 
</center>
  
Once the data has been filled in, click on create and the task appears in the list of scheduled tasks.
+
* 最後に、新たに作成した[[Pandora:Documentation_ja:Templates_and_components#ネットワークコンポーネント|ネットワークコンポーネント]]を用いて、モジュールを設定します。モジュールは、自動的に動作を開始します。
<center>
 
[[image:pre53.png|650px]]
 
</center>
 
<br>
 
  
Once the task has been created, it is possible to force its execution by clicking on the circular icon to the left of the scheduled task. You can also edit or delete the scheduled task using the buttons on the right.
+
カスタムフィールドマクロは、SNMP, WMI, プラグインおよび、インベントリモジュールで利用できます。これらは、単一のモジュール、ネットワークコンポーネント、ポリシーモジュールで利用できます。
  
 
+
WMI モジュールでは、ユーザ名とパスワードを格納するために 2つの新しいカスタムフィールドを同様に定義し、モジュール定義で対応するカスタムフィールドマクロを使用できます。
<br><br>
 
 
 
==== Application and sending of report template by e-mail ====
 
 
 
To apply a template and send the result via email on a scheduled basis, we will use the console extension ''enterprise'' CRON with the following options:
 
 
 
;Task: Seleccionaremos ''Send custom report (from template) by e-mail'': Nos permitirá aplicar una plantilla de informe sobre agentes a nuestra elección, y programar su generación y envío.
 
;Scheduled: In this field we will specify the frequency with which the report will be sent.
 
;Next Execution: In this field we will establish the date and time of the next execution.
 
;Template to build: In this field we will select the template of the report we want to generate.
 
;Agents: We will select the agents on which to apply the template.
 
;Send to mail: This field contains the e-mail address to which the report will be sent.
 
  
 
<center>
 
<center>
[[image:cron_report_template.png|750px]]
+
[[image:wmi_custom_field.png|center]]
 
</center>
 
</center>
  
<br><br>
+
== リモートウィザードとネットワーク監視実行 (Exec Server) ==
==== Configuration ====
 
For the email sending to work, it must be previously configured in Pandora FMS options.
 
  
To edit this configuration go to ''Configuration > Setup > Enterprise''.
+
この機能は、Pandora コンソールから Pandora リモートサーバでのアクションの実行をするものです。そのため、SNMP エージェントのウィザード、MIBブラウザ、およびリモートサーバからの「イベント応答」の使用を許可し、コンソールがあるサーバからのアクセスも許可する必要があります。
<center>
 
[[image:menu_config_enterprise.png]]
 
</center>
 
  
You will need to configure the email section at the bottom of the page correctly:
+
内部的には、"Exec Server" と呼ばれるもので、有効化されたサーバに対して Pandora コンソールから SSH でのリモートコマンド実行を通して動作します。リモートサーバは、Pandora またはサテライトサーバで、Linux である必要があります。
 
 
<center>
 
[[image:menu_config_enterprise_mail.png]]
 
</center>
 
  
== Report Templates ==
+
=== 設定 ===
===Introduction===
 
Report templates are components which allow you to parametrize the report's creation. It also allows you to apply them onto a set of agents and to easily create a lot of reports.
 
  
The report templates are components which allow you to parametrize the report creation that could be applied onto a group of agents and to quickly and easily create a big number of reports. Each element of the templates is going to match to an agent or module by a regular expression or substring, rendering this system very flexible.
+
この機能を正しく使用するためには、対象エージェントがすでに作成済である必要があり、サテライトサーバ利用時は、リモート設定が有効になっている必要があります。
  
<center>
+
{{Warning|リモート設定が有効になってない場合、サテライトモジュールはウィザードで作成されません。}}
[[image:templates1.png|900px]]
 
</center>
 
  
As you can see on the previous image, a report template will be created, containing elements or items. Each one of them is going to generate one or more report items. If they're applied, they fit to some agents or modules of the ones selected within that application.
+
Exec Server を正しく設定するためには、次のステップで設定を行う必要があります。
  
 
+
1. Pandora FMS のサーバ一覧で、exec server として利用したいサーバへアクセスする必要があります。
The type of template items will be almost all the ones that are available within the reports, e.g. 'average value', 'SLA', 'agent events', etc.
 
 
 
Now we're going to describe three examples of template items.
 
 
 
=== Examples ===
 
 
 
In order to access the template's administration menu, please click on 'Reporting' -> 'Custom Reporting' and click on the 'list templates' button:
 
  
 
<center>
 
<center>
[[image:template_main.png|800px]]
+
[[image:Exec-server-111.JPG|center]]
</center>
+
</Center>
  
This template examples are containing three template items mentioned below:
+
2. 指定したコマンドを実行するサーバの IP を編集し、"Exec Server" の検証を有効化します。"ポート(Port)" オプションを使うことによって、サーバへ SSH 接続する際に利用するポートを指定できます。このオプションは、ネットワークサーバまたはサテライトサーバで設定できます。
  
* An automated combined graph which allows you to create graphs on the modules which coincide within the application.
+
3. システムの設定が完了しておらずエラーメッセージが表示されるため、テスト設定は実行しないようにします。
* A 'Top N' report.
 
* An agent event report.
 
  
 
<center>
 
<center>
[[image:Templates_list_items1.jpeg|800px]]
+
[[image:server_222_2.png|center]]
</center>
+
</Center>
  
=== Example 1: The Automated Combined Graph ===
+
4. Pandoraコンソールが動作するサーバーを有効にして、"apache" または同等のユーザーがシェルを実行できるようにします。 /etc/passwd ファイルを修正し、ユーザーが有効なシェルを持つように行を変更します。たとえば、次のようになります。
  
Creating combined graphs is an option within Reporting > Custom graphs which enables generating visual reports made of as many modules as needed.
+
apache:x:48:48:Apache:/var/www:/bin/bash
  
This section allows defining a name for the graphic and other data such as periodicity, graphic type or the weight of each of the modules.
+
5. "/var/www" に ".ssh" ディレクトリを作成し、"apache" ユーザがアクセス可能なパーミッションにします。
  
<center>
+
mkdir /var/www/.ssh
[[image:Combinedgraph1.png|750px]]
+
chown apache /var/www/.ssh
</center>
 
  
<center>
+
6. root で以下を実行します。
[[image:Combinedgraph2.png|750px]]
 
</center>
 
  
<center>
+
su apache
[[image:Combinedgraph3.png|750px]]
 
</center>
 
  
Combined graphs enable establishing the order of each individual module by means of the “sort” option, featured in the option list.
+
7. リモートマシンへの接続のための SSH キーを生成します。次のコマンドを実行します。
  
<center>
+
ssh-keygen
[[image:Combinedgraph5.png|750px]]
 
</center>
 
  
The result of combined graphs clearly differences data from the selected different modules.
+
いくつか質問が表示されるので、そのままエンターを押します。
  
 
<center>
 
<center>
[[image:Combinedgraph4.png|750px]]
+
[[image:Exec-server-3.jpg|center]]
</center>
+
</Center>
  
In the following example, combined graphs will be created for every agent whose module name is equal to "Disk Read Latency" and "Disk Write Latency".
+
8. SSH で "Exec server" (Pandora サーバまたはサテライトサーバ)へアクセスする前に、そのマシン上に
 +
"pandora_exec_proxy" という特定のユーザを作成し、"/home/pandora_exec_proxy/.ssh/" ディレクトリを作成します。
  
Once the combined graphs are created, they will be added to the generated report.
+
sudo useradd pandora_exec_proxy -m
  
<center>
+
mkdir /home/pandora_exec_proxy/.ssh/
[[image:Template automatic graph.png|800px]]
 
</center>
 
  
Along this example, the target modules have been chosen, but the modules could also be selected through a regular expression, filling out the Modules to match (Free text) field. For example, the regular expression *cpu.* would be applied on modules such as: cpu_user, total_cpu_usage, cpu, etc.
+
'''注意''': ユーザにはパスワードが無いため、リモートからの接続には利用できません。
  
One of the available options is adding a dynamic label tag to the future report item. In this field, predefined macros will be able to be used to identify the item that will be generated. This is very useful when printing in PDF, since the report item that is searched in the menu can be certainly identified. Another important field of the form for this kind of model item is “create a graph for each agent”. Once activated, it will enable creating a combined graph for each agent. If disabled, the system will combine all data in a single combinated graph, where information about all matching agents and modules will be added.
+
9. 前のステップで作成した公開鍵の内容を、Pandora コンソールから "''exec server''" にコピーします。これには、Pandora コンソールの <strong>“''/var/www/.ssh/id_rsa.pub''”</strong> の内容をコピーし、exec server の <strong>''/home/pandora_exec_proxy/.ssh/authorized_keys''</strong> にペーストします。その後、ファイルのパーミッションを調整します。
  
=== Example 2: Top N ===
+
chown -R pandora_exec_proxy /home/pandora_exec/.ssh/
  
This item is going to generate a report of the 'Top N' type, showing the most demanded 5 CPUs of the last day. This item applies to all agents with modules which contain the literal "CPU User" element.
+
10. ユーザを作成したら、コンソールを実行しているマシンから "apache" ユーザで、パスワードなしでリモートにログインできるか確認するために次のコマンドを手動で実行します。(前の手順で設定した Exec server のホスト名/ IPを利用)
  
<center>
+
  ssh [email protected]_address
[[image:Template_topn.png|800px]]
 
</center>
 
  
As you can see on the image, the modules are not going to be searched literally, but a regular expression is used here. This performance is selected by clicking on the box next to the agent's name ('exact match'). If you leave it blank, the agent's name is going to match on all agents selected during the application.
+
11. すべてのステップを正しく実行したら、apache ユーザを元の状態(ログインシェル無し)に戻すために /etc/passwd ファイルを編集します。
  
=== Example 3: Agent Events ===
+
apache:x:48:48:Apache:/var/www:/sbin/nologin
  
This element is going to generate a report of the events generated on the last day for all selected agents.
+
12. 最後に、Pandora コンソール内のプロキシサーバの編集セクションで設定をテストをすれば、テストインジケータが緑色に変わり、完全に動作し機能します。
  
 
<center>
 
<center>
[[image:Template_agentevent.png|800px]]
+
[[image:Exec-server-4.png|center]]
</center>
+
</Center>
 
 
As you can see in the 'Agent' field, the regular expression '.*' has been used. It symbolizes any alphanumeric string, so it will be applied on any selected agent.
 
 
 
=== Applying a template ===
 
  
Once we have defined all the template items we need we can apply or ''instantiate'' this template through two methods:
+
=== ''exec server'' 機能の利用 ===
  
==== Direct application ====
+
MIB ブラウザー、エージェントの SNMP ウィザード、およびイベント応答で、ローカルコンソールまたは設定済みの Exec server のどちらから要求を開始するかを選択できます。
You can directly apply and view a template report by clicking on any of the format icons that appear in the row our template occupies:
 
  
 
<center>
 
<center>
[[image:template_direct.png]]
+
[[image:Exec-server-555.JPG|center]]
</center>
+
</Center>
  
We will be shown a pop-up where we will be able to choose the agents on which this report template will be applied:
+
また、WMI ウィザード、SNMP インターフェイス、SNMP エージェントのウィザード(サテライトサーバーでは使用できません)からも同様です。
  
 
<center>
 
<center>
[[image:template_direct2.png]]
+
[[image:Exec-server-666.JPG|center]]
</center>
+
</Center>
  
==== Template Wizard ====
+
ウィザードを起動したときに選択したサーバに依存して、サテライトサーバまたはサーバに関連付けられたモジュールが作成されます。サテライトサーバーの場合は、サーバーで実行できるようにリモート構成ファイルにモジュールを書き込みます。
We can make use of the Template Wizard if we need to si necesitamos ''instantiate'' our report template in a real report to have it available in the Pandora FMS report list.
 
  
 +
"イベント応答" の実行には、最初に新たな exec server を利用する新たなイベント応答の設定を行う必要があります。
  
 
<center>
 
<center>
[[image:Template_application.png|750px]]
+
[[image:Exec-server-777.JPG|center]]
</center>
+
</Center>
 
 
 
 
We can activate the checkbox '''Create report per agent''' if we want to generate a report for each agent selected. If we don't activate it, a general report will be generated with all the information.
 
 
 
* If a report is generated by an agent, the title of the report shall be as follows: [template title] - [agent name] ([agent name])
 
* In the event that a full report is generated, the title shall be as follows: [report title] - agents ([number of agentes]) - [date]
 
  
 +
そしてイベントからそれを起動します。
  
 
<center>
 
<center>
[[image:Template_application1.png|650px]]
+
[[image:Exec-server-8.JPG|center]]
</center>
+
</Center>
  
====Examples====
+
== パス監視 ==
  
A "custom_graph" type element was created for the automatic combined graph. This graph has two elements for the modules "Read Disk Latency" and "Write Disk Latency".
+
Pandora FMS は、ネットワークの 2つのポイント間の完全なルート監視をデフォルトで提供し、これらの 2つのポイント間の通信パスを視覚的に示します。
  
<br><br>
+
このシステムを利用するには以下が必要です。
<center>
 
[[image:Template_application_custom_graph1.png|450px]]
 
</center>
 
<br><br>
 
  
Editing the custom graph you can see that it has both modules:
+
* 分析したいルートの発信元となるポイント上にソフトウエアエージェント
 +
* 発信元ポイントからの ICMP による宛先までの到達性
  
<br><br>
+
Pandora FMS パス解析は、ルートのマップ生成にエージェントプラグインを利用します。このエージェントプラグインは、情報収集し構造化した情報を Pandora サーバへレポートするためいくつかの手法を利用します。
<center>
 
[[image:Template_application_custom_graph.png|700px]]
 
</center>
 
<br><br>
 
  
For the Top N report an element was created with an expression based on the  ''cpu''text.
+
'''注意:''' オプションで、インターネット越しにルートをスキャンしたい場合は、発信元となるコンピュータに mtr アプリケーションを入れることをお勧めします。より詳細は以下を参照してください。
  
<center>
+
https://en.wikipedia.org/wiki/MTR_%28software%29
[[image:template_topn.png|700px]]
 
</center>
 
  
Displaying the rendered report shows the ten most loaded CPUs:
+
http://www.bitwizard.nl/mtr/
  
  
<br><br>
+
=== 設定 ===
<center>
 
[[image:Template_application_top_n1.png|600px]]
 
</center>
 
<br><br>
 
  
Three elements will be created for the agent events report (remember that all agents were selected using .*):
+
バージョン 7.0 の OUM715 以降では、プラグインはエージェント内に含まれています。 設定するには、エージェントのリモート設定が有効になったら、Pandora FMS コンソールからプラグインの実行を有効にします。
  
<br><br>
+
<!--
<center>
 
[[image:Template_application_eventagent.png|600px]]
 
</center>
 
  
=== Editing the Template ===
+
From version 7.0 OUM715 onwards, the plugin is included in the agent. To configure it you must activate the execution of the plugin from Pandora FMS console, once the agent remote configuration is enabled.
  
Within the templates you're able to modify the general parameters of the template as shown on the picture below.
+
* Download the plugin for path analysis of the module library:
 +
https://library.pandorafms.com/index.php?sec=Library&sec2=repository&lng=en&action=view_PUI&id_PUI=821
  
<center>
+
*Transfer the plugin to your software agent (either by collecting or manually copying the file)
[[image:Template_general.png|800px]]
 
</center>
 
  
=== List of Templates ===
+
<center><br><br>
 +
[[image:route_conf1.png|center]]
 +
</Center>
 +
<br><br>
  
In order to access the template's list, please click on 'Administration' -> 'Manage Reports' -> 'Report Builder' and on the 'List Templates' button:
 
  
<center>
+
* Activate plugin execution
[[image:template_main.png|800px]]
+
-->
</center>
 
  
In this section, you may create new templates, edit existing ones, copy and delete them.
+
エージェントのプラグイン設定タブにアクセスし、次の行を追加します(エージェントのバージョンが 7.0 715 より前の場合、またはユーティリティフォルダにプラグインを展開していない場合は、プラグインを実行するための完全パスを指定する必要があります)
  
=== The Items List ===
+
route_parser -t target_address
  
In this section, you're able to review, edit, assort and delete items within a report template.
+
対象のアドレスは、v4 の IP アドレスかまたは FQDN ドメイン名が利用できます。
  
 
<center>
 
<center>
[[image:Template_list_item.png|800px]]
+
[[image:route_conf2.png|center]]
</center>
+
</Center>
 
 
=== The Item Editor ===
 
 
 
This editor was designed to create new items. The item types are the same as in the report section, but with two differences: The agent's name is a regular expression, e.g.  'oracle_agent[.]*'. It's going to match to the agent's names 'oracle_agent_1', 'oracle_agent_2', etc. If you leave it blank, this item is going to be applied onto all selected agents within the [http://wiki.pandorafms.com/index.php?title=Pandora:Documentation_en:Data_Presentation#The_Template_Wizard '''The Template Wizard'''].
 
  
The module's name can be filled out by activating the check box named 'Module exact match' or by a regular expression without activating this particular check box.
+
=== 表示 ===
<center>
 
[[image:template_agentevent.png|750px]]
 
</center>
 
  
=== Advanced Options ===
+
システムを設定しレポートが始まると、エージェント表示画面に新たなタブが表示され、対象との通信が確立されます。
  
You may edit visual aspects for the results report like fonts, logos, headers, the first page or the report footer within this section.
+
発信元ネットワークからの他のネットワーク上のマシンへのルートビューの例を示します。(LAN 接続)
  
 
<center>
 
<center>
[[image:Template_advance.png|800px]]
+
[[image:route_view1.png|center]]
</center>
+
</Center>
  
=== Report Cleaning ===
+
8.8.8.8 (Google の DNS)へのルートの例は以下の通りです。(WAN 接続)
 
 
To delete reports created in previous applications from a template from the Wizard you can select a template and click the delete button (broom button).
 
  
 
<center>
 
<center>
[[image:Template_wizard_cleanup.png|750px]]
+
[[image:route_view2.png|center]]
</center>
+
</Center>
<br><br>
 
 
 
This action will automatically delete all reports created based on this template.
 
 
 
[[Pandora:Documentation_en|Go back to Pandora FMS Documentation Index]]
 
  
 
[[Category: Pandora FMS]]
 
[[Category: Pandora FMS]]
 +
[[Category:Documentation]]
 +
[[Category:Japanese]]

Revision as of 04:45, 11 July 2020

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

1 リモートモニタリング

1.1 概要

Pandora FMS ネットワークサーバは、集中的にリモートからテストを実行することができる重要な要素です。データサーバとは逆に、ネットワークサーバは複数のプロセスキューを通してタスクを実行します。ネットワークサーバはまた、他のネットワークサーバと共にバランシング動作をしたり、他のネットワークサーバがダウンした時に、そのサーバと同等の処理を実行する代替えとして動作することができます。Pandora における HA の詳細については、それに関する章を参照してください。

ネットワークサーバは、それに割り当てられたモジュールのみと動作します。もちろん、ネットワークテストなので、ネットワークサーバはテストをする対象がネットワーク的に通信できないといけません (IPアドレスやポート)。対象システムのポートが開いて無かったりルーティングがない場合は、モニタできません。ファイアーウォールの存在やネットワークのルーティングに関しては、Pandora FMS では何ともできません。これらの理由により発生する問題は、Pandora FMS の特別な設定で解決するわけでもありません。

ネットワークサーバのほかにも、様々なリモートテストを実行する Pandora FMS サーバサブタイプがあります。 この章では、ネットワークサーバ、リモートプラグインサーバー、および Windows マシンに対してリモートテストを実行するサーバ(WMIサーバ)について説明します。 WEB テストサーバ(WEBサーバまたは Goliat サーバ)としてリモートテストを実行する他のサーバには、それ専用のドキュメントの章があります。

Remote-monitoring.jpg

1.2 基本的なネットワーク監視

Pandora FMS のネットワークモジュールは、リモートモニタリングタスクを実行します。リモートで実行するタスクは、次の 3つに分類されます。

ICMP テスト

Ping に答えるか (remote_icmp_proc) または、ミリ秒での応答があるか (remote_icmp) どうかをテストします。両方のテストは、ネットワークモジュールが割り当てられたエージェントに対して、ネットワークサーバで実行されます。

TCP テスト

モジュールで設定された TCP ポートが開いているかをリモートからチェックします。加えて、テキスト文字列を送信し、応答文字列が正しかどうかをチェックすることができます。

例えば、"GET / HTTP/1.0^M^M" という文字列を送信し、"200 OK" を受信することでウェブサーバが稼働しているかどうかをチェックできます。("^M" は、改行を意味します)

SNMP テスト

SNMP が有効になっていて、インタフェースの状態やネットワークトラフィックなどの状態を取得できるるようになっている場合、リモートから SNMP ポーリングを行うことができます。 詳細は、Pandora FMS での SNMP の説明を参照ください (以降にあります)。

Network-data-server-arq.png

まとめると、ネットワークサーバは、それぞれのエージェントに割り当てられた異なるネットワークテストを実行します。それぞれのエージェントはネットワークサーバに割り当てられ、実行結果は Pandora FMS システムのデータベースに保存されます。

1.2.1 ネットワークモニタリングのための一般的なモジュールの設定

リモートからサービス (FTP、SSH など) をモニタするためには、最初にサービスをモニタするための通信を行うエージェントを作成します。

Info.png

エージェントの作成は、対象のマシンのソフトウエアエージェントをインストールする必要はなく、Pandora FMS コンソールで行えばよいです。

 


Pandora FMS コンソールにて、管理メニューの リソース(Resources) > エージェント管理(Manage agents) を使います。

Anvi.jpg

次の画面で、エージェントの作成 ボタンをクリックします。

Bibi.jpg

新しいエージェントの情報を入力して、エージェントの作成 をクリックします。

Raro.jpg

エージェントを作成したあと、上のプルダウンメニューからモジュールを選択します。ここで、「ネットワークサーバモジュールの新規作成」を選択し、作成 ボタンを押します。

Sasa.jpg

以下のフォームで、ネットワークコンポーネントモジュールを選択し、右側のドロップダウンメニューで必要なチェックを見つけます。この例では、Host Alive (ping 疎通確認) を選択しています。これはマシンがネットワークに接続されているかどうかを確認するために、ping 応答をチェックします。

Alive.jpg

拡張オプションはのちほど説明します。モジュールは、エージェントの IP アドレスを取得しています。変更もできます。モジュールの定義が完了したら、作成ボタンをクリックしてください。

以下の画面では、エージェントのモジュールが表示されています。既存の Keepalive モジュール(エージェントと共に作成)と、追加した 'Host Alive' モジュールがあります。

Kiji.jpg

見ての通り、モジュールでワーニングが出ています。ワーニングは、モジュールが追加されたばかりで、まだデータを受信していないということを意味しています。一度データを受信すると、ワーニングは消えます。

作成したモジュールのデータを見るには、上の方にある参照メニューをクリックします。収集した情報が表示されます。

Keso.jpg

他の種類のネットワークチェックを追加するには、上記と同じ要領で他の種類のモジュールを選択してください。

1.2.2 ICMP モニタリング

前述の例は、ICMP モニタリングの例でしたが、重要で正確な情報を提供する、より基本的かつ簡単なチェック手法があります。ICMP チェックには次の 2つの種類があります。

icmp_proc は、IP アドレスが応答するかどうかの (ping) チェックを行います。

icmp_data は、応答遅延のチェックを行います。IP アドレスに対して ICMP 応答にミリ秒単位でどれだけかかったかを確認します。

1.2.3 TCP モニタリング

TCP チェックは、ポートの状態や TCP サービスの状態を確認することができます。

このタイプのモジュールの主なパラメータは対象のポート番号、IP、TCP での送受信データです。

TCP のチェックは、デフォルトでは単純にポートが開いているかどうかを確認します。オプションで、TCP 送信文字列および、TCP 受信文字列フィールドを使って、テキスト文字列の送信と、それの応答確認を行うことができます。

通信が正常に行われているかをチェックするために、テキスト文字列を送り ("^M" は、改行を表します) その応答を確認することができます。これにより簡単なプロトコルチェックが可能です。例えば、ウェブサーバに次の文字列を送信し、

 GET / HTTP/1.0^M^M 

次の応答を確認するとで、正常かどうかの確認ができます。

200 OK

これらは、TCP 送信文字列および、TCP 受信文字列フィールドに定義します。

TCP 送信文字列

TCP ポートに送信するパラメータを設定します。^M は、改行コードの送信を意味します。複数の送信・応答文字列を定義するには、"|" で区切ってください。

TCP 受信文字列

TCP 接続で受信する応答文字列を設定します。複数の送信・応答文字列を定義する場合は、それぞれを "|" 文字で区切ってください。

Pandora FMS の TCP チェックでできるのは、ポートが開いているかどうかや応答があるかどうかだけではありません。複数ステップで、データを送信し、それの応答文字列を見ることができます。すべての手順が正しい場合に、正常と判断させることができます。

複数ステップで Pandora FMS の応答チェックの仕組を利用するには、各ステップの文字列を | で区切ります。

SMTP 接続の例を以下に示します。

R: 220 mail.supersmtp.com Blah blah blah
S: HELO myhostname.com
R: 250 myhostname.com
S: MAIL FROM: 
R: 250 OK
S: RCPT TO: 
R: 250 OK
S: DATA
R: 354 Start mail input; end with .
S: .......your mail here........
S: .
R: 250 OK
S: QUIT
R: 221 mail.supersmtp.com Service closing blah blah blah

これをチェックしたい場合、各フィールドに次のように定義します。

TCP 送信文字列

HELO myhostname.com^M|MAIL FROM: ^M| RCPT TO: ^M

TCP 受信文字列

250|250|250

最初の 3つのステップが OK (コード 250) であれば、SMTP は正常です。メールを実際に送信する必要はありません (必要であればそのような設定も可能です)。これにより、プレーンテキストを用いたプロトコルに対する TCP チェックが実現できます。

1.2.4 リモート実行モジュール

バージョン 741 以降、以下の Enterprise ネットワークサーバモジュールがあります。

  • Remote execution data
  • Remote execution data proc
  • Remote execution data string
  • Remote execution data inc

これらのモジュールを正常に使用するには、監視するエージェントの接続認証データが必要です。それには、認証ストア に接続データを登録します。

Remotexec9.PNG

認証情報を登録したら、モジュールの定義に利用します。

新たなネットワークサーバモジュールを作成します。

モジュールタイプからオプションを一つ選択します。

Remotexec2.png

リモート実行の場合、次のタイプのデータが有効です。

  • remote_execution_data: 数値
  • remote_execution proc: 二値 (0 障害, 0 以外 正常)
  • remote_execution_data_string: 文字列
  • remote_execution_data_inc: 増分データ(比)

以下を定義します。

  1. 接続に利用する認証
  2. オプションで対象の IP (設定しないとエージェントのそれが利用されます)
  3. オプションで対象の OS (設定しないとエージェントのそれが利用されます)
  4. オプションで接続ポート番号 (Linux であれば 22、Windows であれば何でも)
  5. 監視プロセスを実行するためのコマンド

例:


Remotexec8.png


Remotexec3.png


システムはリモートマシンに対してコマンドを実行し、一時作業ディレクトリ内のファイル数を受け取ります。


Remotexec4.png


文字列のタイプを選択して、コマンドの出力を表示することもできます。

モジュール設定:


Remotexec5.png


対象となるエージェントの運用システムを継承するように、対象 OSパラメータを設定することができます。

結果:


Remotexec6.png


Remotexec7.png


Template warning.png

アラートの割り当て、イベントの生成、レポートの表示におけるモジュールの操作は他と同じです。

 


Template warning.png

Pandora FMS バージョン 743以降では、pandora_server.conf でリモート実行モジュールパラメータに関連する次のトークンが利用できます。: ssh_launcherrcmd_timeout および rcmd_timeout_bin

 


1.2.5 SNMP モニタリング

1.2.5.1 SNMP モニタリングの概要

SNMP モニタリングに関して話をする場合、ポーリングとトラップは区別することが重要です。SNMP ポーリングは、Pandora がルータやスイッチ (また、snmp エージェントをインストールしたサーバ) など SNMP デバイスに対して snmpget コマンドを実行することにより実施されます。これは、(指定した秒間ごとに )定期的に実行される処理です。

それに対して、SNMP トラップの受信は(変化の発生に基づく)非同期処理です。一般的には、デバイスからの "アラート" を受信するのに使われます。例えば、スイッチのポートダウンや、筐体の温度上昇が発生したような場合が該当します。

ポーリングによる SNMP 監視は、Pandora FMS における通常のネットワークモジュールで実行されます。

SNMP トラップの利用は全く異なります。Pandora FMS における SNMP コンソール以外の設定は何も必要なく、デバイスからのトラップを受信することができます。SNMP コンソールに受け取ったすべてのトラップが表示されます。アラートは、フィルタリングルールを通して設定できます。

Pandora FMS は、SNMP に個別の OID を利用します。Pandora FMS での個々の OID は、ネットワークモジュールとして定義することになります。例えば、24ポートの Cisco Catalyst スイッチをモニタする場合、各ポートの状態、入力トラフィック、出力トラフィックで、計 72 個のモジュール (24 x 3) を定義することになります。

SNMP デバイスを扱うは次に示す項目が必要です。

  • SNMP プロトコルがどのようなもので、どのように動作するかを知る必要があります。詳細は、IETF から公開されている RFC3411 に示されています。
  • リモートデバイスの IP および SNMP コミュニティを知る必要があります。
  • ネットワークサーバが SNMP アクセスできるように、デバイスの SNMP 管理を有効にする必要があります。このネットワークサーバは、ネットワークモジュールが定義されるエージェントによって割り当てられる必要があります。 割り当てられたサーバに障害が発生した際に他のネットワークサーバが監視を実行するようにした場合、これらの監視は別の IPアドレスで実行されることに注意してください。
  • リモートデバイスのチェックをしたい特定の OID を知る必要があります。(Pandora FMS ウィザードや SNMP OID ブラウザを使うこともできます)
  • デバイスが返す値をどのように扱えばよいかを知る必要があります。SNMP デバイスは、それぞれ異なるファーマットでデータを返します。Pandora FMS は、ほとんどすべてのデータを扱うことができます。カウンタデータは、Pandora が remote_snmp_inc として管理する特別重要なものです。それは、数値データとしてではなく、カウンタとして認識されます。多くの SNMP データはカウンタ値になっています。それをモニタするためには、remote_snmp_inc として設定する必要があります。

1.2.5.2 SNMP のネットワークモジュールでのモニタリング

SNMP でのモニタリングを出来るようにするためには、少なくとも対象の IP アドレスと SNMP コミュニティを知らなくてはいけません。モニタ項目の OID を知ることも重要ですが、それぞれの OID が何であるかを snmpwalk によって得ることができます。ただし、これは簡単なタスクではありません。

SNMP でのモニタリングを行うためには、まず最初にそれのエージェントを作成する必要があります。すでに存在するエージェントに対しては、前述の方法に従って新たなネットワークモジュールを追加します。

モジュールを作成したあとは、モジュールの設定にて SNMP のデータの種類を選択します。

Cap5 snmp 1.png

モニタしたいデータの種類に合った SNMP の定義を選択します。

SNMP のデータの種類を選択すると、SNMP の追加フィールドがフォームに現れます。

Cap5 snmp 2.png

次に、フィールドの設定を行います。

SNMP コミュニティ

SNMP コミュニティです。モニタリングに必要なパスワードのようなものです。

SNMP バージョン

デバイスの SNMP プロトコルバージョンを設定します。1, 2, 2c および 3 を選択できます。バージョン 3 は通信の暗号化と安全な認証を含んでいます。ただし、設定が複雑で、Pandora FMS ネットワークサーバのポーリングパフォーマンスは低くなります。

SNMP OID

モニタする OID を設定します。数値およびドットで表現されます。システムに対応する MIB がインストールされている場合は、より読みやすい文字列に変換されます。MIB は、OID をより記述的な文字列に変換するのに役立つメーカーのライブラリです。

文字で表した OID は次のような形式になります。

iso.org.dod.internet.private.transition.products.chassis.card.slotCps.cpsSlotSummary.cpsModuleTable.cpsModuleEntry.cpsModuleModel.3562.3

数値では次のようになります。

  1.3.6.1.4.868.2.4.1.2.1.1.1.3.3562.3

Pandora FMS は、直接利用することが可能ないくつかの OID をデータベースに保持しています。例えば、モジュールを作成したときに、Cisco MIB を選択すると、Cisco の MIB 一覧を表示します。

Cap5 snmp 4.png

このコンポーネントを選択すると、その中に存在する MIB を選択することができます。

Cap5 snmp 5.png

こうすることによって、フィールドに必要な情報を埋めることができます。

エンタープライズ版の Pandora FMS には、ほかのデバイス向けのより多くの MIB パッケージが含まれています。 データを取り込むには、作成 ボタンをクリックします。

作成したばかりのモジュールのデータを見るには、 参照 という名前の上部のタブをクリックして、ページの一番下を見ます。そこには、開始してから受け取っているデータが表示されます。これにより、リアルタイムの SNMP グラフを見ることができます。

SNMP nueva.png


1.2.5.3 エージェントからの SNMP モニタリング

Windows のソフトウエアエージェントは SNMP の情報を取得するユーティリティを含んでいます。Unix/Linux では、snmpget が元々存在し、module_exec から呼び出すことができます。

我々は、Windows エージェントにデフォルトで snmpget.exe (net-snmp プロジェクトの一部で BSD ライセンスです) を組み込み、基本的な MIB および snmpget.exe ユーティリティを呼び出すためのラッパースクリプトを追加しています。

これを利用することにより、エージェントから SNMP でエージェントからアクセスできるリモートシステムの情報を取得することができます。これは、"サテライトエージェント" や "プロキシエージェント" と(マニュアルでは)呼んでいます。

Windows における実行の書式は次の通りです。

module_exec getsnmp.bat <comunidad_SNMP> <ip de destino> <OID>

Windows エージェントで実行する SNMP モジュールの例を以下に示します。

module_begin
module_name SNMP_if3_in
module_type generic_data_inc
module_exec getsnmp.bat public 192.168.55.1 .1.3.6.1.2.1.2.2.1.10.3
module_end
module_begin
module_name SNMP_if3_desc
module_type generic_data_string
module_exec getsnmp.bat public 192.168.55.1 IF-MIB::ifDescr.3
module_end
module_begin
module_name SNMP_Sysup
module_type generic_data
module_exec getsnmp.bat public 192.168.55.1 DISMAN-EVENT-MIB::sysUpTimeInstance
module_end

Unix エージェントでの同様の実行例です。

module_begin
module_name SNMP_if3_in
module_type generic_data_inc
module_exec snmpget -v 1 -c public 192.168.55.1 .1.3.6.1.2.1.2.2.1.10.3
module_end
module_begin
module_name SNMP_Sysup
module_type generic_data
module_exec snmpget -v 1 -c public 192.168.55.1 DISMAN-EVENT-MIB::sysUpTimeInstance
module_end

基本的な OID は、数値にも置き換え可能で、常に数字の OID を使うことをお勧めします。ツールが変換できるかどうか分からないためです。多くの場合、MIB は Windows Wdeareba /util/mibs ディレクトリに、Linux であれば、/usr/share/snmp/libs ディレクトリにあります。

1.2.6 Pandora FMS SNMP MIB ブラウザ

監視(Monitoring) > SNMP > SNMPブラウザ(SNMP Browser) メニューから、MIB ブラウザにアクセスすることができます。

Pandora FMS バージョン 744 から、新たにポリシーおよびエージェントに追加する操作ができます。この機能は、Pandora FMS Enterprise 版にのみ存在します。

最初に理解しなければならないことは、Pandora FMS が MIB ツリーの完全なパスを作っていることです。(スイッチのように)ツリーが大きい場合は、この操作に数分かかることがあります。 1つのサブツリーのみを探索することもできます。これにより、多くの時間を節約できます。

たとえば、Cisco デバイスの enterprise サブ MIB ツリーの情報のみを取得するには、次のような OID を利用します。

 .1.3.6.1.4.1.9

ブラウザを使用して操作します。各ブランチをクリックすることにより値を取得します。システムは情報を問い合わせ、指定された OID 情報(利用可能な場合)を表示します。 デバイスの OID に関する情報がない場合は、これは数値形式でのみ表示されます。OID に関する説明は MIB にあります。[1] 探査したいデバイスの MIB がない場合、Pandora FMS が表示する情報の中から、複雑で時間がかかる "情報の断片" を探す必要があるかもしれません。

Pandora FMS SNMP ブラウザでは、取得した OID の値と翻訳された OID の値(利用可能な場合)の両方でテキスト文字列を検索できます。既知の特定の文字列を探し、それらの OID を見つける場合に特に役立ちます。複数のエントリが見つかった場合は、1つのエントリから別のものに移動でき、黄色で強調表示されます。

Snmp browser module creator.png

Enterprise 版 バージョン744 から、複数の OID を選択し、"エージェントモジュールの作成(Create agent modules)" をクリックすることによりエージェントに追加することができます。

SNMP1.png

SNMP12.png

また、複数の OID を選択し、"ポリシーモジュール作成(Create policy modules)" ボタンを使うことにより、ポリシーへ追加することもできます。

SNMP21.png

これらの OID のモジュール設定を追加したポリシーをすべて選択します。これらの OID の新たなポリシーを作成したい場合は、"新規ポリシーの作成(Create new policy)" をクリックします。

File:SNMP3.png

名前、グループ、ポリシーの説明のフィールドに入力し、"ポリシーの作成(Create policy)" をクリックします。

すると、ポリシーに画面に反映されます。

この設定をポリシーに適用するには、右側のボックスに追加し、"モジュール追加(Add modules)" をクリックします。

SNMP31.png

SNMP32.png

Pandora FMS Enterprise バージョン 744 からは、特定の OID を選択する場合は、OID の詳細から "エージェントモジュール作成(Create agent module)" ボタンを使用できます。 このボタンをクリックすると、特定のエージェントを選択できるようになり、選択したすべての SNMP データがそのエージェント内のモジュールの作成にリダイレクトされます。

SNMP41.png

SNMP モジュールエディターから、ネットワークモジュールを作成または編集するときは、"SNMPブラウザ(SNMP Browser)" をクリックして SNMP ブラウザーを起動します。ポップアップウィンドウで開きます。

探している OID を選択したら、フィルターアイコンをクリックしてその OID を選択すると、エージェントで使用されるモジュール定義の対応するフィールドに自動的に反映されます。

Snmp browser from module creation.jpg

1.2.7 MIB 管理

MIB をアップロードし、Pandora FMS で管理することができます。新しい MIB を追加したり MIB を削除したりできます。これらの MIB は、Pandora でのみ利用されます。Pandora では、システムの MIB (/usr/share/snmp/mibs にあるもの) も使えます。Pandora FMS での MIB ファイルの保存先は、{PANDORA_CONSOLE}/attachment/mibs です。

New snmp browser mibmanager.png

Pandora の MIB マネージャは、ポーリングの MIB のみ管理し、SNMP trap の MIB に対しては何もしないことに注意してください。trap に関しては、Enterprise 版の Pandora FMS 専用の別のマネージャがあります。

1.2.8 Pandora FMS SNMP ウィザード

エージェント管理画面に、リモートからモジュールを作成するツール、エージェントウィザードがあります。

Agent wizard.png

1.2.8.1 SNMP ウィザード

Agent wizard snmp wizard.png

ホストに snmpwalk するために、対象の IP アドレス、コミュニティ、その他オプションパラメータ (SNMP v3 をサポートしています) を設定する必要があります。

Snmp wizard form.png

データを受信すると、モジュール作成のフォームが表示されます。

Snmp wizard module creator.png

SNMP ウィザードでは、さまざまな種類の SNMP データからモジュールの作成が可能です。

  • デバイス(Devices)
  • プロセス(Processes)
  • ディスク空き容量(Free space on disk)
  • 温度センサ(Temperature sensors)
  • その他 SNMP データ(Other SNMP Data)

モジュールの種類を選択し、左のウインドウから右へ必要なものをもっていきます。終わったら、モジュール作成(Create modules)ボタンをクリックします。

このウィザードは、以下の 2つの種類のモジュールを作成します。

  • 固定の OID をもったデータのための SNMP モジュール (センサー、メモリデータ、CPUデータなど)
  • 動的な OID または計算したデータのためのプラグインモジュール (プロセス、ディスク空き容量、メモリ使用率など)

Template warning.png

すべてのプラグインモジュールでは、SNMP リモートプラグインを利用します。このプラグインがシステムにインストールされていないと、これらの機能は無効になります。プラグインは、 "snmp_remote.pl" という名前である必要があります。置き場所はどこでも構いません。

 


SNMP ウィザードがリモートコンポーネントを使って SNMP デバイスからデータを取得できるようにするには、2つの要件を満たす必要があります。

  - Pandora FMS にデバイス製造元のプライベートエンタープライズ番号(PEN)を登録する。
  - Pandora FMS でデバイス製造元の SNMP ウィザードコンポーネントを登録して有効にする。

スキャンしたデバイスがこれらの要件を満たしている場合、データを取得できた可能性のあるすべてのモジュールが表示され、作成するモジュールと作成しないモジュールを選択できます。

これらのモジュールは、それらを生成したウィザードコンポーネントが属するグループに基づいて、ブロックで表示されます。

すべてのブロックは、参照を容易にするために、最初は圧縮されて表示されます。そうすることで、選択範囲やデータを変更するように拡張できます。さらに、モジュールが作成対象としてマークされている各ブロックでは、これを示す情報アイコンが表示されます。

IMG8 wizard components.png

ブロックをデプロイする場合、追加するモジュールと追加しないモジュールを選択できます。また、各モジュールの名前、説明、またはしきい値を個別に変更するオプションも選択できます。

IMG9 wizard components.png

モジュールの作成(Create modules) をクリックすると、選択したモジュールとその設定の概要一覧が表示されます。この一覧には、エージェントにすでに存在するか、同じ名前で 2つ以上のモジュールがウィザード自体で設定されていることで作成できなかったモジュールが表示されます。

すべての変更を行ったあと、それらがエージェントに追加される前に、それらのモジュールの作成を確認するか、それをキャンセルしてウィザードの結果を変更し続けるかの最後の選択があります。

IMG10 wizard components.png


モジュールの作成が確認されると、確認している間に同じモジュールが別の方法で作成された場合にモジュールが重複しないように、作成できるかどうか 1つずつ再評価されます。

プロセスが正常に完了したか、作成できなかったモジュールがあるかどうかが通知されます。

1.2.8.2 SNMP インタフェースウィザード

Agent wizard snmp interfaces wizard.png

エージェントウィザードにおいては、インタフェースのブラウズのための作成された SNMP ウィザードがあります。

このウィザードは、SNMP の IF-MIB::interfaces ブランチをブラウズし、さまざまなインタフェースを複数選択し、複数のモジュールの作成を可能にします。

SNMP ウィザードのように、対象の IP やコミュニティなどを選択してから行います。システムは、対象ホストに対して SNMP クエリを実施し、モジュール作成フォームを表示します。

これを利用することにより、左側のウインドウから一つもしくは複数のインタフェースを選択することができます。そして、右側には共通の要素 (説明、速度、In/Outトラフィックなど) が表示されます。この画面から複数の要素を選択し、モジュール作成をクリックすることにより、左側の画面で選択したインタフェースのモジュールが作成されます。

Agent wizard snmp interfaces creation.png

SNMP インターフェイスウィザードが SNMP デバイスからデータを取得するには、1つの要件を満たす必要があります。

  - SNMP デバイスは、IF-MIB ブランチのデータを返す。

この要件が満たされている場合、監視に追加するモジュールをデバイスのネットワークインターフェイスごとに選択できます。

追加可能なモジュールを備えた、デバイスで選択したすべてのインターフェースの概要を示す設定ブロックが表示されます。このブロックで選択されたモジュールとそのしきい値は、ネットワークインターフェイスに行われるデフォルト設定になります。 インターフェイスに一般的な監視を追加しないように、このブロックを無効にすることができます。

IMG11 wizard components.png

また、ネットワークインターフェースごとに特定のブロックがあり、監視するインターフェースを選択できます。さらに、前のブロックで一般的な監視が設定されている場合、チェックされたすべてのインターフェイスがそれらの設定を使用します。

IMG12 wizard components.png

各インターフェイスブロックでは、インターフェイスの特定の設定を指定することもできます。つまり、一般的な監視ブロックに含まれていない特定のモジュールを追加したり、特定のケースでそれらの設定を別の設定で上書きしたりできます。 特定のケースごとにモジュールの名前と説明を変更することもできます。特定の設定が有効になるように、インターフェイスブロックを監視対象としてマークする必要があります。

IMG13 wizard components.png

すべてのブロックは、参照を容易にするために、最初は圧縮されて表示されます。選択やデータを変更するために展開できます。 さらに、モジュールが作成対象としてマークされている各ブロックには、それを示す情報アイコンが表示されます。

モジュールの作成(Create modules) をクリックすると、選択したモジュールとその設定の概要一覧が表示されます。この一覧には、エージェントにすでに存在するか、ウィザードで同じ名前のモジュールが 2つ以上構成されているために作成できないモジュールが表示されます。

すべての変更を行ったのち、それらがエージェントに追加される前に、それらのモジュールの作成を確認するか、それをキャンセルしてウィザードの結果を変更し続けるかを最後に選択します。

IMG14 wizard components.png

モジュールの作成が確認されると、モジュールが 1つずつ再評価され、作成できるかどうかが確認されます。確認時間内に同じモジュールが別の方法で作成された場合にモジュールが重複しないようにします。

プロセスが正常に完了したか、作成できなかったモジュールがあるかどうかが通知されます。

1.2.9 ネットワークモジュールの共通拡張機能

以下の画面では、ネットワークモジュールの拡張機能を表示しています。


Cap5 snmp 8.png


説明(Description) モジュールの説明です。デフォルトの説明は変更できます。

カスタムID(Custom ID)

エージェントの情報と共にサーバがメッセージを送信する場合に必要なカスタムIDです。また、Pandora FMS と構成データベースなど外部のデータを統合するのに利用できます。

間隔(Interval)

モジュールの実行間隔です。エージェントとは異なります。

表示される値は、"設定 > 画面設定(Visual Styles)" の "間隔値" の設定に依存します。

管理者ユーザは、モジュール作成または編集時にカスタム間隔を設定することができます。通常のユーザは、あらかじめ定義された間隔のみです。画面設定(Visual Styles)で定義されていない場合は、デフォルトが表示されます。

保存倍率(Post process)

モジュールの事後処理です。モジュールの値に掛け算や割り算を行うのに便利です。例えば、バイト単位のデータをメガバイトで表示したい場合などです。

最小値(Min. Value)

モジュールの最小値です。これより小さな数値は、不正とみなして破棄されます。

最大値(Max. Value)

モジュールの最大値です。これより大きな数値は、不正とみなして破棄されます。

エクスポートターゲット(Export target)

モジュールから返される値をエクスポートサーバへ渡すのに便利です。Pandora FMS Enterprise版にのみにあり、エクスポートサーバを事前に設定する必要があります。詳細はエクスポートサーバの説明を参照してください。

Cron

Cron 開始(Cron from) が設定されているとモジュールの実行間隔は無視され、モジュールは Cron 開始(Cron from) で指定した日時に実行されます。例えば、次の設定ではモジュールは毎週月曜 6:30 に実行されます。

Cron from ex1.png

Cron 開始(Cron from)Cron 終了(Cron to) の両方が設定されていると、モジュールは、Cron 開始(Cron from)Cron 終了(Cron to) の間の時間に 一度実行されます。例えば、次の設定では、毎日 6時と 7時の間に実行されます。

Cron from ex2.png

ローカルモジュールでは、エージェント設定ファイルに module_crontab を設定することで対応します。 詳細は、指定時間モニタリング を参照してください。

カテゴリ(Category)

この分類は、通常のユーザーインターフェイスには影響を与えません。メタコンソールと共に使用することを意図したものです。

1.3 WMI でのリモート Windows モニタリング

WMI は、Windows OS を実行するコンピュータのリモート情報取得用のマイクロシステムであり、Windows XP 以降のバージョンで利用できます。 WMI を使用すると、OS、アプリケーション、さらにはハードウェアのすべての種類の情報を取得できます。 WMI クエリは、ローカルでの実行(実際には、Pandora のエージェントは内部的にオペレーティングシステムの API を呼び出し WMI サブシステムに問い合わせます)または、リモートで実行することができます。 一部のシステムでは、WMI へのリモートアクセスは有効になっておらず、外部からの利用のためには有効にする必要があります。

Pandora FMS は、WMI クエリによって Windows をリモート監視することができます。そのためには、Pandora FMS サーバの設定ファイルにて wmiserver を有効化する必要があります。

# wmiserver : '1' or '0'. Set to '1' to activate the WMI server in this setup.
# DISABLED BY DEFAULT
  wmiserver 1

クエリは、オペレーティングシステムへの内部クエリ用の Microsoft 固有の SQL 言語の一種である WQL で行われ、WMI システムデータベースに表示されるクエリはすべて作成できます。

WMI を通してモニタリングを開始するには、サービスをモニタするための対応するエージェントを作成し、モジュールタブをクリックします。そこで、新たな WMI モジュールの作成を選択し、作成 ボタンをクリックします。

Feo.jpg

いくつかのフィールドは WMI 特有のもので、短い表記を使います。

名前空間(Namespace)

WMI のネームスペースを設定します。いくつかのクエリにおいて、このフィールドが空でなければ (デフォルト)、アプリケーションに依存した情報がモニタされます。

ユーザ名(Username)

administrator もしくは、リモートから WMI クエリを実行する権限があるユーザ名を設定します。

パスワード(Password)

administrator もしくは指定したユーザのパスワードを設定します。

WMI クエリ(WMI Query)

WMI クエリは SQL に似ています。以下に例を示します。

SELECT LoadPercentage from Win32_Processor WHERE DeviceID = "CPU0"
SELECT SerialNumber FROM Win32_OperatingSystem
SELECT AvailableBytes from Win32_PerfRawData_PerfOS_Memory
SELECT DiskWriteBytesPersec from Win32_PerfRawData_PerfDisk_PhysicalDisk WHERE name = "_Total"

Key 文字列(Key string)

クエリにより返された文字列を比較するためのオプションです。結果は文字列ではなく、存在すれば 1、そうでなければ 0 で返ります。

フィールド番号(Field number)

返されるフィールドの数です。0 から開始する数字です (WMI クエリは、1つ以上のフィールドを返します)。ほとんどの場合は、0 か 1 です。

Campos.jpg

正しいパラメータがわからない場合は、Pandora FMS データベースに設定されインストール済のものを選択することもできます。それには、WMI モジュールコンポーネントを選択してください。

Galleta.jpg

その後、可能な WMI チェックを選択します。

Galletita.jpg

ユーザ名とパスワード以外の必要な情報が自動的に入力されます。アドミニストレータ権限のユーザとパスワードが必要であることを忘れないでください。そうでないとモジュールは値を取得できません。

Otro.jpg

Pandora FMS Enterprise 版には、Windows 用の 400 以上の WMI リモート監視モジュールがあります。これらは、以下のデバイスやコンポーネント用です。

  • Active Directory
  • BIOS
  • System Information
  • Windows Information
  • Printers
  • MSTDC
  • IIS
  • LDAP
  • Microsoft Exchange

1.4 WMI ウィザード

エージェントウィザード(エージェントの管理画面のタブ)に、WMI ウィザードがあります。指定のエージェントにおいて WMI クエリでモジュールを参照したり作成したりするのに利用します。

Agent wizard wmi wizard.png

最初の WMI クエリを作成するために、対象ホストの administrator ユーザ(もしくは WMI クエリの実行権限のあるユーザ)とパスワードを指定する必要があります。このデータは、WMI モジュールの作成に利用されます。

Wmi wizard module creator.png

WMI ウィザードでは、次のようなさまざまな種類の WMI データからモジュールを作成することができます。

  • Services: サービスが稼働中であれば正常、停止していれば障害状態となる、ブーリアンの監視を作成します
  • Processes: プロセスが稼動中のときにデータを受け取ります。そうでなければ不明状態になります。
  • Free space on disk: ハードディスクの空き容量。
  • WMI components: この場合、システムに登録された WMI コンポーネントを選択します。(管理 -> モジュール管理 -> ネットワークコンポーネント)

1.5 サーバプラグインを使ったモニタリング

このタイプの監視は、Pandora FMS サーバからリモートでプラグインを実行して行います。いくつかのプラグインが利用可能な状態でデフォルトでインストールされています。また、必要なものを追加することもできます。

リモートプラグインはスクリプトまたは実行形式のファイルで、パラメータに応じて値を返します。プラグインを使用すると、開発したアプリケーションのように、任意のタイプの監視を自分で実装し、いくつかの入力パラメータを使用してカスタマイズすることができます。例えば、監視対象の IP をパラメータとして渡すことができます。結果は数値、ブーリアン値(0:障害、0より大きい:正常)であったり、文字列です。リモートプラグインの唯一の制限は、単一の値のみ返せるということです。

Pandora FMS にプラグインを登録するためには、コンソールの管理メニューへ行き、サーバの管理をクリックします。そして、プラグイン管理(Manage plugins) をクリックします。

Verdecito1.jpg

Verdecito2.jpg

この我慢では、いくつかのプラグインがすでに登録されているのがわかります。ここで、あなたのプラグインを登録することができます。それがどのように動くかを説明するために、すでに登録済のプラグインを見てみましょう。リモートマシンに対して UDP の接続を監視する "UDP Plugin" というプラグインをクリックします。

Plugin create 1.jpg

プラグインタイプ (Plugin type)

プラグインには、標準と Nagios の二種類があります。標準プラグインは、パラメータを受け取って処理を実行する通常のスクリプトです。Nagios プラグインは、その名が示す通り Nagios のプラグインで、Pandora FMS から実行することができます。主な違いは、Nagios プラグインは、テストが成功したかどうかをエラーレベルの戻り値で示し、追加情報を文字列で返す点です。文字列は数値データではありませんがモジュールの値として利用できます。この場合、モジュールの説明に入ります。

この場合(例の UDP ポートチェックプラグイン)は、Nagios プラグインではないので、通常のプラグインを選択します。

最大タイムアウト (Max. timeout)

プラグインのタイムアウト値です。ここで指定した時間内に応答を得られなければ、モジュールは不明状態となり、データが更新されません。これは、プラグインでのモニタリングを実装する上で重要な要素です。プラグインの実行時間がこれより長い場合、全く値を取得できないことになります。この値は、プラグインとして実行するスクリプトが値を得るのにかかる時間より長い時間に設定する必要があります。何も設定しない場合、設定ファイルの plugin_timeout の値が利用されます。

Info.png

プラグインの実行には、サーバ、プラグイン、モジュールの 3つのタイムアウトがあります。サーバの設定が他よりも優先されます。二番目にプラグインです。サーバでのタイムアウト設定を 10秒、プラグインを 20秒、そしてモジュールの設定を 30秒としている場合、モジュールの実行タイムアウト時間は最短の 10秒になります。

 


この例では、15 を設定しています。

説明(Description)

プラグインの説明です。Check a remote UDP port (by using NMAP) のように、簡単な説明を書きます (日本語も入力可能です)。IP アドレスとポートオプションを使用します。 説明は、プラグインのユーザーインターフェースに表示されるものなので、そのプラグインが何であるかの説明を記載してください。

Plugin create 2.jpg

プラグインコマンド(Plug-in command)

プラグインコマンドのパスです。標準のインストールでのデフォルトでは、/usr/share/pandora_server/util/plugin/ です。任意のパスを設定できます。このでの例では、/usr/share/pandora_server/util/plugin/udp_nmap_plugin.sh を入力しています。独自のプラグインを利用する場合は、どこにプラグインを置いたかを確認し、実行権限(chmod 755)がついていることを確認してください。

プラグインパラメータ(Plug-in parameters)

コマンドのパラメータは、コマンドの後にスペース区切りで指定するものです。このパラメータには、_field1_ _field2_ ... _fieldN_ といったマクロが利用できます。これは、プラグインの操作の中で最も複雑な部分ですが、パニックにならないようにしてください。以降の例でも説明します。

パラメータマクロ(Parameters macro)'

プラグインパラメータフィールドには、マクロを制限なく利用することができます。これらのマクロは、ユーザがプラグインモジュールを簡単に使用できるように、モジュール設定のテキストフィールドとして表示されます。 それは、プラグインが内部ではどういう動きをするかの詳細を知らなくても、ライブラリのようにフィールドを入力するだけでユーザが利用できるようにするものです。 マクロの定義によって、スクリプトの動作やスクリプトの呼び出し方法などを知らなくても、呼び出しパラメータを設定することができます。

それぞれのマクロには、次の 3つのフィールドがあります。

  • 説明(Description): マクロの簡単な説明です。フィールドのラベルになります。
  • デフォルト値(Default value): デフォルトでフィールドに割り当てられる値です。
  • ヘルプ(Help): マクロの説明です。フィールドの設定例などを記載するとよいでしょう。

マクロ設定の例:

Macro configuration.png

モジュールエディタでのマクロの例:

Macro editor.png

1.5.1 内部マクロ

アラートのように、プラグインの設定にも内部マクロを使うことができます。

利用可能なマクロは次の通りです。

  • _agent_ または _agentalias_: モジュールが属するエージェントの別名。
  • _agentname_: モジュールが属するエージェント名。
  • _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_: モジュールタグに関連付けられたメールアドレス。

1.5.2 リモートプラグインの内部

UDP プラグインのコードは、とてもシンプルで全体がどのように動作するのかの説明に適しています。

#!/bin/bash
# This is called like -p xxx -t xxxx
HOST=$4
PORT=$2
nmap -T5 -p $PORT -sU $HOST | grep open | wc -l

この Linux プラグインは、2つのパラメータを使います。対象の UDP ポート番号とアドレスで、-p および -sU オプションで指定します。プラグインを登録するときに 2つのマクロを定義します。一つはポート番号でもう一つは IP です。そのため、ユーザーがプラグインモジュールを作成するときには、それ以外のものは表示されません。

プラグインを登録したらそれをエージェントで使うために、モジュールタブをクリックしてプラグインサーバモジュールを作成します。そこで新たなネットワークモジュールの作成を選択し、作成(Create) ボタンをクリックします。

Trescientos1.jpg

以下のフォームで、未定義の部分を設定します。generic numeric 等のモジュールの種類を選択し、 モニタ対象の IP アドレスやポート番号を設定します。

Example1 edition module.png

設定が終わったら、作成 (Create) をクリックします。

以下の画面で、エージェントに作成した "UDP Port check" モジュールが表示されているのがわかります。

Udp port check demo.jpg

1.5.3 例 1: MySQL のプラグインモジュール

プラグイン実装の一例をあげます。ここで紹介するのは、デフォルトでは Pandora に無い、MYSQL をチェックするプラグインです。

次の設定にて、MySQL のプラグインモジュールを作成します (システム管理メニュー(Administration)から、サーバ管理(Manage servers) -> プラグイン管理(Manage plugins) を実行)。

  • 名前: MySQL
  • プラグインタイプ: Standard
  • 最大タイムアウト: 10秒
  • 説明:MySQL check plugin

チェック内容:

このプラグインは、4つのチェックを行います。

Connections: 接続 Com_select: 開始からの select クエリ数 Com_update: 開始からの update クエリ数 Innodb_rows_read: Innodb ファイル読み出し

  • プラグインコマンド(Plugin command): /usr/share/pandora_server/util/plugin/mysql_plugin.sh
  • プラグインパラメータ(Plugin parameters): -s _field1_ -u _field2_ -p _field3_ -q _field4_
  • マクロ(Macro) _field1_:
    • 説明(Description): IP Address
    • デフォルト値(Default value): X.X.X.X
  • マクロ(Macro) _field1_:
    • 説明(Description): User
    • デフォルト値(Default value): User
  • マクロ(Macro) _field1_:
    • 説明(Description): Password
    • デフォルト値(Default value): Password
  • マクロ(Macro) _field1_:
    • 説明(Description): Check
    • デフォルト値(Default value): Connections
    • ヘルプ(Help): Possible values: Connections/Com_select/Com_update/Innodb_rows_read


画面は次のようになります。

Plugin mysql1.png
Plugin mysql2.png
Plugin mysql3.png
Plugin mysql4.png

このプラグインは、4つのチェックを行います。

  • -q Connections: 接続
  • -q Com_select: 開始時点からの select クエリ数
  • -q Com_update: 開始時点からの update クエリ数
  • -q Innodb_rows_read: Innodb のファイルリード数

上記プラグインを使って、Pandora FMS がインストールされているシステムのエージェントにモジュールを作成してみます。名前は、Mysql Connections 等で、localhost において、Pandora データベースの pandora ユーザとそのパスワードで自身のデータベースをチェックします。プラグインパラメータ(Plugin parameters)には、-q Connections を設定しています。

作成後、モジュールは次のようになります。

Plugin mysql module.png
Mysql module2.png

作成すると、プラグインモジュールとしてモジュール一覧に表示されます。(この場合、初期化待ち)

Fosforo3.jpg

1.5.4 例2: SMTP サーバリモートプラグイン

このプラグインは、リモートサーバを使ってメールを送信します。サーバの IP、ポート番号、ユーザ名、パスワードと、認証方式を指定し、また、メールの送信先を指定できます。動作していれば 1 を返し、そうでなければ 0 を返します。タイプは、generic_proc を利用します。

このプラグインを利用したモジュール設定の画面を以下に示します。

Pandora plugin SMTP5.png
Smtp module2.png

1.5.5 例3: DNS サーバリモートプラグイン

このプラグインは、外部 DNS を参照して、指定したドメイン (artica.es など) の IP アドレスが変化していないかどうかをチェックします。これにより、不正なバランシングや DNS アタックなどがなく、ドメインが正しい IP を返しているかどうかを検証できます。正常であれば 1 を返し、そうでなければ 0 を返します。タイプは、generic_proc を利用します。

このプラグインを利用したモジュール設定の画面を以下に示します。

Pandora plugin DNS5.png
Dns module2.png

1.6 リモート監視のためのカスタムフィールドマクロ

リモートモジュールを設定するとき、エージェント特有の設定オプションを何度も入力しなければならないことは面倒です(例えば、SNMP コミュニティ文字列)。カスタムフィールドマクロを使うと、特定のモジュール設定オプションのマクロとして エージェントカスタムフィールド を使うことができます。

以下の例では、コミュニティ文字列が異なる SNMP エージェント間で再利用できる SNMP ネットワークコンポーネントを作成します。

  • 最初に、Pandora FMS コンソールで リソース/カスタムフィールド(Resources/Custom fields) へ行き、SNMP コミュニティ文字列を保存するのに利用する新たなカスタムフィールドを定義します。ID は後でマクロの一部になるため、その ID を書き留めて、SNMP エージェントの適切なコミュニティ文字列を入力します。
Snmp custom field.png
  • そして、新たな SNMP ネットワークコンポーネントを作成します。SNMP コミュニティ文字列として、_agentcustomfield_n_ を入力します。ここで、n は、カスタムフィールドの ID です(今回の例では、_agentcustomfield_11_)。
Custom field network component.png

カスタムフィールドマクロは、SNMP, WMI, プラグインおよび、インベントリモジュールで利用できます。これらは、単一のモジュール、ネットワークコンポーネント、ポリシーモジュールで利用できます。

WMI モジュールでは、ユーザ名とパスワードを格納するために 2つの新しいカスタムフィールドを同様に定義し、モジュール定義で対応するカスタムフィールドマクロを使用できます。

Wmi custom field.png

1.7 リモートウィザードとネットワーク監視実行 (Exec Server)

この機能は、Pandora コンソールから Pandora リモートサーバでのアクションの実行をするものです。そのため、SNMP エージェントのウィザード、MIBブラウザ、およびリモートサーバからの「イベント応答」の使用を許可し、コンソールがあるサーバからのアクセスも許可する必要があります。

内部的には、"Exec Server" と呼ばれるもので、有効化されたサーバに対して Pandora コンソールから SSH でのリモートコマンド実行を通して動作します。リモートサーバは、Pandora またはサテライトサーバで、Linux である必要があります。

1.7.1 設定

この機能を正しく使用するためには、対象エージェントがすでに作成済である必要があり、サテライトサーバ利用時は、リモート設定が有効になっている必要があります。

Template warning.png

リモート設定が有効になってない場合、サテライトモジュールはウィザードで作成されません。

 


Exec Server を正しく設定するためには、次のステップで設定を行う必要があります。

1. Pandora FMS のサーバ一覧で、exec server として利用したいサーバへアクセスする必要があります。

Exec-server-111.JPG

2. 指定したコマンドを実行するサーバの IP を編集し、"Exec Server" の検証を有効化します。"ポート(Port)" オプションを使うことによって、サーバへ SSH 接続する際に利用するポートを指定できます。このオプションは、ネットワークサーバまたはサテライトサーバで設定できます。

3. システムの設定が完了しておらずエラーメッセージが表示されるため、テスト設定は実行しないようにします。

Server 222 2.png

4. Pandoraコンソールが動作するサーバーを有効にして、"apache" または同等のユーザーがシェルを実行できるようにします。 /etc/passwd ファイルを修正し、ユーザーが有効なシェルを持つように行を変更します。たとえば、次のようになります。

apache:x:48:48:Apache:/var/www:/bin/bash

5. "/var/www" に ".ssh" ディレクトリを作成し、"apache" ユーザがアクセス可能なパーミッションにします。

mkdir /var/www/.ssh
chown apache /var/www/.ssh

6. root で以下を実行します。

su apache

7. リモートマシンへの接続のための SSH キーを生成します。次のコマンドを実行します。

ssh-keygen 

いくつか質問が表示されるので、そのままエンターを押します。

Exec-server-3.jpg

8. SSH で "Exec server" (Pandora サーバまたはサテライトサーバ)へアクセスする前に、そのマシン上に "pandora_exec_proxy" という特定のユーザを作成し、"/home/pandora_exec_proxy/.ssh/" ディレクトリを作成します。

sudo useradd pandora_exec_proxy -m
mkdir /home/pandora_exec_proxy/.ssh/

注意: ユーザにはパスワードが無いため、リモートからの接続には利用できません。

9. 前のステップで作成した公開鍵の内容を、Pandora コンソールから "exec server" にコピーします。これには、Pandora コンソールの /var/www/.ssh/id_rsa.pub の内容をコピーし、exec server の /home/pandora_exec_proxy/.ssh/authorized_keys にペーストします。その後、ファイルのパーミッションを調整します。

chown -R pandora_exec_proxy /home/pandora_exec/.ssh/

10. ユーザを作成したら、コンソールを実行しているマシンから "apache" ユーザで、パスワードなしでリモートにログインできるか確認するために次のコマンドを手動で実行します。(前の手順で設定した Exec server のホスト名/ IPを利用)

 ssh [email protected]_address

11. すべてのステップを正しく実行したら、apache ユーザを元の状態(ログインシェル無し)に戻すために /etc/passwd ファイルを編集します。

apache:x:48:48:Apache:/var/www:/sbin/nologin

12. 最後に、Pandora コンソール内のプロキシサーバの編集セクションで設定をテストをすれば、テストインジケータが緑色に変わり、完全に動作し機能します。

Exec-server-4.png

1.7.2 exec server 機能の利用

MIB ブラウザー、エージェントの SNMP ウィザード、およびイベント応答で、ローカルコンソールまたは設定済みの Exec server のどちらから要求を開始するかを選択できます。

Exec-server-555.JPG

また、WMI ウィザード、SNMP インターフェイス、SNMP エージェントのウィザード(サテライトサーバーでは使用できません)からも同様です。

Exec-server-666.JPG

ウィザードを起動したときに選択したサーバに依存して、サテライトサーバまたはサーバに関連付けられたモジュールが作成されます。サテライトサーバーの場合は、サーバーで実行できるようにリモート構成ファイルにモジュールを書き込みます。

"イベント応答" の実行には、最初に新たな exec server を利用する新たなイベント応答の設定を行う必要があります。

Exec-server-777.JPG

そしてイベントからそれを起動します。

Exec-server-8.JPG

1.8 パス監視

Pandora FMS は、ネットワークの 2つのポイント間の完全なルート監視をデフォルトで提供し、これらの 2つのポイント間の通信パスを視覚的に示します。

このシステムを利用するには以下が必要です。

  • 分析したいルートの発信元となるポイント上にソフトウエアエージェント
  • 発信元ポイントからの ICMP による宛先までの到達性

Pandora FMS パス解析は、ルートのマップ生成にエージェントプラグインを利用します。このエージェントプラグインは、情報収集し構造化した情報を Pandora サーバへレポートするためいくつかの手法を利用します。

注意: オプションで、インターネット越しにルートをスキャンしたい場合は、発信元となるコンピュータに mtr アプリケーションを入れることをお勧めします。より詳細は以下を参照してください。

https://en.wikipedia.org/wiki/MTR_%28software%29

http://www.bitwizard.nl/mtr/


1.8.1 設定

バージョン 7.0 の OUM715 以降では、プラグインはエージェント内に含まれています。 設定するには、エージェントのリモート設定が有効になったら、Pandora FMS コンソールからプラグインの実行を有効にします。


エージェントのプラグイン設定タブにアクセスし、次の行を追加します(エージェントのバージョンが 7.0 715 より前の場合、またはユーティリティフォルダにプラグインを展開していない場合は、プラグインを実行するための完全パスを指定する必要があります)

route_parser -t target_address

対象のアドレスは、v4 の IP アドレスかまたは FQDN ドメイン名が利用できます。

Route conf2.png

1.8.2 表示

システムを設定しレポートが始まると、エージェント表示画面に新たなタブが表示され、対象との通信が確立されます。

発信元ネットワークからの他のネットワーク上のマシンへのルートビューの例を示します。(LAN 接続)

Route view1.png

8.8.8.8 (Google の DNS)へのルートの例は以下の通りです。(WAN 接続)

Route view2.png