Observabilidade
Use Prometheus e OpenTelemetry para ver tráfego agregado, erros, transferências e uso de páginas sem seguir visitantes individuais.
Métricas Prometheus
[metrics]
enabled = true
listen = "127.0.0.1:9100"Export OTLP
FLUXHEIM_OTLP=enabled
OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
OTEL_METRIC_EXPORT_INTERVAL=5000A stack compose de observability define isto para o serviço website. Defina FLUXHEIM_OTLP=disabled para executar o mesmo binário sem exportar metrics nem traces.
Mantenha labels low-cardinality: route group, idioma, status class, download artifact e GitHub target são úteis. IPs raw e identificadores de utilizador não são.
O que mostrar no dashboard
| Sinal | Porque importa |
|---|---|
| Requests por route | Mostra que páginas públicas e docs são usados. |
| Requests por locale | Mostra que idiomas precisam de mais cuidado. |
| Classes de estado | Mostra erros sem seguir utilizadores individuais. |
| Download clicks | Mostra que release artifacts são úteis. |
| Clicks GitHub | Mostra que ligações externas do projeto importam. |
Fronteira de privacidade
- Use aggregate counters e histograms em vez de request logs raw.
- Do not label metrics with IP addresses, user agents, or full URLs.
- Mantenha listeners Prometheus e OTLP em loopback ou numa rede interna.
- Torne o comportamento de tracking visível nas páginas de privacidade e cookies.