Errori

Errori raccoglie i crash e le eccezioni che le tue app mandano tramite un SDK. Lo stesso guasto ripetuto mille volte resta una riga sola, con i suoi contatori: vedi subito quanti problemi diversi hai, non quanto rumore fanno.

Come si forma un gruppo

Ogni errore che arriva riceve un'impronta: un codice fisso calcolato dall'errore stesso. Gli errori con la stessa impronta, nello stesso progetto, finiscono nello stesso gruppo. L'impronta si calcola così, nell'ordine:

1. se l'SDK manda un'impronta sua, vale quella;
2. altrimenti il tipo di eccezione più il punto del codice da cui parte;
3. altrimenti il messaggio, con numeri e codici variabili tolti;
4. altrimenti il nome della richiesta.

Il testo variabile del messaggio (un id, un importo) non spacca il gruppo. Se lo stesso messaggio compare in più gruppi perché parte da punti diversi del codice, la pagina lo segnala con «Un problema solo, in N punti».

Ogni gruppo ha un livello (debug, info, warning, error, fatal) e uno stato: Non risolto, Risolto o Ignorato.

Leggere un errore

Apri una riga dell'elenco. In alto trovi Eventi ricevuti, Utenti, il grafico Occorrenze nel tempo e la release in cui è comparso (Introdotto in).

Sotto ci sono le Occorrenze recenti: seleziona una riga per vedere quel caso preciso, diviso in schede:

• Stack trace: le righe di codice attraversate;
• Dettagli: la richiesta, il server, il runtime e l'SDK;
• Utente, Tag e Contesto: quello che l'SDK ha mandato in più;
• Session replay: la registrazione della sessione, se c'è (vedi Registrazioni);
• Log della richiesta: i log della stessa richiesta, se portano lo stesso identificativo.

Puoi filtrare le occorrenze per Ambiente e Release.

Utenti conta le persone diverse colpite. Se dice «non tracciato», l'SDK non manda l'id dell'utente: impostalo prima che l'errore venga catturato. CloseYourIt conta le persone con un'impronta anonima; email, IP e username non vengono salvati.

Alcuni valori (password, token, email) appaiono come «Nascosto»: sono tolti prima del salvataggio, di proposito.

Risolvere, ignorare, riaprire

Sulla pagina dell'errore:

• Risolvi apre Risolvi e spiega: scrivi la Causa e il Rimedio. Sono facoltativi, ma è quello che cercherai se l'errore torna fra sei mesi.
• Ignora mette da parte un errore rumoroso che non ti interessa.
• Riapri riporta attivo un errore risolto o ignorato.

Per smistare molti errori insieme, selezionali nell'elenco e usa Risolvi, Ignora o Riapri nella barra che compare.

cyi errors resolve <id> --project acme-api
cyi errors mute <id> --project acme-api      # come Ignora
cyi errors reopen <id> --project acme-api

Serve il permesso «Triage errori».

Quando un errore risolto torna

Se arriva una nuova occorrenza di un errore Risolto, CloseYourIt lo riapre da solo: è una regressione. Si ricorda in quale release è tornato, e la regola d'avviso Regressione ti avvisa (vedi Avvisi).

Quando risolvi, CloseYourIt si segna la release in uso in quel momento (vedi Rilasci). Un'occorrenza che arriva da una release sicuramente più vecchia viene da un client non aggiornato: non riapre l'errore. Se l'ordine delle release non si può stabilire, l'errore si riapre.

Un errore Ignorato non si riapre da solo.

Trasformare un errore in ticket

1. Apri l'errore e premi Promuovi a ticket.
2. Guarda l'anteprima: progetto, titolo, il punto del codice, quante volte è successo e il collegamento all'errore.
3. Premi Crea il ticket.

Nasce un ticket di tipo Bug, collegato all'errore. Il messaggio originale resta intero nella descrizione. Serve il permesso «Promuovi errore a ticket».

cyi errors promote <id> --project acme-api

Fondere due gruppi

Se due gruppi sono lo stesso problema, selezionali nell'elenco e premi Fondi. Nella pagina Fondi gli errori scegli Quale gruppo resta, poi premi Fondi definitivamente. Si fondono solo errori dello stesso progetto.

Per quanto restano le occorrenze

Le singole occorrenze si tengono 30 giorni, poi vengono cancellate. Il gruppo e il totale Eventi ricevuti restano. Per cambiare la durata, apri il progetto, poi Impostazioni e Retention errori (giorni): vuoto significa usare il valore dell'organizzazione.