Observabilité
Utilisez Prometheus et OpenTelemetry pour voir le trafic, les erreurs, les téléchargements et l'utilisation des pages de façon agrégée, sans suivre les visiteurs individuellement.
Métriques Prometheus
[metrics]
enabled = true
listen = "127.0.0.1:9100"Export OTLP
FLUXHEIM_OTLP=enabled
OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
OTEL_METRIC_EXPORT_INTERVAL=5000Le stack compose d'observabilite definit ces valeurs pour le service du site. Mettez FLUXHEIM_OTLP=disabled pour executer le meme binaire sans exporter de metriques ni de traces.
Gardez les labels à faible cardinalité : groupe de route, langue, classe de statut, artefact de téléchargement et cible GitHub sont utiles. Les adresses IP brutes et identifiants utilisateur ne le sont pas.
A mettre dans le dashboard
| Signal | Pourquoi c'est important |
|---|---|
| Requetes par route | Montre quelles pages publiques et docs sont utilisees. |
| Requetes par langue | Montre quelles langues demandent le plus d'attention. |
| Classes de statut | Montre les erreurs sans suivre les utilisateurs individuellement. |
| Download clicks | Montre quels artefacts de release sont utiles. |
| Clics GitHub | Montre quels liens externes du projet comptent. |
Limite de confidentialite
- Utilisez des compteurs et histogrammes agreges plutot que des logs de requetes bruts.
- Do not label metrics with IP addresses, user agents, or full URLs.
- Gardez les listeners Prometheus et OTLP sur loopback ou un reseau interne.
- Rendez le comportement de suivi visible sur les pages confidentialite et cookies.