Platforma göre kurulum
Java ve Kotlin
Kurulum com.github.blipit-io:blipit-java
blipit-java kütüphanesi JitPack tarafından doğrudan GitHub'dan sunulur. Blipit'in kendi çekirdeği üzerinde çalışır, hiçbir bağımlılığı yoktur ve Java 8 veya daha yenisinde çalışır. Depoyu ve bağımlılığı ekleyin, ardından başlangıçta projenizin public key'i ve proje id'si ile Blipit.init'i bir kez çağırın.
1Depoyu ve bağımlılığı ekleyin
repositories {
mavenCentral()
maven("https://jitpack.io")
}
dependencies {
implementation("com.github.blipit-io:blipit-java:v0.2.2")
}<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>
<dependency>
<groupId>com.github.blipit-io</groupId>
<artifactId>blipit-java</artifactId>
<version>v0.2.2</version>
</dependency>2Başlangıçta başlatın
Spring Boot: main'in en üstünde, SpringApplication.run'dan önce ya da bir @Configuration sınıfının @PostConstruct metodunda. Herhangi bir thread'deki yakalanmamış istisnalar, uygulama durmadan önce diskteki bir kuyruğa yazılır ve ardından gönderilir; böylece ağ kapalı olsa bile çökme raporlanır, geride kalan her şey bir sonraki başlangıçta gönderilir.
import io.blipit.Blipit;
import io.blipit.BlipitOptions;
Blipit.init(BlipitOptions.builder()
.key("<public key>")
.project(<project id>)
.environment("production")
.release("myapp@1.4.2")
.build());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 ve proje id'si ile gönderir. Bunları ortam değişkenlerinden ya da Spring Boot'ta ortamdan doldurulan application.properties'ten okuyun.
blipit.key=${BLIPIT_KEY}
blipit.project=${BLIPIT_PROJECT}Blipit.init(BlipitOptions.builder()
.key(System.getenv("BLIPIT_KEY"))
.project(Long.parseLong(System.getenv("BLIPIT_PROJECT")))
.build());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.captureException(err);
Blipit.captureMessage("cache miss rate above 50%");
Blipit.captureMessage("disk almost full", Level.WARNING);
Blipit.setUser("42", "ana@example.com");
Blipit.addBreadcrumb("GET /api/cart 500", "http", Level.ERROR);
Blipit.captureSecurity("login_failed", email, "bad_password", null, ip, userAgent, null);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.captureMessage("Hello from Java");Bilmekte fayda var
- Kotlin aynı çağrıları kullanır.
- Java SDK'sı istekleri kendiliğinden ölçmez: Pulse sayfası için span'leri herhangi bir OpenTelemetry exporter'ından X-Blipit-Key başlığıyla https://in.blipit.io/v1/traces adresine gönderin (JSON protokolü).
- v0.1'den yükseltme: level enum'u io.blipit.Level oldu, setUser(User) yerini setUser(id, email) ya da setUser(id, email, username)'e, addBreadcrumb(Breadcrumb) yerini addBreadcrumb(message, category, level)'a bıraktı, Blipit.dsn kaldırıldı, captureException ve captureMessage olay id'sini döndürür ve flush her şeyin teslim edilip edilmediğini 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.

