Fluxheim/Документация/Наблюдаемост

Наблюдаемост

Използвай Prometheus и OpenTelemetry, за да виждаш агрегирани traffic, грешки, download и употреба на страници без проследяване на отделни посетители.

Prometheus метрики

[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 без export на metrics или traces.

Дръж label-ите low-cardinality: route group, език, status class, download artifact и GitHub target са полезни. Raw IP адреси и user identifiers не са.

Какво да е в dashboard

СигналЗащо е важно
Request-и по routeПоказва кои public page и docs се използват.
Request-и по localeПоказва кои езици имат нужда от най-много грижа.
Status class-овеПоказва грешки без проследяване на отделни users.
Download clicksПоказва кои release artifact-и са полезни.
GitHub click-овеПоказва кои външни project link-ове са важни.

Граница на поверителност

  • Използвай aggregate counter-и и histogram-и вместо raw request log-ове.
  • Do not label metrics with IP addresses, user agents, or full URLs.
  • Дръж Prometheus и OTLP listener-и на loopback или internal network.
  • Направи tracking поведението видимо на privacy и cookies страниците.
Български