Наблюдаемость
Используйте Prometheus и OpenTelemetry, чтобы видеть aggregate traffic, errors, downloads и page usage без отслеживания отдельных visitors.
Prometheus metrics endpoint
[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=5000Observability compose stack задает это для website service. Установите FLUXHEIM_OTLP=disabled чтобы запускать тот же binary без exports metrics или 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
| Сигнал | Почему это важно |
|---|---|
| Requests по route | Показывает, какие public pages и docs используются. |
| Requests по locale | Показывает, каким languages нужно больше care. |
| Status classes HTTP | Показывает errors без отслеживания individual users. |
| Download clicks | Показывает, какие release artifacts полезны. |
| GitHub clicks счетчик | Показывает, какие external project links важны. |
Privacy boundary метрик
- Используйте aggregate counters и histograms вместо raw request logs.
- Do not label metrics with IP addresses, user agents, or full URLs.
- Держите Prometheus and OTLP listeners на loopback или internal network.
- Сделайте tracking behavior видимым на privacy and cookies pages.