Fluxheim/Dokumentaatio/Havainnointi

Havainnointi

Käytä Prometheusta ja OpenTelemetryä aggregoidun liikenteen, virheiden, latausten ja sivukäytön näkemiseen ilman yksittäisten kävijöiden seurantaa.

Prometheus-mittarit

[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 asettaa nämä website-palvelulle. Aseta FLUXHEIM_OTLP=disabled ajaaksesi saman binäärin ilman metrics- tai trace-exporttia.

Pidä labelit low-cardinality: route group, kieli, statusluokka, latausartefakti ja GitHub-kohde ovat hyödyllisiä. Raa'at IP-osoitteet ja käyttäjätunnisteet eivät ole.

Mitä dashboardiin

Signaali	Miksi sillä on väliä
Requestit routeittain	Näyttää, mitä julkisia sivuja ja dokumentteja käytetään.
Requestit kielittäin	Näyttää, mitkä kielet tarvitsevat eniten huomiota.
Statusluokat	Näyttää virheet seuraamatta yksittäisiä käyttäjiä.
Download clicks	Näyttää, mitkä release-artefaktit ovat hyödyllisiä.
GitHub-klikkaukset	Näyttää, millä ulkoisilla projektilinkeillä on merkitystä.

Tietosuojaraja

Käytä aggregoituja countereita ja histogrammeja raakojen request-logien sijaan.
Do not label metrics with IP addresses, user agents, or full URLs.
Pidä Prometheus- ja OTLP-listenerit loopbackissa tai sisäisessä verkossa.
Tee seurantakäyttäytyminen näkyväksi privacy- ja cookies-sivuilla.