Avvisi via email
Cosa genera un avviso, cosa dice l'email, chi lo riceve, e come attivare gli avvisi e regolare le soglie.
Il Radar racconta cosa succede a chi apre la schermata. Gli avvisi fanno il contrario: segnalano senza che nessuno debba guardare. È la differenza fra sapere che un'app è stata giù e sapere che lo è.
Un avviso arriva solo quando qualcuno deve agire, e dice cosa si è rotto, dove, quante volte, a quante persone e da quando, con un link per vederlo nel Radar.
Si attivano e si regolano nelle Impostazioni della piattaforma, in fondo alla barra laterale.
Nota
Queste impostazioni sono di chi amministra l'installazione. Con il profilo di developer, il menu Impostazioni non compare.
Cosa genera un avviso
| Situazione | Quando avvisa |
|---|---|
| Nuovo problema | Compare un problema in un'app pubblicata: un errore in una schermata, in un workflow o in una route del server, un'API che fallisce sul server, oppure un test che fallisce in un'esecuzione pianificata (vedi Eseguire e leggere i risultati). |
| Problema tornato | Un problema segnato come risolto si ripresenta. |
| Problema aperto tornato | Un problema aperto, di cui nessuno era stato avvisato, si ripresenta. |
| Errore generalizzato | La percentuale di richieste che falliscono sul server supera la soglia, con almeno 5 errori e il minimo di richieste. |
| Script falliti | Le esecuzioni di script fallite superano la soglia. |
| Coda dell'indice e Disco | La coda dell'indice resta indietro o il disco ha poco spazio libero. |
| Antivirus | L'antivirus rifiuta un file inviato, o mette in quarantena un file già salvato (vedi Antivirus). |
| Segreto di un fornitore in scadenza | Il segreto di un fornitore Microsoft Entra ID scade entro 30 giorni, o è già scaduto (vedi Accedere con i fornitori di autenticazione). |
I problemi seguono lo stato che hanno nel Radar (vedi Investigare un problema):
- Finché un problema è aperto, non arrivano altre email su di esso.
- Risolvi, su un problema, chiude l'avviso senza email: chi l'ha risolto lo sa già. Se il problema si ripresenta, arriva una nuova email che dice che è tornato.
- Ignora, su un problema, lo zittisce: non genera mai avvisi.
- Quello che succede nello studio, mentre qualcuno costruisce o prova l'app, non avvisa nessuno.
Per l'errore generalizzato contano solo gli errori del server (stato 500 o superiore). I rifiuti di permesso, le richieste annullate da chi le ha fatte e gli errori di validazione di ciò che qualcuno ha scritto non contano. Quando un'app non ha abbastanza traffico per decidere, l'avviso resta com'era: non si chiude solo perché le persone hanno smesso di usare l'app.
Cosa dice un'email
Ogni persona riceve un'email con gli avvisi che la riguardano, nella lingua con cui usa la piattaforma. Per un problema, l'email dice:
- Il nome dell'app e il messaggio dell'errore, nell'oggetto.
- Dove: l'API, la schermata, il workflow o la route del server.
- Quante occorrenze ci sono state nella finestra, e quante in totale.
- Quanti utenti sono stati coinvolti.
- Quando il problema è stato visto per la prima volta e, per un problema tornato, quando era stato segnato come risolto.
- Apri nel Radar: il link che apre il problema nel Radar dell'app.
Gli avvisi di errore generalizzato e di script dicono quali API o script sono falliti, quante volte, e l'ultimo messaggio di errore di ciascuno.
Attivare gli avvisi
- Apri le Impostazioni nella barra laterale.
- Scegli Allarmi, nel gruppo Avvisi.
- Attiva Avvisi via email. L'aiuto dice cosa c'è in gioco: "Avvisa quando compare un nuovo problema in un'app, quando un problema risolto si ripresenta e quando qualcosa supera i limiti qui sotto. Senza questo, lo sai solo quando apri la schermata."
- Clicca su Salva, nell'intestazione. La conferma dice "Impostazioni salvate."

La sezione Processi, nel gruppo Piattaforma, ha altri tre interruttori che vale la pena conoscere, perché metà degli "avvisi che non arrivano" viene da uno di essi spento:
| Interruttore | Cosa fa |
|---|---|
| Pianificatore | Esegue le pianificazioni, i report pianificati e i timer dei workflow. |
| Indice di osservabilità | Porta ciò che le app registrano nell'indice centrale e applica i periodi di conservazione di ogni app. Disattivato, le schermate mostrano dati vecchi. |
| Notifiche in tempo reale | Server in tempo reale delle notifiche. Senza di esso, le notifiche vengono consegnate alla visita successiva. |
Dove vanno gli avvisi
La sezione Email, nel gruppo Avvisi, ha il server in uscita e i destinatari: "Il server da cui escono gli avvisi della piattaforma. È distinto dall'email di ogni app."

| Campo | Che cos'è |
|---|---|
| Server | L'indirizzo del server email in uscita. |
| Porta | La sua porta. |
| Sicurezza | SSL/TLS (porta 465), STARTTLS se il server lo offre (porta 587) o Nessuna (porta 25). |
| Utente | L'account di autenticazione sul server. |
| Password | "Resta cifrata e non torna mai a questa schermata. Lasciare in bianco mantiene quella attuale." |
| Mittente | L'indirizzo di chi invia. È obbligatorio. |
| Destinatari | Chi riceve tutti gli avvisi, al posto della scelta automatica. |
Con i Destinatari in bianco, la piattaforma sceglie chi avvisare:
- Gli avvisi di un'app vanno alle persone assegnate a quell'app.
- Gli avvisi di un'app senza nessuno assegnato, e quelli della piattaforma (la coda dell'indice e il disco), vanno agli amministratori attivi.
Suggerimento
Lascia i Destinatari in bianco. Ogni app avvisa chi ci lavora, e l'elenco si aggiorna da solo quando qualcuno entra o esce dal team. Un elenco scritto a mano riceve tutto da tutte le app e diventa vecchio il giorno in cui qualcuno cambia lavoro.
Lo stato della password compare sotto il campo: Impostata — scrivi per sostituirla o Da impostare.
Da quando avvisare
Le Soglie sono nella sezione Allarmi, sotto l'interruttore: "I nuovi problemi avvisano sempre. I valori qui sotto decidono quando un errore generalizzato, gli script, la coda dell'indice o il disco inviano un'email."

| Soglia | Cosa misura | Nota |
|---|---|---|
| Errori del server nelle API (%) | "Percentuale di richieste che falliscono sul server (5xx), per app, con almeno 5 errori nella finestra." | Si conta app per app, non sulla somma di tutte. |
| Richieste minime | Quante chiamate servono perché la percentuale conti | "Al di sotto, la percentuale non dice nulla: 1 errore su 3 è il 33%." |
| Script falliti | Quante esecuzioni di script possono fallire prima di avvisare | |
| Ritardo della coda (s) | Di quanto può ritardare la coda dell'indice | "Finché la coda è in ritardo, le schermate mostrano dati vecchi." |
| Disco libero (%) | Sotto quale percentuale di disco libero si avvisa | |
| Finestra (min) | Il periodo in cui tutto questo viene contato | "Periodo su cui vengono contati i numeri qui sopra." |
Le Richieste minime evitano che un'app con poco traffico generi avvisi di errore generalizzato: con tre richieste e un errore, la percentuale è del 33% e non vuol dire niente. Ogni errore del server genera già il proprio avviso di problema; la percentuale serve per il giorno in cui falliscono molte cose insieme.
Come scegliere i valori
Non ci sono numeri universali, ma c'è un metodo che funziona:
- Lascia la piattaforma girare una settimana con i valori predefiniti.
- Apri Osservabilità → Panoramica con il periodo su 7g e guarda il Tasso di errore e la Risposta (p95) reali.
- Metti la soglia di Errori del server nelle API (%) un po' sopra quello che è normale in quell'installazione — l'obiettivo è cogliere l'anormale, non confermare il normale.
- Regola le Richieste minime sul traffico dell'app più tranquilla.
Attenzione
Una soglia troppo stretta è peggio di nessuna soglia. Gli avvisi che scattano tutti i giorni smettono di essere letti dopo una settimana — e il giorno in cui arriverà quello importante, arriverà in mezzo agli altri.
Confermare che gli avvisi funzionano davvero
La sezione Stato dell'Osservabilità ha, in cima, una frase che dice la verità sugli avvisi in questa installazione. È il posto dove confermare dopo aver toccato le impostazioni.

Le frasi possibili sono tre:
| Cosa c'è scritto | Cosa significa |
|---|---|
| "Avvisi attivi: avvisa chi lavora su ogni app quando compare un nuovo problema e quando un problema risolto si ripresenta, e anche quando più del 5% delle richieste fallisce sul server, a partire da 20 richieste." | Tutto funziona — e con le tue soglie bene in vista. |
| "Gli avvisi sono disattivati. Nessuno viene avvisato quando qualcosa va storto — questa pagina lo racconta solo a chi la apre." | Manca da attivare gli Avvisi via email. |
| "Avvisi attivi, ma senza invio di email: … Gli allarmi vengono registrati e nessuno viene avvisato." | L'avviso scatta, ma non esce — manca da configurare il server email. |
La terza è la più insidiosa, perché tutto sembra configurato. Se la vedi, torna alla sezione Email e completa quello che manca.
Sessioni e limiti
Sempre nelle Impostazioni, la sezione Limiti, nel gruppo Piattaforma, ha due valori che non sono avvisi ma di solito si cercano nello stesso momento:
- Durata della sessione (h) — "Una sessione attiva si rinnova da sola; questo è il tempo di inattività che la fa scadere."
- File massimo (MB) — la dimensione massima di un file caricato.
Perché non vedo…?
- …gli avvisi arrivare, con tutto acceso? Controlla il pannello Stato: se dice "senza invio di email", manca il server in uscita. Se dice "disattivati", manca di salvare.
- …la sezione Allarmi? Sei nelle impostazioni di un'app, non in quelle della piattaforma. Quelle della piattaforma si aprono dal menu Impostazioni della barra laterale.
- …le mie soglie valere? Senza Salva, nell'intestazione, non viene salvato niente. La conferma è "Impostazioni salvate."
- …gli avvisi di un'app? Gli avvisi di un'app vanno a chi vi è assegnato. Controlla in Utenti di essere assegnato all'app.
- …un'altra email sullo stesso problema? Un problema aperto avvisa una volta sola. Avvisa di nuovo se viene segnato come risolto e si ripresenta.
- …l'avviso di un errore visto nello studio? Quello che succede nello studio, a chi sta costruendo l'app, non avvisa nessuno. Solo l'app pubblicata genera avvisi.