Error Inspector في Dynatrace ورموز الأخطاء: ما الذي يعدّه Dynatrace خطأً فعلًا

Error Inspector في Dynatrace يحلل أخطاء الواجهة الأمامية؛ أما رموز HTTP للخدمات وRUM فتُضبط في مكان آخر. الافتراضيات والرموز 970-979 والإعدادات.
Error Inspector Dynatrace et codes d'erreur : ce que Dynatrace compte vraiment comme une erreur

غالبًا ما يُذكر Error Inspector في Dynatrace بوصفه «أداة الأخطاء»، لكنه لا يغطي إلا جزءًا من الموضوع. بحسب الوثائق هو تطبيق في منصة Dynatrace (SaaS، الجيل الأحدث) يُستخدم لاكتشاف أخطاء الواجهة الأمامية (front-end) في تطبيقات الويب والجوال وتتبعها وتحليلها. أما الأخطاء من جهة الخدمات (HTTP 5xx والاستثناءات) فتتبع آلية أخرى: كشف إخفاق الخدمات (failure detection).

الخلط بين الاثنين يقود إلى نقاشات لا تنتهي أثناء الحادثة: «يقول Dynatrace إن الإخفاق 2%، والمتصفح يرى 8%». قد يكون الرقمان صحيحين لأنهما لا يعدّان الشيء نفسه. وفهم أي رموز أخطاء تُحتسب، ومن أي جهة، وبأي إعداد، شرط لبناء SLI للتوافر يصمد.

يوضح هذا الدليل ثلاث طبقات: كشف إخفاق الخدمات (Managed وSaaS)، وأخطاء الطلبات في RUM Classic مع رموزه الخاصة 970–979 (Managed وSaaS)، وتطبيق Error Inspector (SaaS فقط).

Error Inspector في Dynatrace: ما الذي يفعله التطبيق فعلًا

Error Inspector تطبيق في المنصة يتطلب تفعيل RUM للواجهات الأمامية للويب والجوال. وله صفحتان:

  • Overview: عدد الأخطاء عبر الزمن، مقسَّمًا بحسب الواجهة الأمامية (أول 10) أو بحسب نوع الخطأ (خطأ طلب، استثناء، خطأ CSP)، ثم توزيعات بحسب error.type وos.name وurl.provider (طرف أول أو ثالث) وbrowser.name وdt.rum.user_type (real_user وrobot وsynthetic) للويب، وapp.short_version للجوال. يُفتح كل رسم في Notebook (Edit in Notebook)، أو يُثبَّت على لوحة معلومات، أو يصدّر استعلام DQL الخاص به (Open With).
  • Explorer: الأخطاء مجمَّعة عبر كل الواجهات الأمامية ومرتبة بعدد المستخدمين المتأثرين. تُحفظ المرشحات في الـ URL، مما يتيح مشاركة التحليل مع زميل مخوَّل.

في تفصيل الخطأ تجد مكدس الاستدعاءات (stack trace، ولا يُقرأ إلا إذا أُرسلت source maps أو ملفات الرموز عبر API أو الواجهة الكلاسيكية)، والجدول Affected pages، والجدول Occurrences الذي يفتح الجلسة في Users & Sessions وكذلك التتبعات في Distributed Tracing إن وُجدت. ويرسل الزر Send ملخصًا منظَّمًا إلى Jira أو Microsoft Teams أو بالبريد الإلكتروني عبر موصّلات Workflows.

ما ليس عليه Error Inspector: ليس أداة لتحليل أخطاء الخدمات الخلفية (back-end)، وليس ميزة في Dynatrace Managed.

من جهة الخدمات: أي رموز HTTP تُعدّ أخطاء؟

افتراضيًا، يحتسب كشف إخفاق الخدمات ما يلي:

  • الاستثناءات (Java و.NET وNode.js وPHP) التي تقطع استدعاء الخدمة؛
  • صفحات أخطاء حاويات الويب للاستثناءات المعالَجة؛
  • الرموز 500–599 أخطاءً من جهة الخادم؛
  • الرموز 400–599 أخطاءً من جهة العميل.

لماذا تتضمن جهة العميل الرموز 5xx؟ مسألة منظور: بالنسبة إلى الخادم فإن 4xx خطأ من العميل؛ وبالنسبة إلى العميل فإن 5xx يظل خطأً حتى لو لم يكن هو المخطئ. وثمة حالتان خاصتان معطَّلتان افتراضيًا: غياب رمز الاستجابة (استدعاء «fire and forget» أو انتهاء المهلة)، والرمز 404 المصنَّف رابطًا مكسورًا من جهة العميل.

تغذي هذه القواعد المقاييس التي تستخدمها في SLO والتنبيهات. في Managed مثلًا: builtin:service.errors.server.rate وbuiltin:service.errors.client.rate وbuiltin:service.errors.fivexx.count وbuiltin:service.errors.fourxx.count. فتغيير الكشف يعني تغيير قيمة مؤشرات SLI لديك: افعله عن علم.

عمليًا: ضبط كشف الإخفاق

الخطوة 1: اختر المستوى

يتم الإعداد عامًّا (Settings > Server-side service monitoring > Failure detection rules وFailure detection parameters) أو لكل خدمة. وتتقدم إعدادات الخدمة على الإعداد العام. تُقيَّم القواعد العامة من الأعلى إلى الأسفل، وتنطبق أول قاعدة مطابقة، ويُعاد حساب المطابقة كل 10 دقائق. ولا تنطبق على خدمات من نوع span ولا على unified services.

الخطوة 2: اضبط خدمة

  1. افتح Services، واختر الخدمة، ثم More (…) > Settings.
  2. انتقل إلى Failure detection > HTTP parameters (أو General parameters للاستثناءات).
  3. فعّل Override global failure detection settings، ثم عدّل نطاقات الرموز (عدة نطاقات تفصلها فواصل، مثل 400-402, 405-417)، ومعالجة الرموز الغائبة، والخيار Consider 404 HTTP response codes as failures.
شاشة HTTP failure detection parameters لخدمة في Dynatrace: تجاوز الإعدادات العامة، والرموز 500-599 من جهة الخادم و400-599 من جهة العميل، ومعالجة الرموز الغائبة، والخيار المتعلق باعتبار 404 إخفاقًا
Source : docs.dynatrace.com

الخطوة 3: عالج استثناءات العمل

في General parameters: تجعل Success forcing exceptions الطلب ناجحًا مهما حدث (عميل يتخلى عن الطلب)، وتتيح Ignored exceptions ألّا يُعلَّم الإخفاق بل يقرر رمز HTTP، وتفرض Custom handled exceptions إخفاق استثناء يعالجه الكود بصمت. أما لخطأ في العمل بلا استثناء ولا رمز HTTP، فتعتمد custom error rule على request attribute.

الخطوة 4: الإصدار عبر Settings API

مخططان: builtin:failure-detection.environment.parameters (مجموعات المعاملات) وbuiltin:failure-detection.environment.rules (قواعد تسندها إلى الخدمات)، بالنطاقين settings.read وsettings.write. مقتطف من مجموعة معاملات:

[{
  "schemaId": "builtin:failure-detection.environment.parameters",
  "scope": "environment",
  "value": {
    "name": "API publique",
    "httpResponseCodes": {
      "serverSideErrors": "500-599",
      "failOnMissingResponseCodeServerSide": false,
      "clientSideErrors": "401-402,405-499",
      "failOnMissingResponseCodeClientSide": false
    },
    "brokenLinks": { "http404NotFoundFailures": false },
    ...
  }
}]

يتضمن المتن الكامل أيضًا كتلة exceptionRules؛ انطلق من مثال الوثائق وجدول المخطط بدل كتابة الكائن يدويًا.

من جهة المتصفح: أخطاء الطلبات والرموز 970–979 في RUM Classic

في RUM Classic (Managed، وSaaS للتطبيقات الكلاسيكية) توجد ثلاثة أنواع من الأخطاء: أخطاء الطلبات، وأخطاء مخصصة (custom) ترسلها JavaScript API الخاصة بـ RUM، وأخطاء JavaScript. افتراضيًا تُعدّ كل رموز 4xx و5xx أخطاء طلبات، وكذلك انتهاكات CSP وإخفاقات تحميل الصور. وهذا أحد أسباب الفوارق مع مقاييس الخدمات التي لا تحتسب إلا 5xx من جهة الخادم.

في التطبيقات المنشأة ابتداءً من الإصدار 1.238، تبلّغ JavaScript الخاصة بـ RUM أيضًا عن رموز ليست رموز HTTP حين يتعذر الوصول إلى الرمز الحقيقي:

جدول رموز الحالة المخصصة في JavaScript الخاصة بـ RUM Classic: 970 Error و971 Canceled و972 Timeout و973 Parse و974 Setup و979 Unknown مع شرح كل منها

تُحتسب هذه الرموز في Apdex لكن لا في تحليل Davis. الرمز 971 على استدعاء تتبع إعلاني مُلغى لا أثر له؛ أما 972 على الدفع فله أثر. لتجاهلها، عطّل القاعدة HTTP 970-979 أو احذفها. أما فيما عدا ذلك فتقرر request error rule (Web > التطبيق > More (…) > Edit > Errors > Request errors) لرمز أو نطاق، ويمكن حصرها في URLs معينة، هل يُلتقط الخطأ، وهل يدخل في Apdex، وهل يُرفع إلى Davis. تُطبَّق القواعد بحسب ترتيب القائمة.

أفضل الممارسات

  • ابنِ SLI التوافر لخدمة على الأخطاء من جهة الخادم؛ واحتفظ بجهة العميل وRUM لتجربة المستخدم.
  • لا تحوّل 404 إلى إخفاق على المستوى العام: خصّص ذلك للخدمات التي يشير فيها 404 فعلًا إلى عيب.
  • وثّق كل استثناء متجاهَل بسببه وتاريخه؛ فهو ضجيج أقل، لكنه أيضًا نقطة عمياء أكثر.
  • أرسل source maps مع كل نشر للواجهة الأمامية، وإلا عرض Error Inspector مكدسات غير مقروءة.

كيف تتحقق من أن كل شيء يعمل

  • بعد تغيير الكشف، يتطور معدل builtin:service.errors.server.rate للخدمة في Data Explorer ابتداءً من وقت التغيير (يُعاد حساب الإعداد العام كل 10 دقائق).
  • مع custom error rule، يُعلَّم الطلب المعني بالإخفاق ويذكر Dynatrace أن القاعدة هي السبب.
  • في SaaS، تعرض صفحة Overview في Error Inspector التوزيع بحسب error.type؛ افتح الرسم بـ Edit in Notebook لاسترجاع استعلام DQL الدقيق بدل إعادة كتابته.

لربط هذه الأخطاء بالمسارات، راجع مقاييس RUM وCore Web Vitals؛ وللصعود من إخفاق خدمة إلى سببه، Distributed traces في Managed؛ ولتحويلها إلى هدف، اختيار مؤشرات SLI. المراجع الرسمية: Error Inspector وConfigure service failure detection.

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

هل Error Inspector متاح في Dynatrace Managed؟

لا. إنه تطبيق في منصة Dynatrace SaaS من الجيل الأحدث. في Managed يُعتمد على كشف إخفاق الخدمات وعلى إعداد أخطاء RUM Classic.

لماذا يحتسب RUM أخطاء أكثر من مقاييس الخدمات؟

يحتسب RUM Classic افتراضيًا كل رموز 4xx و5xx وانتهاكات CSP والصور الفاشلة والرموز 970–979، بينما لا يحتفظ خطأ الخادم لخدمة إلا برموز 5xx والاستثناءات.

هل يعني الرمز 971 عطلًا؟

ليس بالضرورة. إنه رمز خاص بـ JavaScript الخاصة بـ RUM (طلب مُلغى) وليس رمز HTTP. ويتوقف أثره على الطلب: انظر إلى الـ URL المعني قبل التنبيه.

الخلاصة

يجيب Error Inspector عن سؤال محدد: أي أخطاء الواجهة الأمامية تمس أكبر عدد من المستخدمين ولماذا. أما رموز أخطاء الخدمات وRUM Classic فتُضبط في كشف الإخفاق وقواعد request error. وازِن بين هذه الطبقات الثلاث، ووثّق كل استثناء، وستقول مؤشرات SLI للتوافر لديك أخيرًا ما يقوله مستخدموك.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. تتطور التطبيقات والإعدادات والقيم الافتراضية بحسب الإصدار والمنصة (SaaS أو Managed): تحقق منها في الوثائق الرسمية.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Dynatrace Synthetic Recorder, emplacements privés et MFA : le monitoring synthétique avancé

Dynatrace Synthetic Recorder والمواقع الخاصة وMFA: المراقبة الاصطناعية المتقدمة

Next Post
Modes OneAgent : Full-Stack vs Infrastructure, Discovery et OneAgent pour AWS Lambda

modes OneAgent: Full-Stack وInfrastructure وDiscovery وOneAgent لـ AWS Lambda

Related Posts