Osservabilità
Usa Prometheus e OpenTelemetry per vedere traffico aggregato, errori, download e uso delle pagine senza tracciare singoli visitatori.
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=5000Lo stack compose observability imposta questi valori per il servizio website. Imposta FLUXHEIM_OTLP=disabled per eseguire lo stesso binario senza esportare metriche o trace.
Mantieni label a bassa cardinalità: gruppo route, lingua, classe status, artifact download e target GitHub sono utili. Indirizzi IP raw e identificatori utente no.
Cosa mettere in dashboard
| Segnale | Perché conta |
|---|---|
| Request per route | Mostra quali pagine pubbliche e documenti vengono usati. |
| Request per locale | Mostra quali lingue richiedono più cura. |
| Classi status | Mostra errori senza tracciare singoli utenti. |
| Download clicks | Mostra quali artifact release sono utili. |
| Click GitHub | Mostra quali link esterni del 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 i listener Prometheus e OTLP su loopback o rete interna.
- Rendi visibile il comportamento di tracking nelle pagine privacy e cookie.