Connettore Alert

Panoramica

Il connettore Alert invia notifiche quando le condizioni sono soddisfatte.

Tipo Connettore: MeddleAlert

Tipi di Notifica: Email

Configurazione

{
  "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": "Avviso Temperatura",
      "body": "La temperatura ha superato la soglia"
    }
  }
}

Parametri di Configurazione

• name: Nome avviso per identificazione
• condition: Espressione MXL per condizione trigger
• minDuration: Secondi minimi in cui la condizione deve essere vera prima dell’avviso
• cooldown: Secondi di attesa prima di inviare un altro avviso
• notification: Configurazione notifica

Notifica Email

• type: "Email"
• smtpHost: Nome host server SMTP
• smtpPort: Porta server SMTP (tipicamente 587 o 465)
• smtpUser: Nome utente SMTP
• smtpPass: Password SMTP
• fromEmail: Indirizzo email mittente
• toEmails: Array di indirizzi email destinatari
• subject: Oggetto email
• body: Testo corpo email

Condizioni MXL

Usa espressioni MXL per le condizioni:

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

Vedi Riferimento MXL per sintassi completa.

Durata Minima

Previene falsi allarmi richiedendo che la condizione sia vera per una durata minima:

{
  "minDuration": 10
}

La condizione deve essere vera per 10 secondi prima che l’avviso venga inviato.

Cooldown

Previene spam di avvisi attendendo tra le notifiche:

{
  "cooldown": 300
}

Dopo aver inviato un avviso, attende 300 secondi (5 minuti) prima di inviarne un altro.

Casi d’Uso

1. Monitoraggio Temperatura

{
  "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": "Avviso Temperatura Freezer",
      "body": "La temperatura del freezer è sopra -10°C"
    }
  }
}

2. Guasto Attrezzatura

{
  "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": "Avviso Macchina Fermata",
      "body": "La macchina di produzione si è fermata inaspettatamente"
    }
  }
}

3. Condizioni Multiple

{
  "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": "CRITICO: Avviso Processo",
      "body": "Parametri processo critici superati"
    }
  }
}

Configurazione SMTP

Gmail

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

Nota: Usa App Password per Gmail.

Office 365

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

SMTP Personalizzato

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

Best Practice

1. Imposta minDuration appropriata - Evita falsi allarmi
2. Usa cooldown ragionevole - Previeni affaticamento da avvisi
3. Testa impostazioni SMTP - Verifica che le email vengano consegnate
4. Usa nomi descrittivi - Identifica facilmente gli avvisi
5. Includi contesto nel corpo - Rendi gli avvisi azionabili

Risoluzione dei Problemi

Email Non Inviate

• Verifica credenziali SMTP
• Controlla host e porta SMTP
• Assicurati che il firewall permetta traffico SMTP
• Testa connessione SMTP separatamente
• Controlla cartella spam

Troppi Avvisi

• Aumenta minDuration
• Aumenta cooldown
• Affina la condizione per essere più specifica

Avvisi Mancanti

• Diminuisci minDuration
• Controlla logica condizione
• Verifica che i dati fluiscano attraverso il connettore

Connettori Correlati

• Trigger - Logica condizionale
• Anomaly Detection - Rilevamento basato su ML
• Riferimento MXL - Sintassi espressioni