Die NagVis-Geomap-Map-Source wurde in NagVis 1.7 eingeführt. Sie wurde entwickelt, um ohne viel Arbeit sauber gerenderte und skalierte Übersichts-Maps zu erhalten.
Die Geomap rendert verschiedene Hosts auf einer von Open Street Map als Hintergrundbild zur Verfügung gestellten Karte.
Für die aktuelle Geomap benötigen Sie lediglich eine CSV-Datei, die NagVis die Hosts und die Geo-Koordinaten für die zu platzierenden Objekte angibt.
Es ist keine spezielle Software auf dem NagVis-Host erforderlich. Allerdings gibt es eine besondere Anforderung.
Um dieses Feature nutzen zu können benötigt NagVis Zugriff auf den Host geomap.nagvis.org
via port 80.
NagVis benutzt eine simple HTTP-basierte API, um das Map-Image und die Koordinaten dieses Images zu erhalten.
In den meisten Fällen hat der NagVis-Host keinen direkten Internet-Zugriff. Sie können die http_proxy
Option im [global]
-Abschnitt Ihrer NagVis-Hauptkonfigurationsdatei (nagvis.ini.php) verwenden, um NagVis anzuweisen,
einen Proxy für solche Anfragen zu benutzen. Die meisten Proxies erfordern eine Authentifizierung, um den Zugang zum
Internet zu kontrollieren. Mit der Option http_proxy_auth
können die Zugangsdaten gesetzt werden.
NagVis wird mit einer Demo-Geomap namens "demo-geomap" ausgeliefert. Wenn Ihr NagVis korrekt konfiguriert ist, sollten Sie eine Karte von Deutschland mit zwei Knoten sehen. Ein Knoten zeigt den Host "ham-srv1" in Hamburg. Der andere Knoten "muc-srv1" steht in München.
Die Geomap wird definiert mit Hilfe der Map-Konfigurationsdatei "demo-geomap.cfg". Der Inhalt sieht ungefähr so aus:
global { sources=geomap alias=Demo: 4 Geomap parent_map=demo-overview iconset=std_medium backend_id=demo # Geomap Parameters source_type=csv source_file=demo-locations width=800 height=600 }
Die Zeile sources=geomap
bewirkt, dass die geomap-Source benutzt werden soll, um die Map-Konfiguration zu ändern.
Die Zeile source_type=csv
weist den geomap-Code an, die CSV-Datei zu lesen,
die in source_file=demo-locations
angegeben und im Verzeichnis etc/geomap
abgelegt ist, um mit einer Liste
von Hosts und Koordinaten eine Geomap zu füllen.
Die Datei demo-locations.csv
enthält die folgenden zwei Zeilen:
ham-srv1;Hamburg Server 1;53.556866;9.994622 muc-srv1;Munich Server1;48.1448353;11.5580067
Jede Zeile definiert einen Host, der zur Map hinzugefügt werden soll. Die Spalten werden durch ;
-Zeichen
getrennt. Die ersten Spalte enthält den Host-Namen, die zweite einen optionalen Alias, die dritte die LAT-Koordinate
(Breitengrad) und die vierte die LONG-Koordinate (Längengrad).
(Ab Git-Version vom 21.03.2013): Zeilen, die mit den üblichen Kommentarzeichen beginnen
(;
, #
oder //
), werden als Kommentar behandelt.
: Es ist auch möglich, source_type=backend
zu setzen, um das per backend_id
eingestellte Backend für die Ermittlung der anzuzeigenden Hosts und ihrer
Koordinaten zu nutzen. Das ist nur möglich, wenn das livestatus-Backend genutzt wird. Es holt alle Hosts, bei denen die
benutzerdefinierten Objektvariablen _LAT
und _LONG
konfiguriert sind. Es ist möglich, die ermittelten
Hosts durch Angabe der Option filter_group
auf die Mitgliedschaft der angegebenen Host-Gruppe einzugrenzen.
Die Geomap-Source benutzt Anzeigeparameter zur Konfiguration. Für Einzelheiten werfen Sie einen Blick auf den "Ansicht ändern"-Dialog, der im Header-Menü über "Aktionen -> Ansicht ändern" geöffnet werden kann.
Die Anzeigeparameter können auch als Map-Konfigurationsattribute im global-Abschnitt der Maps angegeben werden.
Parameter | Default | Beschreibung |
---|---|---|
geomap_type | mapnik | Definiert den Render-Modus der Geomap. Gültige Werte sind: osmarender, mapnik oder cycle. |
geomap_zoom | Konfiguriert den Zoom-Faktor der Geomap während der Map-Abfragen. Werfen Sie einen Blick auf die OSM-Zoom-Dokumentation für weitere Details. | |
geomap_border | 0.25 | Der Rand, der auf jeder Seite der Geomap hinzugefügt werden soll. Dieser Wert wird einfach zu den berechneten min/max Geo-Koordinaten addiert. |
source_type | csv | Der Typ der Data-Source, die genutzt wird, um die Geomap-Objekte zu ermitteln. Kann csv oder
backend sein. |
source_file | Der Name der CSV-Datei, die als Quelle für das Rendering der Geomap genutzt werden soll. Das wird nur genutzt, wenn
source_type auf csv gesetzt ist. |
|
width | Definiert die Breite der Geomap in Pixeln. Die maximale Größe ist begrenzt durch den benutzten Web-Service. geomap.nagvis.org unterstützt bis zu 50 "Kacheln", was ein Auflösind bis zu 1920x1080 ermöglichen sollte. Bitte kontaktieren Sie uns, falls Sie mehr benötigen sollten. | |
height | Definiert die Höhe der Geomap in Pixeln. Die maximale Größe ist begrenzt durch den benutzten Web-Service. geomap.nagvis.org unterstützt bis zu 50 "Kacheln", was ein Auflösind bis zu 1920x1080 ermöglichen sollte. Bitte kontaktieren Sie uns, falls Sie mehr benötigen sollten. |