‎.NET‎

التثبيت dotnet add package Blipit

أضف حزمة Blipit (الإصدار 0.2.0 أو أحدث) واستدعِ Init مرة واحدة عند البدء بالمفتاح العام ومعرّف المشروع الخاصين بمشروعك. تعمل على نواة Blipit الخاصة. يُبلّغ عن الاستثناءات غير المعالجة والمهام الفاشلة التي لم ينتظرها أحد تلقائيًا، ولا يحتاج ASP.NET Core إلى أي حزمة إضافية.

الصقها في Claude Code أو Cursor أو أي مساعد برمجة بالذكاء الاصطناعي. تحتوي على الخطوات والشيفرة. في app.blipit.io ضمن مفاتيح API تجد التعليمات نفسها مع مفتاحك مكتوباً فيها.
فيديو: ثبّت Blipit في أي تقنية، من 1:07

1التثبيت

sh
dotnet add package Blipit

2التهيئة عند بدء التشغيل

أبقِ المقبض المُعاد حيًّا طوال عمر العملية. القيمتان موجودتان في صفحة مفاتيح المشروع.

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",
});

3احصل على مفاتيحك

سجّل الدخول في app.blipit.io وافتح «مفاتيح API» في الشريط الجانبي، ثم مشروعك. لكل مشروع مفتاحان. يبدأ المفتاح العام بـ blipit_pk_: يوضع في كود المتصفح والتطبيقات، ولا يستطيع سوى إرسال الأحداث، ومن الآمن أن يراه أي شخص. يبدأ المفتاح السري بـ blipit_sk_: يبقى على خادمك أو في Odoo، وليس في متصفح أبدًا، لأنه يستطيع أيضًا قراءة المشكلات وتغييرها. يُعرض المفتاح السري مرة واحدة فقط، فور إنشائه، لذا انسخه حينها؛ وإذا فقدته، فاضغط «إنشاء مفتاح سري جديد»، فيتوقف القديم عن العمل فورًا. تحتاج بعض حزم SDK أيضًا إلى معرّف المشروع، المعروض في الصفحة نفسها.

مفاتيح API في app.blipit.io: المفتاح العام (blipit_pk_) لكود المتصفح، والمفتاح السري (blipit_sk_) للخوادم وOdoo.
مفاتيح API في app.blipit.io: المفتاح العام (blipit_pk_) لكود المتصفح، والمفتاح السري (blipit_sk_) للخوادم وOdoo.
يُعرض المفتاح السري الجديد مرة واحدة. انسخه الآن: يُخزّن مجزّأً (hashed) ولا يمكن عرضه مرة أخرى.
يُعرض المفتاح السري الجديد مرة واحدة. انسخه الآن: يُخزّن مجزّأً (hashed) ولا يمكن عرضه مرة أخرى.

4احتفظ بالمفتاح في ملفات الإعداد

ترسل هذه SDK باستخدام المفتاح العام ومعرّف المشروع. احتفظ بهما في user secrets أثناء التطوير وفي متغيرات البيئة في الإنتاج (Blipit__Key وBlipit__Project)، ثم اقرأهما من configuration.

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"],
});

5أبقِ المفاتيح خارج git

احتفظ بالمفاتيح في متغيرات البيئة أو في الإعدادات السرية لمنصة الاستضافة، وليس أبدًا في كود تودعه في المستودع، وأضف ملفات .env إلى .gitignore. وجود مفتاح عام في صفحة ويب أمر طبيعي. إذا انتهى مفتاح سري يومًا في git أو صفحة عامة أو لقطة شاشة أو محادثة، فافتح «مفاتيح API»، واضغط «إنشاء مفتاح سري جديد»، والصق المفتاح الجديد في كل مكان كان يُستخدم فيه القديم: يتوقف المفتاح القديم عن العمل فورًا.

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

6ASP.NET Core والسجلات

لا شيء آخر لإضافته: استدعِ Init في أعلى Program.cs. يُبلّغ عن الاستثناءات الصادرة من نقاط النهاية ووحدات التحكم والوسائط مع الطلب، حتى عندما يعالجها UseExceptionHandler، ومع ضبط TracesSampleRate يُقاس زمن كل طلب مأخوذ في العينة في Pulse حسب مساره. يحوّل BlipitLoggerProvider مستوى Information وما فوقه إلى مسارات تنقل (breadcrumbs) ومستوى Error وما فوقه إلى أحداث.

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());

7الالتقاط اليدوي ومحاولات تسجيل الدخول

تتطلب محاولات تسجيل الدخول المفتاح السري: على الخادم، ابدأ التهيئة بالمفتاح السري بدلاً من المفتاح العام، وإلا فسترفضها خدمة الاستقبال بالرمز 403 security_needs_secret_key. خطة Scale.

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تحقق من أنه يعمل

افتح المشكلات في app.blipit.io. يظهر الحدث الأول خلال بضع ثوانٍ، مجمّعًا في مشكلة، ويتلقى المسؤولون بريدًا إلكترونيًا.

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

من المفيد معرفته

  • يستهدف netstandard2.0 وnet8.0.
  • يرسل TracesSampleRate = 0.2 في الخيارات الطلبات إلى صفحة Pulse؛ ويضيف await Blipit.Blipit.Trace("charge card", () => gateway.ChargeAsync(order)) خطوة مقيسة الزمن داخل الطلب.
  • الترقية من 0.1: أزِل حزمة ASP.NET Core الإضافية وسطر builder.WebHost اللذين احتاجهما 0.1، لأن Init يغطي ASP.NET Core. أُزيلت Blipit.Dsn وBlipit.Apply وBlipitOptions.Configure وPackageName، وتأخذ CaptureMessage وAddBreadcrumb قيمة BlipitLevel، وتعيد دوال الالتقاط معرّف الحدث كسلسلة نصية.
  • إبقاء Blipit محدّثًا: يشرح دليل إبقاء Blipit محدّثًا (docs.blipit.io/updates) لافتة التحديث، ورسائل البريد للإصدارات المهمة، والتنبيه في وحدة تحكم التطوير، وأمر التحديث لهذه المنصة.
  • مشروع واحد لكل تطبيق ومنصة: يختار كل مشروع منصته عند إنشائه (Android أو iOS أو React Native أو Flutter أو Web أو Backend أو Odoo)، ويرفض Blipit البيانات القادمة من أي منصة أخرى مع رسالة خطأ واضحة، لذلك يحتاج تطبيق iOS وتطبيق Android إلى مشروعين بمفتاحين. الإصدارات والنسخ ومعدلات الأعطال وإصدارات المتاجر تختلف من منصة لأخرى، وخلطها في مشروع واحد يجعلها كلها خاطئة. يقبل مشروع Web أيضًا جانب الخادم من تطبيق الويب نفسه (خادم Next.js أو Node)، ويقبل مشروع React Native أو Flutter أيضًا تقارير الأعطال الأصلية الخاصة به على Android وiOS.

هل واجهتك مشكلة؟ راسل support@blipit.io. المفاتيح ومعرّف كل مشروع موجودة تحت مفاتيح API في app.blipit.io.