Pandora: Documentation es: Pandora GIS

From Pandora FMS Wiki
Jump to: navigation, search

Volver a Indice de Documentacion Pandora FMS

1 Pandora GIS

1.1 Introducción

Un mapa GIS es una representación visual de la localización geográfica de los agentes de la instalación de Pandora FMS. Con este mapa podemos ver la posición actual, así como un pequeño histórico de posiciones de los agentes.

Para poder utilizar los mapas GIS se debe tener configurados los agentes, el servidor y la consola.

1.2 Instalación

1.2.1 Configuración del Agente

El archivo pandora_agent.conf de los agentes software cuenta con unos parámetros para configurar el posicionamiento del dispositivo: longitud, latitud, altitud y descripción de posición. Puede utilizarse también el parámetro gis_exec, en el que habrá que indicar la ruta de un script que devuelva las coordenadas del dispositivo en una cadena con el formato "latitud,longitud,altitud".

Este es un ejemplo de uso:

# Agent position paramters
# 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

1.2.2 Configuración del Servidor

Las funcionalidades GIS también deben ser habilitadas en el servidor, habilitando el parámetro activate_gis. Cuando este indicador esté fijado en 1, el servidor procesará toda la información GIS recibida de los agentes.

Con el posicionamiento de datos existe la posibilidad de almacenar posiciones del agente en Pandora FMS, pero estos datos provienen de una fuente que no es completamente fiable, y puede provocar que un agente sin cambios de posición significativos envíe información de cambio de localización. Para evitar esto, el parámetro location_error fija la distancia que se considera como la misma posición. Esto es una tolerancia al error en el umbral de la posición, y mientras que la localización del agente se mantenga en ese umbral, no se considerará que ha habido un cambio de posición.

Discovery server e información sobre localización:

Utilizando un algoritmo de geolocalización inverso y una base de datos con la relación de IPs e información de posicionamiento, el Discovery server puede calcular la posición de los agentes descubiertos. Para ello, puede usar un fichero formateado MaxMind GeoIP GeoLiteCity, o un par de tablas en la base de datos con esa información.

Así pues, hay dos parámetros que definen este comportamiento del Discovery server: el recon_reverse_geolocation_file, utilizado para señalar el fichero con la información de la geolocalización inversa, utilizando el formato MaxMind GPL GeoLiteCity.dat, y el parámetro recon_location_scatter_radius. El algoritmo calculará una posición aproximada para los agentes y estos se dispondrán al azar alrededor de las posiciones calculadas, tomando en cuenta el radio indicado en recon_location_scatter_radius.

También puede usarse el servicio de geolocalización inversa que proporciona el API de Google u Openstreet Maps. Puede activar la geolocalización inversa de Google poniendo el parámetro google_maps_description a 1. Puede activar la geolocalización inversa de Openstreet Maps poniendo el parámetro openstreetmaps_description a 1. Tenga mucho cuidado usando esta funcionalidad porque disminuye el rendimiento del servidor de Pandora FMS. Tenga también también en cuenta que necesita acceso a Internet para usar el API Google u Openstreet Maps y que, por supuesto, esta funcionalidad depende de la disponibilidad de los proveedores de estos servicios.

Ejemplo de Configuración:

# 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.
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 connetion needed to resolve all GIS input.

google_maps_description 1

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

openstreetmaps_description 1

Existe un plugin que recalcula la localización GIS de los agentes. La ruta por defecto del plugin es /usr/share/pandora_server/util/agent_gis_update.pl, pero se puede localizar en la carpeta que el usuario prefiera.

Ejemplo de Uso:

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

Ejemplo GIS.png



1.2.3 Configuración de la Consola

En la Consola, para utilizar las funcionalidades GIS, primero deberá estar activado en la configuración principal:



Enable GIS.png



Con esto, algunas secciones nuevas de la interfaz de usuario estarán disponibles.

En Setup -> GIS map connection habrá que definir las conexiones que pueden ser utilizadas con map servers para proporcionar mapas para las funcionalidades GIS.

1.2.3.1 Conexiones GIS

1.2.3.1.1 Configuración Básica

La conexión tiene varios parámetros básicos:



Connection configuration basic.png



  • Un nombre para la configuración, para que pueda ser reconocido cuando se seleccione una conexión en la pantalla de definición del mapa.
  • El grupo al que pertenece la conexión.
  • El número de niveles de zoom definido en el mapa.
  • El nivel de zoom por defecto recomendado para el mapa (que se puede redefinir en el mapa) y es el nivel de zoom utilizado cuando el mapa está desplegado.

Una vez que los parámetros básicos están configurados, el administrador debe seleccionar un tipo de conexión y, dependiendo del tipo, existirán diferentes opciones. Así pues, esos son los tipos de conexiones y sus opciones.

1.2.3.1.2 Mapas OpenStreet

La instalación por defecto de Pandora FMS tiene una conexión predefinida con OpenStreetMap, por lo que los usuarios pueden probar y ver directamente las funcionalidades GIS.

Para usar un tipo de mapa OpenStreet, el único parámetro que se necesita es la URL del title server, tal como se muestra en esta imagen:



Connection configruation openstreetmaps.png



Esto podría ser algo similar a :

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

Pandora FMS también incluye la conexión a Google Maps. Para ello, es necesario que una contraseña válida sea obtenida desde Google (ver Google Maps API policy ) y sea colocada en el campo correspondiente de la definición de la conexión.



Connection configruation goole.png



Con esta contraseña es posible definir varias conexiones utilizando diferentes tipos de mapas base (Hybrid, Physical o Satelite).


Info.png

Es posible que esta clave tarde varios minutos en funcionar tras ser obtenida.

 


1.2.3.1.4 Imagen Estática

Otro tipo de conexión provista es utilizar una Static Image como mapa. Para utilizar este tipo de mapa, la imagen debe estar como EPSG:4326.

En este caso los parámetros que se necesitan para la definición del mapa son url de la imagen, la altura y el ancho de la imagen, y los límites posicionales (longitud y latitud) de los bordes de la imagen (derecha, izquierda, parte superior y parte inferior).



Connection configruation static image.png



1.2.3.1.5 Servidor WMS

En muchas ocasiones, el servidor de Pandora FMS está en un lugar sin acceso directo a Internet, por lo que no es posible usar un servicio online de mapas. En otras, el usuario podría preferir su propio map server para tener mayor flexibilidad, ir más rápido, o definir su propio tipo de mosaicos. Desde la versión 7.0 Build 723 es posible añadir conexiones a servidores WMS (Web Map Service), como GeoServer. Para ello, es necesario introducir la dirección en la que se provee el servicio y el nombre o nombres de las capas que se quieren obtener de él.



Gis-connection-wms-server.png



Puede ver cómo realizar una instalación y configuración mínima de un servidor GeoServer en este anexo técnico.


1.2.3.1.6 Centro del Mapa y Posición por Defecto

Lo último que hay que definir en una conexión de mapa es el centro del mapa y la posición por defecto para agentes sin datos posicionales. Para definirlos, es posible previsualizar el mapa y hacer clic en él para fijar estos parámetros, dependiendo de cuál (Map centre o Default position) se haya seleccionado con el selector Change in the Map.

En este mapa de previsualización es posible desplazarse utilizando las flechas verdes de la parte superior izquierda, cambiar el nivel de zoom con los iconos + y -, o usar la lupa para verlo en zoom completo.

Por supuesto, es posible fijar la posición metiendo los valores en sus celdas de entrada correspondientes.



Connection configruation set center default.png



Una vez que todos los parámetros de conexión hayan sido fijados, será posible guardar la conexión para utilizarla en el configurador de mapas pulsando en el botón de guardar.

1.2.3.2 GIS Maps

Una vez que hayamos definido las conexiones, estas podrán utilizarse para definir mapas en el menú GIS Maps .



Gis map menu.png



El menú lleva al usuario a una pantalla con mapas definidos, donde es posible editar un mapa, visualizar el mapa, fijar el mapa como default o borrar un mapa.

Existe también un botón para crear nuevos mapas.

Template warning.png

Debe establecerse un mapa por defecto, que será el empleado en la vista del agente para mostrar su posición.

 


1.2.3.2.1 Crear un Mapa GIS

Cuando estemos en la página de creación del mapa, lo primero que tenemos que hacer es añadir un Nombre de Mapa y una conexión de Mapa, seleccionando alguna de las que ya están disponibles; es posible añadir más de una, que estará disponible después como capa base (solo una de ellas puede estar activa al mismo tiempo). Cuando se selecciona la conexión (o cuando la conexión por defecto del mapa se cambia) la consola de Pandora FMS le preguntará si quiere usar los datos por defecto de la conexión para el mapa. En caso afirmativo la consola rellenará (o actualizará) todos los datos de posicionamiento con los ya definidos en la conexión, y el usuario tendrá que fijar únicamente el nivel zoom por defecto. Si se rechaza el uso de los valores por defecto, no se realizará ningún cambio y simplemente se añadirá la conexión.



Gis map builder main.png



1.2.3.2.2 Definición de Capa

Cuando los parámetros básicos del mapa hayan sido fijados, será el momento de definir las capas del mapa que se utilizarán para seleccionar qué elementos mostrar en él (excepto si es el mapa por defecto, donde no necesitará definir ninguna capa porque se utilizará para mostrar la posición del agente en la vista de agentes).

Cada mapa tiene una o más capas para mostrar los agentes. Cada capa puede mostrar los agentes de un grupo, una lista de agentes y/o un grupo con un agente como respresentante. De este modo es fácil fijar los agentes que se mostrarán en cada capa.

Las capas se pueden configurar como visibles u ocultas, y es posible:



GIS grupo.png



  • Seleccionar el grupo con el selector para añadir sus agentes.
  • Añadir agentes con la celda de manera individual.
  • Añadir un grupo con un único agente como representante.


Info.png

Una vez se ha creado un grupo en una capa con su agente representante, no podremos generar otro grupo igual con otro agente.

 


Una vez que la capa está configurada (no estará completamente guardada hasta que no se guarde el mapa completo) será desplazada a la columna de la izquierda de las capas definidas, donde es posible ordenarlas (mover hacia arriba y hacia abajo), borrarlas o editarlas de nuevo.

Una vez que terminemos con la definición de las capas del mapa, podemos guardarlas todas con el botón guardar (botón actualizar en el caso de la edición de un mapa).

1.3 Operación

Una vez que haya al menos un mapa definido, será posible empezar a utilizar las funcionalidades GIS.

1.3.1 Mapas GIS

El menú de mapas GIS despliega todos los mapas definidos. Cada uno puede visualizarse desplegando el mapa con los parámetros definidos en el mapa.

1.3.1.1 Desplazarse por el mapa

Los controles para el mapa incluyen cuatro flechas verdes en la esquina superior izquierda que permiten desplazarse por el mapa en cada una de las direcciones. Con los iconos + y - para aumentar y disminuir el nivel de zoom, y una barra de zoom para seleccionar directamente el nivel deseado.

Arrastrando el mapa también es posible desplazarse.

Se puede hacer click sobre los agentes mostrados en el mapa para obtener más información acerca del agente (y una vez que el globo con la información extra se despliegue, el nombre del agente es un enlace a la vista de agente).

1.3.1.2 Las Capas Ocultar/Mostrar/ Seleccionar

Si pulsamos sobre el botón + de la derecha se abrirán los controles de capas. Despliega una caja verde donde es posible seleccionar la capa base (la conexión al servidor de mapa, si se hubiese definido más de una para el mapa), y ver qué capas están visibles.

También existe una capa especial definida por el sistema llamada Jerarquía de agentes. Si esta capa se puede visualizar, mostrará lineas punteadas de rojo conectando un agente con su agente padre (si ambos están visibles).

1.3.1.3 Filtros

Encima del mapa hay opciones de filtrado por el estado de los agentes:

  • Ok
  • Critical
  • Warning
  • Other

1.3.1.4 Refrescar el Mapa

Al lado de los botones de filtro hay una casilla combo llamada Refresh para seleccionar el rango de actualización del mapa. El Mapa emplea llamadas [AJAX] para refrescar los agentes en el mapa utilizando el periodo elegido.


1.3.1.5 Edición del mapa y Pantalla completa

Los tres últimos botones en la parte superior del mapa son un link a la Visual Console, un link al GIS Map Builder para editar el Mapa, y un botón para ver el mapa en Pantalla completa.

Gis maps default all controls2.png

1.3.2 Vista de Agente

La vista de agente de la consola de Pandora FMS también tiene funcionalidades GIS. Lo primero que aparece en la vista principal es la localización del agente en términos de longitud, latitud y altitud.


1.3.2.1 Vista Histórica GIS

Hay un botón en la barra superior (siempre que GIS esté activado) que muestra la vista GIS del agente.

Esta vista muestra la posición del agente en el mapa por defecto, con una tabla que muestra el historial de posiciones previas del agente y una ruta de estas posiciones en el mapa.

Cada posición en el mapa está representada por un punto (excepto la actual, que está representada por el icono del agente). Es posible hacer click en cualquiera de estos puntos para conseguir información relativa a esa posición, y también hacer click en el icono del agente para mostrar la información actual del mismo. La siguiente imagen muestra el camino recorrido por el agente de Pandora FMS para dispositivos Android.



Pandroid GIS22.png



Además, puede verse una tabla con toda la información reportada por el agente, incluyendo un sistema de geolocalización inversa que muestra la dirección del agente con la calle, la ciudad y el país donde se encuentra.



Pandroid GIS23.png



1.3.3 Configuración del Agent GIS

Entre las pestañas de administración del agente, hay una opción para fijar de modo manual la posición del agente. También la pestaña agent manage tiene algunos parámetros que afectan a las funcionalidades GIS.

1.3.3.1 Ignorar datos GIS

En la pestaña agent manage hay una opción llamada Ignore GIS data. Si está activada, el servidor ignorará toda la información posicional recibida del agente y seguirá usando los últimos valores válidos para este agente. Esto es útil en caso de que un agente esté reportando una posición errónea o haya que situarlo en un lugar fijo.



Agent management icon ignore gis data2.png



1.3.3.2 Posición manual del agente

La pestaña Gis Data muestra el mapa por defecto. Es posible hacer click en él para definir la nueva posición del agente, o bien fijarla utilizando el formulario de la parte inferior del mapa.



Pos manual.png



Template warning.png

Fijar manualmente la posición del agente activará también la opción de ignorar nuevos datos GIS, para evitar el siguiente paquete de datos con información posicional del agente para reajustar de nuevo la posición. Si esta no es la conducta deseada, no olvide desactivar la opción Ignore new GIS data antes de pulsar el botón Update

 


1.4 Enlaces útiles

Colección de enlaces útiles para el montaje del entorno de pruebas y el desarrollo con OpenLayers.

1.4.1 OpenLayers


1.4.2 OpenStreetMap


1.4.3 OS Geo

The Open Source Geospatial Foundation


1.4.4 Geo Server


1.4.5 PostgreSQL


1.4.6 Blogs

Volver a Indice de Documentacion Pandora FMS