Skip to main content

Drift detection

Detecte automatiquement les changements de schema (DDL applique en dehors d'Auralith) entre une baseline et l'etat courant.

Quand l'utiliser​

  • Verifier que personne n'a fait ALTER TABLE directement en prod.
  • Pre-deploiement, s'assurer que le schema staging matche prod.
  • Audit de conformite — tracer toute modification structurelle.

Workflow rapide​

  1. Drift de schema (sidebar projet, plan Enterprise).
  2. Premiere visite : marquer le snapshot courant comme baseline.
  3. Le cron quotidien drift_check prend un nouveau snapshot et le diff vs baseline. Resultat persiste en DriftReport.
  4. Auralith prend aussi un snapshot automatique apres chaque Mass Patch reussi — repere de rollback supplementaire.
  5. Drift detecte ? Email envoye via send_drift_alert. Badge dans la sidebar.
  6. Reviewer le diff (tables added / removed / modified, severity critical / moderate / minor).
  7. Acknowledge -> nouvelle baseline = current.

Concepts cles​

  • SchemaSnapshot : capture (taken_at, schema_hash, schema_json, is_baseline).
  • DriftReport : diff entre baseline et current. Status : pending / acknowledged.
  • Severity : critical (drop column / drop table), moderate (alter type), minor (add column / add index).
  • Diff engine : compare structure (tables, colonnes, FK, index, contraintes). Le contenu data n'est pas compare.

Pieges courants​

  • Faux positifs sur le default : certaines DBs reformatent le default value apres ALTER. Auralith normalise mais peut detecter un drift cosmetique.
  • Index recree pendant un VACUUM : noms d'index temporaires possibles. Le diff filtre via prefixes connus.
  • Plan Starter / Pro : drift detection est gated Enterprise. Voir Pricing.

API​

# Prendre un snapshot
curl -X POST https://app.auralith.io/api/v1/connections/{cid}/snapshots?baseline=true

# Verifier drift maintenant
curl -X POST https://app.auralith.io/api/v1/connections/{cid}/drift/check

# Acknowledge
curl -X POST https://app.auralith.io/api/v1/drifts/{id}/acknowledge

Voir aussi​