Спостережуваність
Використовуйте 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=5000The 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 clicks | Shows 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.