Features-Monitoring.md 3.7 KB
Real-time Monitoring
Bambuddy provides live monitoring of all your connected Bambu Lab printers through WebSocket-based real-time updates.
Printer Status
Each printer card displays real-time information:
Connection Status
- Green indicator: Connected and communicating
- Red indicator: Disconnected or connection error
- Yellow indicator: Connecting or reconnecting
Temperature Readouts
| Sensor | Description |
|---|---|
| Nozzle | Current hotend temperature |
| Bed | Heated bed temperature |
| Chamber | Enclosure temperature (if available) |
Print Progress
When a print is active:
- Progress bar: Visual completion percentage
- Current layer: Layer X of Y
- Time remaining: Estimated time to completion
- Filament used: Grams consumed
HMS Error Monitoring
The Health Management System (HMS) monitors printer health:
Status Indicator
Always visible on printer cards:
- Green "OK": No issues detected
- Yellow: Minor issues or warnings
- Orange: Serious errors requiring attention
- Red: Fatal errors - stop printing
Error Severity Levels
| Level | Color | Action Required |
|---|---|---|
| Info | Blue | Informational only |
| Common | Yellow | Check when convenient |
| Serious | Orange | Address before next print |
| Fatal | Red | Immediate attention needed |
Error Details
Click the HMS indicator to see:
- Error code and description
- Affected component
- Recommended action
- Link to Bambu Lab support article
MQTT Debug Logging
Built-in debugging tool for printer communication:
Starting Debug Logging
- Go to printer settings
- Click "Start MQTT Debug"
- Messages are captured in real-time
Viewing Messages
- Incoming: Messages from printer to Bambuddy
- Outgoing: Commands sent to printer
- JSON payloads: Expandable for detailed inspection
- Auto-refresh: New messages appear automatically
Use Cases
- Troubleshooting connection issues
- Understanding printer behavior
- Debugging automation problems
- Reporting issues to developers
AMS (Automatic Material System)
For printers with AMS units:
Slot Status
- Filament color: Visual swatch for each slot
- Material type: PLA, PETG, ABS, etc.
- Remaining: Estimated filament left
- Temperature: Drying chamber temp (if applicable)
Humidity Monitoring
- Current humidity level in AMS
- Warning indicators for high humidity
Camera Feed
Access your printer's camera:
- Click the camera icon on a printer card
- View live camera feed
- Take snapshots
- Monitor print progress visually
Camera Page
Dedicated camera view with:
- Larger video display
- Multiple printer support
- Snapshot history
WebSocket Architecture
Bambuddy uses WebSocket for real-time updates:
Printer → MQTT → Bambuddy Backend → WebSocket → Browser
Connection Handling
- Automatic reconnection on disconnect
- State synchronization on reconnect
- Efficient delta updates (only changed data)
Performance
- Low latency updates (<1 second typical)
- Minimal bandwidth usage
- Multiple browser tabs supported
Notifications on Status Changes
Configure alerts for printer events:
- Printer Offline: When connection is lost
- Printer Error: When HMS errors occur
- Print Complete: When a job finishes
- Print Failed: When a print fails
See Push Notifications for setup details.
Tips
- Keep the Printers page open for at-a-glance monitoring
- Use the camera page for visual confirmation of print quality
- Enable HMS error notifications to catch problems early
- Check MQTT debug logs if a printer behaves unexpectedly