Alerts & Notifications

TwinEdge's alerting system monitors your industrial data 24/7 and notifies you when conditions require attention.

Alert Overview

Alerts automatically evaluate your data against defined conditions and trigger notifications when thresholds are exceeded.

Alert Lifecycle

Data Ingested → Condition Evaluated → Alert Triggered → Notification Sent → Acknowledged → Resolved

Severity Levels

Level	Color	Use Case
Critical	Red	Immediate action required
Warning	Orange	Attention needed soon
Info	Blue	Informational only

Creating Alerts

Basic Alert

1. Go to Alerts → Create Alert
2. Configure the alert:

General Settings:

• Name: Descriptive name (e.g., "High Motor Temperature")
• Description: Additional context
• Severity: Critical, Warning, or Info

Condition:

• Data Source: Select your device
• Tag: Select the metric to monitor
• Operator: Greater than, Less than, Equals, etc.
• Threshold: The value to compare against
• Duration: How long the condition must persist

Example:

When Motor_Temperature > 80°C for 30 seconds
Trigger a Warning alert

3. Click Create Alert

Operators

Operator	Description	Example
>	Greater than	Temperature > 80
>=	Greater than or equal	Pressure >= 100
<	Less than	Flow < 10
<=	Less than or equal	Level <= 5
==	Equals	Status == 0
!=	Not equals	Mode != 1
between	Range	RPM between 1000-2000
outside	Outside range	pH outside 6-8

Advanced Conditions

Multiple Conditions (AND)

All conditions must be true:

Temperature > 80°C AND
Vibration > 5 mm/s AND
Run_Status == 1

Any Condition (OR)

At least one condition must be true:

Temperature > 90°C OR
Vibration > 8 mm/s

Rate of Change

Alert on rapid changes:

Temperature rate of change > 5°C/minute

Anomaly Detection (ML)

Use ML models for dynamic thresholds:

Vibration anomaly_score > 0.8

Notification Channels

Email

Send alert notifications via email.

Setup:

1. Go to Settings → Notifications → Email
2. Click Add Recipient
3. Enter email address
4. Select alert severities to receive

Email Content:

• Alert name and severity
• Current value and threshold
• Asset and tag information
• Link to dashboard

Slack

Integrate with Slack workspaces.

Setup:

1. Go to Settings → Notifications → Slack
2. Click Connect to Slack
3. Authorize TwinEdge in your workspace
4. Select the channel for alerts

Features:

• Rich message formatting
• Interactive acknowledge button
• Threaded alert updates

Microsoft Teams

Post alerts to Teams channels.

Setup:

1. Go to Settings → Notifications → Teams
2. Create an Incoming Webhook in Teams
3. Paste the webhook URL in TwinEdge

SMS

Receive critical alerts via text message.

Setup:

1. Go to Settings → Notifications → SMS
2. Add phone numbers
3. Enable for Critical alerts only (SMS costs apply)

Webhook

Send alerts to custom endpoints.

Setup:

1. Go to Settings → Notifications → Webhooks
2. Enter your endpoint URL
3. Configure authentication (Bearer token, Basic auth)

Payload Format:

{
  "alert_id": "alert-123",
  "name": "High Temperature",
  "severity": "critical",
  "asset": "Pump_001",
  "tag": "Motor_Temperature",
  "value": 85.2,
  "threshold": 80,
  "triggered_at": "2026-01-06T10:30:00Z",
  "dashboard_url": "https://app.twinedgeai.com/dashboard/xyz"
}

PagerDuty

Integrate with PagerDuty for on-call management.

Setup:

1. Create a TwinEdge service in PagerDuty
2. Copy the Integration Key
3. Paste in TwinEdge notification settings

OpsGenie

Send alerts to Atlassian OpsGenie.

Setup:

1. Create an API integration in OpsGenie
2. Copy the API Key
3. Configure in TwinEdge

Alert Management

Active Alerts

View all currently active alerts:

1. Go to Alerts → Active
2. Filter by severity, asset, or status
3. Click an alert for details

Acknowledging Alerts

Acknowledge to indicate you're aware:

1. Click the alert
2. Click Acknowledge
3. Optionally add a note

Acknowledged alerts remain active but won't re-notify until resolved and re-triggered.

Resolving Alerts

Alerts resolve automatically when the condition is no longer true.

Manual resolution:

1. Click the alert
2. Click Resolve
3. Add resolution notes

Alert History

View past alerts:

1. Go to Alerts → History
2. Filter by date range
3. Export to CSV for analysis

Escalation Policies

Professional tier feature.

Creating Escalation Rules

Define escalation when alerts aren't acknowledged:

1. Alerts → Escalation Policies
2. Click Create Policy
3. Configure escalation steps:

Step 1: Email to operators@company.com (immediate)
Step 2: Slack to #alerts channel (after 5 minutes)
Step 3: SMS to on-call (after 15 minutes)
Step 4: PagerDuty incident (after 30 minutes)

On-Call Schedules

Rotate who receives alerts:

1. Settings → On-Call
2. Create a schedule
3. Add team members and shifts
4. Link to escalation policies

Alert Templates

Built-in Templates

• Equipment Overheat: Temperature > threshold
• Vibration Alarm: Vibration exceeds limits
• Pressure Warning: Pressure outside range
• Communication Loss: Device offline
• Low Flow: Flow rate below minimum

Creating Templates

Save your alert configuration as a template:

1. Configure the alert
2. Click Save as Template
3. Apply to other assets quickly

Best Practices

Avoid Alert Fatigue

• Set appropriate thresholds (not too sensitive)
• Use duration requirements (avoid transient spikes)
• Route low-severity to dashboards only
• Review and tune alerts monthly

Threshold Guidelines

Metric	Warning	Critical
Motor Temperature	70°C	85°C
Vibration	4 mm/s	7 mm/s
Pressure	+/-10%	+/-20%
Flow Rate	-15%	-30%

Documentation

For each alert, document:

• Why this threshold was chosen
• What action to take when triggered
• Who is responsible for response
• Expected resolution time

API Access

List Alerts

GET /api/v1/alerts
Authorization: Bearer YOUR_API_KEY

Acknowledge Alert

POST /api/v1/alerts/{id}/acknowledge
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "note": "Operator aware, monitoring situation"
}

Create Alert Rule

POST /api/v1/alert-rules
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "name": "High Temperature",
  "severity": "warning",
  "data_source_id": "ds-123",
  "tag": "Motor_Temperature",
  "condition": {
    "operator": "gt",
    "value": 80,
    "duration_seconds": 30
  },
  "notifications": ["email", "slack"]
}

Next Steps

• ML Models - Predictive alerts with ML
• Query Builder - Complex alert conditions
• Scheduled Reports - Alert summary reports