Fluxheim/Dokumentation/Driftsoverblik

Driftsoverblik

Brug Prometheus og OpenTelemetry til at se aggregeret trafik, fejl, downloads og sidebrug uden at spore individuelle besøgende.

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=5000

Observability compose-stacken sætter disse for website-servicen. Sæt FLUXHEIM_OTLP=disabled for at køre samme binær uden at eksportere metrics eller traces.

Hold labels low-cardinality: route group, sprog, status class, download artifact og GitHub target er nyttige. Rå IP-adresser og brugeridentifikatorer er det ikke.

Hvad dashboardet bør vise

SignalværdiværdiHvorfor det betyder noget
Requests efter routeViser hvilke public pages og docs der bruges.
Requests efter localeViser hvilke sprog der kræver mest vedligehold.
Status-klasserViser fejl uden at spore individuelle brugere.
Download clicksViser hvilke release artifacts der er nyttige.
GitHub-clicksViser hvilke eksterne project-links der betyder noget.

Privatlivsgrænse

  • Brug aggregate counters og histograms i stedet for rå request logs.
  • Do not label metrics with IP addresses, user agents, or full URLs.
  • Hold Prometheus- og OTLP-listeners på loopback eller et internt netværk.
  • Gør tracking-adfærd synlig på privacy- og cookies-siderne.
Dansk