Pandora:Documentation ja:GIS

提供: Pandora FMS Wiki JP

移動先: 案内, 検索

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

Pandora GIS


A GIS map is a visual representation of the location of the agents inside the Pandora FMS installation. With this map we can see the current position, as well as a small history of the agents positions.

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

To be able to use the GIS maps, you must have configured the agents, the server and the console.

GIS マップを利用できるようにするには、エージェント、サーバ、コンソールの設定が必要です。



The agent now accepts new parameters to send the positional data, so in the agent.conf now there some new parameters for longitude, latitude, altitude and position_description. Other parameter for an alternative way of get the coordinates is in the file now: gis_exec. This parameter has a script path that will return a string with the coordinates in the format "latitude,longitude,altitude".

エージェントは、新たに位置データを送信することができます。agent.conf 内に、経度、緯度、高度および、位置の説明を設定できます。また、gis_exec で別途パラメータを設定するスクリプトを指定することもできます。これには、"緯度,経度,高度" というフォーマットの文字列を返すスクリプトのパスを指定します。

This is one example of use:


# 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 42.70456
# longitude
longitude -3.897187 
# altitude
altitude 600

# Position description
position_description Madrid, centro


The GIS features must also be enabled on the server, for that there is a new flag called activate_gis, when this flag is set to 1 the server will process all the GIS information received from the agents.

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

There is also the new feature of storing agent positions on Pandora FMS by positional data now. This data is coming from a source without high accuracy. It's possible to store a lot of different points very close to each other without an important difference on the position. To avoid this circumstance, the 'location_error' parameter determines the distance which is considered to be the same location. This is an error threshold on the position and all data received from an agent having a position within the distance (in meters) defined within this parameter will be stored as new data received on the same point, until the received position moves out of the defined error distance which triggers the setting of a new location.

位置情報により、Pandora FMS にエージェントの位置を保存することができます。しかし、このデータには高い正確性はありません。重要な違いを考慮することなく、近い位置の多くの異なるデータが保存されます。これを避けるために、location_error パラメータに 同じ 位置であると認識する距離を設定します。これは位置が変わったと認識する閾値です。エージェントから新たに受け取った位置データが、この距離 (メートル単位) 内であれば同じ位置であると認識し、指定した距離よりも離れていれば、位置が変わったと認識します。

Recon server and positional information:


By using a reverse geolocation algorithm and a database, containing the relation of IPs and positional information, the Recon Server is now able to 'guess' the position of the discovered agents. It's able to use a file in MaxMind GeoIP GeoLiteCity format or a couple of tables on the database containing this particular information.

IP アドレスの位置情報データベースとその検索アルゴリズムを利用することにより、自動検出サーバは、検出したエージェントの位置を推測することができます。このために、MaxMind GeoIP GeoLiteCity フォーマットや、データベースのテーブルの組み合わせを利用します。

There is also an entire two parameters which define this particular behavior of the Recon Server. The 'recon_reverse_geolocation_file' is only used to point to the file which contains the reverse geolocation information by using the 'MaxMind GPL GeoLiteCity.dat'. The last parameter is called 'recon_location_scatter_radius' which is used to place the discovered agents randomly around the point defined by the reverse geolocation algorithm and within the range (in meters) defined by the 'recon_location_scatter_radius' parameter.

自動検出サーバの動作を定義する、2つの新たなパラメータがあります。'recon_reverse_geolocation_file' は、'MaxMind GPL GeoLiteCity.dat' を用いた逆ジオロケーションを含むファイルを指し示すのみに使われます。'recon_location_scatter_radius' は、検出したエージェントを、逆ジオロケーションアルゴリズムおよび 'recon_location_scatter_radius' のパラメータによって定義される範囲(メートル単位)に従い、指定された場所の周辺にランダムに配置するために利用されます。

Also you can use the reverse geolocation provided by Google API and Openstreet Maps. You can activate the Google reverse geolocating setting the parameter google_maps_description to 1. You can activate Openstreet Maps reverse geolocating setting the parameter openstreetmaps_description to 1.

また、Google API および Openstreet マップにより提供される位置情報変換 (リバースジオロケーション) を利用することもできます。Google のジオロケーションを有効にするには、google_maps_description を 1 に設定します。Openstreet マップのリバースジオロケーションを有効にするには、openstreetmaps_description を 1に設定します。

Be careful using this feature because it decreases the Pandora FMS server performance, also keep in mind you need direct connection to Internet to use Google API and Openstreet Maps and of course it depens on service provider availability.

この機能を利用する場合は、十分注意してください。なぜなら、Pandora FMS サーバのパフォーマンスを低下させるためです。また、Google API および Openstreet マップを利用するためには、インターネットへ直接接続している必要があることに注意してください。もちろん、それらのサービスが動作している必要もあります

Configuration Example:


# Flag to activate GIS (positional information for agents and maps). It's deactivated by default.
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 containing the reverse geolocation information using
# the '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 which the agents will be place randomly when found by a recon task.
# The center of the cycle is guessed by geolocating the IP.
recon_location_scatter_radius 1000

# This enables real time reverse geocoding using the Google Maps public API.
# This requires internet access and could have performance penalties because of having to process GIS
# information due the connection required to resolve all GIS input.

google_maps_description 1

# This enables real time reverse geocoding using OpenStreetMaps public API.
# This requires internet access and could have performance penalties because of having to process GIS
# information due the connection required to resolve all GIS input.
# You may alter the code to use a local or your own OpenStreetMaps server.

openstreetmaps_description 1

There is a plugin that recalculates agent GIS localization.

エージェントの GIS 位置情報を再計算するプラグインがあります。

Use example:


/usr/share/pandora_server/util/agent_gis_update.pl /etc/pandora/pandora_server.conf

The default path of the plugin is /usr/share/pandora_server/util/agent_gis_update.pl, but you can locate it wherever you want.

プラグインのデフォルトパスは、/usr/share/pandora_server/util/agent_gis_update.pl ですが、任意の場所に配置することができます。

ファイル:Ejemplo GIS.png


Within the Console, the configuration must be activated in the main setup in order to utilize the GIS features.

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

Enable GIS.png

Because of the activation, the following new sections of the user interface are available now:


In Setup -> GIS map connection, the connections that can be used with map servers to provide maps for GIS functionalities must be defined.

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

GIS 利用マップ


The connection comes with several basic parameters:


Connection configuration basic.png

  • A name for the configuration, so it can be recognized when selecting a connection on the map definition screen.
  • 利用マップ名(Connection name) は、マップ設定画面で利用マップを選択する時の名前です。
  • The group that owns the connection, this will be used to filter the connections available on the map builder depending on the ACLs.
  • グループ(group) は、ACL に依存してマップビルダーに出てくる利用マップのフィルタに使います。
  • The number of zoom levels defined on the map.
  • 選択可能な拡大率の数(number of zoom levels) はマップ上で定義します。
  • The default zoom level recommended for the map (this can be redefined on the map) and it's the zoom level used when the map is open.
  • デフォルト拡大レベル(default zoom level) は、必須パラメータで、マップを開いたときの拡大レベルを指定します。(マップ上で再定義できます)

Once the basic parameters are set, the administrator must select a type of connection, and depending on the type there will be different options, so those are the types of connections and their options.


Open Street マップ

The default Pandora FMS installation comes with a predefined connection with OpenStreetMaps so the users are able to directly see and test the GIS features.

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

In order to use an Open Street Maps type of map, the only parameter required is the URL of the title server, as shown on the image below.

マップに、Open Street マップを利用するには、以下に示すように、画像サーバの URL のみをパラメータとして設定する必要があります。

Connection configruation openstreetmaps.png

This can be something like:


Google マップ

Pandora FMS also suport the connection to Google Maps, for this a valid key for the pandora console server must be obtained from Google (see Google Maps API Policy) and placed on the corresponding field of the connection definition.

Pandora FMS はまた、Google マップもサポートしています。これを利用するには、Pandora コンソールで利用する正しい key を Google から取得し、入力フィールドに設定する必要があります。(詳細は、Google マップ API ポリシー を参照)

Connection configruation goole.png

By means of this password, it is possible to define several connections using different base map types, e.g. 'Hybrid', 'Physical' or 'Satellite'.

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


This password might take a couple of minutes to work after having obtained it.




Another type of connection supported is to use a Static Image as a map. To use this kind of map the image must be on a EPSG:4326 projection.

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

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

マップの定義に必要なパラメータは、画像の URL高さ および、マップ画像の位置情報 (経度緯度) と座標 () です。

Connection configruation static image.png

Map Center and Default Position:


The last thing to define for a map connection is the center of the map and the default position for agents without positional data. To define them it's possible to preview the map and click on map to set this parameters, depending on which parameter is selected with the Change in the Map selector.

マップの最後の設定は、マップの 中心 と、位置情報が無いエージェントを配置する デフォルトの位置 です。これらの設定は、マップのプレビューでクリックすることにより行えます。どちらのパラメータを設定するかは、マップ内での変更(Change in the Map) で選択します。

In this preview map it's possible to move around the map using the green arrows on the top left, change the zoom level with the + and - icons or use the magnifier to set the full zoom.

マップのプレビューでは、左上の緑の矢印を使ってマップを移動させることができます。拡大率を変更するには、+ および - アイコンを使います。最大の拡大率にするには、虫めがねアイコンを使います。

Of course it's possible to set the position entering the values on the corresponding input boxes.


Connection configruation set center default.png

Once all the connection parameters are set, it's possible to save the connection to use it on the maps builder clicking on the save button.

利用マップの全ての設定を行ったら、マップビルダーで利用できるように、保存ボタンをクリックして 保存 することができます。

WMS サーバ

Sometimes Pandora FMS server is located somewhere without direct Internet connection, so it is not possible to use an online map service. Some other times, the user might prefer their own map server to achiever higher flexibility, work faster, or define his own mosaic types. From version 7.0 Build 723 onwards, it is possible to add connections to WMS servers (Web Map Service), like GeoServer. To do this, enter the address where the service is provided and the name or names of the layers you wish to get from it.

Pandora FMS サーバが直接インターネットに接続されていない場所にある場合、オンラインマップサービスを使用することはできません。また、その他の場合においても、ユーザは独自のマップサーバを使用して柔軟性を高めたり、作業を高速化したり、独自のモザイクタイプを定義したい場合があります。バージョン 7.0 ビルド 723 から、GeoServer の WMS サーバ(Web マップサービス)への接続を追加できるようになりました。それには、サービスが提供されているアドレスを入力し、そこから取得したいレイヤの名前を入力する必要があります。


For a minimum installation and configuration of a GeoServer server, see this annex.

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


The last thing to define for a map connection is the map's center and the default position for agents without any positional data. In order to define them, it's possible to preview the map and click on the map to set this parameters, depending on which parameter is selected by the 'Change in the Map' selector.

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

Within this preview map, it's possible to move the map around by using the green arrows on the top left, to change the zoom level with the '+' and '-' icons or to use the 'magnifier' to use the full zoom.

プレビューマップでは、左上の緑の矢印を使ってマップを動かし、'+' および '-' で拡大率を変更または '虫眼鏡' で最大の拡大率にすることができます。

It's also possible to set the position by inserting the values into the corresponding input boxes.


Connection configruation set center default.png

Once all connection parameters are set, it's possible to save the connection in order to use it on the map builder by clicking on the 'Save' button.

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

GIS マップ

Once the connections are defined, they may be used to define the maps within the GIS Maps .

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

500 px

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


There is also a button to create new maps.


Template warning.png

The Administrator is required to establish a default map which is going to be used for the agent's view in order to display the agent's position.

Template warning.png


GIS マップの作成

Once in the Map creation page, the first thing to do is to give it a Map Name and Add a Map connection from the ones available (it's possible to add more than one, that will be available later on as base layers... this means only one can be active at the same time). When the connection is selected (or when the default connection for the map is changed) the Pandora FMS console asks if you want to use the default data from the connection for the map, if the answer is Accept, the console will fill (or update) all the positional data (center longitude, center latitude, center altitude, default longitude, default latitude and default altitude) from the ones defined on the connection, and the user will only have to set is the default zoom level'. If the answer is Cancel no changes will be done in those fields and just the connection will be added

マップ作成ページで最初に行うことは、マップ名 の設定と、定義されている 利用マップの指定 (後述するベースのレイヤとして、一つ以上を設定することができますが、同時には一つのみが有効です) です。利用マップを選択すると (デフォルトのマップを変更すると) 、Pandora FMS コンソールが、利用マップのデフォルトデータを利用したいかどうかを尋ねてきます。それを受け入れると、コンソールは全ての位置データ (中心の経度中心の緯度中心の高度デフォルトの経度デフォルトの緯度デフォルトの高度) を利用マップに設定されている値に設定 (更新) します。ユーザは デフォルトの拡大率 のみ設定する必要があります。キャンセルすると、これらのフィールドの変更は行われず、利用マップの設定のみが追加されます。

Gis map builder main.png


Once the basic map parameters are set, it's time to define the layers of the map that will be used to select which elements to show in the map (except if it's the default map that you don't need to define any layer because it will be used to show the agent position on the agent view).


Each map has one or more layers to show the agents. Each layer can show the agents of a group and/or a list of agents. This way it's easy to set up the agents that will be shown on each Layer.

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

The layers can be defined as 'visible' or 'hidden'.

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

ファイル:GIS grupo.png

  • Choose the group with the selector to add their agents.
  • エージェント追加のためにグループを選択します。
  • Or add manually each agent.
  • または、エージェントを手動で追加します。
  • Or add a group with only one agents as its representation.
  • または、一つのエージェントのみを表現するグループを追加します。


Once you have created a group in a layer with its representative agent, you can not generate the same group with another agent.



Once the layer is defined, it will be moved to the left column of defined layers, in which it's possible to arrange, delete or edit them again. The layer is not going to be entirely saved until the whole map is.

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

Once the definition of the layers of the map is completed, it may be saved by clicking on the 'Save Map' button. The 'Update Map' button is only going to be displayed in case of editing any map.

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


Once there is at least a map defined it's possible to start the operation with the GIS features.

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

GIS マップ

The GIS map menu displays all defined maps. Each one can be visualized by displaying the map with the parameters defined in the map.

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 favored zoom level.

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

It's also possible to move around by dragging the map to its favored position.


The agents shown on the map are able to be clicked on in order to display more information about the agent. Once the bubble containing the extra info is displayed, the agent's name consists of a link to the agent's view.


隠す / 表示する / レイヤの選択

The white + on green background on the right, will open the layers controls, if clicked. It displays a green box where it is possible to select the base layer (the connection to the map server, if more than one were defined for the map), and which layers are visible.

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

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

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


Above the map there are filtering options for the state of the agents:


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


Next to the filter buttons there is a combo box tagged Refresh to select the update rate for the map. The Map uses [AJAX] calls to refresh the agents in the map using the selected period.

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


The last two buttons on the top of the map are a link to the GIS Map Builder to edit the Map, and the full screeen button to see the map on full screen.

マップの上にある最後の 2つのボタンは、マップを編集するための、GIS マップビルダー(GIS Map Builder) へのリンクと、マップを全画面表示させるためのボタンです。



The agent view of Pandora FMS console also have new GIS features.

Pandora FMS コンソールのエージェントビューにもまた、新たな GIS 機能があります。

First of all, in the main view now shows the longitude, latitude and altitude of the agent.

まず最初に、メイン画面でエージェントの 経度緯度高度 を表示します。

GIS 履歴表示

There is a new button on the top bar in order to display the agent's GIS view (if GIS is activated).

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

This view displays the agent's current position on the default map. It contains a table which displays the history of the agent's previous positions and a path of them on the map.


Each position on the map is represented by a dot (except the current one which is represented by the agent's icon). It is possible to click on any of these dots in order to get position-related information. It is also possible to click on the agent's icon in order to display the agent's current information. The following information shows the way covered by the Pandora FMS agent for Android devices.

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


You're also able to display a table which contains all the agent's reported information, including a reverse geolocation system which was designed to display the agent's address including the street, city and country in which the Pandora FMS agent is located.

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

ファイル:Pandroid GIS23.png

エージェントの GIS 設定

Among the administration tabs of the agent, there is a new tag to manually set the agent position, and also the agent manage tab has some parameters that affect the GIS features.

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

GIS データの無視

On the agent manage tab there is a new switch called Ignore GIS data. If this switch is activated, the server will ignore all the positional information received from the agent and keep using the last valid values for this agent. This is useful in case an agent is reporting a wrong position or it's desired to place it on a fixed place.

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

ファイル:Agent management icon ignore gis data2.png


This view shows the default map where it is possible to click to set the new position of the agent, or also it is possible to set the position using the input boxes under the map.


ファイル:Pos manual.png

Template warning.png

Defining the agent's position is going to activate the 'Ignore GIS Data' switch in order to avoid the agent's next positional information data package to reset the agent's position again. If this is not the desired behavior, we recommend to deactivate the 'Ignore GIS Data' switch before clicking on the 'Update' button.

Template warning.png

エージェントの位置を設定すると、エージェントから送られてくる位置情報データにより位置がリセットされることを防ぐために、GIS データを無視するオプションが有効になります。そうしたくない場合は、更新ボタンをクリックする前に、GIS データを無視する(Ignora GIS data) オプションを無効にしてください。


This is a collection of interesting links to implement your own tile server, and expand the features of current code.




OS Geo

Geo Server


Blogs (スペイン語のみ)