Aller au contenu

Plugin CTFd metrics_exporter

Couche : Applications CTF · Où : dans le pod CTFd (plugin chargé depuis CTFd/plugins/) · Version : version de l'image CTFd (3.8.8) ; plugin versionné avec le dépôt

À quoi elle sert ici et pourquoi ce choix

Expose l'état du jeu (utilisateurs, équipes, utilisateurs actifs, solves, soumissions, first bloods, état de l'événement, instances actives) pour les dashboards, les alertes et le scaling KEDA.

Où elle tourne et comment elle est déployée

Chargé par CTFd ; le jeton PAD_METRICS_TOKEN est un Secret ; la valeur est mise en cache 15 s dans le cache partagé (PAD_METRICS_CACHE_SECONDS).

Version épinglée

version de l'image CTFd (3.8.8) ; plugin versionné avec le dépôt

Fichiers de configuration dans le dépôt

apps/ctfd/plugins/metrics_exporter/__init__.py ; gitops/apps/ctfd/servicemonitor.yaml ; tests test_metrics_exporter.py.

Interactions avec les autres briques

Scrapé par Alloy (ServiceMonitor) vers VictoriaMetrics ; ctfd_active_users pilote KEDA.

Sécurité

Authentification Bearer (PAD_METRICS_TOKEN) ; 503 si non configuré (fail closed) ; aucune donnée personnelle dans les labels.

Supervision

Alertes CtfdMetricsMissing, CtfdMetricsStale : CTFd ; dashboard pad-live-ctf.

Opérations courantes

bash apps/ctfd/scripts/test.sh                 # harnais pytest CTFd officiel (PAD_LINT_FULL=1 via scripts/lint.sh)
kubectl -n ctfd logs deploy/ctfd | grep pad.   # journaux des plugins

Pièges connus

Les valeurs sont identiques sur tous les pods : agréger avec max() (jamais sum()).

Documentation officielle

Contrat d'API : API des plugins CTFd (source : apps/ctfd/API.md) · Plugins CTFd

Retour à l'index des composants