Sentry
Sentry raccoglie gli errori dell’applicazione e li presenta con lo stack e il contesto, così un problema si diagnostica senza aspettare la segnalazione dell’operatore. È opzionale e usa il progetto Sentry del laboratorio. Lasciandolo spento l’installazione non invia alcuna telemetria.
OpzionaleCosa fa
Monitoraggio errori.
Categoria: ai e osservabilità — Tutte opzionali: lasciandole vuote, l’installazione resta completamente offline.
Cosa serve
- Progetto Sentry del laboratorio, sul servizio gestito o su un’istanza propria
- Valutazione del trattamento se i contesti di errore possono contenere dati personali
Come funziona
Quando si verifica un errore, l’applicazione lo invia al progetto Sentry configurato tramite il suo indirizzo di raccolta.
Gli errori vengono raggruppati per tipo, con versione del rilascio e percorso in cui si sono verificati.
In fase di build è possibile caricare le mappe del codice, così lo stack risulta leggibile invece che offuscato.
Quando serve
Quando l’installazione è in produzione e si vuole intercettare i problemi prima delle segnalazioni degli utenti.
Quando serve capire se un errore riguarda un solo operatore o l’intera struttura.
Limiti
Sentry è un servizio esterno, salvo installazione autonoma: gli eventi di errore escono dall’infrastruttura del laboratorio.
All’errore viene associato l’utente che lo ha incontrato, con indirizzo email e ruolo, e il contesto applicativo passato da chi ha registrato l’errore.
Non è attivo un filtro automatico dei dati personali: va configurato prima di accendere la raccolta su dati reali, e la scelta va riportata nel registro dei trattamenti.
Senza indirizzo di raccolta configurato la raccolta è disattivata e non viene inviato nulla.
Come si attiva
Se ne occupa chi installa LabBox: il vostro tecnico informatico oppure noi.
Per il tecnico
- `NEXT_PUBLIC_SENTRY_DSN` — indirizzo di raccolta lato browser
- `SENTRY_DSN` — indirizzo di raccolta lato server
- `SENTRY_AUTH_TOKEN`, `SENTRY_ORG` e `SENTRY_PROJECT` — solo per il caricamento delle mappe del codice in fase di build
- Crea il progetto Sentry a nome del laboratorio, oppure predispone un’istanza autonoma.
- Copia l’indirizzo di raccolta nelle variabili lato browser e lato server.
- Se vuoi stack leggibili, imposta anche token, organizzazione e progetto per il caricamento delle mappe.
- Configura il filtraggio dei dati sensibili nel progetto Sentry.
- Rifai il deploy e genera un errore di prova per verificare che arrivi.
Domande frequenti
È obbligatorio?
No. Lasciando l’indirizzo di raccolta vuoto la funzione resta spenta e l’installazione non invia telemetria.
Chi paga il servizio?
Il laboratorio, sul proprio piano Sentry. Esiste anche la possibilità di ospitarlo in proprio.
Possono uscire dati dei pazienti?
Sì, se finiscono nel contesto di un errore. Per questo il filtraggio va configurato prima di attivare la raccolta in produzione.
Moduli che la usano
Sentry lavora insieme a questi moduli di LabBox.
Vuoi vedere Sentry collegato al tuo laboratorio?
Entra nella demo con dati di esempio, senza registrarti.