How-to use geo coordinates from Checkmk in NagVis maps

Owned by Robin Gierse
Last updated: Dec 11, 2023 by Matthew Hierholzer
2 min read

This article overviews on how to add Geo coordinates from Checkmk into Nagvis maps.

LAST TESTED ON CHECKMK 2.2.0P1

Table of Contents

Getting Started

Background information regarding this subject is available in our Official documentation

Problem

You want to have geographical information in Checkmk, and based on that information, you want to have NagVis geomaps that automatically get populated with this information.

Solution

This solution works only on a per-site basis. If the hosts you want to show in NagVis are located at several sites, you need maps with the appropriate backends.

Follow these steps to enable the automatic placement of hosts based on their geolocation:

  1. Create two custom host attributes like described here: How-to configure custom notification attributes#CustomHostattributes

    one attribute will be named "lat" and the other one "long."

    Screenshot of edit host attributes. Add to monitoring configuration. Make this custom attribute available to check commands.

    Screenshot of edit host attributes. Add to monitoring configuration. Make this custom attribute available to check commands.

    You need to select the Checkbox "Add to monitoring configuration" to make both attributes available for NagVis.

    .

  2. Start adding the information to your hosts; you need at least one with coordinates configured.

  3. Navigate to NagVis and create a new map of the type 'Geographical map (non-interactive).'

  4. Go to Edit Map → Map Options

  5. On the rider 'Geomap,' change the source type to 'NagVis Backend' and save the settings.