Skip to main content
Version: 1.0.0

Local Dashboard

The TwinEdge Edge local dashboard provides on-device monitoring when cloud connectivity is unavailable or for low-latency visualization.

Overview​

The local dashboard runs directly on your edge device, accessible via web browser on the local network.

Key Features​

  • Real-time data: Sub-second updates
  • Offline operation: No internet required
  • Local alerts: On-device alert processing
  • PWA support: Install as mobile app
  • Touch-optimized: Works on tablets

Accessing the Dashboard​

URL​

Access from any device on the same network:

http://EDGE_DEVICE_IP:3000

For example:

  • http://192.168.1.100:3000
  • http://twinedge-edge-1.local:3000 (mDNS)

Finding the IP Address​

On the edge device:

hostname -I

Or check your router's connected devices list.

Authentication​

Default credentials:

  • Username: admin
  • Password: twinedge
Change Default Password

Change the default password immediately after first login via Settings → Users.

Dashboard Layout​

Home Page​

The home page shows:

  • System Status: CPU, memory, disk usage
  • Connected Assets: List of configured assets
  • Recent Alerts: Latest triggered alerts
  • Cloud Sync: Connection status to TwinEdge Cloud

Asset View​

Click an asset to see:

  • Real-time Values: Current sensor readings
  • Trend Charts: Recent data history
  • Health Status: Normal/Warning/Critical
  • ML Predictions: Anomaly scores (if deployed)

Alerts Page​

View and manage alerts:

  • Active Alerts: Currently triggered
  • Alert History: Past 24 hours
  • Acknowledge: Mark alerts as seen
  • Silence: Temporarily mute

Real-time Visualization​

Live Charts​

Charts update in real-time via WebSocket:

  • Streaming mode: New points appear instantly
  • Buffering: Smooth rendering for high-frequency data
  • Zoom: Click and drag to zoom time range

Gauges and KPIs​

  • Animated transitions: Smooth value changes
  • Color coding: Green/Yellow/Red based on thresholds
  • Sparklines: Mini trend indicators

Data Tables​

  • Auto-refresh: Configurable update interval
  • Sorting: Click column headers
  • Filtering: Quick search

Alert Management​

Viewing Alerts​

The alert indicator shows:

  • 🔴 Critical alerts active
  • 🟡 Warning alerts active
  • 🟢 No active alerts

Acknowledging Alerts​

  1. Click the alert
  2. Click Acknowledge
  3. Optionally add a note
  4. Alert moves to "Acknowledged" status

Alert Actions​

On the local dashboard, you can:

  • Acknowledge: Mark as seen
  • Silence (1h/4h/24h): Temporarily mute
  • View Details: See trigger history

Offline Operation​

What Works Offline​

When disconnected from the cloud:

FeatureAvailable Offline
Data collectionYes
Local visualizationYes
Local alertsYes
ML inferenceYes
Cloud syncNo
Remote accessNo

Data Buffering​

Data is stored locally when offline:

storage:
  buffer_size_gb: 10
  retention_days: 7
  sync_on_reconnect: true

When cloud connectivity returns, buffered data syncs automatically.

Offline Alerts​

Local alerts continue to work:

  • LED indicators (if configured)
  • Local audio alarms
  • Local email (if SMTP configured)

Configuration​

Dashboard Settings​

Access via Settings gear icon:

Display:

  • Theme: Light/Dark/Auto
  • Refresh rate: 1-60 seconds
  • Default time range: 15m/1h/6h/24h

Units:

  • Temperature: °C/°F
  • Pressure: bar/psi
  • Time format: 12h/24h

Asset Configuration​

Edit assets via Settings → Assets:

  • Add/remove tags
  • Set display names
  • Configure thresholds
  • Set polling intervals

User Management​

Manage local users:

  1. Go to Settings → Users
  2. Add/edit users
  3. Set roles (Admin/Operator/Viewer)

Mobile Access​

Progressive Web App (PWA)​

Install as an app on mobile devices:

iOS:

  1. Open in Safari
  2. Tap Share → "Add to Home Screen"

Android:

  1. Open in Chrome
  2. Tap menu → "Add to Home Screen"

Touch Optimization​

The dashboard is optimized for touch:

  • Large touch targets
  • Swipe navigation
  • Pinch-to-zoom on charts

Performance​

BrowserPerformance
ChromeExcellent
FirefoxExcellent
SafariGood
EdgeExcellent

Resource Usage​

The dashboard uses:

  • ~50MB memory in browser
  • Minimal CPU when idle
  • ~100KB/s network during real-time updates

Scaling Considerations​

For many assets (50+):

  • Use pagination
  • Limit visible charts
  • Consider multiple dashboards

Customization​

Custom Pages​

Create custom dashboard pages:

  1. Go to Settings → Pages
  2. Click New Page
  3. Drag and drop widgets
  4. Save and set visibility

Widget Library​

Available widgets:

  • Line Chart
  • Gauge
  • KPI Card
  • Table
  • Status Indicator
  • Asset Map (local network)

Theming​

Customize appearance:

/* Custom theme in Settings → Appearance */
:root {
  --primary-color: #00E5BF;
  --background: #0B0F14;
  --surface: #151B23;
}

Troubleshooting​

Dashboard Not Loading​

  1. Verify edge device is running:

    docker compose ps

  2. Check dashboard service:

    docker compose logs dashboard

  3. Verify port is accessible:

    curl http://localhost:3000

Slow Performance​

  1. Check browser console for errors
  2. Reduce number of visible charts
  3. Increase chart refresh interval
  4. Check edge device resources

Data Not Updating​

  1. Check WebSocket connection (browser dev tools)
  2. Verify data source connectivity
  3. Check dashboard-api service logs

Login Issues​

Reset admin password:

cd /opt/twinedge
docker compose exec dashboard-api python reset_password.py admin

API Access​

Local REST API​

The dashboard API is available locally:

# Get current values
curl http://localhost:5000/api/assets

# Get asset details
curl http://localhost:5000/api/assets/Pump_001/sensors

# Get historical data
curl "http://localhost:5000/api/assets/Pump_001/history?start=-1h"

WebSocket​

Real-time data via WebSocket:

const ws = new WebSocket('ws://localhost:5000/ws');

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log(data);
};

// Subscribe to asset
ws.send(JSON.stringify({
  type: 'subscribe',
  asset_id: 'Pump_001'
}));

Next Steps​