Skip to main content

Geographic Map

The Geographic Map tab displays all sites on an interactive map using their configured latitude and longitude coordinates. Sites appear as color-coded markers reflecting their current health status, providing a spatial overview of your network infrastructure. The map is built with React-Leaflet using OpenStreetMap tiles — no external API keys are required.

Map Interface​

The map automatically zooms and centers to fit all configured sites. Standard map controls are available:

  • Zoom (+/−) — Zoom in and out using the controls in the top-left corner, mouse scroll wheel, or pinch gesture on touch devices.
  • Pan — Click and drag to move the map.
  • Refresh — The refresh button in the top-right re-fetches site status data and updates marker colors.
  • Filters — The Filters button opens a panel to show or hide sites by status (Healthy, Warning, Critical) or by other site attributes.

Site Markers​

Each site with configured latitude and longitude coordinates appears as a marker on the map. Markers are color-coded to reflect the site's current health status:

Marker ColorStatusMeaning
GreenHealthyAll devices and interfaces at the site are operating normally.
Yellow/OrangeWarningOne or more components have degraded health.
RedCriticalOne or more devices, interfaces, or probes have critical issues.

Site health is calculated the same way as on the Site Cards tab — the worst status from any device, interface, or probe at the site determines the marker color.

Marker Popups​

Click a site marker to open a popup displaying:

  • Site name.
  • Status — Color-coded health label.
  • Devices — Number of devices at the site.
  • Interfaces — Number of monitored interfaces.
  • Avg CPU / Memory — Average CPU and memory utilization across devices at the site (when SNMP metrics are available).

Click the site name in the popup to navigate to the site detail view.

Inter-Site Connections​

When LLDP topology data reveals connections between devices at different sites, the map draws dashed lines between connected sites. These lines represent physical or logical links discovered through LLDP neighbor relationships.

Clicking a connection line opens a popup showing:

  • Source and target site names.
  • Link count — Number of individual links between devices at the two sites.
  • Traffic — Aggregate traffic volume across the links (from recent flow data).

Connection lines help visualize the network backbone and identify which sites are interconnected, making it easy to understand the impact of a site outage on traffic paths.

Status Legend​

The legend in the bottom-left corner provides a quick reference for marker colors:

  • 🟢 Healthy — All components operating normally.
  • 🟡 Warning — Degraded health on one or more components.
  • 🔴 Critical — Critical issues detected.

The legend also displays the last update timestamp (e.g., "Updated: 4:51:10 PM").

Site Coordinate Configuration​

Sites must have latitude and longitude coordinates configured to appear on the map. Coordinates can be set in two ways:

  • Settings → Sites — Edit a site and enter latitude/longitude values manually.
  • NetBox import — When importing sites from NetBox, latitude and longitude are pulled from the NetBox site record automatically if they are populated.

Sites without coordinates are not displayed on the map but still appear on the Site Cards tab.

Troubleshooting​

Sites not appearing on the map​

Verify that the site has latitude and longitude configured. Navigate to Settings → Sites, edit the site, and confirm both coordinate fields are populated. Sites with null or zero coordinates are excluded from the map.

Markers showing wrong status​

Site health is recalculated on each page load and refresh. If a marker color seems stale, click the Refresh button to re-poll device and interface health. Status is based on the most recent SNMP poll cycle (typically within the last 60 seconds) and probe heartbeats (within the last 5 minutes).

No connection lines between sites​

Inter-site connections are derived from LLDP neighbor data. If LLDP discovery hasn't found cross-site links, no lines will appear. Verify that LLDP is enabled on the network devices connecting your sites and that the SNMP poller is collecting LLDP data (the poller collects LLDP neighbors on each poll cycle automatically).