Ruby / RailsCollega le tue app
Documentazione / Collega / Collega le tue app
Ruby / Rails
La gemma closeyourit-ruby manda errori, log, query lente e metriche dei job da un'app Rails.
Cosa raccoglie
Da sola, con Rails:
- le eccezioni non gestite, con la richiesta HTTP che le ha causate;
- gli errori nei job in background (ActiveJob e Sidekiq);
- gli errori gestiti segnalati con
Rails.error.report; - le query lente e i metodi lenti;
- le metriche dei job in background;
- la telemetria d'uso: quali rotte, job e chiavi girano davvero, come
Controller#action, mai l'indirizzo. La spegni conusage_enabled = false.
Se lo chiedi tu:
- i log strutturati, legati alla richiesta dallo stesso codice: quelli che scrivi con
CloseYourIt.loge, concapture_rails_logs, le righe diRails.logger; - i problemi di performance: N+1, troppe query, chiamate HTTP lente.
Non raccoglie pagine viste né registra sessioni: per quelle serve JavaScript.
Installa
# Gemfile
gem "closeyourit-ruby"
Configura
# config/initializers/closeyourit.rb
CloseYourIt.init do |c|
c.endpoint_url = "https://bugs.example.com"
c.token = ENV["CLOSEYOURIT_TOKEN"]
c.project_id = ENV["CLOSEYOURIT_PROJECT_ID"]
c.environment = Rails.env
end
Senza indirizzo, token o progetto la gemma non fa niente: in sviluppo e nei test è sicura.
Da sapere
- L'invio avviene in background: non rallenta la richiesta e non fa mai cadere l'app.
- Dell'utente esce solo l'
id. L'IP del visitatore, la query string, il corpo della richiesta e il resto dell'utente escono solo consend_pii, che è spento. - Alcune cose escono come sono: l'intestazione
Referertiene la sua query string, e nei messaggi d'errore sono nascoste solo l'intestazioneAuthorizatione le credenziali dopoBearer,BasicoToken. Dati inviati dagli SDK elenca tutto quello che la gemma manda e nasconde. - In produzione un indirizzo
http://viene rifiutato: il token viaggerebbe in chiaro.
OpenTelemetry e contesto delle richieste
La gemma nativa raccoglie errori e problemi di prestazioni. La propagazione W3C facoltativa collega le richieste, ma non trasforma la gemma in un esportatore OTLP. Per operazioni complete e metriche generiche usa un esportatore ufficiale lato server con il ricevitore OpenTelemetry. Verifica che sia acceso prima di configurarlo.