Fluxheim/Dokumentacja/Observability operacyjne

Observability operacyjne

Użyj Prometheus i OpenTelemetry, aby widzieć zagregowany traffic, błędy, downloady i użycie stron bez śledzenia pojedynczych odwiedzających.

Metryki Prometheus

[metrics]
enabled = true
listen = "127.0.0.1:9100"

Eksport OTLP

FLUXHEIM_OTLP=enabled
OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
OTEL_METRIC_EXPORT_INTERVAL=5000

Stack compose observability ustawia te wartości dla website service. Ustaw FLUXHEIM_OTLP=disabled aby uruchomić ten sam binary bez eksportu metrics lub traces.

Trzymaj label-e low-cardinality: route group, język, status class, download artifact i GitHub target są przydatne. Raw IP addresses i user identifiers nie są.

Co pokazać w dashboard

Sygnał	Dlaczego to ważne
Requesty według route	Pokazuje, które public pages i docs są używane.
Requesty według locale	Pokazuje, które języki wymagają najwięcej uwagi.
Klasy statusu	Pokazuje błędy bez śledzenia pojedynczych users.
Download clicks	Pokazuje, które release artifacts są przydatne.
Kliknięcia GitHub	Pokazuje, które zewnętrzne project links są ważne.

Granica prywatności

Używaj aggregate counters i histograms zamiast raw request logs.
Do not label metrics with IP addresses, user agents, or full URLs.
Trzymaj Prometheus i OTLP listeners na loopback albo internal network.
Uwidocznij tracking behavior na stronach privacy i cookies.