الأحداث لا تظهر

الأحداث لا تظهر في AllStak: شخّص المشكلة في دقائق

ثبّت الـ SDK لكن اللوحة فاضية، أو الأخطاء الجديدة توقفت عن الوصول. أغلب الحالات سببها واحد من الفحوصات الستة أدناه.

كيف تبدو المشكلة

هيّأت حزمة Sentry الرسمية باستخدام DSN من AllStak ونشرت وأطلقت خطأ تجريبيًا، لكن لا شيء يظهر. أو توقفت الأحداث بعد نشر أو تغيير DSN أو الشبكة. نفّذ الفحوصات أدناه قبل تغيير التجهيز.

وقد "تختفي" الأحداث وهي في الحقيقة وصلت — لكن تحت بيئة مختلفة عن البيئة المفلترة في لوحتك، أو كأحداث مُعالَجة بينما أنت تبحث عن الأعطال فقط. امشِ على الخطوات بالترتيب؛ كل خطوة تستبعد فئة كاملة من الأسباب.

الأسباب الجذرية الشائعة

DSN خاطئ أو غير محمّل

يشير DSN إلى مشروع آخر، أو يكون ALLSTAK_DSN فارغًا في العملية الجارية — وهذا شائع بعد عمليات نشر لا تنقل إعدادات التشغيل.

فلتر البيئة يخفي الأحداث

تصل الأحداث تحت قيمة البيئة التي أرسلها الـ SDK (مثل development)، بينما اللوحة مفلترة على production. البيانات موجودة — لكنك لا تنظر إليها.

تهيئة الـ SDK تتأخر أو لا تعمل أصلًا

إذا وقعت الأخطاء قبل أن يُهيَّأ الـ SDK — أو لم يُنفَّذ مسار التهيئة أصلًا في نسخ الإنتاج — فلا يوجد ما يلتقطها.

منافذ الشبكة أو حدود الخطة

جدار ناري أو بروكسي أو اعتراض TLS يمنع HTTPS إلى نقطة الاستقبال فيُسقط الأحداث بصمت. وبشكل منفصل، قد يُقيَّد الحجم العالي المستمر وفق حدود خطتك.

التشخيص خطوة بخطوة

نفّذ هذه الفحوصات بالترتيب — كل واحدة تستبعد السبب الأكثر شيوعًا قبل التي بعدها.

  1. 1

    تحقق من DSN الخاص بـ AllStak

    افتح المشروع المقصود في AllStak وانسخ DSN مرة أخرى. قارن المفتاح العام والمضيف ومعرف المشروع بالقيمة التي يحملها التطبيق.

  2. 2

    تأكد أن متغيّر البيئة محمّل وقت التشغيل

    سجل وجود ALLSTAK_DSN فقط عند البدء، ولا تسجل قيمته. وجود المتغير في .env محليًا وغيابه عن بيئة التشغيل المنشورة سبب شائع للوحة فارغة.

  3. 3

    افحص فلتر البيئة في اللوحة

    تظهر الأحداث تحت البيئة التي أرسلها الـ SDK (خيار environment في التهيئة أو الإعداد). بدّل فلتر البيئة في اللوحة إلى القيمة المضبوطة فعليًا في الـ SDK — بما فيها قيمة افتراضية مثل development إن لم تضبطها.

  4. 4

    تأكد أن التهيئة تسبق وقوع الأخطاء

    هيّئ حزمة Sentry الرسمية في أبكر نقطة يطلبها دليل بيئة التشغيل — مثلًا قبل تحميل التطبيق في Node.js، أو عبر instrumentation.ts في Next.js، أو قبل إنشاء تطبيق Python.

  5. 5

    اختبر منفذ الشبكة إلى نقطة الاستقبال

    من الجهاز الذي يشغّل تطبيقك، تأكد أن طلبات HTTPS إلى نقطة استقبال AllStak تنجح — فالبروكسيات المؤسسية وسياسات شبكات الحاويات وأجهزة اعتراض TLS كلها تُسقط حركة الـ SDK بصمت.

  6. 6

    افحص بوّابات الالتقاط وحدود الخطة

    يعتمد التقاط الاستثناءات غير المعالجة على تكامل بيئة التشغيل الرسمي؛ أما الأخطاء المعالجة فتحتاج واجهة captureException الصريحة. وإذا كان الحجم عاليًا جدًا فقد يُقيّد الاستقبال وفق حدود الخطة.

كيف تمنع تكرارها

  • وفّر DSN الخاص بـ AllStak عبر إعدادات التشغيل في كل بيئة — ولا تضمّنه في الشيفرة أبدًا.
  • اضبط environment صراحةً في تهيئة الـ SDK حتى لا تختلط بيئتا الاختبار والإنتاج أو تخفي إحداهما الأخرى.
  • هيّئ الـ SDK أولًا في ملف الدخول، قبل أي شيفرة قد ترمي خطأ.
  • بعد كل نشر، أطلق خطأ تجريبيًا واحدًا معروفًا وتأكد من وصوله قبل أن تكمل.
  • راقب استهلاك خطتك حتى لا يفاجئك التقييد أثناء حادثة.

ما زلت عالقًا؟

إذا أنهيت الخطوات الست وما زالت الأحداث لا تصل، تحقّق أولًا من صفحة حالة AllStak لاستبعاد مشكلة من جهة المنصّة، ثم راسلنا على [email protected] باسم مشروعك والـ SDK ونسخته والوقت التقريبي الذي توقعت فيه الأحداث — وسنتتبعها من جهة الاستقبال.

الأسئلة الشائعة

كم يستغرق ظهور الأحداث بعد إرسالها؟

تظهر الأحداث عادةً شبه لحظيًا — خلال ثوانٍ من إرسال الـ SDK لها. إذا كنت تنتظر دقائق، فشيء مما في هذا الدليل يحجبها؛ والأحداث لا تُجدوَل لتسليم متأخر من جهة اللوحة.

ليش أحداثي تظهر تحت بيئة غلط؟

تجمّع اللوحة الأحداث حسب قيمة البيئة التي أرسلها الـ SDK. إذا كان نشر الإنتاج ما زال يمرّر environment: 'development' (أو لا يضبطها أصلًا)، فستصل الأحداث هناك. صحّح خيار environment في التهيئة وأعد النشر.

هل تُلتقط الاستثناءات المُعالَجة تلقائيًا؟

لا. غير المُعالَجة تُلتقط تلقائيًا؛ أما المُعالَجة داخل try/catch فتحتاج نداء captureException صريحًا. إذا كنت ترى الأعطال فقط دون الأخطاء الملتقطة، فهذا هو السلوك المقصود — أضف التقاطًا يدويًا حيث تحتاجه.

هل تسبب حدود الخطة إسقاط الأحداث؟

الحجم المستمر فوق حدود خطتك قد يُقيَّد. إذا كانت الأحداث تصل طبيعيًا عند الحجم المنخفض وتختفي أثناء الذروات، راجع استهلاك خطتك في اللوحة.

استكشف المزيد

خلّ أحداثك تتدفق

ثبّت حزمة Sentry الرسمية وهيّئها باستخدام DSN الخاص بـ AllStak، ثم تحقق من خطأ تجريبي قبل التعميم.

ابدأ مجاناً عرض الأسعار