Technischa Notiz: Observability
Nutz Prometheus und OpenTelemetry, um aggregierten Traffic, Fehler, Downloads und Seitennutzung zu sehn, 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=5000Da Observability-Compose-Stack setzt de Werte für den Website-Dienst. Setz FLUXHEIM_OTLP=disabled um dasselbe Binary ohne Metrik- oder Trace-Export auszuführn.
Version 1.6.37 macht den lokalen Observability-Smoke verlässlicher, indem kurzlebige Prometheus- und Jaeger-Starts mit frisch zugewiesene Ports wiederholt werdn, wenn Host-Network-Ports mit andern Runner-Prozessen zammstossen.
Hoib Labels niedrig-kardinal: Routengruppe, Sproch, Statusklasse, Download-Artefakt und GitHub-Ziel san nützlich. Rohe IP-Adressen und Benutzerkennungen san es ned.
Wos ins Dashboard gheart
| Zoacha | Warum des wichtig is |
|---|---|
| Anfragen nach Route | Zeigt, welche öffentlichen Seiten und Dokus gnutzt werdn. |
| Anfragen nach Sproch | Zeigt, welche Sprochn am meisten Pflege brauchn. |
| Statusklassen | Zeigt Fehler, ohne einzelne Nutzer z verfolgen. |
| Download clicks | Zeigt, welche Release-Artefakte nützlich san. |
| GitHub-Klicks | Zeigt, welche externen Projektlinks wichtig san. |
Datenschutzgrenze
- Nutz aggregierte Counter und Histogramme statt roher Request-Logs.
- Do not label metrics with IP addresses, user agents, or full URLs.
- Hoib Prometheus- und OTLP-Listener auf Loopback oder am internen Netzwerk.
- Mach s Tracking-Verhalten auf den Datenschutz- und Cookie-Seiten sichtbar.