Python

Kurulum pip install blipit

blipit paketini (0.3.0 veya daha yenisi) kurun ve projenizin public key'i ile init'i bir kez çağırın. Blipit'in kendi çekirdeği üzerinde çalışır ve standart kütüphaneden başka hiçbir şeye ihtiyaç duymaz. İşlenmemiş istisnalar kendiliğinden raporlanır; Django, Flask, FastAPI, Starlette, Celery, logging, HTTP çağrıları ve SQLAlchemy otomatik olarak algılanır.

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

1Kurulum

sh
pip install blipit

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

Django için settings.py dosyasının en üstüne koyun. Flask ya da FastAPI için uygulama oluşturulmadan önce. Anahtar, projenin Anahtarlar sayfasındadır. Anahtar boşsa init hata fırlatmak yerine bir uyarı loglar ve False döndürür; böylece eksik bir anahtar uygulamanın başlamasını asla engellemez.

python
import blipit

blipit.init(
    key="<public key>",
    environment="production",
    release="myapp@1.4.2",
)

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ı ortam değişkenlerinde tutun

Bu SDK, projenin API anahtarları sayfasındaki public key ile gönderir. Onu bir ortam değişkeninde tutun: yerelde framework'ünüzün ya da python-dotenv'in yüklediği bir .env dosyasında, production'da barındırma ortamınızın ayarlarında. Secret key'i yalnızca giriş denemeleri gönderiyorsanız kullanın.

.env
BLIPIT_KEY=blipit_pk_your_public_key
python
import os
import blipit

blipit.init(key=os.environ.get("BLIPIT_KEY"))

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ı.

python
blipit.capture_exception(err)
blipit.capture_message("cache miss rate above 50%", level="warning")
blipit.set_user({"id": "42", "email": "ana@example.com"})
blipit.set_context("order", {"id": 1042, "total": 99.5})
blipit.capture_security("login_failed", actor=email, ip=request.META.get("REMOTE_ADDR"), outcome="bad_password")

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.

python
blipit.capture_message("Hello from Python")

Bilmekte fayda var

  • Odoo: bunu kullanmayın; bunun yerine Odoo Apps mağazasından Blipit modülünü kurun. Odoo'nun isteğini, kullanıcısını ve şirketini tanır.
  • init'e traces_sample_rate=0.2 geçirin; istekler, Celery görevleri, giden 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 dict 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.