Fluxheim/Дакументацыя/Назіральнасць

Назіральнасць

Выкарыстоўвайце Prometheus і OpenTelemetry, каб бачыць агрэгаваны traffic, errors, downloads і page usage без tracking асобных наведвальнікаў.

Метрыкі Prometheus

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

Експорт OTLP

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

The observability compose stack sets these для the сайт service. Set FLUXHEIM_OTLP=disabled to запусціць the same binary без exporting метрыки або traces.

Версія 1.6.37 робіць лакальны observability smoke надзейнейшым, паўтараючы часовы запуск Prometheus і Jaeger з нова прызначанымі партамі, калі host-network парты канкуруюць з іншымі runner-працэсамі.

Тримайте labels low-cardinality: route group, language, status class, download artifact і GitHub target корисні. Raw IP addresses і user identifiers не выкарыстоўваюцься.

Що показувати на dashboard

СигналЧому гэта важливо
Запити за маршрутомShows which публічний старонки і docs are being used.
Запити за локаллюShows which мови need the most care.
Класи статусевShows помилки без tracking individual карыстальнікі.
Download clicksShows which выпуск artifacts are useful.
Кліки GitHubПаказвае, якія знешнія спасылкі праекта важныя.

Межа прыватності

  • Выкарыстоўвайце агрэгаваныя counter-ы і histogram-ы замест неапрацаваных request log-аў.
  • Do not label metrics with IP addresses, user agents, or full URLs.
  • Keep Prometheus і OTLP listeners on loopback або an internal network.
  • Выразна апішыце tracking на старонках privacy і cookies.
Беларуская