> For the complete documentation index, see [llms.txt](https://manuale.opencontent.it/manuali/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manuale.opencontent.it/manuali/manuale-operativo-interno/iam-console/monitoraggio-e-log.md).

# Monitoraggio e log

Dove si trovano i log della IAM Console, gli eventi principali e le metriche.

## I log

La console scrive i log in formato JSON, una riga per evento. Ogni riga ha i campi `time`, `level` (`info`, `warn`, `error`) ed `event`, più i dati dell'evento. I log non contengono dati personali in chiaro: gli operatori compaiono con il loro identificativo.

I log sono quelli del servizio Docker della console:

* produzione: `iam-console-prod_iam-console`;
* QA: `iam-console-qa_iam-console`.

## Gli eventi da conoscere

| Evento                                               | Livello     | Significato                                                        |
| ---------------------------------------------------- | ----------- | ------------------------------------------------------------------ |
| `startup`                                            | info        | Avvio della console, con la versione                               |
| `shutdown`                                           | info        | Spegnimento ordinato                                               |
| `growthbook_available` / `growthbook_unavailable`    | info / warn | GrowthBook raggiungibile o no                                      |
| `maintenance_on` / `maintenance_off`                 | info        | Entrata e uscita dalla manutenzione                                |
| `flag_value_clamped`                                 | warn        | Un valore di GrowthBook fuori intervallo è stato corretto          |
| `iam_bootstrap_done`                                 | info        | Fine di un riallineamento di ruoli e accessi, con i conteggi       |
| `iam_member_reconcile_done`                          | info        | Riallineamento degli accessi di un Ente, con i tenant saltati      |
| `staff_group_missing`                                | warn        | Il gruppo dello staff non esiste in Authentik                      |
| `users_page_slow`                                    | info        | La pagina Operatori ha superato un secondo, con i tempi delle fasi |
| `webhook_tm_received` / `webhook_authentik_received` | info        | Webhook ricevuti dal Tenant Manager e da Authentik                 |
| `enrollment_pending_group_skipped`                   | warn        | Un'iscrizione a un gruppo è stata scartata alla registrazione      |
| `invitation_revoke_failed`                           | error       | La revoca di un invito non è riuscita                              |
| `tm_fetch_failed`                                    | error       | Il Tenant Manager non ha risposto                                  |

## Lo stato del servizio

* `GET /api/v1/status` risponde `200` quando la console è attiva. Risponde `503` solo se il database non è ancora aggiornato alle migrazioni della versione installata;
* `GET /metrics` espone in formato Prometheus le iscrizioni ai gruppi in attesa di registrazione: `iam_pending_enrollments_total`, `iam_pending_enrollments_stale_total` (più vecchie di due ore) e `iam_pending_enrollments_oldest_age_seconds`.

{% hint style="info" %}
Sentry raccoglie gli errori applicativi solo se nell'ambiente è impostata la variabile `SENTRY_DSN`.
{% endhint %}
