Osservabilità
Usa Prometheus e OpenTelemetry pi vìdiri trafficu aggregatu, errura, scarricamentu e usu dî pàggini senza tracciari singuli visitatura.
Metriche 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=5000U stack compose observability mposta chisti valori pi u serviziu website. Mposta FLUXHEIM_OTLP=disabled pi eseguiri u stissu binariu senza esportari metriche o trace.
La virsioni 1.6.37 fa cchiù affidabbili lu smoke lucali di observability, ripruvannu avvii timpuranei di Prometheus e Jaeger cu porti appena assignati quannu li porti host-network cumpitinu cu autri prucessi runner.
Manteni label a vascia cardinalità: gruppu route, lingua, classi status, artifact scarricamentu e target GitHub sunnu utili. Indirizzi IP raw e identificatori utenti no.
Cosa mettere in dashboard
| Segnale | Picchì conta |
|---|---|
| Request pi route | Mostra quali pàggini pùbblici e ducumenti vennu usati. |
| Request pi lucali | Mostra quali lingue richiedono cchiù cura. |
| Classi status | Mostra errura senza tracciari singuli utenti. |
| Download clicks | Mostra quali artifact release sunnu utili. |
| Click GitHub | Mostra quali link esterni dû progetto contano. |
Boundary privacy
- Usa counter e histogram aggregati invece di log request raw.
- Do not label metrics with IP addresses, user agents, or full URLs.
- Mantieni li listener Prometheus e OTLP su loopback o rete interna.
- Renni visìbbili u cumpurtamentu di tracking ntê pàggini privacy e cookie.