الانتقال إلى المحتوى الرئيسي
يمكنك إرسال نوعين من بيانات Supabase إلى LogBrew:
  • يرسل تصريف السجلات (log drain) سجلات المنصة لمشروعك في Supabase، مثل سجلات Postgres وAuth وStorage وEdge Functions.
  • ترسل حزمة LogBrew JavaScript SDK السجلات والأخطاء التي تلتقطها شيفرة Edge Function الخاصة بك.
يمكنك استخدام أحدهما أو كليهما. يحتاج كلاهما إلى مفتاح استيعاب للمشروع. أنشئ مفتاح server لكل استخدام. أنواع المفاتيح موضّحة في أنواع مفاتيح المشروع.

أرسل سجلات المنصة عبر تصريف السجلات

يتوفر تصريف السجلات في خطط Pro وTeam وEnterprise من Supabase. وتحتسب Supabase رسومًا على كل تصريف تضيفه وعلى الأحداث التي يرسلها. اقرأ أسعار Supabase قبل أن تضيف تصريفًا.
1

افتح إعدادات تصريف السجلات

افتح مشروعك في لوحة تحكم Supabase. انتقل إلى Project Settings ثم إلى Log Drains.
2

أضف وجهة OpenTelemetry

أضف وجهة من النوع OpenTelemetry (OTLP). اضبط هذه القيم:يمكنك استخدام الترويسة Authorization بالقيمة Bearer lbw_ingest_... بدلًا من x-logbrew-key.
3

احفظ الوجهة

احفظ الوجهة. تبدأ Supabase بإرسال السجلات إلى LogBrew.نقطة تحقق: تظهر سجلات Supabase الجديدة في سجلات مشروعك في LogBrew. لقراءتها من CLI، اتبع اقرأ الحدث التجريبي.
يقرأ LogBrew بيانات التصريف على أنها سجلات OTLP. تحدّد سمة المورد service.name خدمة كل سجل. وتبقى سمات المورد الأخرى في البيانات الوصفية للسجل. ويزيل LogBrew بيانات الاعتماد من عناوين URL ومن سمات مثل authorization قبل تخزين السجل. التفاصيل الكاملة للمطابقة موضّحة في OpenTelemetry (OTLP). إذا لم تصل أي سجلات، فتحقّق من نقطة النهاية والبروتوكول والترويسة. يجب أن ينتمي مفتاح الاستيعاب إلى مشروع LogBrew الذي تقرأ منه.

التقط السجلات والأخطاء في Edge Functions

تعمل Supabase Edge Functions على Deno. استخدم @logbrew/node من npm. يعمل هذا الإعداد مع Deno 2.9 و@logbrew/node 0.1.20 و@logbrew/sdk 0.1.35.
1

احفظ مفتاح الاستيعاب كسرّ للدالة

استخدم Supabase CLI. استبدل القيمة النائبة بمفتاحك:
2

أنشئ العميل وفرّغ الأحداث قبل إعادة الاستجابة

أنشئ العميل مرة واحدة خارج معالج الطلبات. والتقط الأحداث داخل المعالج. استدعِ flush() قبل أن تعيد الاستجابة، لأن الدالة قد تتوقف بعد أن تعيدها.
بفضل captureRuntimeContext: false وسياق runtime، يعرض LogBrew بيئة التشغيل على أنها Deno. وبدونهما، يُبلغ الـ SDK عن إصدار Node.js الذي يحاكيه Deno.إذا فشل التسليم، يطرح flush() الخطأ SdkError، مثلًا بالرمز network_failure. يكتب المثال رمز الخطأ فقط في سجل الدالة، وتظل الدالة تعيد استجابتها.
3

انشر الدالة واستدعِها

انشر الدالة باستخدام supabase functions deploy checkout. ثم استدعِها مرة واحدة.نقطة تحقق: يظهر السجل checkout request في مشروعك في LogBrew.
لا تضع بيانات الاعتماد أو نصوص الطلبات أو بيانات العملاء في البيانات الوصفية للأحداث.