SECURITY WARNING: Never run commands you don't understand. Always review code before execution. Use at your own risk.
Monitoring New Added 8 September 2026

Grafana: Panel plugin not found

A dashboard references a panel type this Grafana does not have installed. It happens when a dashboard JSON is imported from elsewhere, or after an upgrade removed an angular based panel that is no longer supported.

Quick fix

Read the commands before running them. Anything that restarts a service, deletes data or changes permissions should be tried on a non-production system first.

Quick fix
# Which plugin does the dashboard want?
jq -r '.panels[].type' dashboard.json | sort -u
grafana cli plugins ls

# Install it
grafana cli plugins install grafana-piechart-panel
systemctl restart grafana-server

# Container images: install at build or via provisioning
ENV GF_INSTALL_PLUGINS=grafana-clock-panel,grafana-piechart-panel

# Angular panels removed in Grafana 11 have core replacements:
# graph -> timeseries, singlestat -> stat, table-old -> table
# The migration runs automatically when you open and save the dashboard.

How to diagnose Monitoring errors

Monitoring failures create a dangerous blind spot: dashboards go flat and the natural assumption is that traffic stopped. The usual causes are scrape targets unreachable (network policy, wrong port, or a service with no endpoints), exporter queues full (the backend is rejecting or throttling), and cardinality explosions that cause the time-series database to reject writes. Always alert on the absence of data, not only on bad values.

If the quick fix above does not resolve it, work through these steps. They apply to this whole class of error, not just to this one message, which is usually what saves the time.

  1. Check the scrape target's status page (/targets in Prometheus). It shows the last scrape error verbatim.
  2. Curl the metrics endpoint from inside the cluster or network segment the scraper runs in: reachability from your laptop proves nothing.
  3. For OpenTelemetry, enable the collector's own telemetry and watch otelcol_exporter_queue_size and otelcol_exporter_send_failed_spans.
  4. Investigate cardinality before increasing memory: a label containing a user ID, request ID or URL path with IDs in it will exhaust any TSDB.
  5. Write a dead-man's-switch alert that fires when a known-always-firing metric stops arriving. It is the only alert that catches a broken pipeline.

Tools worth reaching for

  • Prometheus /targets
  • promtool check config
  • otelcol internal metrics
  • curl <exporter>/metrics
  • Grafana Explore

Authoritative references

Primary documentation for this error, worth reading before applying any fix in production.

grafana.com

Related Monitoring errors

See all 12 Monitoring errors →

Browse other categories

Something missing or wrong?

This entry is maintained by hand. If the fix is out of date, incomplete, or you have a better one, email a correction and it will be reviewed.