أدلة استكشاف أخطاء AllStak
حلول خطوة بخطوة لمشكلات إعداد AllStak الشائعة: عدم ظهور الأحداث، مفاتيح API، source maps، OpenTelemetry، تنبيهات Slack، اتصال الوكيل، والمزيد.
الأحداث لا تظهر في AllStak: شخّص المشكلة في دقائق
ثبّت الـ SDK لكن اللوحة فاضية، أو الأخطاء الجديدة توقفت عن الوصول. أغلب الحالات سببها واحد من الفحوصات الستة أدناه.
مفتاح API غير صالح: اعثر على المفتاح الخاطئ في دقائق
الـ SDK يرفض مفتاحك، أو الاستقبال يرجع أخطاء مصادقة، أو الأحداث تختفي بصمت. الحل غالبًا واحد من أربعة أخطاء في التعامل مع المفتاح.
خرائط المصدر لا تُحلّ: استرجع مسارات استدعاء مقروءة
أخطاء JavaScript عندك تعرض إطارات مصغّرة مثل a.js:1:48213 بدل ملفاتك الأصلية. في تسع حالات من عشر، سلاسل الإصدار غير متطابقة.
أحداث بلا مسارات استدعاء: استرجع الإطارات
تصل الأخطاء إلى AllStak كرسائل مجردة بلا إطارات تساعدك على التصحيح. والسبب غالبًا في طريقة رمي الخطأ أو التقاطه.
تتبّعات OpenTelemetry لا تظهر: افحص الـ exporter أولًا
خدماتك مجهّزة بـ OTel لكن AllStak لا تعرض أي spans. والمتهم المعتاد exporter يعمل بـ gRPC، أو نقطة نهاية خاطئة، أو إفراغ مفقود.
تنبيهات Slack لا تصل: تتبّع المسار في دقائق
الأخطاء تنطلق في AllStak لكن لا شيء يصل إلى قناة Slack. المسار له ثلاث حلقات بالضبط — الربط والقاعدة والقناة — وإحداها مكسورة.
قضايا Jira لا تُنشأ: أصلح الربط أولًا ثم الصلاحيات
إنشاء قضية Jira من خطأ AllStak يفشل، أو إغلاق قضية Jira لا يحل الخطأ المرتبط أبدًا. ولكلٍّ منهما قائمة فحص قصيرة ومحددة.
وكيل لينكس لا يتصل: شخّصه من على الخادم
ثبّت الوكيل لكن الخادم لا يظهر في الأسطول أبدًا — أو يظهر ثم يصمت فورًا. كل ما تحتاجه موجود في systemctl و journalctl.
خادم تجمّد في الأسطول: اكتشف السبب
الخادم موجود في عرض الأسطول لكن بياناته توقفت عن التحديث. ابدأ من طابع آخر ظهور — فهو يخبرك بأي فئة من الأعطال لديك.
أحداث تصل بلا إصدار: اربطه بشكل صحيح
تصل الأخطاء بلا وسم، أو كل نشر يعرض الإصدار نفسه. الـ SDK لا يوسم الأحداث إلا بالإصدار الذي تضبطه أنت — وهنا طريقة ضبطه الصحيحة.