Aller au contenu principal

Observabilité

EntityFlow expose le traçage, le rapport d’erreurs, des journaux structurés et une piste d’audit — le tout piloté par des variables d’environnement et désactivé par défaut, sans aucune surcharge tant que vous ne l’activez pas.

Traçage​

EntityFlow émet des traces OpenTelemetry lorsque EF_OTEL_ENABLED=true (désactivé par défaut — il n’y a aucune surcharge lorsqu’il est désactivé). Pointez-le vers votre collecteur avec EF_OTEL_EXPORTER_OTLP_ENDPOINT et nommez le service avec EF_OTEL_SERVICE_NAME (par défaut ef-server).

Les spans couvrent :

  • les requêtes HTTP (tRPC et REST),
  • les requêtes de base de données,
  • les tâches de projection, de génération de code et de validation.

Erreurs​

Définissez EF_SENTRY_DSN pour activer le rapport d’erreurs Sentry. Lorsque le DSN n’est pas défini, Sentry est totalement inactif.

Journaux​

Les journaux sont au format JSON structuré via pino. Contrôlez la verbosité avec EF_LOG_LEVEL :

Niveau
fatal error warn info debug trace silentinfo est la valeur par défaut.

Audit​

Un journal d’audit en ajout seul enregistre les événements du cycle de vie des comptes et les actions des administrateurs. Il s’agit d’une fonctionnalité entreprise (voir Licences), affichée sur la page Journal d’audit d’EntityFlow Hub.

Exemple​

Activez le traçage et le rapport d’erreurs ensemble :

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"

Consultez la référence de configuration pour la liste complète des variables d’observabilité.