.NET

Kurulum dotnet add package Blipit

Blipit paketini (0.2.0 veya daha yenisi) ekleyin ve başlangıçta projenizin public key'i ve proje id'si ile Init'i bir kez çağırın. Blipit'in kendi çekirdeği üzerinde çalışır. İşlenmemiş istisnalar ve kimsenin beklemediği hatalı görevler kendiliğinden raporlanır; ASP.NET Core için ek paket gerekmez.

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
dotnet add package Blipit

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

Döndürülen handle'ı süreç boyunca canlı tutun. Her iki değer de projenin Anahtarlar sayfasındadır.

Program.cs
using Blipit;

using var blipit = Blipit.Blipit.Init(new BlipitOptions
{
    Key = "<public key>",
    Project = "<project id>",
    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ı yapılandırmada tutun

Bu SDK public key ve proje id'si ile gönderir. Geliştirme sırasında bunları user secrets içinde, production'da ortam değişkenlerinde (Blipit__Key ve Blipit__Project) tutun, ardından yapılandırmadan okuyun.

sh
dotnet user-secrets set "Blipit:Key" "blipit_pk_your_public_key"
dotnet user-secrets set "Blipit:Project" "12"
Program.cs
using var blipit = Blipit.Blipit.Init(new BlipitOptions
{
    Key = builder.Configuration["Blipit:Key"],
    Project = builder.Configuration["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.

.gitignore
.env
.env.local
.env.*.local

6ASP.NET Core ve loglama

Eklenecek başka bir şey yok: Program.cs'nin en üstünde Init'i çağırın. Endpoint'lerden, controller'lardan ve middleware'den gelen istisnalar, UseExceptionHandler onları işlese bile istekle birlikte raporlanır; TracesSampleRate ayarlıyken örneklenen her istek rotasına göre Pulse'ta ölçülür. BlipitLoggerProvider, Information ve üstünü breadcrumb'a, Error ve üstünü olaya dönüştürür.

Program.cs
var builder = WebApplication.CreateBuilder(args);
using var blipit = Blipit.Blipit.Init(new BlipitOptions
{
    Key = builder.Configuration["Blipit:Key"],
    Project = builder.Configuration["Blipit:Project"],
    TracesSampleRate = 0.2,
});
builder.Logging.AddProvider(new BlipitLoggerProvider());

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

csharp
Blipit.Blipit.CaptureException(ex);
Blipit.Blipit.CaptureMessage("cache miss rate above 50%", BlipitLevel.Warning);
Blipit.Blipit.SetUser(id: "42", email: "ana@example.com");
Blipit.Blipit.CaptureSecurity("login_failed", email, "bad_password", null, ip, userAgent, null);

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.

csharp
Blipit.Blipit.CaptureMessage("Hello from .NET");

Bilmekte fayda var

  • netstandard2.0 ve net8.0'ı hedefler.
  • Seçeneklerde TracesSampleRate = 0.2 istekleri Pulse sayfasına gönderir; await Blipit.Blipit.Trace("charge card", () => gateway.ChargeAsync(order)) bir isteğin içine süresi ölçülen bir adım ekler.
  • 0.1'den yükseltme: 0.1'in gerektirdiği ek ASP.NET Core paketini ve builder.WebHost satırını kaldırın, çünkü Init ASP.NET Core'u kapsar. Blipit.Dsn, Blipit.Apply, BlipitOptions.Configure ve PackageName kaldırıldı, CaptureMessage ve AddBreadcrumb BlipitLevel alır ve capture çağrıları olay id'sini string olarak 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.