Ruby ve Rails

Kurulum gem install blipit

blipit gem'ini (0.3.0 veya daha yenisi) ekleyin ve projenizin public key'i ile init'i bir kez çağırın. Blipit'in kendi çekirdeği üzerinde çalışır ve çalışma zamanı bağımlılığı yoktur. İşlenmemiş istisnalar kendiliğinden raporlanır; Rails, Rack, Sinatra ve Sidekiq desteği yerleşiktir.

Claude Code, Cursor veya başka bir yapay zekâ kodlama asistanına yapıştırın. Adımları ve kodu içerir. app.blipit.io'da API anahtarları altında aynı istem, anahtarınız yazılmış olarak gelir.
Video: Blipit'i her stack'e kurun, 1:07 itibarıyla

1Gemfile

ruby
gem "blipit"

2Başlangıçta başlatın

Rails: config/initializers/blipit.rb; başka bir şey kurmanız gerekmez, çünkü Blipit Rack middleware'ini, Active Job ve Rails.error raporlamasını kendisi ekler. Rack ve Sinatra uygulamaları use Blipit::Rack ekler. Betikler: kodunuz çalışmadan önce. Anahtar, projenin Anahtarlar sayfasındadır. Anahtar boşsa init hata fırlatmak yerine bir uyarı yazdırır ve false döndürür.

ruby
Blipit.init(
  key: "<public key>",
  environment: Rails.env,
  release: ENV["RELEASE"],
)

3Anahtarlarınızı alın

app.blipit.io'da oturum açın ve kenar çubuğunda API anahtarları'nı, ardından projenizi açın. Her projenin iki anahtarı vardır. Public key blipit_pk_ ile başlar: tarayıcı ve uygulama koduna gider, yalnızca olay gönderebilir ve herkesin görmesi güvenlidir. Secret key blipit_sk_ ile başlar: sunucunuzda ya da Odoo'da kalır, asla tarayıcıda olmaz, çünkü sorunları okuyup değiştirebilir de. Secret key yalnızca bir kez, oluşturulduktan hemen sonra gösterilir, bu yüzden o anda kopyalayın; kaybederseniz Yeni bir secret key oluştur'a basın, eskisi hemen çalışmayı durdurur. Bazı SDK'lar ayrıca aynı sayfada gösterilen proje id'sine ihtiyaç duyar.

app.blipit.io'da API anahtarları: tarayıcı kodu için public key (blipit_pk_), sunucular ve Odoo için secret key (blipit_sk_).
app.blipit.io'da API anahtarları: tarayıcı kodu için public key (blipit_pk_), sunucular ve Odoo için secret key (blipit_sk_).
Yeni bir secret key yalnızca bir kez gösterilir. Şimdi kopyalayın: hash'lenmiş olarak saklanır ve bir daha gösterilemez.
Yeni bir secret key yalnızca bir kez gösterilir. Şimdi kopyalayın: hash'lenmiş olarak saklanır ve bir daha gösterilemez.

4Anahtarı Rails credentials içinde tutun

Bu SDK public key ile gönderir. Rails'te onu şifreli credentials içinde tutun ve initializer'da okuyun; başka yerlerde bir ortam değişkeni kullanın.

sh
bin/rails credentials:edit
credentials
blipit:
  key: blipit_pk_your_public_key
config/initializers/blipit.rb
Blipit.init(
  key: Rails.application.credentials.dig(:blipit, :key),
  environment: Rails.env,
)

5Anahtarları git'ten uzak tutun

Anahtarları ortam değişkenlerinde ya da barındırma ortamınızın gizli ayarlarında tutun, asla commit ettiğiniz kodda tutmayın ve .env dosyalarınızı .gitignore'a ekleyin. Bir web sayfasında public key bulunması normaldir. Bir secret key git'e, herkese açık bir sayfaya, bir ekran görüntüsüne ya da bir sohbete düşerse API anahtarları'nı açın, Yeni bir secret key oluştur'a basın ve yeni anahtarı eskisinin kullanıldığı her yere yapıştırın: eski anahtar hemen çalışmayı durdurur.

.gitignore
.env
.env.local
.env.*.local

6Manuel yakalama ve giriş denemeleri

Giriş denemeleri gizli anahtar gerektirir: sunucuda genel anahtar yerine gizli anahtarla başlatın, aksi halde alım bunları 403 security_needs_secret_key ile reddeder. Scale planı.

ruby
Blipit.capture_exception(e)
Blipit.capture_message("cache miss rate above 50%", level: :warning)
Blipit.set_user(id: "42", email: "ana@example.com")
Blipit.capture_security("login_failed", email, outcome: "bad_password", ip: request.remote_ip, user_agent: request.user_agent)

7Çalıştığını kontrol edin

app.blipit.io içinde Sorunlar'ı açın. İlk olay birkaç saniye içinde bir sorun altında gruplanmış olarak görünür ve sorumlu kişilere e-posta gider.

ruby
Blipit.capture_message("Hello from Rails")

Bilmekte fayda var

  • init'e traces_sample_rate: 0.2 geçirin; istekler, işler, Net::HTTP çağrıları ve SQL sorguları Pulse sayfasında görünür.
  • 0.2'den yükseltme: project: artık gerekmez (hâlâ kabul edilir), Blipit.dsn kaldırıldı ve before_send artık olayı Blipit'in biçiminde bir Hash olarak alır.
  • Blipit'i güncel tutmak: Blipit'i güncel tutmak rehberi (docs.blipit.io/updates) güncelleme afişini, önemli sürümler için e-postaları, geliştirme konsolunuzdaki bildirimi ve bu platformun güncelleme komutunu açıklar.
  • Her uygulama ve platform için bir proje: her proje oluşturulurken platformunu seçer (Android, iOS, React Native, Flutter, Web, Backend veya Odoo) ve Blipit başka bir platformdan gelen verileri açık bir hatayla reddeder. Yani bir iOS uygulaması ile bir Android uygulaması için iki anahtarlı iki proje gerekir. Sürümler, versiyonlar, çökme oranları ve mağaza derlemeleri her platformda farklıdır; bunları tek projede karıştırmak hepsini yanlış yapar. Web projesi aynı web uygulamasının sunucu tarafını da kabul eder (Next.js sunucusu veya Node), React Native veya Flutter projesi de kendi yerel Android ve iOS çökme raporlarını kabul eder.

Takıldınız mı? support@blipit.io adresine e-posta gönderin. Her projenin anahtarları ve proje id'si app.blipit.io içindeki API anahtarları altındadır.