Platforma göre kurulum
Node.js
Kurulum npm install @blipit/node
@blipit/node yakalanmamış istisnaları ve işlenmemiş promise redlerini kendiliğinden yakalar, Express ve Fastify için handler ekler ve aynı anahtarla log ve giriş denemelerini gönderir. Secret key'i kullanın; sunucuda kalır. 0.3'ten itibaren Koa, Hono ve NestJS için tek satırlık kurulum ve AWS Lambda tarzı handler'lar için bir sarmalayıcı da sunar.
1Kurulum
npm install @blipit/node2Anahtarları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.
3Anahtarı ortam değişkenlerinde tutun
Node secret key'i kullanır. Onu kodda değil, bir ortam değişkeninde tutun: yerelde Node 20.6 ve sonrasının --env-file ile yüklediği bir .env dosyasında, production'da barındırma ortamınızın ortam değişkenlerinde ya da gizli ayarlarında (Fly secrets, Docker, systemd, Render, Vercel). Değiştirdikten sonra süreci yeniden başlatın.
BLIPIT_SECRET_KEY=blipit_sk_your_secret_keynode --env-file=.env --import ./instrument.mjs server.mjs4Anahtarları 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.*.local5Önce başlatın
Bunu uygulamanızdan önce çalışan bir dosyaya koyun ve ilk olarak import edin.
import * as Blipit from "@blipit/node";
Blipit.init({
key: process.env.BLIPIT_SECRET_KEY,
environment: process.env.NODE_ENV,
release: process.env.RELEASE,
serverName: "api",
});6Express, Fastify, Koa, Hono veya NestJS
Handler'ı route'larınızdan sonra ekleyin; böylece işlenmiş ve işlenmemiş hatalar isteğin metodu, URL'si ve user agent'ı ile Blipit'e ulaşır. Koa, Hono ve NestJS birer satır ister: Koa'nın middleware'i en başa, Hono'nunki rotalardan önce gelir. Durumu 500 ve üzeri olan hataları bildirirler. İstekler bundan sonra Pulse sayfasında her URL için ayrı satır yerine GET /users/:id gibi rotaya göre görünür.
import "./instrument.mjs";
import * as Blipit from "@blipit/node";
import express from "express";
const app = express();
app.get("/", (req, res) => res.send("ok"));
app.use(Blipit.expressErrorHandler());
app.listen(3000);await app.register(Blipit.fastifyPlugin());app.use(Blipit.koaMiddleware());app.use(Blipit.honoMiddleware());app.useGlobalInterceptors(Blipit.nestInterceptor());7Sunucusuz: AWS Lambda ve Vercel
Sunucusuz ortamlar fonksiyonu yanıt verir vermez duraklatır ve Lambda, Node'un HTTP sunucusunu çalıştırmaz; bu yüzden handler'ı sarmalayın. wrapHandler isteği kaydeder (API Gateway, fonksiyon URL'si ve yük dengeleyici olaylarını yöntem ve rotaya göre, diğer olayları fonksiyon adına göre), hataları bildirir ve handler dönmeden önce her şeyi gönderir; yalnızca gönderilecek bir şey olduğunda, en fazla 2 saniye bekler. traceRequest, Request alan her handler için aynısını yapar. Vercel'de veriler yanıttan sonra waitUntil ile gider, böylece hiçbir şey gecikmez. Next.js'te withBlipit kullanın (Next.js rehberine bakın).
import * as Blipit from "@blipit/node";
export const handler = Blipit.wrapHandler(async (event, context) => {
return { statusCode: 200, body: "ok" };
});export default { fetch: (request) => Blipit.traceRequest(request, () => app.fetch(request)) };8Manuel yakalama, loglar ve giriş denemeleri
Blipit.captureException(err);
Blipit.captureMessage("cache miss rate above 50%", "warning");
Blipit.setUser({ id: "user-42" });
Blipit.log.info("order placed", { order_id: 42 });
Blipit.captureSecurity({ kind: "login_failed", actor: email, ip, userAgent, outcome: "bad_password" });
await Blipit.flush();9Bağımlılıklar ve sunucu sağlığı
0.2'den itibaren SDK veritabanı ve dış hizmet çağrılarınızı, ayrıca sunucunuzun CPU, bellek ve olay döngüsünü de kaydeder. Bağımlılıklar ve Sunucu sağlığı rehberlerine bakın; tracesSampleRate, tracing: false ve metrics: false ile kontrol edilir.
10Ç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 Node");Bilmekte fayda var
- Yakalanmamış bir istisnada SDK bekleyen olayları gönderir, ardından 1 koduyla çıkar; onFatal ile geçersiz kılın.
- captureConsole: true, console.log ve benzerlerini Loglar sayfasına gönderilen log satırlarına dönüştürür.
- Kurulu sürümü npm ls @blipit/node (veya pnpm list @blipit/node) ile kontrol edin. pnpm 11 yeni bir sürümü kurmadan önce bir gün bekler (minimum-release-age), bu yüzden yayın günü pnpm add hiçbir uyarı vermeden önceki sürümü kurar; yenisini hemen almak için pnpm add @blipit/node@<version> --config.minimum-release-age=0 komutunu çalıştırın.
- 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.

