Skip to main content

Dashboard

Monitor system health, workflow statistics, and resource usage in the EdgeFlow dashboard

The Dashboard provides a real-time overview of your EdgeFlow system, including health status, workflow statistics, and resource monitoring. It's your central hub for understanding the state of your automations.

Dashboard Interface

Dashboard
Dashboard Workflows Executions Modules Settings
System Health ● Healthy
Uptime 3d 14h 22m
WebSocket Clients 2
Last Check Just now
Workflows View All →
12 Total
8 Running
3 Stopped
1 Error
Resources
CPU 23%
Memory 156 MB / 1 GB
Disk 2.3 GB / 16 GB
Recent Activity
Temperature Monitor started 2m ago
MQTT Handler deployed 15m ago
! GPIO Reader error 1h ago

System Health

The System Health card shows the overall status of your EdgeFlow installation and provides key metrics at a glance.

Health Status Indicators

Healthy

All systems operating normally. API responding, database connected, all services running.

Degraded

Some non-critical services have issues. Core functionality works but may have reduced performance.

Unhealthy

Critical issues detected. Some features may not work. Immediate attention required.

Health Metrics

Metric Description Update Frequency
Uptime Time since EdgeFlow service started Real-time
WebSocket Clients Number of connected browser sessions and API clients Real-time
Last Health Check When the last health verification was performed Every 30 seconds
Database Status Connection status to SQLite/PostgreSQL database Every 30 seconds
Engine Status Flow execution engine operational status Real-time

Workflow Statistics

The Workflows card provides a quick overview of all your automation flows and their current status.

Workflow States

📊

Total

Total number of flows created in EdgeFlow, regardless of their current state.

Running

Flows that are actively executing and processing messages.

Stopped

Flows that have been manually stopped or are in idle state.

Error

Flows that encountered errors and require attention.

Quick Actions

  • View All - Navigate to the Workflows page for detailed management
  • Click on a stat - Filter workflows by that status
  • Error count - Click to see flows with errors that need fixing

Resource Monitoring

The Resources card displays real-time system resource usage, essential for monitoring performance on resource-constrained edge devices like Raspberry Pi.

Resource Metrics

💻

CPU Usage

Current processor utilization percentage. High CPU may indicate heavy processing or inefficient flows.

0-50%: Normal 50-80%: Moderate 80%+: High
🧠

Memory Usage

RAM consumption by EdgeFlow. Shows used and total available memory.

Minimal: 50MB idle Standard: 150MB Full: 400MB
💾

Disk Usage

Storage space used by database, logs, and configuration files.

Database: ~10MB Logs: Variable Watch if >80%

Resource Auto-Scaling

EdgeFlow includes intelligent resource management that can automatically disable non-essential modules when resources are constrained:

📉

Low Memory Mode

When memory exceeds 80%, EdgeFlow automatically unloads unused modules to free resources.

CPU Throttling

High CPU usage triggers rate-limiting on non-critical operations.

🔄

Automatic Recovery

Resources are restored when system load returns to normal levels.

Recent Activity

The Activity feed shows recent events in your EdgeFlow system, helping you track changes and identify issues quickly.

Activity Types

Icon Type Description
Flow Started A workflow was started manually or by a trigger
Flow Stopped A workflow was stopped manually
Deployment Flow changes were deployed to the runtime
+ Flow Created A new workflow was created
Flow Modified An existing workflow was edited
🗑 Flow Deleted A workflow was removed
! Error An error occurred in a workflow
📦 Module Event A module was loaded, unloaded, or installed

Real-time Updates

The Dashboard uses WebSocket connections to provide real-time updates without requiring page refreshes.

🔌

WebSocket Connection

EdgeFlow maintains a persistent WebSocket connection between your browser and the server. This enables instant updates for:

  • Health status changes
  • Workflow state transitions
  • Resource metrics (updated every 5 seconds)
  • Activity feed events
  • Debug messages from flows
🔄

Connection Status

The connection indicator in the header shows your WebSocket status:

Connected - Real-time updates active
Reconnecting - Attempting to restore connection
Disconnected - Manual refresh required

Dashboard Customization

The Dashboard layout can be customized to show the information most relevant to your needs.

🎛️ Card Visibility

Show or hide dashboard cards based on your preferences. Access via Settings → Dashboard.

📐 Layout Options

Rearrange cards by dragging them to your preferred positions.

🔄 Refresh Rate

Adjust resource monitoring refresh interval (default: 5 seconds).

🌙 Theme

Switch between light and dark themes for comfortable viewing.

Raspberry Pi Considerations

When running EdgeFlow on Raspberry Pi, the Dashboard helps you monitor resource constraints specific to edge devices.

Recommended Monitoring Practices

1

Watch Memory Usage

Pi Zero has only 512MB RAM. Keep memory under 400MB for stable operation. The Minimal profile uses ~50MB idle.

2

Monitor CPU Temperature

High CPU usage can cause thermal throttling. Consider adding a heatsink or fan for intensive workloads.

3

Check Disk Space

SD cards have limited space. Enable log rotation and periodically clean old execution logs.

4

Use Appropriate Profile

Choose the right build profile for your Pi model: Minimal for Pi Zero, Standard for Pi 3/4, Full for Pi 4/5 with 2GB+ RAM.