Skip to content

Metrics#

The Metrics page provides real-time and historical system monitoring, displaying CPU, memory, disk, and network usage for the DUMB container.

Overview#

The metrics dashboard shows:

  • Real-time gauges - Current resource usage
  • Historical charts - Usage trends over time
  • Process details - Per-service resource consumption
  • System information - Container and host details

Metrics dashboard

Resource monitoring#

CPU usage#

Metric Description
Usage % Current CPU utilization
Core Count Available CPU cores
Load Average 1, 5, 15 minute averages

The CPU gauge shows:

  • Green: 0-60%
  • Amber: 60-85%
  • Red: 85%+

Memory usage#

Metric Description
Used Currently allocated memory
Available Free memory for allocation
Total Total system RAM
Usage % Percentage in use

Swap usage#

Metric Description
Used Current swap utilization
Total Total swap space
Usage % Percentage in use

Swap monitoring

High swap usage may indicate memory pressure. Consider increasing container memory limits.

Disk usage#

Metric Description
Used Space consumed
Free Available space
Total Total disk capacity
Usage % Percentage in use

Network I/O#

Metric Description
Bytes Sent Total outbound data
Bytes Received Total inbound data
Packets Sent Outbound packet count
Packets Received Inbound packet count

Historical charts#

The metrics page displays time-series charts showing resource usage over time:

  • Time range - Configurable history window
  • Bucket size - Data aggregation interval
  • Auto-refresh - Continuous updates via WebSocket

Chart controls#

Control Function
Zoom Scroll to zoom in/out
Pan Click and drag to move
Reset Double-click to reset view

Per-process metrics#

View resource usage for individual services:

Column Description
Process Service name
PID Process ID
CPU % CPU utilization
Memory % RAM utilization
Memory RSS Resident set size

Sort by any column to identify resource-intensive services.

System information#

Container details#

Info Description
Boot Time When the container started
Uptime Time since boot
Platform Operating system

cgroup awareness#

DUMB automatically detects whether it's running in a cgroup-limited environment (Docker/Kubernetes) and reports metrics accordingly:

  • cgroup mode - Reports container limits, not host resources
  • Host mode - Reports full system resources

WebSocket connection#

Metrics are streamed in real-time via WebSocket:

Status Indicator
Connected Live updates active
Connecting Establishing connection
Disconnected No live updates

The frontend automatically reconnects if the connection drops.

Configuration#

Update interval#

Configure how frequently metrics are updated:

Setting Default Range
Interval 2 seconds 0.5-10 seconds

Lower intervals provide more responsive updates but increase network traffic.

History settings#

Setting Default Description
Retention 7 days How long to keep history
Bucket Size 5 seconds Aggregation interval
Max File Size 50 MB Per-file storage limit

Alert thresholds#

Configure when alerts appear on the dashboard:

Resource Default Setting Location
CPU 85% Settings Preferences
Memory 85% Settings Preferences
Disk 90% Settings Preferences

Alerts appear as banners at the top of the dashboard when thresholds are exceeded.

API access#

Metrics are also available via the REST API:

# Current metrics snapshot
curl http://localhost:8000/api/metrics

# Historical metrics
curl http://localhost:8000/api/metrics/history?start=2025-01-01&end=2025-01-15

See the WebSocket API documentation for real-time streaming.

Troubleshooting#

Metrics not updating#

  • Check WebSocket connection status
  • Verify browser supports WebSocket
  • Check for network/firewall issues

High memory usage#

  • Review per-process metrics to identify heavy services
  • Consider disabling unused services
  • Increase container memory limits

Disk filling up#

  • Check log file sizes
  • Review metrics retention settings
  • Clear old data if needed