Observability-overzicht
Gebruik Prometheus en OpenTelemetry om geaggregeerd verkeer, fouten, downloads en paginagebruik te zien zonder individuele bezoekers te volgen.
Prometheus-metrics
[metrics]
enabled = true
listen = "127.0.0.1:9100"OTLP-export
FLUXHEIM_OTLP=enabled
OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
OTEL_METRIC_EXPORT_INTERVAL=5000De observability compose-stack zet deze voor de websiteservice. Zet FLUXHEIM_OTLP=disabled om dezelfde binary te draaien zonder metrics of traces te exporteren.
Houd labels low-cardinality: routegroep, taal, statusklasse, downloadartifact en GitHub-doel zijn nuttig. Ruwe IP-adressen en gebruikersidentifiers zijn dat niet.
Wat je in een dashboard zet
| Signaal | Waarom het belangrijk is |
|---|---|
| Requests per route | Laat zien welke publieke pagina's en docs worden gebruikt. |
| Requests per taal | Laat zien welke talen de meeste aandacht nodig hebben. |
| Statusklassen | Laat fouten zien zonder individuele gebruikers te volgen. |
| Download clicks | Laat zien welke release-artifacts nuttig zijn. |
| GitHub-klikken | Laat zien welke externe projectlinks belangrijk zijn. |
Privacygrens
- Gebruik geaggregeerde counters en histogrammen in plaats van ruwe requestlogs.
- Do not label metrics with IP addresses, user agents, or full URLs.
- Houd Prometheus- en OTLP-listeners op loopback of een intern netwerk.
- Maak trackinggedrag zichtbaar op de privacy- en cookiepagina's.