Fluxheim/Dokument/Observerbarhet

Observerbarhet

Använd Prometheus och OpenTelemetry för att se aggregerad trafik, fel, nedladdningar och sidanvändning utan att spåra enskilda besökare.

Prometheus-mätvärden

[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 dessa värden för webbplatstjänsten. Sätt FLUXHEIM_OTLP=disabled för att köra samma binary utan att exportera metrics eller traces.

Version 1.6.37 gör den lokala observability-smoken mer tillförlitlig genom att starta om tillfälliga Prometheus- och Jaeger-processer med nya portar när host-network-portar krockar med andra runner-processer.

Håll labels lågkardinala: ruttgrupp, språk, statusklass, nedladdningsartefakt och GitHub-mål är användbara. Råa IP-adresser och användaridentifierare är det inte.

Vad som ska visas i dashboarden

MätsignalVarför det spelar roll
Förfrågningar per ruttVisar vilka publika sidor och docs som används.
Förfrågningar per språkVisar vilka språk som behöver mest omsorg.
StatusklasserVisar fel utan att spara enskilda användare.
Download clicksVisar vilka releaseartefakter som är användbara.
GitHub-klickVisar vilka externa projektlänkar som spelar roll.

Integritetsgräns

  • Använd aggregerade räknare och histogram istället för råa request-loggar.
  • Do not label metrics with IP addresses, user agents, or full URLs.
  • Håll Prometheus- och OTLP-listeners på loopback eller internt nätverk.
  • Gör spårningsbeteendet synligt på privacy- och cookie-sidorna.
Svenska