====== GIS 監視 ======
{{indexmenu_n>20}}
[[ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]
===== Pandora FMS GIS =====
==== 概要 ====
GIS マップは、Pandora FMS のエージェントの場所を視覚的に表現したものです。このマップで、エージェントの現在の位置と、これまでの位置の履歴を見ることができます。
GIS マップを利用できるようにするには、エージェント、サーバ、コンソールの設定が必要です。
==== 設定 ====
=== エージェント設定 ===
[[:ja:documentation:pandorafms:installation:05_configuration_agents|ソフトウエアエージェント]] の ''pandora_agent.conf'' ファイルには、デバイスの位置をするパラメータがあります。
* 経度
* 緯度
* 高度
* 位置の説明
''gis_exec'' で別途パラメータを設定するスクリプトを指定することもできます。これには、"緯度,経度,高度" というフォーマットの文字列を返すスクリプトのパスを指定します。
例:
# Agent position parameters
# Those parameters define the agent's geographical position.
# gis_exec: Calls 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
==== サーバ設定 ====
GIS 機能は、サーバで有効にする必要があります。''[[:ja:documentation:pandorafms:installation:04_configuration#activate_gis|activate_gis]]'' フラグを **1** に設定することにより、サーバが、エージェントから受け取った GIS 情報を処理するようになります。
位置情報により、Pandora FMS にエージェントの位置を保存することができます。しかし、このデータには高い正確性はありません。重要な違いを考慮することなく、近い位置の多くの異なるデータが保存されます。これを避けるために、''[[:ja:documentation:pandorafms:installation:04_configuration#location_error|location_error]]'' パラメータに 同じ位置であると認識する距離を設定します。これは位置が変わったと認識する閾値です。エージェントから新たに受け取った位置データが、この距離 (メートル単位) 内であれば同じ位置であると認識し、指定した距離よりも離れていれば、位置が変わったと認識します。
=== 自動検出サーバと位置情報 ===
IP アドレスの位置情報データベースとその検索アルゴリズムを利用することにより、自動検出サーバは、検出したエージェントの位置を推測することができます。このために、[[http://www.maxmind.com/app/geolitecity|MaxMind GeoIP GeoLiteCity]] フォーマットや、データベースのテーブルの組み合わせを利用します。
自動検出サーバの動作を定義する、2つのパラメータがあります。''[[:ja:documentation:pandorafms:installation:04_configuration#recon_reverse_geolocation_file|recon_reverse_geolocation_file]]'' は、MaxMind ''GeoLiteCity.dat'' を用いた逆ジオロケーションを含むファイルを指し示すのみに使われます。''[[:ja:documentation:pandorafms:installation:04_configuration#recon_location_scatter_radius|recon_location_scatter_radius]]'' は、検出したエージェントを、逆ジオロケーションアルゴリズムおよび ''recon_location_scatter_radius'' のパラメータによって定義される範囲(メートル単位)に従い、指定された場所の周辺にランダムに配置するために利用されます。
また、Google API® および OpenStreetMaps® により提供される位置情報変換 (リバースジオロケーション) を利用することもできます。
* Google® のジオロケーションを有効にするには、''google_maps_description'' を ''1'' に設定します。
* Openstreet Maps® のリバースジオロケーションを有効にするには、''openstreetmaps_description'' を ''1'' に設定します。
* この機能を利用する場合は、十分注意してください。なぜなら、**Pandora FMS サーバのパフォーマンスを低下させる**ためです。
* Google® API および Openstreet Maps® を利用するためには、**インターネットへ直接接続している必要がある**ことに注意してください。もちろん、それらのサービスが動作している必要もあります。
**設定例:**
# 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
=== コンソール設定 ===
コンソールで GIS 機能を利用するには、最初にメインの設定で有効にする必要があります。**セットアップ(Setup) > セットアップ(Setup) > 基本設定(General Setup)** へ行きます。
{{ :wiki:enable_gis.png }}
GIS 機能を有効化し更新をクリックします。すると、ユーザインタフェースに新たなメニューが追加されます。
{{ :wiki:pfms-profiles-manage_users.png }}
**セットアップ(Setup) > 利用 GIS マップ(GIS map connection)** にて、GIS で利用するマップを提供する地図サーバへの接続を定義する必要があります。
== 基本設定 ==
接続はいくつかの基本的なパラメータで設定します。
{{ wiki:Connection_configuration_basic.png?800 }}
* **利用マップ名(Connection name)** は、マップ設定画面で利用マップを選択する時の名前です。
* **グループ(group)** は所属するグループです。**GIS 接続マップを作成しようとしているユーザが明示的に "すべて" グループに属していない場合**でも、接続として[[:ja:documentation:pandorafms:management_and_operation:11_managing_and_administration#すべて_グループ|"すべて"グループ]]を割り当てることができます。
* **選択可能な拡大率の数(number of zoom levels)** はマップ上で定義します。
* **デフォルト拡大レベル(default zoom level)** は、必須パラメータで、マップを開いたときの拡大レベルを指定します。(マップ上で再定義できます)
基本パラメータを設定したら、利用マップのタイプを選択する必要があります。タイプによりオプションが異なります。以下に、それぞれのタイプとオプションを示します。
{{ :wiki:pfms-setup-setup-gis_map_connection-create_new.png }}
== Open Street マップ ==
Pandora FMS のデフォルトインストール状態では、[[http://www.openstreetmap.org/|Open Street マップ]] を利用するようになっています。これを使って直接 GIS 機能を確認することができます。
マップに、Open Street マップを利用するには、以下に示すように、画像サーバの URL のみをパラメータとして設定する必要があります。
{{ :wiki:pfms-setup-setup-gis_map_connection-create_new-openstreetmaps.png }}
例:
http://tiles.example.com/${z}/${x}/${y}.png
http://tile.example.com/${z}/${x}/${y}.png
[[https://wiki.openstreetmap.org/wiki/Tile_servers|OpenStreetMap® の公式サーバ一覧]]サイトを確認し、名前と識別に関して確認し、それに従ってください。
== Google マップ ==
Pandora FMS はまた、Google Maps® もサポートしています。これを利用するには、Pandora コンソールで利用する正しい **password** を Google から取得し、入力フィールドに設定する必要があります。(詳細は、[[http://developers.google.com/maps/documentation/directions/#api_key|Google マップ API ポリシー]] を参照)
{{ :wiki:pfms-setup-setup-gis_map_connection-create_new-google.png?nolink& }}
このパスワードで、ベースのマップの種類 (//航空写真//、//地形//、//地図//) を設定することができます。
このキーは、取得してから利用できるまでに数分かかる場合があります。
== 静的画像 ==
ほかには、マップとして静的画像の利用をサポートしています。この種類のマップを利用するには、画像ファイルは、[[http://en.wikipedia.org/wiki/EPSG:4326|EPSG:4326]] である必要があります。
マップの定義に必要なパラメータは、画像の **URL**、**高さ**、**幅** および、マップ画像の位置情報 (**経度**、**緯度**) と座標 (**右**、**左**、**上**、**下**) です。
{{ :wiki:pfms-setup-setup-gis_map_connection-create_new-static_image.png?nolink& }}
== WMS サーバ ==
Pandora FMS サーバが直接インターネットに接続されていない場所にある場合、オンラインマップサービスを使用することはできません。また、その他の場合においても、ユーザは独自のマップサーバを使用して柔軟性を高めたり、作業を高速化したり、独自のモザイクタイプを定義したい場合があります。
バージョン 723 から、GeoServer のような WMS サーバ(Web マップサービス)への接続を追加できるようになりました。それには、サービスが提供されているアドレスを入力し、そこから取得したいレイヤの名前を入力する必要があります。
{{ :wiki:pfms-setup-setup-gis_map_connection-create_new-wms_server.png?nolink& }}
GeoServer サーバの最小限のインストールと設定は、[[:ja:documentation:pandorafms:technical_annexes:13_geoserver_installation|こちら]] を参照してください。
== マップの中心とデフォルトの位置 ==
マップ接続の最後は、位置情報を持っていないエージェントに対するマップの中心とデフォルトの位置の定義です。それらを定義するには、マップをプレビューし、マップをクリックして、'Change in the Map' セレクタで選択されているパラメータに応じて、このパラメータを設定します。
このプレビューマップでは、左上の緑色の矢印を使用して移動したり、+ または - アイコンでズームレベルを変更したり、ズームインオプションを使用したりすることができます。
入力ボックスに値(小数点はドットです)を入れることによって、位置を設定することもできます。
{{ :wiki:connection_configruation_set_center_default.png?nolink& }}
すべての接続パラメータを設定したら、'保存(Save)' ボタンをクリックすることにより、マップビルダから利用できるように接続を保存できます。
=== GIS マップ ===
接続の設定を行うと、**GIS マップ(GIS Map)** で利用することができるようになります。
{{ :wiki:gis_map_menu.png }}
定義済のマップを含む画面が表示されます。ここでは、マップの編集、マップの表示、デフォルトマップの定義、マップの削除ができます。
サンプルレイヤ:
{{ :wiki:pfms-topology_maps-gis_maps-list_of_gis_maps_sample.png }}
新たなマップを作成するボタン(**作成(Create)**ボタン)もあります。
**デフォルトマップ** を設定します。これは、エージェント表示でその位置を表示するために使用されます。
{{ :wiki:pfms-topology_maps-gis_maps-list_of_gis_maps-default_map.png }}
=== GIS マップの作成 ===
{{ :wiki:gis_map_builder_main.png }}
マップ作成ページで最初に行うことは、**マップ名** の設定と、定義されている **利用マップの指定** (後述するベースのレイヤとして、一つ以上を設定することができますが、同時には一つのみが有効です) です。
{{ :wiki:pfms-topology_maps-gis_maps-builder_map-add_map_connection.png }}
利用マップを選択すると (デフォルトのマップを変更すると) 、Pandora FMS コンソールが、利用マップのデフォルトデータを利用したいかどうかを尋ねてきます。それを'受け入れる'と、コンソールは**全ての位置データ**を利用マップに設定されている値に設定 (更新) します。ユーザは **デフォルトの拡大率** のみ設定する必要があります。キャンセルすると、これらのフィールドの変更は行われず、利用マップの設定のみが追加されます。
**レイヤ定義**{{ :wiki:gis_grupo.png }}
基本的なマップのパラメータを設定したら、どのエレメントをマップに表示するかを選択するためのマップのレイヤを定義します。(ただし、デフォルトマップではレイヤを定義する必要がありません。なぜならエージェントビューにおいて、エージェントの位置を表示するのに利用されるためです。)
それぞれのマップは、エージェントを表示するための **一つ以上のレイヤ** を持っています。それぞれのレイヤは、**グループに属するエージェント** や、**エージェント一覧** を表示することができます。これにより、それぞれのレイヤに表示するエージェントの設定は簡単です。
レイヤは、'表示' または '非表示' を定義できます。
* エージェント追加のためにグループを選択します。
* または、エージェントを手動で追加します。
* または、一つのエージェントのみを表現するグループを追加します。
代表エージェントを持つレイヤにグループを作成したら、他のエージェントで同じグループは生成できません。
レイヤが定義されると(**マップの保存**をクリックまで、完全には保存されません)、定義されたレイヤーの左の列に移動し、レイヤの削除、または編集が再度可能になります。 レイヤはマップ全体が保存されるまで完全に保存されません。
マップのレイヤ定義が完了したら、**マップの保存(Save Map)** ボタンにて全てを保存することができます。マップを編集する場合は、**マップの更新(Update Map)** ボタンが表示されます。
==== 操作 ====
少なくとも一つのマップを定義すると、GIS 機能を使い始めることができます。
=== GIS マップ ===
GIS マップメニューは、すべての定義済マップを表示します。それぞれマップに定義されたパラメータでマップを表示できます。
{{ :wiki:pfms-topology_maps-gis_maps-list_of_gis_maps-setup_gear.png }}
== マップの移動 ==
左上にマップ操作のための、4つの緑の矢印があります。それぞれの方向の矢印をクリックすることにより、マップを動かすことができます。'+' と '-' は、拡大率を増減させるアイコンです。また、'ズームバー' で直接設定したい拡大率を選択することができます。
{{ :wiki:pfms-topology_maps-gis_maps-list_of_gis_maps-control_navigation.png }}
マップをドラッグすることによっても、動かすことができます。
マップ上に表示されているエージェントをクリックすると、そのエージェントに関する詳細情報を表示できます。追加情報画面が表示され、エージェントの名前はエージェント表示へのリンクになっています。
== レイヤ ==
右側の緑の背景に白の '+' をクリックすると、レイヤの操作パネルが開きます。緑色のボックスが表示され、ベースのレイヤ (利用マップが一つ以上定義されている場合) および、表示するレイヤを選択することができます。
{{ :wiki:pfms-topology_maps-gis_maps-list_of_gis_maps-control_layers.png }}
**エージェントの階層(Hierarchy of Agents)** と呼ばれる特別なシステム定義レイヤもあります。 このレイヤーが表示されている場合は、赤い点線が表示され、両方が表示されている場合はエージェントがその親要素に接続されます。
== フィルタ ==
マップ上には、エージェントの状態のフィルタオプションがあります。
* 正常(Ok)
* 障害(Critical)
* 警告(Warning)
* その他(Other)
{{ :wiki:pfms-topology_maps-gis_maps-list_of_gis_maps-filter_status.png }}
== マップの更新 ==
フィルタボタンの隣に、マップの更新間隔を設定する **更新(Refresh)** というコンボボックスがあります。マップは、指定した間隔でエージェントを更新するために、[[http://ja.wikipedia.org/wiki/AJAX AJAX]] を呼び出します。
== 補助ボタン ==
マップの上にある残りの 3つのボタンは次の通りです。
* ビジュアルコンソールへのリンク
* **全画面** マップ表示ボタン
* GIS マップ一覧へのボタン
{{ :wiki:pfms-topology_maps-gis_maps-list_of_gis_maps-link-screen-list.png }}
=== エージェントビュー ===
Pandora FMS コンソールのエージェント表示にもまた GIS 機能があります。メイン画面でエージェントの **経度**、**緯度**、**高度** を表示します。
== GIS 履歴表示 ==
トップバーに、エージェントの **GISビュー** を表示するためのボタンがあります。(GIS が有効な場合)
ここで、デフォルトマップでのエージェントの現在の位置が表示されます。また、エージェントの過去の位置の履歴およびマップ上に位置のパスが表示されます。
マップにおけるそれぞれの位置は、**ドット** で表現されます(現在の位置は、エージェントアイコンもしくは、エージェントのアイコンが定義されていない場合はグループアイコンで表されます)。ドットをクリックすることによって、その位置にあった時の情報を表示することができます。また、エージェントアイコンをクリックすると、エージェントの現在の情報が表示されます。以下の画像では、Android デバイス向け Pandora FMS エージェントによって通知されたパスを表示しています。
{{ wiki:Pandroid_GIS22.png?800 }}
また、エージェントから通知された全ての情報を表形式で表示することができます。位置情報変換 (reverse geolocation) システムにより、Pandora FMS エージェントがいる場所が、国、都市、通りの名前と共に表示されます。
{{ wiki:Pandroid_GIS23.png }}
=== エージェントの GIS 設定 ===
エージェント管理メニューの中に、新たにエージェントの位置を手動で設定する項目があります。また、GIS 機能に関連するいくつかのパラメータがあります。
== GIS データの無視 ==
//エージェント管理// メニューに、//新たな GIS データを更新(Update new GIS data)// という選択があります。これを無効にすると、エージェントから受け取る位置情報をサーバが無視し、最後に設定された位置を維持するようになります。エージェントが間違った位置情報を送信してくる場合や、位置が固定されている場合に便利です。
{{ wiki:Agent_management_icon_ignore_gis_data2.png }}
== エージェントの手動での位置決め ==
デフォルトのマップで、クリックすることによりエージェントの新たな位置を設定することができます。また、位置情報を入力ボックスから入力することもできます。
{{ wiki:Pos_manual.png }}
エージェントの位置を定義すると、[[:ja:documentation:pandorafms:management_and_operation:10_gis#update_gis_data|新たな GIS データを更新(Update new GIS data)]] と逆に**GISデータを無視**オプションが有効になります。このオプションは、エージェントから次の位置情報データが来ても、エージェントの位置情報を再度リセットします。
これが望む動作でない場合は、**更新(Update)** をクリックする前に **GISデータを無視する** オプションを無効にすることをお勧めします。
==== リンク ====
以下に、独自のマップサーバの設定および、現在のコードの機能をより理解するために参考になるリンクを示します。
=== OpenLayers ===
* ウィキページ [[http://en.wikipedia.org/wiki/OpenLayers|OpenLayers]]
* Openlayer ドキュメント [[http://www.naturaldocs.org|Natural Docs]] [http://dev.openlayers.org/docs/files/OpenLayers Openlayers doc]
* Openlayer に関する追加情報 [[http://docs.openlayers.org/library/feature_styling.html|Official documentation about Styles]]
* OpenLayer styles ヘルプ: [[http://trac.openlayers.org/wiki/Styles|OpenLayers Styles]]
* Firebug を使ったデバッグ [[http://openlayers.org/dev/examples/debug.html|Openlayers Debug]]
=== OpenStreetMap ===
* [[http://wiki.openstreetmap.org/wiki/OpenLayers|OpenLayers のサンプル]]
* [[http://wiki.openstreetmap.org/wiki/Using_OpenStreetMap|OpenStreetMap の利用]]
* マップデータダウンロード [[http://planet.openstreetmap.org/|OSM]]
* [[http://wiki.openstreetmap.org/wiki/Osm2pgsql|Osm2qgsql]]
=== OS Geo ===
* [[http://www.osgeo.org/|OSGeo財団(The Open Source Geospatial Foundation) ]]
=== Geo Server ===
* メインウェブサイト [[http://geoserver.org|geoserver.org]]
* [[http://geoserver.org/display/GEOS/Stable|安定版]]
=== PostgreSQL ===
* [[http://www.postgresql.org/docs/8.1/interactive/index.html|PostgreSQL 8.1]] の GIS 拡張ドキュメント
=== Blogs ===
* SIGポータルと地図作成l'UPV [[https://cartosig.webs.upv.es/|CartoSIG]]
* リソース [[https://cartosig.webs.upv.es/recursos/|"Cartographie et SIG"]]