GIS 監視

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

A GIS map is a visual representation of the geographical location of the agents of the Pandora FMS installation. With this map you can observe the current position, as well as a small historical summary of the agents' positions.

GIS マップは、Pandora FMS のエージェントの地理的な場所を視覚的に表現したものです。このマップで、エージェントの現在の位置と、これまでの位置履歴の概要を見ることができます。

The pandora_agent.conf file of the Software agent has parameters to configure the device's positioning:

ソフトウエアエージェント の pandora_agent.conf ファイルには、デバイスの位置を設定するパラメータがあります。

• Longitude.
• Latitude.
• Altitude.
• Item description.

• 経度
• 緯度
• 高度
• 説明

You can also use the gis_exec parameter to indicate the path of a script that returns the device coordinates in a string with the format “latitude, logitude, altitude”.

別途 gis_exec パラメータで、座標を返すスクリプトのパスを指定することもできます。スクリプトは “緯度,経度,高度” というフォーマットの文字列で座標を返す必要があります。

Example:

例:

# Agent position parameters
# Those parameters define the geographical position of the agent

# gis_exec: Call a script that returns a string with "latitude,longitude,altitude"
# i.e.: 41.377,-5.105,2.365

#gis_exec /tmp/gis.sh

# latitude
latitude 40.37346827
# longitude
longitude -3.6418548
# altitude
altitude 637

# Position description
position_description Madrid, Vallecas

The GIS functionalities should be enabled in the server with the parameter activate_gis . When this flag is set to 1, the server will process all GIS information received from the agents.

GIS 機能はサーバの activate_gisパラメータで有効化できます。このフラグを 1 に設定することにより、サーバがエージェントから受け取った GIS 情報を処理するようになります。

With the data positioning there is the possibility of storing agent positions in Pandora FMS, but this data comes from a source that is not completely reliable, and can cause an agent without significant position changes to send location change information. To avoid this, the parameter location_errorsets the distance that is considered as the same position. This is an error tolerance on the position threshold, and as long as the agent's location remains at that threshold it will be considered to be in the same position.

位置情報により Pandora FMS にエージェントの位置を保存することができますが、このデータは完全には信頼できないソースから届くため、大きく移動していないのにエージェントが場所移動の情報を送信する可能性があります。これを避けるために、location_error パラメータに同じ位置であるとみなす距離を設定します。これは閾値によるエラー許容であり、エージェントの位置が閾値内にとどまっていれば同じ位置であると認識します。

Using an inverse geolocation algorithm and a database with IP addresses and positional information, the Discovery server can calculate the position of the discovered agents. This can be done either by using a formatted **MaxMind GeoIP GeoLiteCity** file, or a couple of tables in the database with that information.

逆ジオロケーションアルゴリズム(位置情報からの住所検索)と IP アドレスおよび位置情報のデータベースを利用することにより、自動検出サーバは検出したエージェントの位置を推測することができます。利用のためにはMaxMind GeoIP GeoLiteCity フォーマットか、データベース内の IP アドレスと位置情報のテーブルの組み合わせを利用します。

There are two parameters that define this behavior of the Discovery server: the recon_reverse_geolocation_file , used to point to the file with the reverse geolocation information (using the MaxMind GPL 'GeoLiteCity.dat'), and the parameter recon_location_scatter_radius. The algorithm will calculate an approximated position for the agents and they will be randomly arranged around the calculated positions, taking into account the radius indicated in recon_location_scatter_radius.

自動検出サーバの動作を定義する、2つのパラメータがあります。recon_reverse_geolocation_file は、MaxMind GeoLiteCity.dat を用いた逆ジオロケーションを含むファイルを指定するのに使われます。recon_location_scatter_radius は、検出したエージェントのおおよその位置をアルゴリズムで推測する際、推測位置から recon_location_scatter_radius のパラメータによって定義される半径(メートル単位)の中でランダムに配置するために利用されます。

The reverse geolocation serivce provided by the Google API® and OpenStreetMaps® (OSM) can also be used.

また、Google API® および OpenStreetMaps® により提供される位置情報変換 (リバースジオロケーション) サービスを利用することもできます。

• Google® reverse geolocation can be enabled by setting the parameter google_maps_description, to 1.
• You can activate the reverse geolocation of OpenstreetMaps® by setting the parameter openstreetmaps_description, to 1.
• This functionality decreases the performance of the Pandora FMS server.
• Internet access is required to use Google® or OpenstreetMaps® API and that, of course, this functionality depends on the availability of the providers of these services.
• Google® のジオロケーションを有効にするには、google_maps_description を 1 に設定します。
• OpenstreetMaps® のリバースジオロケーションを有効にするには、openstreetmaps_description を 1 に設定します。
• この機能は Pandora FMS サーバのパフォーマンスを低下させます 。
• Google® や Openstreet Maps® の API を利用するためにはインターネット接続が必要 であり、もちろん本機能はこれらのサービス提供者の可用性に依存しています。

# Flag to activate GIS (positional information for agents and maps) by default it is deactivated
activate_gis 1

# Radius of the Error in meters to consider two gis locations as the same location.
location_error 10

# Recon reverse geolocation file (databases with the reverse geolocation information using
# MaxMind GPL GeoLiteCity.dat format).
# Comment it to disable the IP geolocation on agent creation.

recon_reverse_geolocation_file /usr/local/share/GeoIP/GeoLiteCity.dat

# Radius (in meters) of the circle in where the agents will be place randomly when found by a recon task
# The center of the cicle is guessed by geolocating the IP address.
recon_location_scatter_radius 1000

# This enables realtime reverse geocoding using Google Maps public API.
# This requires internet access, and could have performance penalties processing GIS
# information due the connection needed to resolve all GIS input.

google_maps_description 1

# This enables realtime reverse geocoding using OpenStreetMaps public API.
# This requires internet access, and could have performance penalties processing GIS
# information due the connection needed to resolve all GIS input.
# You can alter the code to use a local (your own) OpenStreetMaps server.

openstreetmaps_description 1

In the Web console, to use the GIS functionality, it must first be enabled in the main configuration.

コンソールで GIS 機能を利用するには、最初にメインの設定で有効にする必要があります。

Menu Management → Setup → Setup → General Setup → Enable GIS features → Update.

管理(Management) → 設定(Setup) → システム設定(Setup) → 基本設定(General Setup) → GIS 機能の有効化(Enable GIS features) → 更新(Update) へ進みます。

This will make available some new sections of the user interface.

すると、ユーザインタフェースに新たなメニューが追加されます。

In Setup → Setup → GIS map connection you will define the connections that can be used with map servers to provide maps for GIS functionalities.

設定(Setup) → システム設定(Setup) → 利用 GIS マップ(GIS map connection) にて、GIS で利用するマップを提供する地図サーバへの接続を定義する必要があります。

• Group: The group to which the connection belongs. Even if the user who is creating the GIS map connection does not explicitly belong to the ALL group (ALL), you can still assign the ALL group as the group to which the connection belongs.
• Number of zoom levels: The zoom number defined on the map.
• Default zoom level: The default magnification level recommended for the map (which can be redefined on the map) and is the zoom level used when the map is displayed.

• グループ(Group) は所属するグループです。GIS 接続マップを作成しようとしているユーザが明示的に “すべて” グループに属していない場合 でも、接続として"すべて"グループを割り当てることができます。
• 選択可能な拡大率の数(Number of zoom levels) はマップ上に定義される拡大率の数です。
• デフォルト拡大レベル(Default zoom level) はデフォルトのマップのズーム倍率です。(マップ上で再定義できます)

Once the basic parameters are configured, the administrator must select a connection type and, depending on the type, there will be different options.

基本パラメータを設定したら、利用マップのタイプを選択する必要があります。タイプによりオプションが異なります。

The default installation of Pandora FMS has a predefined connection with OpenStreetMap®, so users can directly test and view the GIS functionalities.

Pandora FMS のデフォルトインストール状態では、OpenStreet マップ を利用するようになっています。これを使って直接 GIS 機能を確認することができます。

To use an OpenStreet® map type, the only parameter needed is the URL of the title server:

マップに OpenStreet マップを利用するのに必要なパラメータは タイルサーバの URL のみです。

http://tiles.example.com/${z}/${x}/${y}.png

http://tile.example.com/${z}/${x}/${y}.png

You can consult the official list of servers on OpenStreetMap® web site with instructions on naming and accreditation.

サーバの名前と認定についての説明はOpenStreetMap® の公式サーバ一覧サイトを確認してください。

Pandora FMS also includes the connection to Google Maps®. For this, it is necessary that a valid password is obtained from Google® (see Google Maps API policy) and that it is placed in the corresponding field of the connection definition.

また Pandora FMS は Google Maps® もサポートしています。これを利用するには、正しい パスワード を Google から取得し、接続設定の対応するフィールドに入力する必要があります。(詳細は、Google マップ API ポリシー を参照)

With this password it is possible to define several connections using different types of base maps: Hybrid, Physical or Satelite.

このパスワードで、ベースのマップの種類 (航空写真 、地形 、地図) を設定することができます。

Another type of connection provided is to use a Static Image as a map. To use this type of map, the image must be as EPSG:4326 (WGS84).

ほかには、マップとして静的画像の利用をサポートしています。この種類のマップを利用するには、画像ファイルは、EPSG:4326 である必要があります。

In this case the parameters needed for the map definition are the url of the image, the height and width of the image, and the position limits (longitude and latitude) of the image borders (right, left, top and bottom).

マップの定義に必要なパラメータは、画像の URL 、高さ 、幅 および、マップ画像の境界 (右 、左 、上 、下) の位置情報 (経度 、緯度) です。

Pandora FMS サーバが直接インターネットに接続されていない場所にある場合、オンラインマップサービスを使用することはできません。また、その他の場合においても、ユーザは独自のマップサーバを使用して柔軟性を高めたり、作業を高速化したり、独自のモザイクタイプを定義したい場合があります。

From version 723, it is possible to add connections to WMS (Web Map Service) server, such as GeoServer. For that it is necessary to enter the address where the service is provided and the name or names of the layers to be obtained from it.

バージョン 723 から、GeoServer のような WMS サーバ(Web マップサービス)への接続を追加できるようになりました。それには、サービスが提供されているアドレスを入力し、そこから取得したいレイヤの名前を入力する必要があります。

GeoServer サーバの最小限のインストールと設定は、こちら を参照してください。

マップ接続の最後は、位置情報を持っていないエージェントに対するマップの中心とデフォルトの位置の定義です。それらを定義するには、マップをプレビューし、マップをクリックして、'Change in the Map' セレクタで選択されているパラメータに応じて、このパラメータを設定します。

In this preview map, it is possible to move around using the green arrows at the top left, change the zoom level with icons + or - or use the zoom in option.

このプレビューマップでは、左上の緑色の矢印を使用して移動したり、+ または - アイコンでズームレベルを変更したり、ズームインオプションを使用したりすることができます。

It is also possible to fix the position by entering the values in their corresponding entry cells (the decimal separator is the dot).

入力ボックスに値(小数点はドットです)を入れることによって、位置を設定することもできます。

すべての接続パラメータを設定したら、'保存(Save)' ボタンをクリックすることにより、マップビルダから利用できるように接続を保存できます。

接続の設定を行うと、GIS マップ(GIS Map) で利用することができるようになります。

The menu takes the user to a screen with defined maps, where it is possible to edit a map, view the map, fix the default map or delete a map.

定義済のマップを含む画面が表示されます。ここでは、マップの編集、マップの表示、デフォルトマップの定義、マップの削除ができます。

Sample layer:

サンプルレイヤ:

There is also a button to create new maps (Create button).

新たなマップを作成するボタン(作成(Create) ボタン)もあります。

Once on the map creation page, the first thing to do is to add a map name and a map connection from the ones available. You may add more than one, which will be available later on as base layers (only one of them can be active at once).

マップ作成ページで最初に行うことは、マップ名 の設定と、定義されている 利用マップの指定 (後述するベースのレイヤとして、一つ以上を設定することができますが、同時には一つのみが有効です) です。

When the connection is selected, or if the default connection for the map is changed, the Pandora FMS Console will ask whether you intend to use the default data from the connection for the map. If the answer is 'Accept', the console will fill out or update all positional data with the ones defined in the connection, and the user will just set the default zoom in level. If use of the default values is denied, no changes will be made and the connection will just be added.

利用マップを選択すると (デフォルトのマップを変更すると) 、Pandora FMS コンソールが、利用マップのデフォルトデータを利用したいかどうかを尋ねてきます。それを'受け入れる'と、コンソールは全ての位置データ を利用マップに設定されている値に設定 (更新) します。ユーザは デフォルトの拡大率 のみ設定する必要があります。キャンセルすると、これらのフィールドの変更は行われず、利用マップの設定のみが追加されます。

Layer definition

レイヤ定義

Once the basic map parameters are set, it is time to define the map's layers used to select which elements are shown on the map - except if it is the default map - on which there is no need to define any layer, because it will be used to display the agent's position in the agent view.

基本的なマップのパラメータを設定したら、どのエレメントをマップに表示するかを選択するためのマップのレイヤを定義します。(ただし、デフォルトマップではレイヤを定義する必要がありません。なぜならエージェントビューにおいて、エージェントの位置を表示するのに利用されるためです。)

Each map has one or more layers to display agents. Each layer was designed to display the group agents, a list of agents and/or a group with an agent as a sample. That way, it is easy to define the agents shown on each layer.

それぞれのマップは、エージェントを表示するための 一つ以上のレイヤ を持っています。それぞれのレイヤは、グループに属するエージェント や、エージェント一覧 を表示することができます。これにより、それぞれのレイヤに表示するエージェントの設定は簡単です。

Layers can be defined as visible or hidden and it is possible to:

レイヤは、'表示' または '非表示' を定義できます。

• Choose the group with the selector to add agents.
• Add agents with the cell individually.
• Add a group with only one agents as sample.

• エージェント追加のためにグループを選択します。
• または、エージェントを手動で追加します。
• または、一つのエージェントのみを表現するグループを追加します。

Once the layer is defined (it is not completely saved until the complete map is, by clicking Save map), it will be moved to the left column of defined layers, where it is possible to arrange (move them up or down), delete or edit them again.

レイヤが定義されると(マップの保存 をクリックまで、完全には保存されません)、定義されたレイヤーの左の列に移動し、レイヤの削除、または編集が再度可能になります。 レイヤはマップ全体が保存されるまで完全に保存されません。

Once the map layer definition is complete, it is saved by clicking on the Save Map button (Update Map button in case the map was edited instead).

マップのレイヤ定義が完了したら、マップの保存(Save Map) ボタンにて全てを保存することができます。マップを編集する場合は、マップの更新(Update Map) ボタンが表示されます。

少なくとも一つのマップを定義すると、GIS 機能を使い始めることができます。

GIS マップメニューは、すべての定義済マップを表示します。それぞれマップに定義されたパラメータでマップを表示できます。

The controls for the map include four green arrows on the top left corner which allow to move around on the map. The '+' and '-' icons are intended to increase and decrease the zoom level. There is also a 'zoom bar', designed to directly select the desired zoom level.

左上にマップ操作のための、４つの緑の矢印があります。それぞれの方向の矢印をクリックすることにより、マップを動かすことができます。'+' と '-' は、拡大率を増減させるアイコンです。また、'ズームバー' で直接設定したい拡大率を選択することができます。

マップをドラッグすることによっても、動かすことができます。

マップ上に表示されているエージェントをクリックすると、そのエージェントに関する詳細情報を表示できます。追加情報画面が表示され、エージェントの名前はエージェント表示へのリンクになっています。

The white '+' icon at the right opens the layer's controls. It displays a green box in which it is possible to select the base layer (the connection to the map's server, if there were more than one are defined for that map) and see which layers are visible.

右側の緑の背景に白の '+' をクリックすると、レイヤの操作パネルが開きます。緑色のボックスが表示され、ベースのレイヤ (利用マップが一つ以上定義されている場合) および、表示するレイヤを選択することができます。

There is also a special system-defined layer called Agent Hierarchy. If this layer is visible, it will display some red dashed lines, connecting an agent to its parent element (if both of them are visible).

エージェントの階層(Hierarchy of Agents) と呼ばれる特別なシステム定義レイヤもあります。 このレイヤーが表示されている場合は、赤い点線が表示され、両方が表示されている場合はエージェントがその親要素に接続されます。

マップ上には、エージェントの状態のフィルタオプションがあります。

• 正常(Ok)
• 障害(Critical)
• 警告(Warning)
• その他(Other)

フィルタボタンの隣に、マップの更新間隔を設定する 更新(Refresh) というコンボボックスがあります。マップは、指定した間隔でエージェントを更新するために、http://ja.wikipedia.org/wiki/AJAX AJAX を呼び出します。

The Pandora FMS console agent view also comes with new GIS features. The main view now displays the agent location in terms pf longitude, latitude and altitude.

Pandora FMS コンソールのエージェント表示にもまた GIS 機能があります。メイン画面でエージェントの 経度 、緯度 、高度 を表示します。

トップバーに、エージェントの GISビュー を表示するためのボタンがあります。(GIS が有効な場合)

ここで、デフォルトマップでのエージェントの現在の位置が表示されます。また、エージェントの過去の位置の履歴およびマップ上に位置のパスが表示されます。

マップにおけるそれぞれの位置は、ドット で表現されます(現在の位置は、エージェントアイコンもしくは、エージェントのアイコンが定義されていない場合はグループアイコンで表されます)。ドットをクリックすることによって、その位置にあった時の情報を表示することができます。また、エージェントアイコンをクリックすると、エージェントの現在の情報が表示されます。以下の画像では、Android デバイス向け Pandora FMS エージェントによって通知されたパスを表示しています。

また、エージェントから通知された全ての情報を表形式で表示することができます。位置情報変換 (reverse geolocation) システムにより、Pandora FMS エージェントがいる場所が、国、都市、通りの名前と共に表示されます。

エージェント管理メニューの中に、新たにエージェントの位置を手動で設定する項目があります。また、GIS 機能に関連するいくつかのパラメータがあります。

On the agent manage tab, there is a new switch called Update new GIS data. If this switch is activated, the server will ignore all positional information received from the agent and use the last valid values for it. This is useful in case an agent reports a wrong position or it gets its own fixed place.

エージェント管理 メニューに、新たな GIS データを更新(Update new GIS data) という選択があります。これを無効にすると、エージェントから受け取る位置情報をサーバが無視し、最後に設定された位置を維持するようになります。エージェントが間違った位置情報を送信してくる場合や、位置が固定されている場合に便利です。

デフォルトのマップで、クリックすることによりエージェントの新たな位置を設定することができます。また、位置情報を入力ボックスから入力することもできます。