Fluxheim/Dokumentáció/Megfigyelhetőség

Megfigyelhetőség

Használj Prometheust és OpenTelemetryt aggregált traffic, error, download és page usage megfigyeléshez egyedi látogatók követése nélkül.

Prometheus metrikák

[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

Az observability compose stack ezeket állítja be a website service-hez. Állítsd be: FLUXHEIM_OTLP=disabled hogy ugyanaz a bináris metrics vagy traces export nélkül fusson.

Tartsd low-cardinalityn a labelöket: route group, language, status class, download artifact és GitHub target hasznos. Nyers IP-címek és user azonosítók nem.

Mit tegyél dashboardra

JelMiért számít
Requestek route szerintMegmutatja, mely public page-eket és docsokat használják.
Requestek locale szerintMegmutatja, mely nyelvek igénylik a legtöbb gondozást.
Status classokHibákat mutat egyedi felhasználók követése nélkül.
Download clicksMegmutatja, mely release artifactok hasznosak.
GitHub kattintásokMegmutatja, mely external project linkek számítanak.

Privacy boundary

  • Raw request logok helyett aggregate countereket és histogramokat használj.
  • Do not label metrics with IP addresses, user agents, or full URLs.
  • Tartsd a Prometheus és OTLP listenereket loopbacken vagy internal networkön.
  • Tedd láthatóvá a tracking viselkedést a privacy és cookies oldalakon.
Magyar