Vai al contenuto
CloseYourItdocsPagine

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.