Monitoring des widgets

Suivi des deploiements de composants dsfr-data sur les sites gouvernementaux.

Opt-in uniquement

Les beacons sont desactives par defaut. Aucune donnee n'est collectee tant que le site deployeur n'a pas explicitement active le tracking.

Activation

Le site qui integre les composants dsfr-data doit ajouter cette ligne avant le chargement de la bibliotheque :

<script>window.DSFR_DATA_BEACON = true;</script>
<script src="https://cdn.jsdelivr.net/npm/dsfr-data@0/dist/dsfr-data.core.umd.js"></script>

Fonctionnement

  • Chaque composant dsfr-data-* envoie un beacon (pixel de tracking) lors de son initialisation dans la page.
  • Le beacon transmet : le nom du composant, le type de graphique (le cas echeant) et l'URL de la page (origin + path, sans query string).
  • Deduplication : un seul beacon par composant+type par chargement de page.
  • Ignore en dev : aucun envoi sur localhost, 127.0.0.1 ou le domaine du proxy.

Collecte des donnees

  • Les beacons arrivent sous forme de requetes image (pixel 1x1) sur l'endpoint /beacon du proxy, qui les enregistre dans beacon.log.
  • Un script periodique transforme ces logs en donnees exploitables pour ce tableau de bord.
  • En mode base de donnees (__gwDbMode), les beacons sont envoyes en POST JSON vers /api/monitoring/beacon et stockes en MariaDB.
Chargement...