Passer au contenu principal

​
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é :
StatutSignification
pendingNouvellement levée ; aucune action encore.
acknowledgedUn utilisateur l’a vue (enregistre qui/quand).
resolvedGérée (enregistre qui/quand + un commentaire optionnel).
archivedCaché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.
ChampSignification
statusPENDING → RUNNING → SUCCESS / FAILED.
triggerTypeMANUAL, SCHEDULED, ou API.
alertIdsAlertes spécifiques à évaluer (null = toutes les alertes actives).
stats{ alertsEvaluated, instancesCreated, instancesResolved, durationMs }.
logsEntré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.