التثبيت حسب المنصة
Node.js
التثبيت npm install @blipit/node
تلتقط @blipit/node الاستثناءات غير الملتقطة ورفض الـ promise غير المعالج تلقائيًا، وتضيف معالجات لـ Express وFastify، وترسل السجلات ومحاولات تسجيل الدخول بالمفتاح نفسه. استخدم المفتاح السري؛ فهو يبقى على الخادم.
1التثبيت
npm install @blipit/node2التهيئة أولًا
ضع هذا في ملف يعمل قبل تطبيقك، واستورده أولًا.
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",
});3Express أو Fastify
أضف المعالج بعد مساراتك لتصل الأخطاء المعالجة وغير المعالجة معًا إلى Blipit، مع طريقة الطلب وعنوانه ووكيل المستخدم.
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());4الالتقاط اليدوي والسجلات ومحاولات تسجيل الدخول
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();5تحقق من أنه يعمل
افتح المشكلات في app.blipit.io. يظهر الحدث الأول خلال بضع ثوانٍ، مجمّعًا في مشكلة، ويتلقى المسؤولون بريدًا إلكترونيًا.
Blipit.captureMessage("Hello from Node");من المفيد معرفته
- عند استثناء غير ملتقط، يفرغ SDK الأحداث المعلقة ثم يخرج بالرمز 1؛ يمكن تجاوز ذلك بـ onFatal.
- captureConsole: true يحوّل console.log وأخواته إلى أسطر سجلات تُرسل إلى صفحة السجلات.
- هل تستخدم @sentry/node بالفعل؟ يعمل دون تغيير مع DSN بقيمة https://<public key>@in.blipit.io/<project id>.
هل واجهتك مشكلة؟ راسل support@blipit.io. المفاتيح وDSN الدقيق لكل مشروع موجودة تحت مفاتيح API في app.blipit.io.

