Platforma göre kurulum
Go
Kurulum go get github.com/blipit-io/blipit-go
blipit-go modülünü (v0.3.0 veya daha yenisi) ekleyin ve main içinde projenizin public key'i ve proje id'si ile Init'i bir kez çağırın. Blipit'in kendi çekirdeği üzerinde çalışır ve yalnızca Go standart kütüphanesini kullanır. Son olayların kaybolmaması için süreç çıkmadan önce Flush çağırın.
1Kurulum
go get github.com/blipit-io/blipit-go2main içinde başlatın
Init asla panic etmez: anahtar ya da proje id'si boşsa bir hata döndürür ve Blipit kapalı kalır; bu yüzden çıkmak yerine hatayı loglayın.
import (
"log"
"time"
"github.com/blipit-io/blipit-go"
)
func main() {
if err := blipit.Init(blipit.Options{
Key: "<public key>",
Project: "<project id>",
Environment: "production",
Release: "myapp@1.4.2",
}); err != nil {
log.Printf("blipit: %v", err)
}
defer blipit.Flush(2 * time.Second)
}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ı barındırma ortamınızın, bir systemd unit'inin ya da docker run -e'nin ayarladığı ortam değişkenlerinden okuyun.
blipit.Init(blipit.Options{
Key: os.Getenv("BLIPIT_KEY"),
Project: os.Getenv("BLIPIT_PROJECT"),
})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.SetUser(blipit.User{ID: "42", Email: "ana@example.com"})
blipit.CaptureSecurity(blipit.Security{Kind: "login_failed", Actor: email, IP: ip, UserAgent: agent, Outcome: "bad_password"})7Panic'ler ve net/http
main'in ya da herhangi bir goroutine'in en üstündeki defer blipit.Recover(), bir panic'i stack'iyle birlikte raporlar, flush eder ve yeniden panic eder. Panic'leri istekle birlikte raporlamak ve her isteğin süresini ServeMux kalıbıyla adlandırılmış olarak Pulse'ta ölçmek için sunduğunuz handler'ı blipit.Handler ile sarın. Gin, Echo ve Fiber, paketin README'sinde gösterildiği gibi StartRequest, SetRoute ve End kullanır.
go func() {
defer blipit.Recover()
work()
}()
mux := http.NewServeMux()
mux.HandleFunc("GET /items/{id}", item)
http.ListenAndServe(":8080", blipit.Handler(mux))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 Go")Bilmekte fayda var
- Options içinde TracesSampleRate: 0.2 istekleri Pulse sayfasına gönderir; blipit.Trace(ctx, name, fn) bir isteğin içine süresi ölçülen bir adım ekler.
- v0.2'den yükseltme: blipit.DSN kaldırıldı; User, Breadcrumb ve Level artık Blipit'in kendi türleridir (User, ID, Email ve Username'i korur; Breadcrumb, Category, Message, Level, Data ve Timestamp'i korur).
- 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.

