Osservabilità
Usa Prometheus e OpenTelemetry pe vedere traffic aggregato, errori, scarricamiento e uso d'e paggene senza tracciare singule visitatore.
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=5000Lo stack compose observability imposta chiste valori pe 'o servizio website. Imposta FLUXHEIM_OTLP=disabled per eseguire 'o stesso binario senza esportare metriche o trace.
’A versione 1.6.37 fa cchiù affidabile ’o smoke locale ’e observability, pruvanno n’ata vota ll’avvii temporanei ’e Prometheus e Jaeger cu porte appena assegnate quanno ’e porte host-network se contendono cu ate processi runner.
Mantieni label a bassa cardinalità: gruppo route, lengua, classe status, artifact scarricamiento e target GitHub sono utili. Indirizzi IP raw e identificatori utente no.
Cosa mettere in dashboard
| Segnale | Pecché conta |
|---|---|
| Request pe route | Mostra quali paggene pubbliche e documenti veneno usati. |
| Request pe lucale | Mostra quali lingue richiedono cchiù cura. |
| Classi status | Mostra errori senza tracciare singule utente. |
| Download clicks | Mostra quali artifact release sono utili. |
| Click GitHub | Mostra quali link esterni d'o progetto contano. |
Boundary privacy
- Usa counter e histogram aggregati invece 'e log request raw.
- Do not label metrics with IP addresses, user agents, or full URLs.
- Mantieni 'e listener Prometheus e OTLP su loopback o rete interna.
- Rendi visibile 'o comportamento 'e tracking dint' 'e paggene privacy e cookie.