Surveillance SIG

Une carte SIG (une système d'information géographique, GIS en anglais) est une représentation visuelle de l'emplacement géographique des agents d'installation de Pandora FMS. Avec cette carte, vous pouvez voir la position actuelle, ainsi qu'un petit historique des positions des agents.

Le fichier pandora_agent.conf des Agents logiciels contient des paramètres permettant de configurer le positionnement de l'appareil :

• Longitude.
• Latitude.
• Altitude.
• Description du poste.

Le paramètre gis_exec peut également être utilisé pour spécifier le chemin d'accès à un script qui renvoie les coordonnées de l'appareil dans une chaîne au format « latitude,longitude,altitude ».

# 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

Les fonctionnalités SIG doivent être activées sur le serveur avec le paramètre activate_gis. Lorsque ce paramètre est à 1, le serveur traitera toutes les informations SIG reçues des agents.

Avec les données de positionnement il y a la possibilité de stocker les positions des agents dans Pandora FMS, mais ces données proviennent d'une source qui n'est pas complètement fiable, et cela peut amener un agent sans changement de position significatif à envoyer des informations de changement de position. Pour éviter cela, le paramètre location_error fixe la distance qui est considérée comme une même position. Il s'agit d'une tolérance d'erreur sur le seuil de position, et tant que la position de l'agent reste à ce seuil, il sera considéré comme étant dans la même position.

En utilisant un algorithme de géolocalisation inverse et une base de données d'adresses IP et d'informations de positionnement, le serveur de découverte peut calculer la position des agents découverts. Cela peut être fait en utilisant un fichier formaté MaxMind GeoIP GeoLiteCity, ou quelques tables dans la base de données avec de telles informations.

Deux paramètres définissent ce comportement du serveur Discovery : le paramètre recon_reverse_geolocation_file, utilisé pour pointer vers le fichier contenant les informations de géolocalisation inversée (en utilisant la licence MaxMind GPL GeoLiteCity), et le paramètre recon_location_scatter_radius), et le paramètre recon_location_scatter_radius. L'algorithme calculera une position approximative pour les agents et les agents seront disposés aléatoirement autour des positions calculées, en tenant compte du rayon indiqué dans recon_location_scatter_radius .

Le service de géolocalisation inversée fourni par l'API Google® ou OpenStreetMaps® (OSM) peut également être utilisé.

• La géolocalisation inversée de Google® peut être activée en fixant le paramètre google_maps_description à 1.
• Vous pouvez activer la géolocalisation inversée d'OpenStreetMaps® en mettant le paramètre openstreetmaps_description à 1.
• Cette fonctionnalité diminue les performances du serveur Pandora FMS.
• Un accès à Internet est nécessaire pour utiliser l'API Google® ou OpenStreetMaps® et, bien entendu, cette fonctionnalité dépend de la disponibilité des fournisseurs de ces services.

# 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

Dans la console Web, pour utiliser les fonctionnalités SIG, il faut d'abord l'activer dans la configuration principale.

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

De nouvelles sections de l'interface utilisateur seront ainsi disponibles.

Au Setup → Setup → GIS map connection définissez les connexions qui peuvent être utilisées avec les serveurs de cartes pour fournir des cartes pour les fonctionnalités SIG.

• Group : Le groupe auquel la connexion appartient. Même si l'utilisateur qui crée la connexion à la carte SIG n'appartient pas explicitement au groupe TOUS (ALL), vous pouvez toujours assigner le groupe TOUS comme groupe auquel la connexion appartient.
• Number of zoom levels : Le nombre de niveaux de zoom (zoom) définis dans la carte.
• Default zoom level : Le niveau d'agrandissement par défaut recommandé pour la carte (qui peut être redéfini dans la carte) et est le niveau zoom utilisé lorsque la carte est affichée.

Une fois les paramètres de base configurés, l'administrateur doit sélectionner un type de connexion et, selon le type, il y aura différentes options.

L'installation par défaut de Pandora FMS dispose d'une connexion prédéfinie avec OpenStreetMap®, de sorte que les utilisateurs peuvent directement tester et visualiser les fonctionnalités SIG.

Pour utiliser un type de carte OpenStreet®, le seul paramètre nécessaire est l'URL du serveur de titres :

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

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

La la liste officielle des serveurs est disponible sur le site web d'OpenStreetMap® avec les instructions de nomination et d'accréditation.

Pandora FMS comprend également la connexion à Google Maps®. Pour cela, il est nécessaire d'obtenir un mot de passe valide auprès de Google® (voir Google Maps API policy) et à placer dans le champ correspondant de la définition de la connexion.

Avec ce mot de passe, il est possible de définir plusieurs connexions en utilisant différents types de cartes de base : Hybrid, Physical ou Satelite.

Un autre type de connexion consiste à utiliser une Static image comme carte. Pour utiliser ce type de carte, l'image doit être la suivante EPSG:4326 (WGS84).

Dans ce cas, les paramètres nécessaires à la définition de la carte sont l'url de l'image, la hauteur et la largeur de l'image, et les limites de position (longitude et latitude) des bords de l'image (droite, gauche, haut et bas).

Un serveur de cartes WMS local peut être installé et utilisé (Web Map Service) lorsqu'il est impossible d'utiliser un service de cartographie en ligne. Cela permet également de définir des types mosaic pour une plus grande rapidité.

Depuis la version 723, il est possible d'ajouter des connexions à des serveurs WMS tels que GeoServer. Pour ce faire, il est nécessaire d'indiquer l'adresse où le service est fourni et le(s) nom(s) des couches à obtenir auprès de lui.

Vous pouvez voir comment effectuer une installation et une configuration minimales d'un GeoServer dans cette annexe technique.

La dernière chose à définir dans une connexion cartographique est le centre de la carte et la position par défaut pour les agents sans données positionnelles. Pour les définir, il est possible de prévisualiser la carte et de cliquer dessus pour définir ces paramètres, en fonction de celui que vous souhaitez définir (Map centre ou Default position for agents without GIS data) a été sélectionné à l'aide du sélecteur Change in the Map.

Dans cette carte de prévisualisation, il est possible de faire défiler la carte à l'aide des flèches vertes situées en haut à gauche, de modifier le niveau de zoom à l'aide des icônes + et - , ou d'utiliser l'icône de la loupe pour voir la carte en plein zoom.

Il est également possible de fixer la position en saisissant les valeurs dans les cellules de saisie correspondantes (ici, le séparateur décimal est le point).

Une fois tous les paramètres de connexion définis, il sera possible d'enregistrer la connexion pour l'utiliser dans le configurateur de cartes en cliquant sur le bouton Save.

Une fois les connexions définies, elles peuvent être utilisées pour définir des cartes dans le menu GIS Maps.

Le menu permet à l'utilisateur d'accéder à un écran contenant des cartes définies, où il est possible de modifier une carte, d'afficher la carte, de définir la carte par défaut (default map) ou de supprimer une carte.

Un bouton permet également de créer de nouvelles cartes (bouton Create).

Créer une carte SIG

Lorsque vous accédez à la page de création de la carte, la première chose à faire est d'ajouter un nom (Map Name) et une connexion cartographique (Add Map connection), en sélectionnant l'une de celles déjà disponibles. Il est possible d'en ajouter plusieurs, qui seront alors disponibles comme couche de base (une seule d'entre elles peut être active en même temps).

Après avoir sélectionné la connexion (ou lorsque la connexion par défaut de la carte est modifiée), la console Pandora FMS vous demandera si vous souhaitez utiliser les données par défaut de la connexion pour la carte. Dans l'affirmative, la console remplira (ou mettra à jour) toutes les données de positionnement avec celles déjà définies dans la connexion, et l'utilisateur n'aura qu'à définir le niveau de zoom par défaut. Si l'utilisation des valeurs par défaut est rejetée, aucune modification ne sera apportée et la connexion sera simplement ajoutée.

Définition de la couche

Lorsque les paramètres de base de la carte ont été définis, il est temps de définir les couches (LAYERS) les couches de la carte qui seront utilisées pour sélectionner les éléments à afficher sur la carte. S'il s'agit de la carte par défaut, il n'est pas nécessaire de définir une couche car elle sera utilisée pour afficher la position de l'agent dans la vue de l'agent.

Chaque carte comporte une ou plusieurs couches pour afficher les agents. Chaque couche peut afficher les agents d'un groupe, une liste d'agents et/ou un groupe dont un agent est le représentant. Il est ainsi facile de définir les agents à afficher sur chaque couche.

Les couches peuvent être configurées comme visibles ou cachées, et c'est possible de :

• Sélectionner le groupe à l'aide du sélecteur pour ajouter vos agents.
• Ajouter des agents avec la cellule individuellement.
• Ajouter un groupe avec un seul agent comme représentant.

Une fois la couche configurée (elle sera complètement sauvegardée, avec la carte complète, lorsque vous cliquerez sur le bouton Save map) seront déplacés dans la colonne de gauche des couches définies, où il est possible de les trier (en les déplaçant vers le haut et vers le bas), de les supprimer ou de les modifier à nouveau.

Une fois que vous avez fini de définir les couches de la carte, vous pouvez les enregistrer en cliquant sur le bouton Save map (botón Update map dans le cas de l'édition d'une carte).

Le menu Carte SIG affiche toutes les cartes définies. Chaque carte peut être visualisée en affichant la carte avec les paramètres définis dans la carte. Une fois ouverte, chaque carte peut être éditée en cliquant sur le bouton Setup situé sur le bord supérieur.

Les commandes de la carte comprennent quatre flèches vertes dans le coin supérieur gauche qui vous permettent de faire défiler la carte dans chaque direction. Des icônes + et - permettent d'augmenter et de diminuer le niveau de zoom, et une barre de zoom permet de sélectionner directement le niveau souhaité.

Faire glisser la carte permet également de se déplacer.

Les agents figurant sur la carte peuvent être cliques pour obtenir plus d'informations sur l'agent (et une fois que le ballon avec les informations supplémentaires est affiché, le nom de l'agent est un lien vers la vue de l'agent).

En cliquant sur le bouton + à droite, vous ouvrirez les contrôles des couches. Il affiche une boîte verte où il est possible de sélectionner la couche de base (la connexion au serveur de cartes, si plusieurs ont été définies pour la carte), et d'afficher les couches qui sont visibles.

Il existe également une couche spéciale définie par le système, appelée hiérarchie des agents (Agent hierarchy). Si cette couche est visible, elle affichera des lignes rouges en pointillés reliant un agent à son agent parent (si les deux sont visibles).

Au-dessus de la carte, il y a des options de filtrage par état de l'agent :

• OK.
• Critical.
• Warning.
• Other.

À côté des boutons de filtrage se trouve une zone de liste nommée Refresh pour sélectionner la période de rafraîchissement de la carte. La carte utilise des appels AJAX pour rafraîchir les agents sur la carte en fonction de la période choisie.

La vue de l'agent de la console de Pandora FMS possède également des fonctionnalités SIG. La première chose qui apparaît dans la vue principale est la localisation de l'agent en termes de longitude, de latitude et d'altitude.

Un bouton dans la barre supérieure (à condition que le SIG soit activé) permet d'afficher la vue SIG de l'agent.

Cette vue montre la position de l'agent sur la carte par défaut, dans un tableau avec toutes les informations rapportées par l'agent, y compris un système de géolocalisation inversée qui montre l'adresse de l'agent avec la rue, la ville et le pays où elle se trouve.

Parmi les onglets de gestion des agents, une option permet de définir manuellement la position de l'agent. L'onglet Agent manage possède certains paramètres qui affectent les fonctionnalités SIG.

Dans l'onglet Agent manage il existe une option appelée Update new GIS data.

• Si cette option est activée, le serveur met à jour toutes les informations relatives à la position reçues de l'agent et cesse d'utiliser les dernières valeurs valables pour cet agent.
• Cette option étant inactive, elle est utile lorsqu'un agent signale une position erronée ou doit être placé à un endroit fixe.

L'onglet GIS Data affiche la carte par défaut. Il est possible de cliquer dessus pour définir la nouvelle position de l'agent, ou de la définir à l'aide du formulaire situé au bas de la carte.

Retour à l'index de la documentation du Pandora FMS