Observability with Grafana, Prometheus, and Tempo
LobeHub supports advanced observability for self-hosted deployments using open-source tools:
- Grafana for dashboards and visualization
- Prometheus for metrics collection
- Tempo for distributed tracing
- otel-collector ingesting other OpenTelemetry supported data
We provided Docker Compose (docker-compose) file presets to bootstrap the observability stack with advanced self-hosting features.
This guide will help you set up and use these tools to monitor your LobeHub instance.
Prerequisites
dockerCLI- OrbStack (macOS), or Docker Desktop Windows
docker-composeplugin enabled (check throughdocker compose version)
1. Deploy
-
Update the password & secrets in the
.envfile as needed. -
Start the stack with the correct profile:
docker compose up -dThis will launch Grafana, Prometheus, Tempo, and the otel-collector alongside LobeHub with Casdoor, Minio, and other advanced services.
2. Access Grafana Dashboards
- Open Grafana in your browser at http://localhost:3000 (or your server's IP).
- Default login (if required):
- Username: admin
- Password: (see your environment or Docker Compose file)
3. Explore traces & metrics
Click on "Explore" in the left sidebar to access the query editor to run ad-hoc queries against your Prometheus and Tempo data sources.
4. Troubleshooting
- Ensure all containers are running:
docker compose ps - Check logs for any service:
docker compose logs <service-name> - Verify Prometheus and Tempo are scraping and receiving data from LobeHub and otel-collector.
See Also
For questions or feedback, open an issue on GitHub or join our community discussions.