Observability operațional
Folosește Prometheus și OpenTelemetry pentru a vedea traffic agregat, erori, download-uri și utilizarea paginilor fără să urmărești vizitatori individuali.
Metrici 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=5000Stack-ul compose de observability setează acestea pentru website service. Setează FLUXHEIM_OTLP=disabled pentru a rula același binary fără export de metrics sau traces.
Ține label-urile low-cardinality: route group, limbă, status class, download artifact și GitHub target sunt utile. Raw IP addresses și user identifiers nu sunt.
Ce să pui în dashboard
| Semnal | De ce contează |
|---|---|
| Request-uri pe route | Arată ce public pages și docs sunt folosite. |
| Request-uri pe locale | Arată ce limbi au nevoie de cea mai multă atenție. |
| Clase de status | Arată erori fără urmărirea utilizatorilor individuali. |
| Download clicks | Arată ce release artifacts sunt utile. |
| Clickuri GitHub | Arată ce linkuri externe de proiect contează. |
Limită de confidențialitate
- Folosește counters și histograms agregate în loc de raw request logs.
- Do not label metrics with IP addresses, user agents, or full URLs.
- Ține Prometheus și OTLP listeners pe loopback sau o rețea internă.
- Fă vizibil comportamentul de tracking pe paginile privacy și cookies.