Skip to content

Troubleshooting

Pavel Erokhin edited this page Oct 25, 2026 · 3 revisions

Grafana 12 or older won't import it

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.

Every panel says “No data”

  1. Check that the “Prometheus” variable points at the Prometheus that scrapes minecraft-exporter.
  2. In Grafana's Explore, run minecraft_up. No result means Prometheus doesn't scrape the exporter: check its scrape job.
  3. minecraft_up at 0 means the exporter can't reach WorldAPI. Check WORLDAPI_URL and that WorldAPI answers at /api/v1/server.
  4. Check that the “Server” variable has a value. It lists the instance labels of minecraft_up.

Some rows stay empty

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.

The bar charts are empty but the stats work

Bar charts count changes over time, so they need history. Wait half an hour after a fresh setup, or widen the time range.

The chat, event, or console table is empty

  • 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, events events:read, the console logs: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: true in its config. Messages from before you turned it on don't come back.

“Deaths by cause” or the events graph misses the first event

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.

Import says a dashboard with the same name exists

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.

A provisioned dashboard lost my edits

Grafana replaces a provisioned dashboard from its file. Make your changes in a copy (Save as), or edit the file.