# BambuLab Metrics Exporter

BambuLab Metrics Exporter is a Prometheus exporter for Bambu Lab printers that collects printer status, print progress, and maintenance metrics and exposes them to Prometheus for self-hosted homelab monitoring and. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2649/bambulab-metrics-exporter

## Description

BambuLab Metrics Exporter is a Prometheus exporter for Bambu Lab printers that collects printer status, print progress, and maintenance metrics and exposes them to Prometheus for self-hosted homelab monitoring and alerting.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

60/100 (Good), based on 4 of 5 factors.
- Maintained: 79 (last commit 10 days ago)
- Popular: 20 (9 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 95 (no serious findings, CI, tests)

## Links

- GitHub: https://github.com/TheBlackBush/bambulab_metrics_exporter
- Docker Hub: https://hub.docker.com/r/blackbush/bambulab_metrics_exporter
- Unraid: https://ca.unraid.net/apps/bambulab-metrics-exporter-0m6hgva0fwxoea?q=bambulab-metrics-exporter

## Common questions

### Which environment variables must be set before starting the exporter?

Set BAMBULAB_TRANSPORT, BAMBULAB_SERIAL, and BAMBULAB_SECRET_KEY, using a random base64 string for the secret key.

### Which HTTP endpoints are available for scraping and health checks?

The exporter exposes /metrics, /health, and /ready.

### How can I tell if the exporter data is stale?

Check bambulab_printer_connected and bambulab_exporter_last_success_unixtime. If the connected metric is 0, the MQTT session has dropped.

### What should I do if cloud access stops working?

The cloud access token may have expired. Restart the exporter to trigger re-authentication.

---
Source: Our Local Host (https://ourlocalhost.com/app/2649/bambulab-metrics-exporter), the self-hosted and open-source app directory.
