Alert-Konnektor

Übersicht

Der Alert-Konnektor sendet Benachrichtigungen, wenn Bedingungen erfüllt sind.

Konnektor-Typ: MeddleAlert

Benachrichtigungstypen: E-Mail

Konfiguration

{
  "type": "MeddleAlert",
  "config": {
    "name": "High Temperature Alert",
    "condition": "temperature > 80",
    "minDuration": 10,
    "cooldown": 300,
    "notification": {
      "type": "Email",
      "smtpHost": "smtp.example.com",
      "smtpPort": 587,
      "smtpUser": "alerts@example.com",
      "smtpPass": "password",
      "fromEmail": "alerts@example.com",
      "toEmails": ["operator@example.com", "manager@example.com"],
      "subject": "Temperaturwarnung",
      "body": "Die Temperatur hat den Schwellenwert überschritten"
    }
  }
}

Konfigurationsparameter

• name: Warnungsname zur Identifikation
• condition: MXL-Ausdruck für Auslösebedingung
• minDuration: Mindestsekunden, die Bedingung wahr sein muss vor Warnung
• cooldown: Sekunden Wartezeit vor Senden einer weiteren Warnung
• notification: Benachrichtigungskonfiguration

E-Mail-Benachrichtigung

• type: "Email"
• smtpHost: SMTP-Server-Hostname
• smtpPort: SMTP-Server-Port (typischerweise 587 oder 465)
• smtpUser: SMTP-Benutzername
• smtpPass: SMTP-Passwort
• fromEmail: Absender-E-Mail-Adresse
• toEmails: Array von Empfänger-E-Mail-Adressen
• subject: E-Mail-Betreff
• body: E-Mail-Text

MXL-Bedingungen

Verwenden Sie MXL-Ausdrücke für Bedingungen:

temperature > 80
pressure < 10
temperature > 80 && pressure < 10
humidity > 60 || temperature > 25
status == "error"

Siehe MXL-Referenz für vollständige Syntax.

Mindestdauer

Verhindert Fehlalarme, indem die Bedingung für eine Mindestdauer wahr sein muss:

{
  "minDuration": 10
}

Bedingung muss 10 Sekunden lang wahr sein, bevor Warnung gesendet wird.

Cooldown

Verhindert Warnungs-Spam durch Warten zwischen Benachrichtigungen:

{
  "cooldown": 300
}

Nach dem Senden einer Warnung 300 Sekunden (5 Minuten) warten, bevor eine weitere gesendet wird.

Anwendungsfälle

1. Temperaturüberwachung

{
  "type": "MeddleAlert",
  "config": {
    "name": "Freezer Temperature Alert",
    "condition": "temperature > -10",
    "minDuration": 30,
    "cooldown": 600,
    "notification": {
      "type": "Email",
      "smtpHost": "smtp.gmail.com",
      "smtpPort": 587,
      "smtpUser": "alerts@company.com",
      "smtpPass": "app-password",
      "fromEmail": "alerts@company.com",
      "toEmails": ["maintenance@company.com"],
      "subject": "Gefrierschrank-Temperaturwarnung",
      "body": "Gefrierschrank-Temperatur liegt über -10°C"
    }
  }
}

2. Geräteausfall

{
  "type": "MeddleAlert",
  "config": {
    "name": "Machine Stopped",
    "condition": "status == \"stopped\" && runtime > 0",
    "minDuration": 60,
    "cooldown": 1800,
    "notification": {
      "type": "Email",
      "smtpHost": "smtp.example.com",
      "smtpPort": 587,
      "smtpUser": "alerts@factory.com",
      "smtpPass": "password",
      "fromEmail": "alerts@factory.com",
      "toEmails": ["supervisor@factory.com", "maintenance@factory.com"],
      "subject": "Maschine gestoppt Warnung",
      "body": "Produktionsmaschine unerwartet gestoppt"
    }
  }
}

3. Mehrere Bedingungen

{
  "type": "MeddleAlert",
  "config": {
    "name": "Critical Process Alert",
    "condition": "temperature > 100 || pressure > 150 || vibration > 5",
    "minDuration": 5,
    "cooldown": 300,
    "notification": {
      "type": "Email",
      "smtpHost": "smtp.example.com",
      "smtpPort": 587,
      "smtpUser": "critical@factory.com",
      "smtpPass": "password",
      "fromEmail": "critical@factory.com",
      "toEmails": ["emergency@factory.com"],
      "subject": "KRITISCH: Prozesswarnung",
      "body": "Kritische Prozessparameter überschritten"
    }
  }
}

SMTP-Konfiguration

Gmail

{
  "smtpHost": "smtp.gmail.com",
  "smtpPort": 587,
  "smtpUser": "your-email@gmail.com",
  "smtpPass": "app-specific-password"
}

Hinweis: Verwenden Sie App-Passwörter für Gmail.

Office 365

{
  "smtpHost": "smtp.office365.com",
  "smtpPort": 587,
  "smtpUser": "your-email@company.com",
  "smtpPass": "your-password"
}

Benutzerdefiniertes SMTP

{
  "smtpHost": "mail.example.com",
  "smtpPort": 587,
  "smtpUser": "alerts@example.com",
  "smtpPass": "password"
}

Best Practices

1. Angemessene minDuration setzen - Fehlalarme vermeiden
2. Vernünftigen Cooldown verwenden - Warnungsmüdigkeit verhindern
3. SMTP-Einstellungen testen - Sicherstellen, dass E-Mails zugestellt werden
4. Beschreibende Namen verwenden - Warnungen leicht identifizieren
5. Kontext im Body einbeziehen - Warnungen umsetzbar machen

Fehlerbehebung

E-Mails werden nicht gesendet

• SMTP-Anmeldeinformationen überprüfen
• SMTP-Host und -Port überprüfen
• Sicherstellen, dass Firewall SMTP-Verkehr erlaubt
• SMTP-Verbindung separat testen
• Spam-Ordner überprüfen

Zu viele Warnungen

• minDuration erhöhen
• cooldown erhöhen
• Bedingung verfeinern, um spezifischer zu sein

Fehlende Warnungen

• minDuration verringern
• Bedingungslogik überprüfen
• Sicherstellen, dass Daten durch den Konnektor fließen

Verwandte Konnektoren

• Trigger - Bedingte Logik
• Anomaly Detection - ML-basierte Erkennung
• MXL-Referenz - Ausdruckssyntax