In questa guida
Per comunicare un incidente in inglese, descrivi quale problema incontrano i clienti, che cosa sta facendo il team e quando arriverà il prossimo aggiornamento. Durante un incidente in produzione, puoi confermare l’impatto sul servizio mentre sono ancora in corso le indagini sulla causa. Gli esempi seguono un incidente immaginario in cui alcuni clienti faticano a caricare lo storico degli ordini.
Scrivi il primo aggiornamento mentre indaghi
Sulla pagina di stato del servizio, parti da quello che il cliente stava cercando di fare. Poi comunica che il team sta indagando e indica entro che ora pubblicherai il prossimo aggiornamento.
Some customers are unable to load their order history.
We’re investigating the issue.
We’ll post another update by 14:25 UTC.
Some customers chiarisce che il problema riguarda solo una parte dei clienti. By 14:25 UTC significa “entro le 14:25 UTC” e indica quando aspettarsi il prossimo messaggio. Comunica i fatti man mano che li confermi e pubblica l’aggiornamento entro l’ora indicata anche se l’indagine è ancora in corso. Google SRE Workbook
Comunica la mitigazione e monitora il ripristino
We’ve rolled back a recent configuration change comunica che il team ha annullato una modifica alla configurazione. Di’ che cosa avete osservato dopo e che cosa state monitorando.
We’ve rolled back a recent configuration change.
The error rate is back to normal, and we’re monitoring recovery.
Usa mitigated quando l’intervento ha ridotto o eliminato l’impatto. Monitoring indica che il team sta continuando a osservare il servizio dopo l’intervento. Quando hai conferma del ripristino, comunica la chiusura dell’incidente indicando in quale intervallo i clienti hanno riscontrato il problema.
Order history is loading normally again.
The issue affected some customers from 14:10 to 14:23 UTC.
Adatta l’aggiornamento al canale del team tecnico
Nel canale interno, aggiungi l’ora di inizio, un endpoint o una metrica che aiuti il team a indagare. Se stai verificando un’ipotesi, usa We’re checking whether… per far capire che il nesso è ancora da confermare.
The orders API started returning more 5xx errors at 14:10 UTC.
We’re checking whether a recent configuration change contributed to the increase.
Per le comunicazioni pubbliche, segui il processo di approvazione del tuo team. Un rapporto di GitHub sulla disponibilità del servizio offre esempi di come descrivere al pubblico l’impatto sui clienti e il ripristino. Blog di GitHub
Esercitati con due aggiornamenti
Immagina che dalle 09:05 UTC alcuni clienti non riescano più a caricare file e che il team stia ancora indagando. Scrivi un aggiornamento per i clienti in due o tre frasi. Spiega l’impatto e impegnati a pubblicare un altro aggiornamento entro le 09:20 UTC. Poi registra una versione per il canale interno e aggiungi un dato che aiuti il team a indagare.
Continua con come chiedere chiarimenti in inglese e come dare un aggiornamento alla daily.