مشاركة عبر

استكشاف أخطاء Azure Stream Analytics وإصلاحها باستخدام سجلات الموارد

  • مقالة

في بعض الأحيان، تتوقف وظيفة Azure Stream Analytics عن المعالجة بشكل غير متوقع. من المهم أن تكون قادراً على استكشاف هذا النوع من الأحداث وإصلاحها. يمكن أن تكون حالات الفشل ناتجة عن نتيجة استعلام غير متوقعة أو عن طريق الاتصال بالأجهزة أو انقطاع غير متوقع للخدمة. يمكن أن تساعدك سجلات الموارد في Stream Analytics في تحديد سبب المشكلات عند حدوثها وتقليل وقت الاسترداد.

يوصى بشدة بتمكين سجلات الموارد لجميع الوظائف لأنها ستساعد بشكل كبير في تصحيح الأخطاء والمراقبة.

أنواع السجلات

يوفر Stream Analytics نوعين من السجلات:

  • سجلات النشاط (قيد التشغيل دائماً)، والتي تعطي نتائج تحليلات حول العمليات التي يتم إجراؤها على الوظائف.

  • سجلات الموارد (قابلة للتكوين)، والتي توفر نتائج تحليلات أكثر ثراء في كل ما يحدث مع الوظيفة. تبدأ سجلات الموارد عند إنشاء الوظيفة وتنتهي عند حذف الوظيفة. وهي تغطي الأحداث عند تحديث الوظيفة وأثناء تشغيلها.

إشعار

يمكنك استخدام خدمات مثل Azure Storage ومركز الأحداث من Azure وسجلات مراقبة Azure لتحليل البيانات غير المتماثلة. يتم تحصيل رسوم منك استناداً إلى نموذج الأسعار لهذه الخدمات.

إشعار

تم تحديث هذه المقالة مؤخرًا لاستخدام مصطلح سجلات مراقبة Azure بدلاً من تحليلات السجلات. لا تزال بيانات السجل مخزنة في مساحة عمل Log Analytics ولا يزال يتم جمعها وتحليلها بواسطة نفس خدمة Log Analytics. نحن نحدِّث المصطلحات لتعكس دور السجلات في Azure Monitorعلى نحوٍ أفضل. راجع تغييرات مصطلحات Azure Monitor للحصول على التفاصيل.

تصحيح الأخطاء باستخدام سجلات النشاط

تكون سجلات النشاط قيد التشغيل بشكل افتراضي وتعطي نتائج تحليلات عالية المستوى للعمليات التي تقوم بها وظيفة Stream Analytics. قد تساعد المعلومات الموجودة في سجلات النشاط في العثور على السبب الجذري للمشكلات التي تؤثر على وظيفتك. قم بالخطوات التالية لاستخدام سجلات النشاط في Stream Analytics:

  1. سجل الدخول إلى مدخل Azure، وحدد سجل الأنشطة ضمن نظرة عامة.

    سجل أنشطة Stream Analytics

  2. يمكنك مشاهدة قائمة العمليات التي تم تنفيذها. تحتوي أي عملية تسببت في فشل وظيفتك على فقاعة معلومات حمراء.

  3. حدد عملية لمشاهدة طريقة عرض الملخص الخاصة بها. غالبا ما تكون المعلومات هنا محدودة. لمعرفة المزيد من التفاصيل حول العملية، حدد JSON.

    ملخص عملية سجل أنشطة Stream Analytics

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

    تفاصيل خطأ JSON

  5. يمكنك اتخاذ إجراءات تصحيحية استناداً إلى رسالة الخطأ في JSON. في هذا المثال، يجب إضافة عمليات التحقق للتأكد من أن قيمة خط العرض بين -90 درجة و90 درجة إلى الاستعلام.

  6. إذا لم تكن رسالة الخطأ في سجلات النشاط مفيدة في تحديد السبب الجذري، فقم بتمكين سجلات الموارد واستخدم سجلات مراقبة Azure.

إرسال التشخيصات إلى سجلات مراقبة Azure

يوصى بشدة بتشغيل سجلات الموارد وإرسالها إلى سجلات مراقبة Azure. تكون متوقفة عن التشغيل بشكل افتراضي. لتشغيلها، أكمل الخطوات التالية:

  1. إنشاء مساحة عمل Log Analytics إذا لم تكن لديك مساحة عمل بالفعل. من المستحسن أن يكون لديك مساحة عمل Log Analytics في نفس المنطقة مثل وظيفة Stream Analytics.

  2. سجل الدخول إلى مدخل Azure، وانتقل إلى وظيفة Stream Analytics. ضمن المراقبة، حدد سجلات التشخيص. ثم حدد تشغيل التشخيص.

    تنقل الجزء إلى سجلات الموارد

  3. أدخل اسماً في اسم إعدادات التشخيص، وحدد مربعات التنفيذ والتأليف ضمن السجل، و AllMetrics ضمن المقياس. ثم حدد إرسال إلى Log Analytics، واختر مساحة العمل الخاصة بك. حدد حفظ.

    إعدادات سجلات الموارد

  4. عند بدء مهمة Stream Analytics، يتم توجيه سجلات الموارد إلى مساحة عمل Log Analytics. لعرض سجلات الموارد لوظيفتك، حدد سجلات ضمن قسم المراقبة.

    تُظهر لقطة الشاشة القائمة «عام» مع تحديد «السجلات».

  5. يوفر Stream Analytics استعلامات محددة مسبقا تسمح لك بالبحث بسهولة عن السجلات التي تهتم بها. يمكنك تحديد أي استعلامات معرفة مسبقا في الجزء الأيمن ثم تحديد تشغيل. سترى نتائج الاستعلام في الجزء السفلي.

    لقطة شاشة تعرض سجلات لوظيفة Stream Analytics.

فئات سجل الموارد

يلتقط Azure Stream Analytics فئتين من سجلات الموارد:

  • التأليف: يلتقط أحداث السجل المتعلقة بعمليات تأليف الوظيفة، مثل إنشاء الوظيفة وإضافة وحذف المدخلات والمخرجات وإضافة الاستعلام وتحديثه وبدء المهمة أو إيقافها.

  • التنفيذ: يلتقط الأحداث التي تحدث أثناء تنفيذ المهمة.

    • أخطاء الاتصال
    • أخطاء معالجة البيانات، بما في ذلك:
      • الأحداث التي لا تتوافق مع تعريف الاستعلام (أنواع الحقول والقيم غير المتطابقة والحقول المفقودة وما إلى ذلك)
      • أخطاء تقييم التعبير
    • أحداث وأخطاء أخرى

يتم تخزين كافة السجلات بتنسيق JSON. للتعرف على مخطط سجلات الموارد، راجع مخطط سجلات الموارد.

الخطوات التالية