Observabilidad
Usa Prometheus y OpenTelemetry para ver tráfico agregado, errores, descargas y uso de páginas sin rastrear visitantes individuales.
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=5000El stack compose de observability define esto para el servicio website. Define FLUXHEIM_OTLP=disabled para ejecutar el mismo binario sin exportar metrics ni traces.
Mantén labels low-cardinality: route group, idioma, status class, download artifact y GitHub target son útiles. IPs raw e identificadores de usuario no lo son.
Qué mostrar en dashboard
| Señal | Por qué importa |
|---|---|
| Requests por route | Muestra qué páginas públicas y docs se usan. |
| Requests por locale | Muestra qué idiomas necesitan más cuidado. |
| Clases de estado | Muestra errores sin rastrear usuarios individuales. |
| Download clicks | Muestra qué release artifacts son útiles. |
| Clicks de GitHub | Muestra qué enlaces externos del proyecto importan. |
Frontera de privacidad
- Usa aggregate counters e histograms en lugar de request logs raw.
- Do not label metrics with IP addresses, user agents, or full URLs.
- Mantén Prometheus y OTLP listeners en loopback o red interna.
- Haz visible el comportamiento de tracking en las páginas de privacidad y cookies.