Monitoraggio macchine: dal sensore all'allarme

Cosa otterrai

Al termine di questo tutorial avrai un flusso completo di monitoraggio industriale: ricevere dati da un sensore tramite webhook, visualizzare eventi e attivare allarmi con creazione automatica di attivita. Tempo stimato: 25 minuti.

Prerequisiti

• Un account attivo su Rela AI con accesso alla dashboard
• Accesso a un terminale con curl (Linux, macOS o Windows con WSL)
• Un agente macchina creato (o lo creeremo nel Passo 1)

Passo 1: Crea un agente macchina

1. Nel menu laterale, fai clic su Agenti.
2. Fai clic su Nuovo Agente.
3. Configura:
   • Nome: Monitor Pompa P-101
   • Tipo: seleziona Macchina
   • Descrizione: Monitora vibrazioni e temperatura della pompa P-101
4. Fai clic su Crea.

Dovresti vedere la pagina di configurazione dell'agente macchina con le sezioni fonti di eventi e allarmi.

Passo 2: Aggiungi una fonte di eventi HTTP

1. Nella pagina dell'agente, vai su Fonti di Eventi.
2. Fai clic su Nuova Fonte.
3. Configura:
   • Tipo: HTTP Webhook
   • Nome: Sensore Vibrazione P-101
4. Fai clic su Crea.

Dovresti vedere un URL webhook generato, simile a:

https://api.rela.ai/v1/events/webhook/abc123def456

Passo 3: Invia un evento di test

Apri il tuo terminale ed esegui il seguente comando curl:

curl -X POST https://api.rela.ai/v1/events/webhook/abc123def456 \
  -H "Content-Type: application/json" \
  -d '{
    "timestamp": "2026-03-26T10:30:00Z",
    "machine_id": "P-101",
    "metrics": {
      "vibration_mm_s": 3.2,
      "temperature_c": 67.5,
      "pressure_bar": 4.1
    },
    "status": "running"
  }'

Dovresti ricevere una risposta di successo:

{
  "status": "accepted",
  "event_id": "evt_789xyz"
}

Passo 4: Visualizza l'evento nella cronologia

1. Torna alla dashboard e vai su Agenti > Monitor Pompa P-101.
2. Fai clic sulla scheda Eventi.
3. Cerca l'evento appena inviato.

Dovresti vedere l'evento con timestamp, metriche (vibrazione: 3.2 mm/s, temperatura: 67.5 C, pressione: 4.1 bar) e stato "running".

Passo 5: Crea una regola di allarme

1. Nella pagina dell'agente, vai su Allarmi > Regole.
2. Fai clic su Nuova Regola.
3. Configura la regola:
   • Nome: Vibrazione Alta P-101
   • Condizione: vibration_mm_s > 5
   • Priorita: Alta
   • Azione — Crea attivita: abilitato
   • Titolo attivita: Controllare vibrazione alta nella pompa P-101
   • Priorita attivita: urgent
   • Assegnato a: seleziona un tecnico
   • Azione — Notifica: abilitato (email e/o WhatsApp)
4. Fai clic su Salva.

Dovresti vedere la regola elencata con stato "Attiva" e la condizione vibration_mm_s > 5 visibile.

Passo 6: Testa la regola con un evento critico

Invia un nuovo evento con vibrazione superiore alla soglia:

curl -X POST https://api.rela.ai/v1/events/webhook/abc123def456 \
  -H "Content-Type: application/json" \
  -d '{
    "timestamp": "2026-03-26T11:00:00Z",
    "machine_id": "P-101",
    "metrics": {
      "vibration_mm_s": 7.8,
      "temperature_c": 72.3,
      "pressure_bar": 4.0
    },
    "status": "running"
  }'

Dovresti vedere quanto segue:

1. Allarme attivo — In Allarmi appare un nuovo allarme "Vibrazione Alta P-101" con priorita Alta.
2. Attivita creata — Nella bacheca Kanban appare l'attivita "Controllare vibrazione alta nella pompa P-101" in stato todo.
3. Notifica inviata — Il tecnico assegnato riceve un'email e/o un messaggio WhatsApp.

Riepilogo

Prossimi passi

• Configura l'escalation degli allarmi per notificare i supervisori automaticamente
• Connetti fonti MQTT per ricevere dati dai PLC direttamente
• Crea un piano di manutenzione basato sugli allarmi generati