Bambulab Metrics

BambuLab 3D Printer — Grafana Dashboard

Real-time monitoring dashboard for BambuLab 3D printers. Tracks printer health, live print progress, temperatures, fan speeds, AMS filament inventory, and job queue status. Supports multiple printers and multiple AMS units automatically via Prometheus label-based discovery.

Requirements

Grafana plugins required

This dashboard uses the Business Text panel (formerly Dynamic Text) by Volkov Labs for the AMS filament inventory visualization. The AMS panel renders filament spool cards with real colors, type labels, remaining % progress bars, and active slot indicators using a Handlebars HTML template. It cannot be replicated with native Grafana panel types because Canvas does not support dynamic color binding from label values, and Stat/Table panels cannot loop over rows to render per-slot cards.

1. Install the Business Text plugin

Via Grafana CLI:

grafana-cli plugins install marcusolsson-dynamictext-panel

Via Docker — add to your docker-compose.yml:

environment:
  - GF_INSTALL_PLUGINS=marcusolsson-dynamictext-panel

Via Grafana UI: Administration → Plugins → Search "Business Text" → Install.

Restart Grafana after installing.

2. Enable HTML rendering

The Business Text panel renders HTML templates. By default Grafana sanitizes HTML for security, which strips all styling and layout. You must disable sanitization for the AMS panel to render correctly.

Option A — grafana.ini:

[panels]
disable_sanitize_html = true

Option B — environment variable (recommended for Docker):

GF_PANELS_DISABLE_SANITIZE_HTML=true

Docker Compose example:

services:
  grafana:
    image: grafana/grafana:latest
    environment:
      - GF_PANELS_DISABLE_SANITIZE_HTML=true
      - GF_INSTALL_PLUGINS=marcusolsson-dynamictext-panel

Restart Grafana after making this change. Without it the AMS panel will display plain unstyled text instead of the visual spool cards.

3. Set Content mode to HTML

After creating the Business Text panel, in the panel editor make sure to set Content mode → HTML in the panel options on the right side. The default mode is Markdown which will not render the template correctly.

Data collection

Metrics are collected from BambuLab printers via MQTT using the bambulab_metrics_exporter Prometheus exporter. The exporter connects to the printer's local MQTT broker and exposes all telemetry as Prometheus gauges on a /metrics endpoint.

How it works

BambuLab Printer (MQTT)
        │
        ▼
bambulab_metrics_exporter (Prometheus exporter)
        │
        ▼
Prometheus (scrapes /metrics every 15s)
        │
        ▼
Grafana (queries Prometheus)

For exporter installation and configuration see the bambulab_metrics_exporter README.

Prometheus scrape config

Add this to your prometheus.yml:

scrape_configs:
  - job_name: bambulab
    scrape_interval: 15s
    scrape_timeout: 10s
    static_configs:
      - targets:
          - localhost:9101        # Replace with your exporter host/port
        labels:
          environment: home

Reload Prometheus after adding:

curl -X POST http://localhost:9090/-/reload

Verify metrics are flowing by visiting:

http://localhost:9101/metrics

You should see metrics prefixed with bambulab_.

Dashboard panels

Printer status row

Print progress row

Temperatures row

Fans row

AMS row

Speed & network row

Errors & safety row

Exporter health row

Key metrics reference

Full metric list available at your exporter's /metrics endpoint.

Multiple printers

The dashboard uses printer_name as a label on all metrics. To support multiple printers, add a Dashboard variable:

1. Dashboard Settings → Variables → Add variable
2. Type: Query
3. Name: printer
4. Query:

label_values(bambulab_printer_up, printer_name)

1. Then update all panel queries to use {printer_name="$printer"} instead of a hardcoded name.

Alerting suggestions

License

MIT — free to use, modify, and share.