Plugins 〉Mapgl

Panel

community

Mapgl

Overview
Installation
Change log
Related content

✉️

Start a new panel with a mock node graph to test styles and modes.

Node graph with layered auto-layout or Geomap view
Spline / Rectilinear edge routing. Self-loops.
Multi-segment, parallel routes
Namespace-based subgraphs.
Arc sections on nodes for multiple metrics.
Network interface TX/RX load visualization using bi-metric arcs
Webgl GPU-acceleration for rendering large data volumes
Ad-hoc filtering by layers, node groups in the legend
Dynamic drill-down data links to external panels

🕹️ Demo

Playground with open configuration

Geomap NodeGraph

Data Format

NodeGraph

*Unified dataframe model for nodes and links. Field names are examples only; Mapgl does not require fixed field names.

See Panel configuration for setup details and dataframe usage.

Data Preparation

Use Grafana’s built-in transformations to prepare and merge data from:

Zabbix
Prometheus
Postgres
Any other datasource

Netbox+Prometheus with drill-down datalinks
Zabbix events on geomap

Field Config

Full support for native Grafana field config:

Thresholds – value ranges with associated colors to visually indicate status
Mapping – rename displayed values
Units – measurement unit conversion
Overrides – custom settings for specific metrics
DataLinks – links to external dashboards or graphs
Node Group style rules extend control over node color, icon, size, and line width.

Install on Grafana Cloud

Plugins can be installed directly from within your Grafana instance or automated using the Cloud API or Terraform.

Learn more about plugin installation

For more information, visit the docs on plugin installation.

Changelog Mapgl

2.5.0

adjacent edges list in tooltip.
graph highlighter via shader mask for instant nodes/edges picking.
FIX: cross-namespace edges with > 1 segment

2.4.0

edge routing modes: SugiyamaSplines/Rectilinear
edge curve interpolation on GPU shaders

2.3.0

icon color tint config for Node Groups #8
adhoc node group filter in the legend. GPU-fast
SVGs (raw/donut) resampled for highres, boxed into circle boundaries. Simplify group rules (rm icon size)
text labels offset from circle boundary (not from center point).

2.2.0

namespace subgraphs support. Make your graph more branchy.
revamped Group rules section #6
fix: group rules threshold options sync with node metric field #5
fix: scale on zoom for arrows and arc labels. Better arrow tips positioning.

2.1.0

align styles with Grafana theme tokens. Theme support for widget buttons.
hot patch for upstream FolderPickerTab Grafana 12.4.0. (No portal popups #119187)
robust svg loading for edge arrows under stricter Grafana environments (v11.2.0)
update field pickers and matchers from Grafana core

2.0.1

arrows config for edges in 'routed' view mode
parallel edges support for arcs/hyperedges in nodegraph view
cut edges at node boundary ports to prevent overlapping with semi-transparent nodes.
show head node id in edge tooltip
enlarge picked arc, edge

2.0.0

Node Graph with autolayout and spline edge routing that respects node boundary curves. In addition to Geo mode.
Arc sections on nodes for any metrics.
Style config extends Grafana Geomap styles-from-dimensions concept with overrides for user-defined node groups
Native Grafana Field config support: Thresholds, Mappings, Units, Overrides, Data links.
Bi-metric Arcs (ex., for TX/RX)
Ad-hoc filters by layers, node groups in the legend
Unified (Graph+Geo) single dataframe for nodes and edges (same as in v.1) avoids hardcoded dataframe requirements of the native Geomap/NodeGraph.
v1 -> v2 data migration is not required

1.6.1

fix cluster labels edit in thresholds to comply with braking < Tooltip > component since Grafana 10.3.0
fix tooltip css classes for pointerEvents:all
ncu u: bump deck.gl & luma.gl versions

1.6.0

cluster legend-filter
fullscreen and compass widgets
migrate to deck.gl 9 (with WebGPU support in the near future)

1.5.0

point circle and text label dimensions
svg icon rules collapsible + resource picker
bugfix: cluster hull polygon onHover doesn't lag on large datasets

1.4.0

alerting states from built-in Grafana annotations query. State colors for nodes and clusters
see-through convex hull polygon for cluster area

1.3.0

cluster max zoom menu select to control clusterization
convex hull polygon shows cluster boundaries, cluster expansion zoom on click
restore Grafana >=9.2.5 support
fix performance issues that occured on large datasets because of composite cluster+circles+icons+text layer with sublayers constantly recalculating. Now that IconGeoJsonLayer (circles+icons+text) is separated from IconClusterLayer, deck.gl has less to render

1.2.0

svg icons for nodes
text labels with collision filter.
bug fixes: allow lineWidth custom size, no min/max

1.1.0

Multi-source, multi-target support
Switch path direction by declaring dashboard variable 'locRole'.
Data-links: icon in tooltip to sets values for 'target' and 'source' dashboard variables. This lets you show charts dynamically in other panels.
Comment icons for intermediate locations from text and color inlined in coordinates (ex.: [37.560447,55.550818, 0, "comment", "green"])
Aggregation nodes and offset for overlapping lines.
stat1/stat2 switch to disable offset and show secondary metric
edge labels in stat2 mode , aggregation nodes labels.

1.0.2

New: support for parent path as an array of coordinates or location names
New: aggregation nodes and offset for overlapping lines in parent path.
Parent line style improvements: -Extended path to root as a separate dotted line.
Bug fixes:

isolate config options for different layers;

1.0.1

Multi layers support
PolygonsLayer, Path (LineStrings) layer from frames datasource
Static GeoJson layer with FeatureCollection support from GeoJson file (url)
Advanced thresholds processor for metrics. Set specific color for any set of parameters describing group of features.
Points show toggle