Observabilitat
Usa Prometheus i OpenTelemetry per veure trànsit agregat, errors, baixades i ús de pàgines sense rastrejar visitants individuals.
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=5000El stack compose de observability define esto per a el servei website. Define FLUXHEIM_OTLP=disabled per executar el mateix binari sense exportar metrics ni traces.
La versió 1.6.37 fa més fiable l’observability smoke local reintentant arrencades temporals de Prometheus i Jaeger amb ports acabats d’assignar quan els ports host-network competeixen amb altres processos runner.
Mantingues labels low-cardinality: route group, idioma, status class, download artifact i GitHub target són útils. IPs raw i identificadors d'usuari no ho són.
Què mostrar al dashboard
| Senyal | Per què importa |
|---|---|
| Requests per route | Muestra qué pàgines públicas i docs se usan. |
| Requests per locale | Muestra qué idiomas necessitan más cuidado. |
| Clases de estat | Muestra errors sense rastrear usuaris individuals. |
| Download clicks | Mostra quins release artifacts són útils. |
| Clicks de GitHub | Muestra qué enlaces externs del proyecto importan. |
Frontera de privadesa
- Usa aggregate counters i histograms en lloc de request logs raw.
- Do not label metrics with IP addresses, user agents, or full URLs.
- Mantingues Prometheus i OTLP listeners en loopback o xarxa interna.
- Haz visible el comportament de tracking en les pàgines de privadesa i cookies.