Passa al contenuto principale

Osservabilità

EntityFlow espone tracciamento, segnalazione degli errori, log strutturati e una pista di audit — tutto governato da variabili d'ambiente e disattivato per impostazione predefinita, senza alcun overhead finché non lo attivi.

Tracciamento​

EntityFlow emette tracce OpenTelemetry quando EF_OTEL_ENABLED=true (disattivato per impostazione predefinita — non c'è alcun overhead quando è disattivato). Indirizzalo al tuo collector con EF_OTEL_EXPORTER_OTLP_ENDPOINT e assegna un nome al servizio con EF_OTEL_SERVICE_NAME (predefinito ef-server).

Gli span coprono:

  • le richieste HTTP (tRPC e REST),
  • le query del database,
  • i job di proiezione, generazione del codice e validazione.

Errori​

Imposta EF_SENTRY_DSN per abilitare la segnalazione degli errori di Sentry. Quando il DSN non è impostato, Sentry è completamente inattivo.

Log​

I log sono in JSON strutturato tramite pino. Controlla il livello di dettaglio con EF_LOG_LEVEL:

Livello
fatal error warn info debug trace silentinfo è il valore predefinito.

Audit​

Un log di audit in sola aggiunta registra gli eventi del ciclo di vita degli account e le azioni degli amministratori. Si tratta di una funzionalità enterprise (vedi Licenze) ed è consultabile nella pagina Registro di audit di EntityFlow Hub.

Esempio​

Abilita insieme il tracciamento e la segnalazione degli errori:

export EF_OTEL_ENABLED=true
export EF_OTEL_EXPORTER_OTLP_ENDPOINT="http://otel-collector:4318"
export EF_OTEL_SERVICE_NAME="ef-server"
export EF_SENTRY_DSN="https://examplePublicKey@o0.ingest.sentry.io/0"
export EF_LOG_LEVEL="info"

Consulta il riferimento alla configurazione per l'elenco completo delle variabili di osservabilità.