Fluxheim/Τεκμηρίωση/Παρατηρησιμότητα

Παρατηρησιμότητα

Χρησιμοποίησε Prometheus και OpenTelemetry για να δεις aggregate traffic, errors, downloads και page usage χωρίς tracking μεμονωμένων επισκεπτών.

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 stack θέτει αυτά για το website service. Θέσε FLUXHEIM_OTLP=disabled για να τρέξει το ίδιο binary χωρίς metrics ή traces export.

Κράτα labels χαμηλού cardinality: route group, language, status class, download artifact και GitHub target είναι χρήσιμα. Raw IP addresses και user identifiers δεν είναι.

Τι να βάλεις στο dashboard

ΣήμαΓιατί έχει σημασία
Requests ανά routeΔείχνει ποιες public pages και docs χρησιμοποιούνται.
Requests ανά localeΔείχνει ποιες γλώσσες χρειάζονται περισσότερη φροντίδα.
Status classes ομάδες ομάδεςΔείχνει errors χωρίς tracking μεμονωμένων users.
Download clicksΔείχνει ποια release artifacts είναι χρήσιμα.
GitHub clicks μέτρηση μέτρησηΔείχνει ποιοι εξωτερικοί project links έχουν σημασία.

Privacy boundary όριο όριο

  • Χρησιμοποίησε aggregate counters και histograms αντί για raw request logs.
  • Do not label metrics with IP addresses, user agents, or full URLs.
  • Κράτα Prometheus και OTLP listeners σε loopback ή internal network.
  • Κάνε το tracking behavior ορατό στις privacy και cookies pages.
Ελληνικά