Observabilité Aquila PRO V1

L’édition PRO fournit plusieurs mécanismes d’observabilité destinés aux équipes de supervision (N2/N3).

Logs

• Format recommandé : JSON structuré.
• Chaque décision contient au minimum :
• timestamp ;
• repository, pipeline, branche ;
• statut (accepted / refused) ;
• raisons (codes de règles).

Les logs peuvent être collectés par un agent (ex. Promtail, Filebeat) et envoyés vers une plateforme de logs.

Métriques Prometheus

Exposées via le endpoint /metrics. Exemples de métriques typiques :

• aquila_publish_requests_total{status="accepted"} ;
• aquila_publish_requests_total{status="refused"} ;
• aquila_projects_loaded ;
• aquila_cooldown_active_total.

Ces métriques peuvent être affichées dans Grafana pour suivre :

• le volume de demandes ;
• les taux de refus par projet ;
• les périodes de forte activité.

Alerting

Quelques idées de règles d’alerte :

• taux de refus anormalement élevé sur un projet critique ;
• absence de métriques depuis un certain temps (suspicion d’arrêt de l’agent) ;
• nombre de cooldowns actifs en permanence (risque de sur‑déploiement).

L’implémentation concrète (Prometheus, Alertmanager, autre outil) relève de la responsabilité de l’équipe de supervision.