# Problemi

Tenere traccia delle anomalie di sistema ricorrenti (errori di sincronizzazione, provisioning e metadati), raggruppate e gestite fino alla risoluzione.

Un **problema** è un'anomalia *di sistema* ricorrente che la piattaforma ha rilevato da sé: un errore operativo che si verifica in background e tende a ripetersi. Laddove l'[audit log](https://dts-identity.com/it/docs/monitoring/audit-logs.md) registra i singoli eventi, i problemi raccolgono molte occorrenze dello stesso problema di fondo in un'unica voce che è possibile seguire fino alla risoluzione: una directory che non riesce a sincronizzarsi ogni ora compare così come **un solo** problema con un conteggio di occorrenze in crescita, anziché come decine di righe di log sparse.

Si trova nella Admin Console in **Audit Trail → Problemi**.

I problemi vanno intesi come la propria **coda di triage per ciò che la piattaforma ha rilevato da sé**: errori di sincronizzazione, provisioning, metadati e capacità, oltre ad altri schemi ripetitivi analoghi, emergono qui automaticamente e già raggruppati, così da lavorare sul *problema* anziché rincorrere singole righe di log. Si affianca all'[audit log](https://dts-identity.com/it/docs/monitoring/audit-logs.md): l'audit log è ciò che si *interroga* quando si ha una domanda precisa ("che cosa è successo all'utente X?"); i problemi sono ciò che si *passa in rassegna* per intercettare ciò che si ripete silenziosamente in background.

## Che cosa diventa un problema

I problemi vengono creati per le operazioni in background che falliscono, tipicamente:

- **Sincronizzazione delle directory**: un'esecuzione di sincronizzazione fallita, un errore di sincronizzazione utenti a monte, un errore di sincronizzazione della password oppure un problema di sincronizzazione relativo a un singolo utente (ad esempio un'email duplicata già usata da un altro utente).
- **Provisioning (SCIM)**: errori nella creazione, nell'aggiornamento, nella disattivazione o nell'eliminazione di utenti o gruppi in un'applicazione a valle collegata, oppure una connessione irraggiungibile.
- **Metadati SAML**: un URL di metadati che non è stato possibile aggiornare oppure una Request che non è stato possibile analizzare.
- **Capacità**: la registrazione di un dispositivo rifiutata perché è stato raggiunto il limite di postazioni per i dispositivi.

Ogni problema porta una **gravità** *Warning* o *Error* ed è collegato all'oggetto correlato (applicazione, directory, dispositivo o utente), quando ne esiste uno.

## Come funziona il raggruppamento

Le occorrenze ripetute della stessa causa radice vengono unite in un unico problema. Ogni problema tiene traccia di:

- un **conteggio delle occorrenze**: quante volte l'evento di fondo è stato osservato;
- un timestamp di **prima osservazione** e di **ultima osservazione**;
- un istogramma delle occorrenze nel tempo, consultabile sulle **ultime 24 ore, 30 giorni o 90 giorni**, così da distinguere un episodio isolato da un problema persistente con la granularità desiderata.

## Stati di un problema

Un problema attraversa questi stati:

| Stato | Significato |
|---|---|
| **Non risolto** | Aperto e da approfondire: è lo stato predefinito di un problema appena creato. |
| **Risolto** | La causa di fondo è stata affrontata e il problema è stato contrassegnato come concluso. |
| **Ripresentati** | Un problema risolto in precedenza che ha ricominciato a verificarsi. |
| **Archiviato** | Messo da parte e non più mostrato negli elenchi attivi. |

La vista si apre sulla scheda **Non risolto** e offre inoltre le schede **Risolto**, **Ripresentati** e **Archiviato**, così da passare tra il lavoro aperto, ciò che è stato gestito, i problemi tornati a presentarsi e gli elementi messi da parte.

[Image: L'elenco dei problemi con errori di provisioning ricorrenti e il numero di occorrenze]

## Lavorare su un problema

1. Aprire **Audit Trail → Problemi**. La scheda **Non risolto** elenca i problemi aperti, a partire da quelli osservati più di recente.
2. Selezionare un problema per aprirne la vista di dettaglio. Vi si trovano il tipo, la gravità, l'oggetto correlato, il conteggio delle occorrenze, i momenti di prima e ultima osservazione, un istogramma specifico del problema e il contesto completo dell'evento.
3. Indagare la causa radice a partire da quel contesto, ad esempio correggendo le credenziali della directory oppure la mappatura di provisioning a valle.
4. **Modificare lo stato**: contrassegnare il problema come *Risolto* una volta affrontato. Se lo stesso problema si ripresenta in seguito, torna come *Ripresentati*, così da non perderlo di vista. Un problema risolto o archiviato può essere **riaperto** (riportato a *Non risolto*) dalla sua pagina di dettaglio.
5. **Archiviare** un problema che si vuole togliere dagli elenchi attivi mantenendone però traccia: usare **Azioni → Archivia** nella pagina di dettaglio. Un problema archiviato è nascosto dalle schede Non risolto e Risolto e resta nella scheda **Archiviato**; il problema e il suo storico vengono conservati ed è sempre possibile riaprirlo. L'archiviazione è l'azione reversibile "ho fatto il triage, lo metto da parte".
6. **Eliminare** un problema solo quando non serve davvero conservarne traccia. L'eliminazione rimuove il problema in modo definitivo: a differenza dell'archiviazione non è previsto alcun annullamento e non viene conservato alcuno storico.

## Argomenti correlati

- [Audit log](https://dts-identity.com/it/docs/monitoring/audit-logs.md): la registrazione per singolo evento da cui i problemi vengono derivati.
- [Piani e add-on](https://dts-identity.com/it/docs/getting-started/plans-and-addons.md): che cosa include il proprio livello.
