Platforma göre kurulum
PHP ve Laravel
Kurulum composer require blipit/blipit
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 başka hiçbir paket çekmez. Yakalanmamış istisnalar, uyarılar ve ölümcül hatalar kendiliğinden raporlanır; Laravel ve Symfony desteği yerleşiktir.
1Kurulum
composer require blipit/blipit2Başlangıçta başlatın
Düz PHP: front controller'ınızın en üstünde, herhangi bir istek işlenmeden önce. Laravel, sonraki adımdaki gibi Blipit'i kendi config'inden başlatır. Anahtar, projenin Anahtarlar sayfasındadır. Anahtar boşsa init istisna fırlatmak yerine hata loguna bir uyarı yazar ve false döndürür.
use Blipit\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 public key ile gönderir. Laravel: onu .env dosyasına ve config/services.php'ye ekleyin; Blipit service provider'ı kendiliğinden bulunur ve Blipit'i bu config'den başlatır, başka bir şey gerekmez. Değerleri config üzerinden okuyun, çünkü config önbelleğe alındıktan sonra env() uygulama kodunda hiçbir şey döndürmez. Düz PHP: anahtarı sunucunun ortamından getenv() ile okuyun.
BLIPIT_KEY=blipit_pk_your_public_key'blipit' => [
'key' => env('BLIPIT_KEY'),
'environment' => env('APP_ENV'),
'release' => env('GIT_SHA'),
],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.*.local6Laravel ve Symfony
Laravel: handler'ının raporladığı her istisna Blipit'e ulaşır; böylece 404'ler ve doğrulama hataları dışarıda kalır. Sorgular, log satırları ve HTTP istemci çağrıları breadcrumb olur, kuyruğa alınan işler trace edilir. bootstrap/app.php'de zaten bulunan bir Blipit::captureException satırı kalabilir: aynı istisna asla iki kez gönderilmez. Symfony: listener'ı config/services.yaml içinde kaydedin ve Blipit::init'i public/index.php ile bin/console'da erkenden çağırın.
Blipit\Symfony\BlipitListener:
arguments: ['@router']
tags:
- { name: kernel.event_listener, event: kernel.exception, method: onKernelException }
- { name: kernel.event_listener, event: kernel.request, method: onKernelRequest }
- { name: kernel.event_listener, event: kernel.terminate, method: onKernelTerminate }
- { name: kernel.event_listener, event: console.error, method: onConsoleError }7Manuel 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::captureException($e);
Blipit::captureMessage("cache miss rate above 50%", "warning");
Blipit::setUser(["id" => "42", "email" => "ana@example.com"]);
Blipit::captureSecurity("login_failed", $email, "bad_password", null, $request->ip(), $request->userAgent());8Ç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::captureMessage("Hello from PHP");Bilmekte fayda var
- init içinde "traces_sample_rate" => 0.2 geçirin; istekler Pulse sayfasında görünür. Blipit::trace("import orders", fn () => $importer->run()), trace edilen bir istek ya da iş içindeki herhangi bir bloğun süresini ölçer.
- 0.2'den yükseltme: project artık gerekmez (hâlâ kabul edilir), Blipit::dsn() ve Blipit::notice() kaldırıldı ve before_send artık olayı Blipit'in biçiminde bir dizi olarak alır ve döndürü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.

