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.
Se lo chiedi tu:
- i log strutturati, legati alla richiesta dallo stesso codice;
- i problemi di performance: N+1, troppe query, chiamate HTTP lente;
- la telemetria d'uso: quali parti dell'app girano davvero.
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.
- Nessun dato personale parte, a meno che tu non lo accenda.
- 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.