Osservabilità
Usa Prometheus e OpenTelemetry par vedere traffico aggregato, errori, descarga e uso de łe pàxene sensa tracciare singoli visitadori.
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=5000
Lo stack compose observability imposta sti valori par el servizio website. Imposta FLUXHEIM_OTLP=disabled per eseguire el stesso binario sensa esportare metriche o trace.
La version 1.6.37 rende pì affidabile el smoke locale de observability riprovando avvii temporanei de Prometheus e Jaeger co porte apena assegnà quando le porte host-network le concore co altri processi runner.
Tegnì label a basa cardinalità: gruppo route, łengua, classe status, artifact descarga e target GitHub i xe ùtiłi. Indirisi IP raw e identificatori utente no.
Cosa mettere in dashboard
| Segnale | Parcossa conta |
|---|---|
| Request par route | Mostra che pàxene publiche e documenti i vien doparà. |
| Request par łocałe | Mostra che lingue richiedono più cura. |
| Classi status | Mostra errori sensa tracciare singoli utenti. |
| Download clicks | Mostra che artifact release i xe ùtiłi. |
| Click GitHub | Mostra che link esterni del progetto contano. |
Boundary privacy
- Usa counter e histogram aggregati invese de log request raw.
- Do not label metrics with IP addresses, user agents, or full URLs.
- Tegnì i listener Prometheus e OTLP su loopback o rete interna.
- Rendi visibile el comportamento de tracking inte łe pàxene privacy e cookie.