Catalogue des checks Qualité
Le cockpit calcule en continu un score de qualité d'intégration par SIA : une moyenne pondérée de plusieurs checks, chacun mesurant un signal observable sur vos events.
Niveaux de qualité
| Niveau | Score | Sémantique |
|---|---|---|
| 🟢 EXCELLENT | ≥ 90 | Tous les checks passent. SIA pleinement exploitable. |
| 🟡 GOOD | ≥ 70 | Warnings mineurs. Le diagramme fonctionne. |
| 🟠 DEGRADED | ≥ 50 ou un check critical | Au moins un check critical échoue. |
| 🔴 BROKEN | < 40 avec critical | SIA structurellement cassé. |
La présence d'un seul check critical en échec bascule le niveau au minimum à DEGRADED, quel que
soit le score moyen. Poids : critical → 3, warning → 2, info → 1.
Les checks
flow_name_present — CRITICAL · seuil 95 %
% de spans run avec flow.name non-vide. Sans ce champ, les spans aval deviennent orphelins →
cascade illisible. Fix : flow.name.
hierarchy_resolvable — CRITICAL · seuil 80 %
% de spans dont le parent_span_id pointe vers un parent valide. Détecte le pattern « trop
d'orphelins ». Fix : pattern context manager : encapsulez vos
top-level steps dans un seul flow.
flow_phase_present — WARNING · seuil 80 %
% de spans avec flow.phase. Sans phase, les step cards perdent leur couleur. Fix :
flow.phase.
flow_step_present — WARNING · seuil 80 %
% de spans avec flow.step. Sans lui, pas de libellé court sur la card. Fix :
flow.step.
flow_name_consistent — WARNING · 1:1
Un flow_definition_id doit porter exactement un flow.name. Fix :
centraliser le slug.
asset_name_present — INFO · seuil 90 %
% de spans avec asset.name. Sans lui, les chips d'assets sont anonymes. Fix :
asset.name.
Quand le score n'est pas calculé
Pour les SIA en démarrage (< 20 spans sur 7 jours), le score affiche EXCELLENT/100. C'est volontaire : on ne pénalise pas un SIA qui n'a pas encore émis assez de données pour une statistique significative.