MiroxMirox
  • Piattaforma

    • Filosofia
    • Panoramica della piattaforma
    • Risorse della piattaforma
    • Disponibilità e finestre di manutenzione
    • Rilasci e versioni
  • Mirox-Cloud

    • Panoramica del cloud
    • Microservizi connessi
  • Mirox-Agent

    • Panoramica dell'agente
    • Opzioni di distribuzione
    • Data Scraper
    • Gemello digitale
  • Dettagli tecnici

    • Raccolta delle metriche
  • Informazioni

    • Impianti supportati
  • Tipi di impianto

    • Impianti solari
    • Inseguitori solari e controllori di parco
    • Cabine di trasformazione
    • Parchi eolici
    • Accumulo a batteria
    • Sistema di allarme
  • Monitoraggio e visualizzazione

    • Monitoraggio in tempo reale
    • Gemello digitale
    • Stati dei componenti
    • Codici di stato dell'inverter
    • Eventi dell'inverter
    • Rilevamento delle perdite
    • Limiti di potenza e riduzione
    • Rilevamento dell'efficienza
    • Dashboard KPI
  • Gestione dei dati

    • Eventi
    • Livelli di allarme
    • Ticket
    • Previsioni
    • Report
    • Metriche
  • Alert Manager

    • Panoramica
    • Regole di allarme
    • Allarmi e notifiche
    • Esempi
  • Integrazione e condivisione

    • Cooperazioni
    • Token API
    • VPN
    • Conflitti di indirizzi VPN
    • Proxy
  • IA

    • Assistente IA e wizard
    • Accesso agentico (MCP)
  • Fatturazione

    • Mercato e tariffe
    • Come vengono calcolati i ricavi
    • Contabilità e fatturazione
    • Contratti
    • Certificati di servizio e fatture
  • Collaborazione

    • Inviti
  • Sicurezza

    • Autenticazione
    • Blocco account
    • Criterio di sicurezza dell'organizzazione
    • Sistema di permessi
    • Segmentazione di rete
    • Restrizioni di cooperazione
    • Audit log degli accessi
    • Attività e audit trail
    • Isolamento dei dati
  • Per iniziare

    • Onboarding
    • Configurazione iniziale
  • Personale

    • Usare la VPN
    • Usare il proxy
    • Autenticazione a due fattori
    • Sessioni
    • Token API
    • Notifiche
    • Collegare Microsoft Teams
  • Per impianto

    • Contatti
    • Dispositivi di rete
    • Datalogger
    • Lettore Modbus generico
    • Componenti
    • VPN diretta (per agente)
    • Volume dati
    • Importa lo storico
  • Organizzazione

    • Permessi dei membri
    • Criterio di sicurezza
    • Cooperazioni
    • Archiviazione file
    • Servizi VPN
    • Lavorare con i report
  • Esportazione di dati

    • Metric Export
    • Metric Export API
    • Migrare al Metric Export
    • API di esportazione legacy
    • Generazione esterna di report
    • Grafana
    • Dashboard Grafana
    • Panoramica dell'API
    • Formule MiroxQL (API)
  • Assistenza

    • Richiedi un'integrazione
  • Reportistica

    • Generatore di report esterno
    • Metric Export per Excel
  • Accesso remoto
  • Sicurezza dell'account
  • AI in Mirox
  • Importazione dello storico
  • Report
  • Esportazione dati
  • English
  • Deutsch
  • Español
  • Français
  • Português
  • Italiano
  • English
  • Piattaforma

    • Filosofia
    • Panoramica della piattaforma
    • Risorse della piattaforma
    • Disponibilità e finestre di manutenzione
    • Rilasci e versioni
  • Mirox-Cloud

    • Panoramica del cloud
    • Microservizi connessi
  • Mirox-Agent

    • Panoramica dell'agente
    • Opzioni di distribuzione
    • Data Scraper
    • Gemello digitale
  • Dettagli tecnici

    • Raccolta delle metriche
  • Informazioni

    • Impianti supportati
  • Tipi di impianto

    • Impianti solari
    • Inseguitori solari e controllori di parco
    • Cabine di trasformazione
    • Parchi eolici
    • Accumulo a batteria
    • Sistema di allarme
  • Monitoraggio e visualizzazione

    • Monitoraggio in tempo reale
    • Gemello digitale
    • Stati dei componenti
    • Codici di stato dell'inverter
    • Eventi dell'inverter
    • Rilevamento delle perdite
    • Limiti di potenza e riduzione
    • Rilevamento dell'efficienza
    • Dashboard KPI
  • Gestione dei dati

    • Eventi
    • Livelli di allarme
    • Ticket
    • Previsioni
    • Report
    • Metriche
  • Alert Manager

    • Panoramica
    • Regole di allarme
    • Allarmi e notifiche
    • Esempi
  • Integrazione e condivisione

    • Cooperazioni
    • Token API
    • VPN
    • Conflitti di indirizzi VPN
    • Proxy
  • IA

    • Assistente IA e wizard
    • Accesso agentico (MCP)
  • Fatturazione

    • Mercato e tariffe
    • Come vengono calcolati i ricavi
    • Contabilità e fatturazione
    • Contratti
    • Certificati di servizio e fatture
  • Collaborazione

    • Inviti
  • Sicurezza

    • Autenticazione
    • Blocco account
    • Criterio di sicurezza dell'organizzazione
    • Sistema di permessi
    • Segmentazione di rete
    • Restrizioni di cooperazione
    • Audit log degli accessi
    • Attività e audit trail
    • Isolamento dei dati
  • Per iniziare

    • Onboarding
    • Configurazione iniziale
  • Personale

    • Usare la VPN
    • Usare il proxy
    • Autenticazione a due fattori
    • Sessioni
    • Token API
    • Notifiche
    • Collegare Microsoft Teams
  • Per impianto

    • Contatti
    • Dispositivi di rete
    • Datalogger
    • Lettore Modbus generico
    • Componenti
    • VPN diretta (per agente)
    • Volume dati
    • Importa lo storico
  • Organizzazione

    • Permessi dei membri
    • Criterio di sicurezza
    • Cooperazioni
    • Archiviazione file
    • Servizi VPN
    • Lavorare con i report
  • Esportazione di dati

    • Metric Export
    • Metric Export API
    • Migrare al Metric Export
    • API di esportazione legacy
    • Generazione esterna di report
    • Grafana
    • Dashboard Grafana
    • Panoramica dell'API
    • Formule MiroxQL (API)
  • Assistenza

    • Richiedi un'integrazione
  • Reportistica

    • Generatore di report esterno
    • Metric Export per Excel
  • Accesso remoto
  • Sicurezza dell'account
  • AI in Mirox
  • Importazione dello storico
  • Report
  • Esportazione dati
  • English
  • Deutsch
  • Español
  • Français
  • Português
  • Italiano
  • English
  • Monitoraggio e visualizzazione

    • Monitoraggio in tempo reale
    • Gemello digitale
    • Stati dei componenti
    • Codici di stato dell'inverter
    • Eventi dell'inverter
    • Rilevamento delle perdite
    • Limiti di potenza e riduzione
    • Rilevamento Efficienza (PRRC)
    • Local Network Inspector
    • Monitoraggio degli accessi
    • Dashboard KPI
    • Visualizzazione a grafici
  • Gestione dei dati

    • Eventi
    • Livelli di allarme ed eventi notificabili
    • Ticket
    • Previsioni
    • Report
    • Metriche
  • Alert Manager

    • Gestore allarmi
    • Regole di allarme
    • Allarmi e notifiche
    • Esempi
  • Integrazione e condivisione

    • Cooperazioni
    • Token API
    • VPN
    • VPN: conflitti di indirizzi
    • Proxy (Accesso web ai dispositivi dell'impianto)
  • IA

    • Assistente AI e Wizard
    • Accesso agentico (MCP)
  • Fatturazione

    • Mercato e tariffe
    • Come vengono calcolati i ricavi
    • Contabilità e fatturazione
    • Contratti
    • Certificati di servizio e fatture
  • Collaborazione

    • Inviti
  • Sicurezza

    • Autenticazione
    • Account temporaneamente bloccato
    • Criterio di sicurezza dell'organizzazione
    • Sistema di permessi
    • Segmentazione di rete
    • Restrizioni dei permessi di cooperazione
    • Audit Logging degli Accessi
    • Attività e Audit Trail
    • Isolamento dei dati

Allarmi e notifiche

Allarmi

Gestore allarmi ▸ Allarmi elenca gli allarmi generati dalle tue regole. Apri in Mirox Per impostazione predefinita vedi ciò che è attivo in questo momento; due interruttori ampliano l'elenco:

  • Mostra risolti — aggiunge gli allarmi terminati, come storico.
  • Mostra silenziati — aggiunge gli allarmi trattenuti da un silenziamento. Gli allarmi silenziati sono nascosti per impostazione predefinita, attivi o risolti, così l'elenco mostra ciò che qualcuno deve ancora guardare; la Panoramica li conta a parte rispetto agli allarmi attivi come + N silenziati.

Ogni allarme mostra il suo livello, la regola, l'impianto, il componente (per le regole giudicate per componente), il valore e da quando — o da quando a quando — era attivo; date e ore seguono le impostazioni di lingua e area geografica del tuo browser. L'impianto e il componente sono collegamenti alle loro pagine. Un allarme di una regola giudicata sul totale dell'impianto offre Quali componenti?: riproduce la regola per componente nel periodo dell'allarme ed elenca quali erano dietro. Un allarme trattenuto da un silenziamento è contrassegnato come Silenziato.

Un allarme si risolve da solo quando la condizione non vale più, quando la regola viene disattivata, modificata in modo che non corrisponda più o eliminata. Gli allarmi risolti restano nell'elenco come storico.

Chi è stato notificato, chi l'ha visto

Notificati e Visto da nei dettagli dell'allarme mostrano chi la piattaforma ha notificato dell'allarme e quando, e chi l'ha aperto da allora — aprire i dettagli ti registra lì. Non c'è nulla da confermare: un allarme termina da solo quando la condizione non vale più.

Silenziare un allarme dai suoi dettagli

Silenzia questo avviso nei dettagli dell'allarme tiene tranquillo esattamente questo allarme senza aprire la scheda Silenziamenti. Scegli per quanto — 1 ora, 4 ore (predefinito), 8 ore, 1 giorno, 3 giorni o 7 giorni — e viene creato un silenziamento per questa regola, questo impianto e questo componente (il totale impianto quando l'allarme riguarda l'intero impianto). L'allarme viene subito contrassegnato come Silenziato e nessuno viene notificato finché il silenziamento dura. Se l'allarme è ancora attivo quando il silenziamento termina, viene notificato allora — il silenziamento rinvia, non inghiotte. Un allarme che era già stato notificato prima di essere silenziato invia comunque il suo avviso di risoluzione. I dettagli rimandano al silenziamento con Apri i silenziamenti, dove può essere prolungato, esteso o rimosso.

Le modifiche a regole e silenziamenti compaiono anche nell'attività della tua organizzazione.

Chi viene notificato

Quando un allarme si apre, tutte le persone della tua organizzazione che hanno accesso all'impianto vengono notificate — nell'app, con notifica push sull'app mobile e via e-mail, esattamente come ciascuno ha scelto nelle proprie impostazioni di notifica nel gruppo Gestore allarmi. Lì ognuno sceglie i canali e il livello minimo da cui vuole essere informato su questi allarmi; per impostazione predefinita è Normale.

Quando l'allarme si risolve, le persone notificate ricevono un avviso di risoluzione. La notifica rimanda direttamente all'allarme.

Silenziamenti

Un silenziamento tiene lontane le notifiche per un po' — per manutenzione, un problema noto o uno spegnimento programmato. Gli allarmi corrispondenti continuano ad aprirsi e chiudersi e vengono registrati, contrassegnati come Silenziato (e nascosti nella scheda Allarmi finché non scegli Mostra silenziati); solo le notifiche e i destinatari restano silenziosi.

Apri Gestore allarmi ▸ Silenziamenti e fai clic su Nuovo silenziamento. Apri in Mirox Scegli:

  • Regola — una regola o ogni regola.
  • Impianto — un impianto o ogni impianto.
  • Inizio — adesso o in un momento pianificato.
  • Per — da 1 ora fino a 1 anno, oppure Fino a una data… per una data di fine libera (al massimo un anno dopo l'inizio).
  • Commento — il motivo, così i tuoi colleghi lo sanno.

Mentre scegli, la finestra conta in tempo reale quanti allarmi aperti corrispondono — N avvisi aperti verrebbero silenziati ora — così vedi che cosa il silenziamento tratterrà prima di crearlo. Un silenziamento che inizia adesso trattiene subito gli allarmi aperti corrispondenti.

La tabella mostra per ogni silenziamento la regola, l'impianto, l'inizio e la fine, il commento e lo stato — Attivo, Pianificato o Terminata — e Trattiene: il numero di allarmi aperti che il silenziamento trattiene in questo momento.

Un silenziamento può essere modificato dalla sua riga (Modifica): regola, impianto, inizio, fine e commento. La modifica ha effetto subito — gli allarmi che il silenziamento ora copre smettono di notificare, quelli che non copre più tornano a notificare dalla prossima valutazione. Un silenziamento creato da un singolo allarme copre solo il componente di quell'allarme (o il totale impianto); in Componente può essere esteso a Tutti i componenti della regola e dell'impianto, ma non ristretto a un altro componente.

Un silenziamento termina da solo. Rimuovilo prima con Rimuovi — gli allarmi corrispondenti vengono di nuovo notificati dalla prossima valutazione in poi, compresi quelli attivi in questo momento. I silenziamenti vengono creati, modificati e rimossi da Admin, Moderatori e dai due ruoli Asset Manager.

Destinatari

Un destinatario riceve automaticamente ogni allarme delle regole a cui è associato — un sistema di ticket, un canale del team o una casella condivisa. Le persone non hanno bisogno di un destinatario; vengono comunque notificate tramite le proprie impostazioni. Due tipi li crei tu, Webhook ed E-mail; un trader diretto configurato in Organizzazione diventa destinatario da sé — vedi Trader diretto.

Apri Gestore allarmi ▸ Destinatari e fai clic su Nuovo destinatario Apri in Mirox, poi associalo alle regole in Destinatari nella scheda Notifica dell'editor delle regole. Invia prova consegna un allarme di esempio — con dentro una segnalazione di indisponibilità di esempio — per verificare la connessione e il tuo modello; un trader diretto offre invece Prova accesso, che effettua l'accesso al servizio web del trader. Un destinatario può essere modificato in seguito dal menu della sua riga (Modifica): il nome, gli indirizzi oppure l'indirizzo e il modello del webhook, e se inviare anche la risoluzione (Invia anche la risoluzione); solo il tipo è fisso. Rinnova il segreto di firma emette un nuovo segreto del webhook, mostrato una sola volta come alla creazione. Un destinatario disattivato dopo ripetuti errori di consegna (etichetta Disattivato) viene riacceso con Riattiva. Il destinatario di un trader diretto si gestisce in Organizzazione ▸ Trader diretti; nella scheda Destinatari offre solo Prova accesso e il suo interruttore attivo. Nella tabella delle regole ogni destinatario compare come chip; passandoci sopra il mouse si vedono il destinatario e il modello con cui invia (un destinatario e-mail senza modello: Testo integrato).

E-mail

Un elenco di indirizzi e-mail. Ogni allarme e la sua risoluzione arrivano come un'unica e-mail.

Webhook

Un indirizzo HTTPS più un modello: l'indirizzo riceve un POST per ogni allarme e la sua risoluzione, nella forma data dal modello del destinatario — il metodo, le intestazioni e il corpo. Il destinatario prende uno dei modelli webhook della tua organizzazione — la finestra li elenca, alla creazione del destinatario come alla modifica; se non ce n'è ancora nessuno, creane prima uno in Modelli. Gli esempi lì coprono Microsoft Teams, Slack e Discord oltre al tuo JSON, XML e CSV: l'esempio JSON generico (busta firmata) — l'allarme completo come JSON, vedi sotto — è la base per sistemi di ticket e per la tua automazione; Scheda Microsoft Teams, Messaggio Slack e Embed Discord sono messaggi già pronti per un webhook in entrata di quei servizi, il cui indirizzo è allora l'indirizzo del destinatario (Slack hooks.slack.com/services/…, Discord discord.com/api/webhooks/…, Teams Workflows *.environment.api.powerplatform.com o *.logic.azure.com — vedi Collegare Microsoft Teams per sapere come crearne uno). Un webhook di Teams Workflows rifiuta un'intestazione Authorization — non aggiungerne una a un modello per Teams.

Quando crei un destinatario webhook, il suo segreto di firma viene mostrato una sola volta. Ogni richiesta è firmata: porta l'intestazione X-Mirox-Signature: sha256=<hex> — l'HMAC-SHA256 del corpo grezzo della richiesta con quel segreto — più X-Mirox-Timestamp e un X-Mirox-Delivery-Id univoco, insieme alle intestazioni del modello, qualunque sia l'indirizzo. Verifica la firma prima di fidarti di una richiesta e usa l'id di consegna per ignorare una consegna ripetuta. I servizi chat come Teams, Slack e Discord ignorano semplicemente le intestazioni X-Mirox-*.

Il corpo del modello già pronto JSON generico (busta firmata):

{
  "version": "1",
  "status": "firing",
  "event_id": "1216448682925686786",
  "rule_uid": "A1B2C3D4E5F6",
  "rule_name": "Inverter without power",
  "rule_version": 3,
  "priority": "high",
  "park_uid": "0A1B2C3D4E5F",
  "park_name": "Plant North",
  "instance_key": "inverter_id=7",
  "labels": { "inverter_id": "7" },
  "component": "Inverter 7",
  "metric": "AC power per inverter",
  "value": 0.0,
  "unit": "W",
  "op": "lt",
  "threshold": 10.0,
  "condition_since": 1791200400,
  "title": "[FIRING] Inverter without power — Plant North (Inverter 7)",
  "body": "Inverter 7 delivers only 0 W (limit 10 W)",
  "link": "https://service.mirox.io/#/alertmanager?tab=alerts&alert=1216448682925686786",
  "sent_at": "2026-10-06T09:05:12+00:00"
}

status è firing o resolved; una risoluzione ripete l'allarme con l'ultimo valore giudicato. condition_since è un timestamp Unix. In versioni successive possono essere aggiunti campi — ignora ciò che non conosci. event_id è una stringa: l'identificativo è più lungo di quanto un numero JavaScript possa rappresentare con esattezza.

Dopo ripetute consegne fallite un destinatario viene disattivato e contrassegnato come Disattivato; controlla l'indirizzo, poi riattivalo con Riattiva dal menu della sua riga.

Quali indirizzi chiama Mirox

Mirox si collega a un indirizzo webhook solo tramite HTTPS sulla porta 443, e solo se l'indirizzo corrisponde a un indirizzo IP pubblico. Altre porte (come 8443), http:// non cifrato e gli indirizzi privati o interni (10.x, 172.16–31.x, 192.168.x, localhost e simili) vengono rifiutati. Se il tuo endpoint è in ascolto su un'altra porta o è raggiungibile solo all'interno della tua rete, metti davanti un reverse proxy raggiungibile pubblicamente sulla porta 443, oppure contatta il nostro supporto se per te non è possibile.

Trader diretto

Un trader diretto si configura una sola volta in Organizzazione ▸ Trader diretti Apri in Mirox: un nome, il protocollo che parla — oggi l'interfaccia BWE per le indisponibilità; Richiedi un altro protocollo ci invia il nome dello standard usato dal tuo trader —, gli indirizzi del servizio web e di accesso, le credenziali rilasciate dal trader e le ore in anticipo con cui vuole ricevere un'indisponibilità (2 per impostazione predefinita, da 1 a 48). Ogni riga termina con un menu …: Modifica, Prova accesso, Destinatario nel Gestore allarmi ed Elimina. Prova accesso effettua l'accesso presso il trader e mostra quanti impianti ha assegnato al tuo account; non comunica mai un'indisponibilità. Un impianto eolico sceglie il trader tramite cui vende nella sua pagina Indisponibilità — vedi Indisponibilità e Trader Diretto.

Quali indirizzi chiama Mirox

Mirox si collega agli indirizzi del servizio web e di accesso del trader diretto solo tramite HTTPS sulla porta 443, e solo se corrispondono a un indirizzo IP pubblico. Altre porte (come 8443), http:// non cifrato e gli indirizzi privati o interni vengono rifiutati. Se il servizio del tuo trader è raggiungibile solo su un'altra porta, chiedigli un indirizzo sulla porta 443, oppure contatta il nostro supporto.

Il trader diventa automaticamente un unico destinatario nel Gestore allarmi, con il suo nome. Non può essere creato da Nuovo destinatario (quel dialogo offre solo webhook ed e-mail) e non esiste mai due volte; rinominare o disattivare il trader si riflette sul destinatario, eliminare il trader lo elimina, e riconfigurarlo lo riporta. Nella scheda Destinatari la riga è di sola lettura — Gestito in Organizzazione ▸ Trader diretti — tranne Prova accesso e il suo interruttore attivo, entrambi riservati ad Admin e Moderatori. Non ha modello: il protocollo detta ciò che il trader riceve.

La regola segnala l'indisponibilità. Su una regola che sorveglia una per una le turbine di un impianto eolico (giudicata su ogni componente di una metrica di aerogeneratore), la scheda Notifica offre l'interruttore Segnala indisponibilità. Attivato, ogni allarme di turbina attivo della regola è un'indisponibilità di quella turbina dal momento in cui si apre: un inizio, segnalato con le ore in anticipo; una proroga circa ogni metà di quelle ore finché l'allarme resta attivo; e la fine, accorciata alla fine reale, quando si risolve. Accanto all'interruttore scegli il motivo dell'indisponibilità — Manutenzione, Prescrizione amministrativa, Gestore di rete o Trader diretto — e la potenza residua: Fermo totale (0 kW) oppure il valore misurato, il valore di potenza dell'allarme limitato alla potenza nominale della turbina, per una regola su una metrica di potenza. Usa Gestore di rete e Trader diretto solo quando l'origine della limitazione è certa — contano come limitazioni indennizzate nella liquidazione, gli altri due abbassano la disponibilità della turbina. Le ore in anticipo sono quelle del trader dell'impianto quando la regola gli segnala, altrimenti 2. L'interruttore è forzato e mostrato bloccato finché il destinatario del trader è associato; una regola giudicata sul totale impianto non lo offre e non viene mai segnalata. Anche un impianto che un'altra organizzazione condivide con voi per cooperazione può essere segnalato: ogni organizzazione segnala con le proprie regole e il proprio trader diretto, indipendentemente dal proprietario dell'impianto — la regola indica il trader tramite il suo destinatario.

Ogni destinatario della regola riceve i tre momenti — inizio, proroga e fine — e nient'altro: il tuo destinatario e-mail o webhook li riceve resi dal suo modello con le variabili outage.* (o come testo integrato senza modello), e il destinatario del trader li riceve tramite il suo protocollo, inviati dall'agente dell'impianto. Una regola che segnala indisponibilità non invia in più ai suoi destinatari i consueti messaggi di attivazione e risoluzione; le persone della tua organizzazione vengono notificate come sempre, e una prova degli allarmi non segnala mai un'indisponibilità.

Così provi prima e passi dopo: costruisci la regola con il tuo destinatario e-mail o webhook e guarda inizio, proroga e fine arrivare nella tua casella o al tuo endpoint — esattamente ciò che riceverebbe il trader. Quando sei soddisfatto, apri la scheda Notifica della regola, rimuovi il tuo destinatario (o tienilo) e aggiungi il destinatario del trader. Nient'altro cambia — regola, motivo, potenza residua e ore in anticipo restano; dal passaggio successivo l'impianto segnala al trader ogni indisponibilità aperta, dal suo inizio originale.

Quali impianti raggiungono il trader dipende dagli impianti: un impianto segnala tramite il trader collegato nella sua pagina Indisponibilità, quindi il destinatario del trader segnala esattamente gli impianti della regola collegati a lui. Per un impianto collegato a un altro trader o a nessuno, l'indisponibilità viene registrata nel registro dell'impianto e inviata ai tuoi destinatari, ma a nessun trader — l'editor delle regole indica questi impianti nella scheda Notifica. Dice anche quando l'agente di un impianto ha ancora bisogno di un aggiornamento per le segnalazioni di indisponibilità: fino ad allora i destinatari della regola ricevono l'allarme stesso, come per una regola normale.

I modelli di sistema per gli aerogeneratori arrivano con l'interruttore attivo e associano il destinatario del tuo trader quando li adotti — vedi Esempi. Sull'impianto, le indisponibilità compaiono nel registro Indisponibilità come Comunicato da allarme, e il riquadro Comunicato in tempo reale da allarme nella scheda Trader diretto dell'impianto elenca ogni regola che segnala l'impianto — regola, motivo, potenza residua, ore in anticipo e se raggiunge il trader — con il badge Disattivato per una regola disattivata.

Cosa è stato consegnato

I dettagli di un allarme elencano le sue Consegne: una riga per destinatario e momento — attivazione o risoluzione per una regola normale, inizio, proroga o fine per una segnalazione di indisponibilità — con l'ora e se è stata inviata, fallita (con l'errore) o saltata, e perché: un silenziamento, il destinatario disattivato, risoluzioni non volute, la segnalazione di indisponibilità al posto del messaggio di allarme oppure — per una risoluzione — che l'allarme stesso non ha mai raggiunto il destinatario. Quando una regola apre molti allarmi in una volta (una regola su ciascuna di centinaia di stringhe al tramonto), le sue notifiche e i messaggi ai destinatari si sospendono dopo i primi quattro in un'ora, per 30 minuti, e le persone ricevono invece un riepilogo; un allarme mai inviato a un destinatario non gli invia nemmeno una risoluzione. Per il destinatario del trader la riga mostra cosa ha segnalato l'impianto e la finestra coperta. Quando un destinatario fallisce, la tua organizzazione riceve l'evento Destinatario in errore, rivolto agli Admin e ai Moderatori e agli autori delle regole che usano il destinatario; dopo dieci consegne fallite di seguito il destinatario viene disattivato (Destinatario disattivato), e l'evento si chiude da solo appena una consegna riesce di nuovo — correggi la causa, poi Riattiva il destinatario dal menu della sua riga. Il destinatario del trader riporta allo stesso modo lo stato della connessione al trader.

Modelli

Un modello stabilisce esattamente cosa invia un destinatario, così ogni sistema riceve il formato che si aspetta: per un webhook il metodo (POST, PUT o PATCH), le tue intestazioni e il corpo in JSON, XML, CSV, HTML, testo semplice o dati di modulo; per un'email l'oggetto e il testo (testo semplice o il tuo HTML). Il destinatario di un trader diretto non ha modello — il suo protocollo detta la segnalazione; ciò che una regola che segnala indisponibilità invia ai tuoi destinatari e-mail e webhook è dato dai loro modelli, con le variabili outage.*. Scrivi testo fisso e inserisci variabili dell'allarme, della regola, dell'impianto e del componente. Un modello è riutilizzabile: più destinatari possono usarlo e una modifica vale subito per tutti.

Apri Gestore allarmi ▸ Destinatari Apri in Mirox: sotto i destinatari trovi i tuoi modelli e gli esempi da cui partire. Usa esempio ne copia uno nella tua organizzazione; Nuovo modello parte vuoto. I modelli webhook già pronti — il JSON generico (busta firmata) e i messaggi chat per Microsoft Teams, Slack e Discord — si avviano dagli esempi come tutti gli altri; la finestra del destinatario elenca solo i modelli della tua organizzazione. Il modello si apre nell'editor: a sinistra le impostazioni, le intestazioni e il corpo, al centro l'elenco delle variabili — un clic inserisce la variabile al cursore — e a destra l'anteprima dal vivo: la richiesta o l'email esattamente come verrebbe inviata, con l'allarme di esempio o uno dei tuoi allarmi recenti, con tutti gli errori e gli avvisi. Poi scegli il modello per un destinatario, alla creazione o con il pulsante modello nella sua riga. Un destinatario webhook invia sempre con un modello; un destinatario e-mail senza modello invia il testo integrato.

La cornice e-mail Mirox è una vostra scelta. Un modello di email di testo ha l'interruttore Invia nella cornice e-mail Mirox (attivo per impostazione predefinita): attivo, il vostro testo è inserito nella mail Mirox — intestazione, un pulsante verso l'allarme, piè di pagina e «mirox |» davanti all'oggetto; disattivo, oggetto e testo escono esattamente come generati, senza nulla di aggiunto. Un modello HTML viene inviato sempre così com'è. L'anteprima è sempre la mail come arriva — con la cornice mostra la mail incorniciata completa — e offre, accanto all'allarme di esempio e ai vostri allarmi recenti, altre tre fonti: una segnalazione di indisponibilità di esempio all'inizio, alla proroga e alla fine, per verificare un modello di una regola che segnala indisponibilità con tutti i campi compilati. Sotto l'anteprima una nota dice se il gruppo indisponibilità mostrato è stato segnalato dal gemello digitale o derivato dall'allarme, e quali campi restano vuoti in quel caso.

I modelli sono creati, duplicati, modificati ed eliminati da Admin, Moderatori e dai due ruoli Asset Manager; ogni membro può vederli. Un modello contrassegnato come Privato lo modificano solo chi lo ha creato, un Admin o un Moderatore — vedi Privato. Un modello usato da un destinatario non si può eliminare: scegline prima un altro per quel destinatario.

Il linguaggio dei modelli

ScriviSignificato
Variabile: {{plant.name}}il valore, ad es. il nome dell'impianto
Filtro: {{alert.since|date:"DD.MM.YYYY HH:mm"}}il valore, formattato
Sezione: {{#alert.firing}}…{{/alert.firing}}la parte in mezzo solo se il valore esiste — per una lista una volta per elemento
Sezione inversa: {{^component.name}}…{{/component.name}}la parte in mezzo solo se il valore è vuoto
Commento: {{! … }}niente — una nota per te
Parentesi letterali: \{{{{ come testo

In una sezione di lista sono disponibili {{@index}} (da 0), {{@number}} (da 1), {{@first}} e {{@last}} — ad esempio {{^@last}},{{/@last}} mette una virgola tra gli elementi. Una variabile inesistente resta vuota e l'anteprima la segnala come avviso. In un modello non viene eseguito nulla; produce solo testo.

Variabili

VariabileSignificato
{{alert.id}}ID dell'allarme (testo)
{{alert.status}}firing (attivo) o resolved (risolto)
{{alert.firing}}Vero finché l'allarme è attivo (usabile come sezione)
{{alert.resolved}}Vero per l'avviso di risoluzione
{{alert.level}}Livello: very_low, low, normal, high, very_high, critical
{{alert.title}}Il titolo pronto su una riga
{{alert.text}}Il messaggio pronto su una riga
{{alert.summary}}Il riepilogo della regola, se presente
{{alert.value}}Il valore valutato (l'ultimo alla risoluzione)
{{alert.value_label}}Il valore con unità, come in Mirox
{{alert.value_kw}}Il valore in kW — solo per una metrica di potenza (W, kW, MW)
{{alert.unit}}L'unità della metrica
{{alert.threshold}}La soglia della regola
{{alert.threshold_label}}La soglia con unità
{{alert.threshold_kw}}La soglia in kW — solo per una metrica di potenza
{{alert.op}}Confronto: gt, ge, lt, le, eq, ne
{{alert.op_symbol}}Il confronto come simbolo
{{alert.since}}Da quando vale la condizione
{{alert.until}}Quando l'allarme è stato risolto (vuoto finché è attivo)
{{alert.duration_s}}Secondi dall'inizio alla fine (o ad ora)
{{alert.close_reason}}Motivo della risoluzione: condition, rule_disabled, …
{{alert.silenced}}Vero se un silenziamento corrispondeva
{{alert.link}}Link assoluto all'allarme in Mirox
{{alert.instance_key}}L'istanza dell'allarme (etichette)
{{rule.uid}}ID della regola
{{rule.name}}Nome della regola
{{rule.description}}Descrizione della regola
{{rule.version}}Versione della regola
{{rule.window_s}}Finestra della regola in secondi
{{rule.for_s}}Per quanto deve valere la condizione, in secondi
{{rule.metric.name}}Nome della metrica
{{rule.metric.unit}}Unità della metrica
{{plant.uid}}ID dell'impianto
{{plant.name}}Nome dell'impianto
{{plant.type}}Tipo: solar, wind, battery
{{plant.timezone}}Fuso orario dell'impianto (predefinito per le date)
{{plant.peak_power_kw}}Potenza di picco installata in kWp
{{plant.grid_limit_kw}}Limite di connessione alla rete in kW, se impostato
{{plant.inverter_limit_kw}}Limite di potenza degli inverter in kW, se impostato
{{plant.latitude}}Latitudine
{{plant.longitude}}Longitudine
{{plant.portfolio.uid}}ID del portafoglio
{{plant.portfolio.name}}Nome del portafoglio
{{plant.address.street}}Via (riga 1)
{{plant.address.street2}}Riga 2 dell'indirizzo
{{plant.address.zip}}CAP
{{plant.address.city}}Città
{{plant.address.state}}Regione
{{plant.address.country}}Paese
{{plant.grid_operator}}Gestore di rete, se inserito
{{plant.project_company}}Società di progetto, se inserita
{{plant.market_zone}}Zona di mercato, se inserita
{{plant.commissioning_date}}Data di messa in servizio, se inserita
{{component.name}}Nome del componente (vuoto per regole sull'impianto)
{{component.id}}ID del componente in Mirox, se noto
{{component.kind}}Tipo di componente (inverter, string, …)
{{component.labels}}Le etichette del componente come oggetto
{{component.labels_list}}Le etichette come lista di {name, value} per una sezione
{{organization.uid}}ID dell'organizzazione
{{organization.name}}Nome dell'organizzazione
{{delivery.id}}ID univoco di questa consegna
{{delivery.receiver}}Nome del destinatario
{{delivery.test}}Vero per un invio di prova
{{now}}Il momento dell'invio

Ogni consegna porta il gruppo outage, e non è mai vuoto. In un allarme normale è derivato dall'allarme stesso: l'unità è il componente dell'allarme (una turbina), begin il primo istante in cui la condizione era vera, end la risoluzione, motivo e potenza residua vengono dalle impostazioni di indisponibilità della regola — e outage.reported è falso. In una regola che segnala indisponibilità subentra il gemello digitale dell'impianto e segnala l'indisponibilità: una finestra in anticipo, prorogata finché l'allarme resta attivo, chiusa alla risoluzione — solo allora reported, renewed, reported_until, horizon_hours, marketer.name e register_link sono compilati; in un allarme normale restano vuoti o falsi. {{#outage.reported}}…{{/outage.reported}} distingue i due casi in un unico modello. Numero di serie, chiave d'impianto e potenza nominale sono dati anagrafici dell'impianto e restano vuoti dove non inseriti. L'editor delle regole avvisa quando un modello dei suoi destinatari legge un campo compilato solo da un'indisponibilità segnalata su una regola che non segnala:

VariabileSignificato
{{outage.reported}}Vero quando il gemello digitale dell'impianto ha segnalato questo momento come indisponibilità (regola con segnalazione); falso quando il gruppo è derivato dal solo allarme
{{outage.moment}}Cosa annuncia questa consegna: start (allarme attivato), renewal (finestra segnalata prorogata — solo indisponibilità segnalate) o end (allarme risolto)
{{outage.started}}, {{outage.renewed}}, {{outage.ended}}Vero per quel momento (usabili come sezioni)
{{outage.begin}}Inizio dell'indisponibilità
{{outage.end}}La fine reale una volta risolto l'allarme (vuoto prima)
{{outage.reported_until}}Fine della finestra finora segnalata — prorogata prima della scadenza (solo indisponibilità segnalate; vuoto in un allarme normale)
{{outage.horizon_hours}}Con quante ore di anticipo viene segnalata l'indisponibilità (solo indisponibilità segnalate; vuoto in un allarme normale)
{{outage.reason}}Codice del motivo: ADMINISTRATIVE, MAINTENANCE, GRID, MARKET
{{outage.reason_label}}Il motivo in parole (inglese)
{{outage.available_power_kw}}Potenza residua della turbina in kW (0 = fermo totale)
{{outage.comment}}Il commento della segnalazione (il nome della regola)
{{outage.marketer.name}}Il trader diretto a cui la regola segnala tramite il suo destinatario trader (vuoto in un allarme normale o in una prova senza trader)
{{outage.unit.name}}, {{outage.unit.id}}Nome e ID della turbina
{{outage.unit.serialnumber}}, {{outage.unit.manufacturer_id}}, {{outage.unit.plant_key}}Numero di serie, ID del costruttore e chiave d'impianto dai dati anagrafici, se inseriti
{{outage.unit.rated_kw}}Potenza nominale della turbina in kW
{{outage.register_link}}Link al registro delle indisponibilità dell'impianto in Mirox

Le date sono mostrate nel fuso orario dell'impianto, salvo che il filtro date ne indichi un altro. L'impianto non ha un campo per un numero MaStR o un punto di prelievo di mercato: scrivi tali identificativi come testo fisso nel modello.

I filtri seguono la variabile dopo | e si possono concatenare, ad esempio {{alert.value|kw|number:1:de}}:

FiltroSignificato
date:"DD.MM.YYYY HH:mm":"Europe/Berlin"Data e ora: iso (predefinito), unix, unix_ms, rfc2822 o uno schema di YYYY YY MM DD HH mm ss Z ZZ. Il fuso orario è facoltativo; senza vale quello dell'impianto.
number:1:deUn numero come testo con i decimali indicati (predefinito 2) e i separatori di en, de, fr, es, it, pt o plain.
round:1Arrotonda e resta un numero (in JSON senza virgolette).
kwDivide per 1.000 o 1.000.000 (W in kW o MW).
upperMaiuscolo, minuscolo, senza spazi attorno.
truncate:120Al massimo n caratteri.
default:"—"Questo testo se il valore è vuoto.
yesno:"yes":"no"Un testo se c'è un valore, un altro se è vuoto.
jsonIl valore come testo JSON, inclusi oggetti e liste.

Formati e codifica

Il tipo di contenuto del modello decide come viene inserito un valore, così un nome d'impianto con virgolette o una «&» non rompe mai il risultato:

  • JSON — dentro una stringa ("plant": "{{plant.name}}") il valore è codificato come testo; fuori ("value": {{alert.value}}) diventa un valore JSON: un numero resta un numero, il testo ha le virgolette, un valore vuoto diventa null, oggetti e liste sono scritti come JSON.
  • XML e HTML — <, >, & e le virgolette sono codificati.
  • CSV — un campo va tra virgolette se contiene il separatore, una virgoletta o un a capo; in un campo che il modello mette già tra virgolette, le virgolette vengono raddoppiate. Il separatore è quello usato dal modello (virgola, punto e virgola, tabulazione).
  • Dati di modulo — i valori sono codificati come URL.
  • Testo semplice — così com'è.

I valori delle intestazioni e l'oggetto dell'email non contengono mai un a capo. Il modello viene controllato al salvataggio: deve essere completo (ogni sezione chiusa, ogni filtro noto), al massimo 64 KiB, e per JSON e XML il risultato con l'allarme di esempio deve essere valido. Intestazioni: al massimo 30, solo nomi standard. Content-Type segue il formato; Content-Length, Host e le intestazioni X-Mirox-* le imposta Mirox e non si possono sostituire. Ogni richiesta webhook resta firmata: X-Mirox-Signature è l'HMAC-SHA256 esattamente del corpo prodotto dal modello.

Esempi

Ogni esempio è un punto di partenza da copiare e adattare:

  • JSON generico (busta firmata) — La busta di allarme Mirox documentata — base per sistemi di ticket.
  • Scheda Microsoft Teams — Una Adaptive Card per un webhook di Teams Workflows.
  • Messaggio Slack — Messaggio Block Kit per un webhook in entrata di Slack.
  • Embed Discord — Un embed colorato per un webhook di canale Discord.
  • Documento XML — L'allarme come documento XML.
  • Riga CSV — Un'intestazione e una riga per allarme, separate da virgole.
  • Email di testo — Un'email di testo compatta con i dati principali, nella cornice e-mail Mirox (disattivate la cornice per inviare solo il testo).
  • Email HTML — La vostra email HTML con tabella dei dati.
  • Avviso a un trader diretto senza l'interfaccia BWE (CSV) — Una riga CSV in tedesco per segnalazione — inizio, proroga o fine dell'indisponibilità di una turbina — con identità della turbina, finestra, potenza residua e motivo della regola; per un destinatario webhook, da adattare alla specifica del trader.
  • Avviso a un trader diretto senza l'interfaccia BWE (email) — La stessa segnalazione come email in tedesco, per un destinatario email — adattala a ciò che richiede il trader.

Avvia gli esempi webhook come tutti gli altri e scegli poi la copia per un destinatario — la finestra del destinatario elenca solo i modelli della tua organizzazione.

I due avvisi di indisponibilità (in tedesco) sono modelli per una regola che segnala indisponibilità: rendono il gruppo outage — il momento, nome, ID, numero di serie e chiave d'impianto della turbina, inizio, fine e finestra finora segnalata, potenza nominale e residua, motivo e commento. Servono a un trader senza l'interfaccia BWE, raggiunto da un destinatario webhook o email, e alla tua casella mentre provi una regola prima di associare il destinatario del trader. Non esiste un formato vincolante per questo avviso: adatta colonne e testo a quanto richiede il tuo trader diretto e inserisci numero MaStR e punto di mercato come testo fisso.

Un modello per un sistema di ticket che si aspetta XML:

<ticket priority="{{alert.level}}">
  <title>{{alert.title}}</title>
  <site id="{{plant.uid}}">{{plant.name}}</site>
  {{#component.name}}<asset>{{component.name}}</asset>{{/component.name}}
  <opened>{{alert.since|date:"iso"}}</opened>
  <link>{{alert.link}}</link>
</ticket>

Testare gli allarmi

Un test mostra l'intero percorso di un allarme su uno dei tuoi impianti, senza aspettare un problema reale e senza toccare i dati dell'impianto. Apri Gestore allarmi ▸ Panoramica e fai clic su Testa gli allarmi Apri in Mirox, poi scegli l'impianto, il livello dell'allarme di test (fino a Critico) e, se vuoi, i destinatari.

La piattaforma scrive quindi un segnale di test fisso per quell'impianto: tranquillo per 5 minuti, sopra la soglia per 15 minuti, poi di nuovo tranquillo. L'agente dell'impianto lo valuta come qualsiasi tua regola, quindi:

  1. circa 5–10 minuti dopo l'avvio si apre l'allarme di test, al livello scelto;
  2. viene avvisata solo la persona che ha avviato il test — nell'app, via push e via e-mail, secondo le proprie impostazioni — e lo ricevono anche i destinatari scelti; nessun altro nell'organizzazione viene avvisato;
  3. circa 15 minuti dopo si risolve da solo, con il suo avviso di risoluzione.

La pagina segue il test passo dopo passo e indica chi lo ha avviato. Un test termina da solo dopo circa 30 minuti, o prima con Interrompi; il suo allarme resta nello storico. I test non compaiono mai tra le tue regole e i dati di test vengono scritti solo mentre un test è attivo. I test vengono avviati da Admin e Moderatori; ne possono girare fino a tre contemporaneamente.

Pagine correlate

  • Panoramica del Gestore allarmi
  • Regole di allarme
  • Impostazioni di notifica
Prev
Regole di allarme
Next
Esempi
© 2026 Mirox Verwaltungs GmbH. Tutti i diritti riservati. | Informativa sulla privacy