Fluxheim/Dokumentace/Pozorovatelnost

Pozorovatelnost

Použij Prometheus a OpenTelemetry pro agregovaný přehled traffic, chyb, download a použití stránek bez sledování jednotlivých návštěvníků.

Prometheus metriky

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

OTLP export dat dat

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 nastavuje toto pro website service. Nastav FLUXHEIM_OTLP=disabled pro spuštění stejného binary bez exportu metrics nebo trace.

Drž label low-cardinality: route group, jazyk, status class, download artifact a GitHub target jsou užitečné. Raw IP adresy a user identifiers nejsou.

Co dát do dashboard

Signál sledování	Proč na tom záleží
Request podle route	Ukazuje, které public pages a docs se používají.
Request podle locale	Ukazuje, které jazyky potřebují nejvíc péče.
Status class	Ukazuje chyby bez sledování jednotlivých user.
Download clicks	Ukazuje, které release artifact jsou užitečné.
GitHub click	Ukazuje, které externí project link jsou důležité.

Hranice soukromí

Použij aggregate counter a histogram místo raw request log.
Do not label metrics with IP addresses, user agents, or full URLs.
Drž Prometheus a OTLP listener na loopback nebo internal network.
Zviditelni tracking behavior na stránkách privacy a cookies.