Avvisi

Due impostazioni decidono ogni avviso. Una regola decide se l'avviso nasce: vale per tutta l'organizzazione. Le tue preferenze decidono se arriva a te e su quale canale. Servono tutte e due: se la regola è spenta, l'avviso non nasce e le preferenze non possono farlo comparire.

Regole di avviso

Le regole stanno in Avvisi → Regole di avviso. Le vede e le cambia chi ha il permesso di gestire gli avvisi.

Le organizzazioni nuove hanno già le regole di base: sito giù e di nuovo su, lavoro programmato mancato, macchina giù, servizio in errore, disco in errore, database non raggiungibile e altre. Puoi rinominarle, spegnerle o cambiarle.

Il modo più rapido per aggiungerne è un modello pronto, in Modelli pronti:

• Avvisami se un sito cade: due regole, la caduta e il ritorno;
• Avvisami se un lavoro programmato non parte;
• Avvisami dei nuovi errori;
• Avvisami se una macchina è in difficoltà: macchina irraggiungibile e disco che si riempie.

Creare una regola

1. Premi Nuova regola.
2. Dai un Nome e scegli l'Evento: per esempio Nuovo errore, Uptime down, Cron mancato, Disco server oltre soglia, Segreto letto.
3. Scegli Progetto e Ambiente. Vuoti = tutti i progetti, qualsiasi ambiente.
4. Compila i campi che servono a quell'evento:
   • Livello minimo: per gli errori, scatta solo da questa gravità in su;
   • Solo errori non gestiti: ignora gli errori che il codice cattura di proposito;
   • Soglia server: per CPU, memoria e disco in percentuale, temperatura in °C, connessioni del database, ritardo della replica in secondi.
5. Raggruppa avvisi ripetuti: gli eventi uguali dentro questi minuti diventano una notifica sola.
6. Se vuoi, scegli i Canali esterni (vedi sotto) e premi Salva regola.

Quando la regola scatta, chi può vedere il progetto riceve la notifica nell'app, e l'email se l'ha accesa.

La pagina di una regola la spiega In parole semplici, dice Cosa copre e mostra lo Storico degli scatti. Nell'elenco, una regola che produce gran parte degli avvisi del periodo viene segnalata.

Silenziare una regola

Per una manutenzione o un falso allarme non serve spegnere la regola. Nella pagina della regola scegli Silenzia 1 ora, Silenzia 1 giorno o Silenzia 1 settimana. La regola resta attiva e continua a contare gli eventi, ma non avvisa fino alla scadenza. Poi torna da sola.

Il centro notifiche

Ogni avviso arriva sempre nella campanella in alto e nella pagina Avvisi → Notifiche. Questo canale non si spegne.

Puoi filtrare per tipo, progetto e lette o da leggere, e premere Segna tutte come lette.

Le tue preferenze

Ognuno sceglie per sé in Preferenze → Notifiche.

• Canali: In-app è sempre attivo; Email e Telegram li accendi tu.
• Per notifica: per ogni tipo di avviso e per ogni canale scegli Ogni volta, Riepilogo giornaliero, Riepilogo settimanale o Disattivata.
• Configurazioni pronte: Essenziale, Tutto o Solo urgenze scrivono in un gesto tutte le cadenze. Sostituiscono le scelte fatte a mano.
• Livello minimo errori: ricevi solo gli errori da questa gravità in su.

Se un avviso ti è già arrivato su Telegram, la stessa email non parte.

Ore silenziose

Accendi Ore silenziose e scegli Da, A e Fuso orario. In quella finestra le email non urgenti sono trattenute. Le notifiche nell'app non vengono mai ritardate.

I guasti gravi passano sempre, anche di notte: sito giù, server giù, database non raggiungibile, replica scollegata, lavoro programmato mancato, cluster muto.

Telegram

1. In Preferenze → Notifiche accendi Telegram e premi Collega Telegram: si apre la chat con il bot, già riconosciuta come tua.
2. Nella chat premi Avvia (in inglese Start).
3. Torna nella pagina: quando leggi «Collegato come», gli avvisi ti arrivano in chat.

Il bot va creato una volta dall'amministratore dell'installazione: vedi Impostazioni. Anche le email partono solo se l'installazione ha un server SMTP.

Webhook

Un webhook porta gli avvisi a un altro sistema: una chat di squadra, un tuo servizio.

1. Apri Avvisi → Canali di consegna e premi Nuovo canale.
2. Scrivi il Nome e l'URL webhook: un indirizzo https pubblico.
3. Se vuoi, imposta un Secret firma (opzionale).
4. Premi Crea canale, poi collegalo alle regole che devono usarlo, nel campo Canali esterni.

A ogni avviso CloseYourIt manda una richiesta POST con un JSON: event_type, title, body, url, project, subject e sent_at. Con il secret, la richiesta porta l'intestazione X-CloseYourIt-Signature: sha256=<firma>: la firma HMAC-SHA256 del corpo, da controllare prima di fidarti. Se il tuo indirizzo non risponde, la consegna non viene ripetuta.

Riepilogo via email

Diverso dagli avvisi: un'email con il quadro d'insieme dei tuoi progetti, cioè visite, errori e uptime, con il confronto sul periodo prima. In Preferenze → Notifiche, sotto Riepilogo dei dati via email, scegli Ogni giorno, Ogni lunedì, Il primo del mese o Mai. Arriva la mattina e parla solo dei progetti che vedi.