OpenTelemetry

CloseYourIt ha un’implementazione locale per ricevere e conservare tracce, metriche e log da OpenTelemetry. Il ricevitore è spento per impostazione predefinita. Le prove locali non dimostrano che sia acceso nella tua installazione o disponibile in una versione pubblicata.

Scegli il percorso

Per OTLP lato server usa un SDK o un Collector ufficiale OpenTelemetry. Gli SDK CloseYourIt conservano i propri canali per errori, prestazioni e altri dati. Abilitare gli header W3C in quegli SDK non crea da solo una traccia completa.

Il ricevitore OTLP iniziale richiede un token segreto di progetto con permesso ingest, solo lato server. Non inserirlo nel browser, in un’app mobile, nella configurazione pubblica Nuxt o in un’applicazione scaricabile. Il DSN pubblico non dà accesso a questo ricevitore.

Prima di collegare l’applicazione

Chi gestisce l’installazione deve distribuire versioni compatibili di gateway e Rails, abilitare esplicitamente OTLP_ENABLED=true e configurare la rete privata o un proxy HTTPS verificato. Le impostazioni locali non espongono un servizio pubblico:

Questi ingressi non gestiscono TLS. Usa l’indirizzo protetto fornito da chi gestisce il servizio, senza dedurlo dall’indirizzo dell’applicazione o da una porta standard. Il solo comando closeyourit enable ingest non dimostra che OTLP sia configurato.

Configura l’esportatore del tuo SDK con quel trasporto e indirizzo. Invia Authorization: Bearer <project token> negli header lato server o nei metadati gRPC. HTTP accetta Protobuf e JSON Protobuf OTLP, anche compressi con gzip. Il token autenticato sceglie il progetto; service.name non concede accesso a un altro progetto.

Verifica il primo invio

1. Invia una traccia con un’operazione padre e una figlia, una metrica e un log riconoscibili come prova.
2. Svuota la coda dell’esportatore e controlla eventuali errori o rifiuti parziali.
3. In CloseYourIt verifica i dati conservati nel progetto corretto, con orari e nome del servizio. La lettura tramite API richiede il permesso separato read.
4. Controlla che un altro progetto non possa leggerli e che non siano rimasti credenziali o dati personali.

Il successo del ricevitore significa conservato nella coda, non ancora salvato da Rails. Una risposta parziale indica gli elementi rifiutati: non rispedire alla cieca tutto il gruppo già accettato. Un log con gravità di errore non diventa automaticamente una segnalazione di errore.

Cosa è stato provato

Esistono prove locali complete con gli esportatori ufficiali Go OpenTelemetry 1.46.0 per tracce e metriche e l’SDK log 0.22.0, tramite HTTP e gRPC con gzip. Ogni prova ha controllato il salvataggio reale e la lettura privata. Non certifica altri linguaggi, servizi distribuiti su più macchine o la capacità in produzione.

Il ricevitore pubblico limita ogni richiesta a 1 MiB trasmesso e 5 MiB dopo la decompressione. Gli indirizzi interni Rails accettano JSON normalizzato non compresso fino a 5 MiB. Le metriche generiche e le segnalazioni native di query lente sono segnali diversi. Dati non supportati o troppo grandi producono errori espliciti, non una promessa di raccolta completa.

Per gli errori Nuxt senza OTLP usa gli adattatori Nuxt. Per i canali esistenti consulta il confronto degli SDK.

Consulta i dati

La guida tracce, misure e sessioni descrive il diagramma temporale delle operazioni, i filtri delle misure e gli avvisi su finestre chiuse. Gli altri stack hanno profili e segnali differenti: una prova Go non certifica automaticamente ogni SDK OpenTelemetry.