tony/bzzz
1
0
Fork 0
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity
Files
605fb92ee71a75f49612b13961bc855d19bec07c
bzzz/README_MONITORING.md
anthonyrawlins 605fb92ee7 Add mock API testing infrastructure and monitoring dashboard 
- Add mock Hive API server providing fake projects/tasks for real bzzz coordination
- Add comprehensive test suite with task simulator and coordination scenarios
- Add real-time monitoring dashboard (btop/nvtop style) for coordination activity
- Add antennae monitoring and logging infrastructure
- Add systemd configuration scripts and deployment tools
- Update pubsub message types for coordination requests and completion
- Add Docker support and cluster deployment scripts

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-14 11:30:34 +10:00

4.7 KiB
Raw Blame History

Bzzz Antennae Monitoring Dashboard

A real-time console monitoring dashboard for the Bzzz P2P coordination system, similar to btop/nvtop for system monitoring.

Features

🔍 Real-time P2P Status

  • Connected peer count with history graph
  • Node ID and network status
  • Hive API connectivity status

🤖 Agent Activity Monitoring

  • Live agent availability updates
  • Agent status distribution (ready/working/busy)
  • Recent activity tracking

🎯 Coordination Activity

  • Task announcements and completions
  • Coordination session tracking
  • Message flow statistics

📊 Visual Elements

  • ASCII graphs for historical data
  • Color-coded status indicators
  • Live activity log with timestamps

Usage

Basic Usage

# Run with default 1-second refresh rate
python3 cmd/bzzz-monitor.py

# Custom refresh rate (2 seconds)
python3 cmd/bzzz-monitor.py --refresh-rate 2.0

# Disable colors for logging/screenshots
python3 cmd/bzzz-monitor.py --no-color

Installation as System Command

# Copy to system bin
sudo cp cmd/bzzz-monitor.py /usr/local/bin/bzzz-monitor
sudo chmod +x /usr/local/bin/bzzz-monitor

# Now run from anywhere
bzzz-monitor

Dashboard Layout

┌─ Bzzz P2P Coordination Monitor ─┐
│ Uptime: 0:02:15 │ Node: 12*SEE3To... │
└───────────────────────────────────┘

P2P Network Status
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Connected Peers: 2
Hive API Status: Offline (Overlay Network Issues)

Peer History (last 20 samples):
███▇▆▆▇████▇▆▇███▇▆▇ (1-3 peers)

Agent Activity  
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Recent Updates (1m): 8
  Ready: 6
  Working: 2

Coordination Activity
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Total Messages: 45
Total Tasks: 12
Active Sessions: 1
Recent Tasks (5m): 8

Recent Activity
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
11:10:35 [AVAIL] Agent acacia-node... status: ready
11:10:33 [TASK]  Task announcement: hive#15 - WebSocket support
11:10:30 [COORD] Meta-coordination session started
11:10:28 [AVAIL] Agent ironwood-node... status: working
11:10:25 [ERROR] Failed to get active repositories: API 404

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Press Ctrl+C to exit | Refresh rate: 1.0s

Monitoring Data Sources

The dashboard pulls data from:

  1. Systemd Service Logs: journalctl -u bzzz.service
  2. P2P Network Status: Extracted from bzzz log messages
  3. Agent Availability: Parsed from availability_broadcast messages
  4. Task Activity: Detected from task/repository-related log entries
  5. Error Tracking: Monitors for failures and connection issues

Color Coding

  • 🟢 Green: Good status, active connections, ready agents
  • 🟡 Yellow: Working status, moderate activity
  • 🔴 Red: Errors, failed connections, busy agents
  • 🔵 Blue: Information, neutral data
  • 🟣 Magenta: Coordination-specific activity
  • 🔷 Cyan: Network and P2P data

Real-time Updates

The dashboard updates every 1-2 seconds by default and tracks:

  • P2P Connections: Shows immediate peer join/leave events
  • Agent Status: Real-time availability broadcasts from all nodes
  • Task Flow: Live task announcements and coordination activity
  • System Health: Continuous monitoring of service status and errors

Performance

  • Low Resource Usage: Python-based with minimal CPU/memory impact
  • Efficient Parsing: Only processes recent logs (last 30-50 lines)
  • Responsive UI: Fast refresh rates without overwhelming the terminal
  • Historical Data: Maintains rolling buffers for trend analysis

Troubleshooting

No Data Appearing

# Check if bzzz service is running
systemctl status bzzz.service

# Verify log access permissions
journalctl -u bzzz.service --since "1 minute ago"

High CPU Usage

# Reduce refresh rate
bzzz-monitor --refresh-rate 5.0

Color Issues

# Disable colors
bzzz-monitor --no-color

# Check terminal color support
echo $TERM

Integration

The monitor works alongside:

  • Live Bzzz System: Monitors real P2P mesh (WALNUT/ACACIA/IRONWOOD)
  • Test Suite: Can monitor test coordination scenarios
  • Development: Perfect for debugging antennae coordination logic

Future Enhancements

  • 📈 Export metrics to CSV/JSON
  • 🔔 Alert system for critical events
  • 📊 Web-based dashboard version
  • 🎯 Coordination session drill-down
  • 📱 Mobile-friendly output