System Info¶
View system information, database statistics, and manage telemetry settings.
Overview¶
The System Info page shows:
- Database statistics - Archive counts, sizes
- Resource usage - Memory, storage
- Application info - Version, uptime
- Telemetry settings - Anonymous usage data
Database Statistics¶
Archive Statistics¶
| Metric | Description |
|---|---|
| Total Archives | Number of archived prints |
| Total Size | Database file size |
| 3MF Files | Number of stored 3MF files |
| Thumbnails | Number of thumbnail images |
| Photos | Number of attached photos |
Print Statistics¶
| Metric | Description |
|---|---|
| Successful Prints | Completed prints |
| Failed Prints | Print failures |
| Total Print Time | Cumulative hours |
| Total Filament | Cumulative kg |
Database Health¶
| Check | Status |
|---|---|
| Integrity | Database file intact |
| FTS Index | Full-text search working |
| Connections | Active database connections |
Resource Usage¶
Memory¶
| Metric | Value |
|---|---|
| RAM Used | Current usage |
| RAM Available | Free memory |
| Process Memory | Bambuddy process |
Storage¶
| Metric | Value |
|---|---|
| Database Size | SQLite file size |
| Archive Folder | 3MF and thumbnail storage |
| Log Files | Log directory size |
| Total Used | All Bambuddy data |
Disk Space¶
| Location | Free Space |
|---|---|
| Data Directory | Available storage |
| Archive Directory | Available storage |
Application Info¶
Version¶
| Info | Value |
|---|---|
| Version | Current Bambuddy version |
| Python | Python version |
| Database | SQLite version |
Runtime¶
| Info | Value |
|---|---|
| Uptime | Time since start |
| Started | Start timestamp |
| Restarts | Number of restarts |
Environment¶
| Info | Value |
|---|---|
| OS | Operating system |
| Architecture | CPU architecture |
| Docker | Running in Docker? |
Telemetry¶
Anonymous Usage Data¶
Bambuddy can collect anonymous usage statistics to help improve the application.
What's Collected¶
| Data | Purpose |
|---|---|
| Feature usage | Which features are popular |
| Error counts | Common issues |
| Print counts | Usage volume |
| OS/Version | Compatibility |
What's NOT Collected¶
- Personal information
- Printer details
- IP addresses
- Print names or files
- Filament info
- Anything identifiable
Opt-Out¶
Disable telemetry:
- Go to Settings > System Info
- Find Anonymous Telemetry
- Toggle OFF
- Click Save
Telemetry Helps Development
Anonymous usage data helps prioritize features and identify issues. Consider leaving it enabled.
Maintenance Actions¶
Rebuild FTS Index¶
If search isn't working correctly:
- Click Rebuild Search Index
- Wait for completion
- Search should work now
Clear Cache¶
Remove temporary files:
- Click Clear Cache
- Confirm action
- Cache is cleared
Vacuum Database¶
Optimize database size:
- Click Vacuum Database
- Wait for completion
- May reduce file size
When to Vacuum
Vacuum after deleting many archives to reclaim disk space.
Debug Information¶
Log Files¶
Access application logs:
| Log | Content |
|---|---|
| Application | General operations |
| MQTT | Printer communication |
| Database | Database operations |
Log Level¶
Configure logging detail:
| Level | Detail |
|---|---|
| ERROR | Only errors |
| WARNING | Errors + warnings |
| INFO | Normal operations |
| DEBUG | Everything (verbose) |
API Endpoint¶
Get system info via API:
Response includes:
{
"version": "0.1.5b6",
"uptime": 86400,
"database": {
"archives": 1234,
"size_mb": 45.6
},
"resources": {
"memory_mb": 256,
"disk_free_gb": 100
}
}
Tips¶
Regular Checks
Check system info periodically to monitor storage and performance.
Before Backups
Review database size before backing up to plan storage.
Troubleshooting
Check uptime and logs when investigating issues.
Clean Up
Use vacuum and cache clear to maintain performance.