Skip to main content
Version: 1.0.0

Your First Dashboard

This tutorial walks you through creating a comprehensive pump monitoring dashboard with real-time data, trends, and alerts.

What You'll Build​

By the end of this tutorial, you'll have a dashboard showing:

  • Real-time vibration and temperature readings
  • Historical trend charts
  • Performance KPIs
  • Health status indicators

Prerequisites​

  • TwinEdge account with an active data source
  • At least one connected device with sensor data

Step 1: Create a New Dashboard​

  1. Navigate to Dashboards in the sidebar
  2. Click New Dashboard
  3. Enter details:
    • Name: Pump Monitoring
    • Description: Real-time pump health monitoring
  4. Click Create

Step 2: Add a KPI Card​

KPI cards show important single values at a glance.

  1. Click Add Widget → KPI Card
  2. Configure the widget:
    • Title: Motor Temperature
    • Data Source: Select your pump
    • Tag: Motor_Temperature
    • Unit: °C
  3. Set thresholds:
    • Warning: 70
    • Critical: 85
  4. Click Add Widget

The card will show green (normal), yellow (warning), or red (critical) based on the current value.

Step 3: Add a Line Chart​

Trend charts show how values change over time.

  1. Click Add Widget → Line Chart
  2. Configure:
    • Title: Vibration Trends
    • Data Source: Select your pump
    • Tags: Check Vibration_X, Vibration_Y, Vibration_Z
    • Time Range: Last 1 Hour
  3. Click Add Widget

Customize the Chart​

  • Y-Axis Range: Set min/max for better visualization
  • Colors: Assign distinct colors to each series
  • Line Style: Solid, dashed, or area fill

Step 4: Add a Gauge Widget​

Gauges are ideal for values with clear operating ranges.

  1. Click Add Widget → Gauge
  2. Configure:
    • Title: Flow Rate
    • Data Source: Select your pump
    • Tag: Flow_Rate
    • Unit: L/min
    • Min: 0
    • Max: 100
  3. Set zones:
    • Green: 30-70 (optimal)
    • Yellow: 20-30, 70-85 (warning)
    • Red: 0-20, 85-100 (critical)
  4. Click Add Widget

Step 5: Add a Status Table​

Tables show multiple readings in a compact format.

  1. Click Add Widget → Table
  2. Configure:
    • Title: Sensor Readings
    • Data Source: Select your pump
    • Tags: Select all relevant tags
    • Show Columns: Name, Value, Unit, Timestamp
  3. Click Add Widget

Step 6: Arrange Your Layout​

Drag and resize widgets to create a logical layout:

┌─────────────┬─────────────┬─────────────┐
│  Temp KPI   │ Vibration   │  Flow Rate  │
│             │   KPI       │    Gauge    │
├─────────────┴─────────────┴─────────────┤
│                                         │
│          Vibration Trends Chart         │
│                                         │
├─────────────────────────────────────────┤
│           Sensor Readings Table         │
└─────────────────────────────────────────┘

Tips:

  • Group related metrics together
  • Put most critical info at the top
  • Use consistent sizing for KPI cards

Step 7: Configure Auto-Refresh​

  1. Click the Settings (gear) icon
  2. Set Auto-refresh: 5 seconds
  3. Enable Full Screen Mode for display monitors

Step 8: Save and Share​

  1. Click Save Dashboard
  2. To share with team members:
    • Click Share → Copy Link
    • Or embed: Share → Get Embed Code

Adding Alerts (Optional)​

Create alerts for critical conditions:

  1. Go to Alerts → Create Alert
  2. Configure:
    • Name: High Temperature Alert
    • Data Source: Your pump
    • Tag: Motor_Temperature
    • Condition: Greater than 80
    • Duration: 30 seconds
  3. Set notification channels
  4. Click Create

Advanced Features​

Using Variables​

Create dynamic dashboards with variables:

  1. Click Dashboard Settings → Variables
  2. Add a variable:
    • Name: pump
    • Type: Data Source
    • Multi-select: Enable
  3. Update widgets to use ${pump} instead of hardcoded sources

Time Range Selector​

Add a time range picker:

  1. The default time range control is at the top
  2. Users can select: Last 15m, 1h, 6h, 24h, 7d, or custom range

Annotations​

Mark important events on charts:

  1. Go to Dashboard Settings → Annotations
  2. Create annotation queries for:
    • Alert triggers
    • Maintenance events
    • Shift changes

Best Practices​

Dashboard Organization​

  • Overview dashboards: High-level KPIs for all assets
  • Detail dashboards: Deep dive into single assets
  • Alert dashboards: Focus on active issues

Performance Tips​

  • Limit to 10-15 widgets per dashboard
  • Use appropriate time ranges (shorter = faster)
  • Aggregate data for long time ranges

Color Conventions​

ColorMeaning
GreenNormal operation
Yellow/OrangeWarning, attention needed
RedCritical, immediate action
BlueInformational
GrayOffline/Unknown

Example Dashboards​

Explore pre-built templates:

  • Pump Health: Temperature, vibration, flow monitoring
  • Motor Performance: Current, voltage, RPM, efficiency
  • Environmental: Temperature, humidity, pressure mapping
  • Energy: Power consumption, costs, optimization

Next Steps​