Alertes — instances & exécutions

Instances d’alerte

Chaque fois qu’une alerte correspond, une instance est levée. Son cycle de vie orienté utilisateur est suivi séparément de l’enregistrement immuable levé :

Statut	Signification
`pending`	Nouvellement levée ; aucune action encore.
`acknowledged`	Un utilisateur l’a vue (enregistre qui/quand).
`resolved`	Gérée (enregistre qui/quand + un commentaire optionnel).
`archived`	Cachée de la liste active.

Une instance enregistre ce qui a correspondu — par exemple :

{
  "alert_id": "<uuid>",
  "alert_value": 85.5,
  "trigger_type": "THRESHOLD_APPROACHING",
  "approach_percentage": 92,
  "tags": ["low-stock", "critical"],
  "perimeter_results": {
    "shop_ids": [
      { "id": "<shop>", "productIds": [ { "id": "<product>", "variants": [ { "id": "<variant>", "value": 2 } ] } ] }
    ],
    "brandIds": ["<brand>"]
  }
}

alert_value — la valeur correspondante.
trigger_type — voir types de déclenchement.
approach_percentage — à quel point proche du seuil (pour THRESHOLD_APPROACHING).
perimeter_results — les entités correspondantes, par niveau de périmètre. La casse des clés reflète la forme stockée telle quelle (par ex. shop_ids à côté de brandIds).

Exécutions d’évaluation

Les alertes sont évaluées par une exécution d’évaluation d’alerte — manuelle, planifiée ou via API. Une exécution évalue les alertes actives (ou un sous-ensemble spécifié), crée des instances pour les nouvelles correspondances, et résout les instances qui ne correspondent plus.

Champ	Signification
`status`	`PENDING → RUNNING → SUCCESS / FAILED`.
`triggerType`	`MANUAL`, `SCHEDULED`, ou `API`.
`alertIds`	Alertes spécifiques à évaluer (null = toutes les alertes actives).
`stats`	`{ alertsEvaluated, instancesCreated, instancesResolved, durationMs }`.
`logs`	Entrées structurées (`DEBUG`/`INFO`/`WARN`/`ERROR`), plafonnées à 5000 par exécution.

{
  "status": "SUCCESS",
  "triggerType": "MANUAL",
  "stats": { "alertsEvaluated": 2, "instancesCreated": 3, "instancesResolved": 1, "durationMs": 4523 }
}

Parce qu’une exécution crée et résout, la liste des instances actives reste synchronisée — un problème qui s’efface est résolu automatiquement à la prochaine exécution.

Les exécutions partagent la même forme observable (statut, type de déclenchement, journaux structurés, statistiques) que les exécutions d’ingestion et d’évaluation d’étiquette.

Intégration API

Recettes API

Plateforme & modèle de données

Couche décision (référence)

Exploitation & infrastructure

Specs d'ingestion (référence)

Workflows (référence)

Règles de tagging (référence)

Alertes (référence)

Alertes — instances & exécutions

Instances d’alerte

Exécutions d’évaluation

​Instances d’alerte

​Exécutions d’évaluation

Instances d’alerte

Exécutions d’évaluation