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.

Η έκδοση 1.6.37 κάνει το τοπικό observability smoke πιο αξιόπιστο επαναδοκιμάζοντας προσωρινές εκκινήσεις Prometheus και Jaeger με νέες θύρες όταν οι host-network θύρες ανταγωνίζονται άλλα runner processes.

Κράτα 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.
Ελληνικά