Repository navigation
Troubleshooting
From 1.5.1 the dashboard is a v2 dashboard, which needs Grafana 13. Upgrade Grafana, or import 1.4.1, the last release for Grafana 11 and 12. It shows a server well but has no row for a singleplayer world.
- Check that the “Prometheus” variable points at the Prometheus that scrapes minecraft-exporter.
- In Grafana's Explore, run
minecraft_up. No result means Prometheus doesn't scrape the exporter: check its scrape job. -
minecraft_upat 0 means the exporter can't reach WorldAPI. CheckWORLDAPI_URLand that WorldAPI answers at/api/v1/server. - Check that the “Server” variable has a value. It lists the
instancelabels ofminecraft_up.
The Host, Lag sources, and Plugins and console rows need a WorldAPI token behind the exporter, each with its own permission. Unfold the Exporter row: “What the token can read” shows which endpoints stay closed. Data sources lists which permission fills what.
Bar charts count changes over time, so they need history. Wait half an hour after a fresh setup, or widen the time range.
-
All three: the “WorldAPI” variable has no Infinity data source, or its URL lacks
/api/v1. Open the data source and press “Save & test”. -
A 401 or 403 error: the token is missing or lacks a permission. Chat needs
chat:read, eventsevents:read, the consolelogs:read. - Infinity refuses the request: add the WorldAPI URL to the data source's “Allowed hosts”.
-
Only chat: WorldAPI records chat only with
events.chat: truein its config. Messages from before you turned it on don't come back.
Counters that start with the exporter lose their first step under increase(). The exporter seeds what it can at zero, and “Deaths by cause” subtracts the value at the start of the range instead, so a gap closes after the first event.
Grafana refuses two dashboards with one title in a folder. Import into another folder, or overwrite the old copy: the uid minecraft-worldapi stays the same across releases, so links keep working.
Grafana replaces a provisioned dashboard from its file. Make your changes in a copy (Save as), or edit the file.
Server owners
Developers