Observerbarhet
Bruk Prometheus og OpenTelemetry for å se aggregert trafikk, feil, nedlastinger og sidebruk uten å spore individuelle besøkende.
Prometheus-metrikker
[metrics]
enabled = true
listen = "127.0.0.1:9100"OTLP-eksport
FLUXHEIM_OTLP=enabled
OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
OTEL_METRIC_EXPORT_INTERVAL=5000Observerbarhets-compose-stacken setter disse for nettstedstjenesten. Sett FLUXHEIM_OTLP=disabled for å kjøre samme binær uten å eksportere metrics eller traces.
Hold labels lav-kardinalitet: rutegruppe, språk, statusklasse, nedlastingsartefakt og GitHub-mål er nyttige. Rå IP-adresser og brukeridentifikatorer er det ikke.
Hva dashboardet bør vise
| Målepunkt | Hvorfor det betyr noe |
|---|---|
| Requests per rute | Viser hvilke offentlige sider og docs som brukes. |
| Requests per språk | Viser hvilke språk som trenger mest oppfølging. |
| Statusklasser | Viser feil uten å spore individuelle brukere. |
| Download clicks | Viser hvilke utgivelsesartefakter som er nyttige. |
| GitHub-klikk | Viser hvilke eksterne prosjektlenker som betyr noe. |
Personverngrense
- Bruk aggregerte tellere og histogrammer i stedet for rå request-logger.
- Do not label metrics with IP addresses, user agents, or full URLs.
- Hold Prometheus- og OTLP-lyttere på loopback eller et internt nettverk.
- Gjør sporingsatferd synlig på personvern- og cookie-sidene.