Platforma göre kurulum
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.
1Kurulum
pip install blipit2Baş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.
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.
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.
BLIPIT_KEY=blipit_pk_your_public_keyimport 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.
.env
.env.local
.env.*.local6Manuel 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ı.
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.
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.

