Metrics & Monitoring

EmberNet provides comprehensive metrics collection and visualization for industrial environments. This document covers the metrics pipeline, available visualizations, and how to create custom monitoring dashboards.

Metrics Pipeline

Data Collection

EmberNet collects metrics from multiple sources:

• Industrial Protocols — OPC UA, MQTT, Modbus, SNMP, and BACnet
• System Metrics — CPU, memory, disk, and network utilization of edge nodes
• Application Metrics — EmberNet platform service health and performance
• Custom Metrics — User-defined metrics submitted via the API

Data Flow

Devices/Sensors → Protocol Adapters → Normalization → Time-Series Storage → Dashboards

1. Protocol adapters collect raw readings from connected devices
2. Data is normalized into a standard metric format with tags and timestamps
3. Metrics are stored in high-performance time-series storage
4. Dashboard widgets query the storage layer for visualization

Metric Types

Type	Description	Example
Gauge	Point-in-time value	Temperature: 72.5°F
Counter	Monotonically increasing count	Total items produced: 14,523
Rate	Change over time	Throughput: 250 items/hour
Histogram	Distribution of values	Response time distribution
State	Enumerated state	Valve: Open / Closed

Dashboard Widgets

Visualization Types

EmberNet includes a rich set of widget types:

• Time Series Chart — Line, area, or bar charts over time
• Gauge — Radial or linear gauge showing a single value
• Stat Panel — Large numeric display with trend indicator
• Table — Tabular data with sorting and filtering
• Heatmap — Density visualization for large datasets
• Status Map — Geographic or logical map with status indicators
• Alert List — Current and historical alerts

Creating Dashboards

1. Navigate to Dashboards → New Dashboard
2. Click Add Widget to insert a visualization
3. Select the metric source(s) and configure the query
4. Choose a visualization type and customize appearance
5. Arrange and resize widgets by dragging
6. Save the dashboard with a name and optional description

Dashboard Templates

EmberNet includes pre-built templates for common use cases:

• System Overview — Edge node health, CPU, memory, disk, network
• Production Line — OPC UA tag monitoring, cycle times, OEE metrics
• Environmental — Temperature, humidity, pressure monitoring
• Network Health — Mesh connectivity, latency, bandwidth
• Alert Summary — Active alerts by severity and tenant

Querying Metrics

Time Range Selection

All dashboard views support flexible time range selection:

• Preset ranges: Last 5 minutes, 1 hour, 6 hours, 24 hours, 7 days
• Custom range: Pick specific start and end dates/times
• Auto-refresh: Automatically update at configurable intervals

Aggregation

For large datasets, metrics are automatically aggregated:

Time Range	Default Aggregation
< 1 hour	Raw data points
1–6 hours	10-second intervals
6–24 hours	1-minute intervals
1–7 days	5-minute intervals
7+ days	1-hour intervals

Filtering

Metrics can be filtered by:

• Device — Select specific devices or device groups
• Tag — Filter by metric tags (location, equipment type, etc.)
• Tenant — Scope to specific tenant (platform admins)
• Value — Filter by metric value range

Data Export

Metrics data can be exported for external analysis:

• CSV Export — Download query results as CSV files
• API Access — Query metrics programmatically via the REST API
• Streaming — Real-time metric streaming via MQTT or webhooks

Next Steps

• Alerts & Notifications — Set up alerting on metrics
• API Reference — Query metrics via API
• Configuration Reference — Configure data retention