Plugins 〉MapTrack3D


Developer

Theo Hussey

Sign up to receive occasional product news and updates:


Grafana Cloud
Grafana Cloud
  • Grafana, of course
  • 10k series Prometheus metrics
  • 50 GB logs
  • 50 GB traces
  • 2,232 app o11y host hours
  • ...and more
Create free account

No credit card needed, ever.


Panel
community

MapTrack3D

  • Overview
  • Installation
  • Change log
  • Related content

MapTrack3D

A plugin for Grafana that visualizes GPS points on a 3D globe. A marker shows the position at the time when hovering over other panels on the dashboard.

Configuration

The plugin requires latitude,longitude, and optionally altitude measurements provided as floats in two/three separate fields formatted by Grafana as a "Time series".

It can be used with MySQL/MariaDB as a data source by using a querie along the lines of:

SELECT
    "timestamp" as time,
    lat,
    lon,
    alt,
FROM test_data
WHERE $__timeFilter(timestamp)
ORDER BY timestamp ASC

A demo CSV file that can be used in conjunction with CSV datasource is provided here

How to develop

If you don’t want to install Grafana on your local machine, you can use Docker.

To set up Grafana for plugin development using Docker, run the following command:

docker run -d -p 3000:3000 -v "$(pwd)"/dist:/var/lib/grafana/plugins --name=grafana grafana/grafana:7.4.3

Since Grafana only loads plugins on start-up, you need to restart the container whenever you add or remove a plugin.

docker restart grafana

Attributions

Icon made by Freepik from Flaticon

Map Texture from Planet Pixel Emporium Copyright (c) James Hastings-Trew

Installing MapTrack3D on Grafana Cloud:

For more information, visit the docs on plugin installation.

Installing on a local Grafana:

For local instances, plugins are installed and updated via a simple CLI command. Plugins are not updated automatically, however you will be notified when updates are available right within your Grafana.

1. Install the Panel

Use the grafana-cli tool to install MapTrack3D from the commandline:

grafana-cli plugins install 

The plugin will be installed into your grafana plugins directory; the default is /var/lib/grafana/plugins. More information on the cli tool.

2. Add the Panel to a Dashboard

Installed panels are available immediately in the Dashboards section in your Grafana main menu, and can be added like any other core panel in Grafana.

To see a list of installed panels, click the Plugins item in the main menu. Both core panels and installed panels will appear.

Change Log

All notable changes to this project will be documented in this file.

v0.1.3

Initial Release