Log

I log sono i messaggi che le tue app scrivono mentre funzionano: informazioni, avvisi, errori. Log li raccoglie tutti in un solo elenco, da cercare quando qualcosa non torna. Arrivano dagli SDK o da OpenTelemetry.

A differenza degli errori, i log non si raggruppano e non si risolvono: sono un elenco in ordine di tempo, che si legge e si filtra.

Com'è fatto un messaggio

Ogni messaggio ha:

• un livello: debug, info, warning, error o fatal;
• il Messaggio, cioè il testo;
• gli Attributi: coppie nome-valore che la tua app aggiunge, per esempio order_id o user_plan;
• il Contesto: progetto, ambiente, release e logger che l'ha scritto;
• se c'è, l'identificativo della richiesta (trace id): un codice uguale per tutto quello che succede durante la stessa richiesta.

Le app mandano solo i livelli per cui sono configurate. Se filtri un livello che l'app non ha mai mandato, l'elenco resta vuoto: il livello minimo si imposta nell'SDK.

Cercare un messaggio

1. Apri Log.
2. Scrivi nella ricerca una parola del messaggio, oppure incolla l'identificativo di una richiesta.
3. Restringi con i filtri Livello, Environment e Progetto.

Il grafico Quanti messaggi, e quando mostra il volume nel tempo e quanti messaggi sono allarmanti. Clicca una barra per guardare solo quel periodo; Torna a tutto il periodo lo annulla.

Per vedere quante volte compare lo stesso testo, raggruppa per Messaggio simile: ogni riga dice quando è comparso la prima e l'ultima volta.

Dalla riga di comando:

cyi logs list --project acme-api --level error
cyi logs show <id>

Seguire una richiesta

Quando un messaggio porta l'identificativo della richiesta, CloseYourIt lo collega da solo a tutto quello che è successo nella stessa richiesta. Non devi fare niente.

• Sulla pagina di un messaggio, Questa richiesta elenca gli altri log della stessa richiesta, e Errori di questa richiesta gli errori.
• Sulla pagina di un errore, la scheda Log della richiesta mostra i log emessi mentre succedeva. Vedi tutti i log di questa richiesta apre l'elenco filtrato.

I messaggi standard di Rails e dei lavori in background vengono riconosciuti in automatico. Per gli altri, manda l'identificativo come trace id insieme al log.

cyi logs list --trace-id <trace-id>

Collegare un messaggio a un errore o a un ticket

Se un messaggio spiega un errore o un ticket ma non porta lo stesso identificativo, collegalo a mano:

1. Apri il messaggio.
2. In Collegato a premi Collega a errore/ticket.
3. Cerca l'errore per titolo o il ticket per codice o titolo, poi premi Collega.

Il messaggio compare in Log collegati sulla pagina dell'errore o del ticket. Rimuovi toglie il collegamento.

Per aprire un ticket nuovo da un messaggio, premi Apri un ticket: nasce già compilato dal testo. Se quel messaggio era già diventato un ticket, viene collegato a quello invece di aprirne un altro.

Collegare e aprire un ticket richiedono il permesso «Collega un registro a un ticket».

cyi logs link <id> --to "Errors::Group:<uuid>"
cyi logs link <id> --to "Ticketing::Ticket:<uuid>"

Ricevere un avviso

La regola d'avviso Log error/fatal scatta quando arriva un messaggio di livello error o fatal. Come si crea: Avvisi.

Per quanto restano

I log si tengono 14 giorni, poi vengono cancellati da soli. Per cambiare la durata di un progetto, aprilo, poi Impostazioni e Retention log (giorni): vuoto significa usare il valore dell'organizzazione.