Fluxheim/Documentasion/Osservabilità

Osservabilità

Usa Prometheus e OpenTelemetry par vedere traffico aggregato, errori, descarga e uso de łe pàxene sensa tracciare singoli visitadori.

Metriche 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=5000

Lo stack compose observability imposta sti valori par el servizio website. Imposta FLUXHEIM_OTLP=disabled per eseguire el stesso binario sensa esportare metriche o trace.

La version 1.6.37 rende pì affidabile el smoke locale de observability riprovando avvii temporanei de Prometheus e Jaeger co porte apena assegnà quando le porte host-network le concore co altri processi runner.

Tegnì label a basa cardinalità: gruppo route, łengua, classe status, artifact descarga e target GitHub i xe ùtiłi. Indirisi IP raw e identificatori utente no.

Cosa mettere in dashboard

SegnaleParcossa conta
Request par routeMostra che pàxene publiche e documenti i vien doparà.
Request par łocałeMostra che lingue richiedono più cura.
Classi statusMostra errori sensa tracciare singoli utenti.
Download clicksMostra che artifact release i xe ùtiłi.
Click GitHubMostra che link esterni del progetto contano.

Boundary privacy

  • Usa counter e histogram aggregati invese de log request raw.
  • Do not label metrics with IP addresses, user agents, or full URLs.
  • Tegnì i listener Prometheus e OTLP su loopback o rete interna.
  • Rendi visibile el comportamento de tracking inte łe pàxene privacy e cookie.
Vèneto