Live Debugger: تتبّع الأخطاء في الإنتاج دون إعادة نشر

Live Debugger: ضع نقاط توقف غير حاجزة في بيئة الإنتاج مع حدود وشروط وصلاحيات IAM ودون إعادة نشر. يعمل على Dynatrace SaaS فقط.
Live Debugger : déboguer la production sans redéployer

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

ينطلق المقال من قرار تشغيلي: هل يجوز السماح للمطورين بوضع نقاط توقف (breakpoints) في بيئة الإنتاج؟ الجواب يتوقف على الضوابط أكثر مما يتوقف على الأداة. المعلومات مأخوذة من وثائق Dynatrace SaaS التي قُرئت في 12 نوفمبر 2026 ومن إعلان الشركة المزوّدة. لم أجرّب هذه الميزة في بيئة حقيقية.

النطاق: تصف الوثائق بيئة Dynatrace SaaS باشتراك DPS. لم أجد أي صفحة مماثلة لـ Dynatrace Managed، لذلك لا أصف الميزة لتلك البيئة.

المشكلة: سجل إضافي يعني نشرًا إضافيًا

حين تنقص المعلومة، يكون أول ما يخطر في البال إضافة سجل. عندها تعدّل الشيفرة، وتمرّ بمسار CI، وتنشر، وتنتظر تكرار الخطأ، ثم تعيد الدورة إن لم يكفِ السجل. كل دورة تطيل زمن الإصلاح MTTR وتعرّض الإنتاج لتغيير جديد.

تقلب نقطة التوقف غير الحاجزة هذا الترتيب. تختار سطرًا، فيجمع الوكيل حالة التطبيق كلما نُفّذ ذلك السطر، وتبقى العملية تخدم الطلبات. والناتج لقطة (snapshot) تضم مكدس الاستدعاءات والمتغيرات المحلية ومعلومات عن العملية والتتبع.

ما تضمنه الوثائق وما لا تذكره

تحدد الصفحة الرسمية متطلبات دقيقة:

  • بيئة Dynatrace SaaS باشتراك DPS يشمل قدرة Code Monitoring؛
  • إصدار OneAgent 1.309 أو أحدث، مع تفعيل الميزتين «Java Live-Debugger» و/أو «Node.js Live-Debugger»؛
  • الأوضاع Full-Stack أو Infrastructure أو Discovery (مع حقن وحدة الشيفرة في الحاوية)؛
  • وحدتا الشيفرة Java وNode.js، وهما الوحيدتان المذكورتان.

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

تفعيل Live Debugger دون فتح كل شيء دفعة واحدة

يجري التفعيل على ثلاث طبقات، من الأوسع إلى الأدق.

  1. في Settings، ضمن Collect and capture ثم General monitoring settings ثم OneAgent features، فعّل Java Live-Debugger أو Node.js Live-Debugger أو كليهما، ثم أعد تشغيل العمليات المعنية.
  2. فعّل Observability for Developers. يمتد النطاق من البيئة كاملة إلى مجموعة عمليات أو عنقود Kubernetes أو namespace أو مجموعة مضيفين أو عملية نشر.
  3. خيار موصى به: فعّل وحدة التتبع في ActiveGate (الإصدار 1.311 أو أحدث). ليست إلزامية، لكنها تركّز حركة البيانات، خصوصًا على Kubernetes.

عند استخدام مشغّل Kubernetes، تُمنح قدرة التتبع لـ ActiveGate داخل DynaKube:

مقتطف من DynaKube.yaml تظهر فيه قدرة debugging ضمن activeGate.capabilities

نصيحتي التشغيلية: ابدأ بـ namespace في بيئة ما قبل الإنتاج أو بمجموعة عمليات واحدة، ولا تبدأ أبدًا بخيار «Enable for entire tenant». التوسيع لاحقًا يكلّف نقرة واحدة، أما التراجع بعد أزمة ثقة فيكلّف أكثر بكثير.

وضع نقطة توقف لا تُحدث ضررًا

في تطبيق Live Debugger تصفّي النسخ المستهدفة، ثم تحمّل الشيفرة المصدرية (محلية أو من مزوّد Git)، ثم تنقر في الهامش بجانب رقم السطر. تحدد ثلاثة إعدادات الأثر على الإنتاج.

الحدود الافتراضية

لكل نقطة توقف حد زمني (7 أيام افتراضيًا) وحد للقطات (100 افتراضيًا) ومستوى جمع (Medium افتراضيًا). عند بلوغ الحد تنتقل إلى حالة Disabled. وتعيد تفعيلها بالنقر الأيمن ثم Enable، فيبدأ العداد من الصفر.

مستوى الجمع

تحدد ثلاثة مستويات عمق الكائنات وطول النصوص وعدد العناصر المجموعة من كل قائمة. على JVM يبلغ Low العمق 2 (128 حرفًا و10 عناصر)، وMedium العمق 5 (512 و15)، وHigh العمق 8 (4096 و25). وعلى Node.js القيم هي 2/128/5 و3/512/10 و5/4096/20. ابدأ بـ Low، فلقطة خفيفة تجيب غالبًا عن السؤال.

الشروط

يحصر الشرط الجمع في الحالات التي تهمك، كعميل واحد أو مبلغ شاذ. تعرض الوثائق هذه الأمثلة للتعابير المتقدمة:

أمثلة من الوثائق على تعابير الشروط المتقدمة: العوامل والأقواس المربعة والدالة size()

العوامل الموثقة هي == و!= و> و>= و< و<= وin و&& و|| والأقواس. ولمعرفة حجم قائمة استخدم size() وليس len ولا length.

فهم سبب عدم وصول أي لقطة

لنقطة التوقف خمس حالات: Active وPending وDisabled وError وWarning. الحالات الشائعة وفق الوثائق:

  • Active دون لقطات: السطر لا يُنفَّذ في النسخة الصحيحة، أو كانت الدالة تعمل أصلًا حين وضعت النقطة. تُغطّى الاستدعاءات اللاحقة فقط.
  • Pending: OneAgent غائب، أو التطبيق خارج المرشّح، أو الملف المصدري غير محمّل، أو السطر بلا شيفرة قابلة للتنفيذ. وعلى JVM تعيق الفئات المترجمة بلا معلومات تتبع.
  • Error: الملف المصدري الظاهر في بيئة التطوير يختلف عن الملف المنشور، أو استغرق الجمع وقتًا طويلًا. يتحقق Dynatrace من إصدار الملف قبل وضع النقطة.
  • Warning: آلية تحديد المعدل تأخذ عينات من الجمع على مسار شديد الازدحام لحماية الأداء.

وعلى Node.js يسبب أيضًا الكود المحوَّل بلا source maps، أو وجود مصحّح متزامن مثل مصحّح WebStorm، مشكلات. وتكشف رسالة الحالة (نقرة يمنى ثم Status) السبب الدقيق.

من يحق له وضع نقاط التوقف: الصلاحيات

الجواب الحقيقي عن سؤال البداية يكمن في سياسات IAM. توجد صلاحيتان: dev-obs:breakpoints:set لرؤية الوكلاء ووضع النقاط، وdev-obs:breakpoints:manage لرؤية نقاط جميع المستخدمين وتعطيلها. وتتيح الشروط التقييد حسب namespace أو العنقود أو مجموعة العمليات أو المضيف. أما قراءة اللقطات فتمرّ عبر صلاحية تخزين منفصلة.

أمثلة من الوثائق على سياسات IAM لوضع نقاط التوقف وقراءة اللقطات

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

ممارسات جيدة

  • خصّص breakpoints:set لفريق مسمّى وقيّده بـ namespace أو مجموعة عمليات.
  • أبقِ الحدود الافتراضية أو خفّضها: 100 لقطة تكفي في الغالب.
  • ضع شرطًا بمجرد ارتفاع الحركة، ولا تعتمد على تحديد المعدل.
  • دوّن في تذكرة الحادث أي نقطة وُضعت، ومن وضعها، ولماذا.
  • اربط اللقطة بتتبع: اللقطة تجيب عن «أي قيمة»، والتتبع عن «أي خدمة». أما لاستهلاك المعالج فانظر إلى التنميط المستمر، وهو أداة خارجية مستقلة.

ولربط هذا العمل بصحة الخدمة، ابدأ بحالة الـ pods في تشخيص CrashLoopBackOff وOOMKilled، ثم تابع أثر إصلاحك في لوحة DQL.

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

هل يوقف Live Debugger التطبيق؟

لا. تتحدث الوثائق عن نقاط توقف غير حاجزة: تُجمع الحالة دون إيقاف الشيفرة الجارية. وتحمي آلية تحديد المعدل المسارات كثيرة الاستدعاء.

ما اللغات المدعومة؟

تذكر صفحة المتطلبات وحدتي الشيفرة Java وNode.js. ولا يوجد في تلك الصفحة أي توثيق للغات أخرى، فتحقق قبل التخطيط لأي نشر.

هل يعمل على Dynatrace Managed؟

تصف الوثائق التي قرأتها بيئة SaaS مع DPS. لم أجد أي صفحة عن Managed، فاعدّ الميزة غير متاحة هناك ما لم توثّقها الشركة.

الخلاصة

يستبدل Live Debugger دورة «أضف سجلًا، انشر، انتظر» بقراءة موجَّهة ومحدودة زمنيًا. وتتوقف قيمته في الإنتاج على الضوابط: نطاق تفعيل ضيق، وصلاحيات IAM، وحدود وشروط. وللتوسع اقرأ وثائق Live Debugger.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك.

Total
0
Shares
Leave a Reply

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

Previous Post
Interroger la topologie Kubernetes avec DQL : quatre décisions d'exploitation

الاستعلام عن طوبولوجيا Kubernetes بلغة DQL: أربعة قرارات تشغيلية

Next Post
Groupes de pipelines OpenPipeline : gouverner les flux de télémétrie à grande échelle

مجموعات خطوط المعالجة في OpenPipeline: حوكمة تدفقات القياس عن بُعد

Related Posts