Beobachtbarkeit
Nutze Prometheus und OpenTelemetry, um aggregierten Traffic, Fehler, Downloads und Seitennutzung zu sehen, ohne einzelne Besucher zu verfolgen.
Prometheus-Metriken
[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=5000Der Observability-Compose-Stack setzt diese Werte fur den Website-Dienst. Setze FLUXHEIM_OTLP=disabled um dasselbe Binary ohne Metrik- oder Trace-Export auszufuhren.
Halte Labels niedrig-kardinal: Routengruppe, Sprache, Statusklasse, Download-Artefakt und GitHub-Ziel sind nützlich. Rohe IP-Adressen und Benutzerkennungen sind es nicht.
Was ins Dashboard gehort
| Signal | Warum es wichtig ist |
|---|---|
| Anfragen nach Route | Zeigt, welche offentlichen Seiten und Dokus genutzt werden. |
| Anfragen nach Sprache | Zeigt, welche Sprachen am meisten Pflege brauchen. |
| Statusklassen | Zeigt Fehler, ohne einzelne Nutzer zu verfolgen. |
| Download clicks | Zeigt, welche Release-Artefakte nutzlich sind. |
| GitHub-Klicks | Zeigt, welche externen Projektlinks wichtig sind. |
Datenschutzgrenze
- Nutze aggregierte Counter und Histogramme statt roher Request-Logs.
- Do not label metrics with IP addresses, user agents, or full URLs.
- Halte Prometheus- und OTLP-Listener auf Loopback oder einem internen Netzwerk.
- Mache das Tracking-Verhalten auf den Datenschutz- und Cookie-Seiten sichtbar.