====== Surveillance SIG ====== {{indexmenu_n>20}} ===== Pandora FMS GIS ===== 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. Pour utiliser les cartes SIG, les agents, le serveur et la console doivent être configurés. ===== Installation ===== ==== Configuration de l'agent ==== Le fichier ''pandora_agent.conf'' des [[:fr:documentation:pandorafms:installation:05_configuration_agents|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 ==== Configuration du serveur ==== Les fonctionnalités SIG doivent être activées sur le serveur avec le paramètre [[:fr:documentation:pandorafms:installation:04_configuration#activate_gis|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 [[:fr:documentation:pandorafms:installation:04_configuration#location_error|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//. === Serveur de découverte et informations de localisation === 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é [[http://www.maxmind.com/app/geolitecity|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 [[:fr:documentation:pandorafms:installation:04_configuration#recon_reverse_geolocation_file|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 [[:fr:documentation:pandorafms:installation:04_configuration#recon_location_scatter_radius|recon_location_scatter_radius]]), et le paramètre [[:fr:documentation:pandorafms:installation:04_configuration#recon_location_scatter_radius|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 [[:fr:documentation:pandorafms:installation:04_configuration#google_maps_description|google_maps_description]] à ''1''. * Vous pouvez activer la géolocalisation inversée d'OpenStreetMaps® en mettant le paramètre [[:fr:documentation:pandorafms:installation:04_configuration#openstreetmaps_description|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 ==== Configuration de la console ==== 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. === Configuration de base === 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** ([[:fr:documentation:pandorafms:management_and_operation:11_managing_and_administration#ks1_2_2|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. === OpenStreetMap === L'installation par défaut de Pandora FMS dispose d'une connexion prédéfinie avec [[http://www.openstreetmap.org/|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 **: {{ :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 La [[https://wiki.openstreetmap.org/wiki/Tile_servers|la liste officielle des serveurs est disponible sur le site web d'OpenStreetMap®]] avec les instructions de nomination et d'accréditation. === Google Maps === 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 [[https://developers.google.com/maps/documentation/directions/#api_key|Google Maps API policy]]) et à placer dans le champ correspondant de la définition de la connexion. {{ :wiki:pfms-setup-setup-gis_map_connection-create_new-google.png }} 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//. Ce mot de passe peut mettre plusieurs minutes à fonctionner après avoir été obtenu. === Image statique === 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). === Serveur WMS === 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 [[:fr:documentation:pandorafms:introduction:03_glossary#mosaic|mosaic]] pour une plus grande rapidité. Depuis la version 723, il est possible d'ajouter des connexions à des serveurs WMS tels que [[http://geoserver.org/|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. {{ :wiki:pfms-setup-setup-gis_map_connection-create_new-wms_server.png }} Vous pouvez voir comment effectuer une installation et une configuration minimales d'un GeoServer dans [[:fr:documentation:pandorafms:technical_annexes:13_geoserver_installation|cette annexe technique]]. === Centre de la carte et position par défaut === 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). {{ :wiki:connection_configruation_set_center_default.png }} 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**. ==== Cartes SIG ==== 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. {{ :wiki:pfms-topology_maps-gis_maps-list_of_gis_maps_sample.png }} Un bouton permet également de créer de nouvelles cartes (bouton **Create**). Une **carte par défaut** doit être définie, qui sera utilisée dans la vue de l'agent pour indiquer sa position. **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). {{ :wiki:gis_map_builder_main.png }} 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 qu'un groupe a été créé dans une couche avec son agent représentatif, il n'est pas possible de générer un autre groupe avec un autre agent. 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). ===== Fonctionnement ===== ==== Cartes SIG ==== 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. {{ :wiki:pfms-topology_maps-gis_maps-list_of_gis_maps-setup_gear.png }} === Se déplacer sur la carte === 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**). {{ :wiki:pfms-topology_maps-gis_maps-list_of_gis_maps-control_navigation.png }} === Couches === 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**. {{ :wiki:pfms-topology_maps-gis_maps-list_of_gis_maps-control_layers.png }} 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). === Filtres === Au-dessus de la carte, il y a des options de filtrage par état de l'agent : * OK. * Critical. * Warning. * Other. === Rafraîchir la carte === À 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. ==== Vue d'agent ==== 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. === Vue historique du SIG === 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. {{ :wiki:pandroid_gis22.png }} ==== Configuration de l'agent SIG ==== 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. === Mise à jour des données 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. === Position manuelle de l'agent === 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. {{ :wiki:pos_manual.png }} Le réglage //manuel// de la position de l'agent activera également l'option permettant d'ignorer les nouvelles données SIG (**Ignore new GIS data** - qui prendra alors la valeur opposée dans l'option « [[#ks3_3_1|Update new GIS data]] »), pour éviter que le prochain paquet de données contenant des informations //positionnelles// de l'agent ne réinitialise à nouveau la position. Si ce n'est pas le comportement souhaité, n'oubliez pas de désactiver l'option **Ignore new GIS data** avant de cliquer **Update**. [[:fr:documentation:start|Retour à l'index de la documentation du Pandora FMS]]