استكشاف أخطاء 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:
سجل الدخول إلى مدخل Azure، وحدد سجل الأنشطة ضمن نظرة عامة.
يمكنك مشاهدة قائمة العمليات التي تم تنفيذها. تحتوي أي عملية تسببت في فشل وظيفتك على فقاعة معلومات حمراء.
حدد عملية لمشاهدة طريقة عرض الملخص الخاصة بها. غالبا ما تكون المعلومات هنا محدودة. لمعرفة المزيد من التفاصيل حول العملية، حدد JSON.
قم بالتمرير لأسفل وصولاً إلى قسم الخصائص في JSON، والذي يوفر تفاصيل الخطأ الذي تسبب في فشل العملية. في هذا المثال، كان الفشل بسبب خطأ وقت التشغيل من قيم خط العرض المنضمة. يؤدي التناقض في البيانات التي تتم معالجتها بواسطة وظيفة Stream Analytics إلى حدوث خطأ في البيانات. يمكنك التعرف على أخطاء بيانات الإدخال والإخراج المختلفة وسبب حدوثها.
يمكنك اتخاذ إجراءات تصحيحية استناداً إلى رسالة الخطأ في JSON. في هذا المثال، يجب إضافة عمليات التحقق للتأكد من أن قيمة خط العرض بين -90 درجة و90 درجة إلى الاستعلام.
إذا لم تكن رسالة الخطأ في سجلات النشاط مفيدة في تحديد السبب الجذري، فقم بتمكين سجلات الموارد واستخدم سجلات مراقبة Azure.
إرسال التشخيصات إلى سجلات مراقبة Azure
يوصى بشدة بتشغيل سجلات الموارد وإرسالها إلى سجلات مراقبة Azure. تكون متوقفة عن التشغيل بشكل افتراضي. لتشغيلها، أكمل الخطوات التالية:
إنشاء مساحة عمل Log Analytics إذا لم تكن لديك مساحة عمل بالفعل. من المستحسن أن يكون لديك مساحة عمل Log Analytics في نفس المنطقة مثل وظيفة Stream Analytics.
سجل الدخول إلى مدخل Azure، وانتقل إلى وظيفة Stream Analytics. ضمن المراقبة، حدد سجلات التشخيص. ثم حدد تشغيل التشخيص.
أدخل اسماً في اسم إعدادات التشخيص، وحدد مربعات التنفيذ والتأليف ضمن السجل، و AllMetrics ضمن المقياس. ثم حدد إرسال إلى Log Analytics، واختر مساحة العمل الخاصة بك. حدد حفظ.
عند بدء مهمة Stream Analytics، يتم توجيه سجلات الموارد إلى مساحة عمل Log Analytics. لعرض سجلات الموارد لوظيفتك، حدد سجلات ضمن قسم المراقبة.
يوفر Stream Analytics استعلامات محددة مسبقا تسمح لك بالبحث بسهولة عن السجلات التي تهتم بها. يمكنك تحديد أي استعلامات معرفة مسبقا في الجزء الأيمن ثم تحديد تشغيل. سترى نتائج الاستعلام في الجزء السفلي.
فئات سجل الموارد
يلتقط Azure Stream Analytics فئتين من سجلات الموارد:
التأليف: يلتقط أحداث السجل المتعلقة بعمليات تأليف الوظيفة، مثل إنشاء الوظيفة وإضافة وحذف المدخلات والمخرجات وإضافة الاستعلام وتحديثه وبدء المهمة أو إيقافها.
التنفيذ: يلتقط الأحداث التي تحدث أثناء تنفيذ المهمة.
- أخطاء الاتصال
- أخطاء معالجة البيانات، بما في ذلك:
- الأحداث التي لا تتوافق مع تعريف الاستعلام (أنواع الحقول والقيم غير المتطابقة والحقول المفقودة وما إلى ذلك)
- أخطاء تقييم التعبير
- أحداث وأخطاء أخرى
مخطط سجلات الموارد
يتم تخزين كافة السجلات بتنسيق JSON. يحتوي كل إدخال على حقول السلسلة الشائعة التالية:
| Name | الوصف |
|---|---|
| time | الطابع الزمني (بالتوقيت العالمي المتفق عليه) للسجل. |
| resourceId | معرف المورد الذي تمت العملية عليه، بأحرف كبيرة. يتضمن معرف الاشتراك ومجموعة الموارد واسم الوظيفة. على سبيل المثال، /SUBSCRIPTIONS/6503D296-DAC1-4449-9B03-609A1F4A1C87/RESOURCEGROUPS/MY-RESOURCE-GROUP/PROVIDERS/MICROSOFT.STREAMANALYTICS/STREAMINGJOBS/MYSTREAMINGJOB. |
| الفئة | فئة السجل، إما التنفيذ أو التأليف. |
| اسم العملية | اسم العملية التي تم تسجيلها. على سبيل المثال، إرسال الأحداث: فشل كتابة إخراج SQL إلى mysqloutput. |
| الحالة | حالة العملية. على سبيل المثال، فاشلة أو ناجحة. |
| المستوى | مستوى السجل. على سبيل المثال، خطأ أو تحذير أو معلوماتي. |
| الخصائص | تفاصيل إدخال السجل الخاصة، متسلسلة كسلسلة JSON. لمزيد من المعلومات، راجع الأقسام التالية. |
مخطط خصائص سجل التنفيذ
تحتوي سجلات التنفيذ على معلومات حول الأحداث التي حدثت أثناء تنفيذ مهمة Stream Analytics. يختلف مخطط الخصائص اعتماداً على ما إذا كان الحدث خطأ في البيانات أو حدثاً عاماً.
أخطاء البيانات
أي خطأ يحدث أثناء معالجة المهمة للبيانات في هذه الفئة من السجلات. غالباً ما يتم إنشاء هذه السجلات أثناء عمليات قراءة البيانات وتسلسلها وكتابتها. لا تتضمن هذه السجلات أخطاء الاتصال. يتم التعامل مع أخطاء الاتصال كأحداث عامة. يمكنك معرفة المزيد حول سبب أخطاء بيانات الإدخال والإخراج المختلفة.
| Name | الوصف |
|---|---|
| المصدر | اسم إدخال الوظيفة أو إخراجها حيث حدث الخطأ. |
| رسالة | الرسالة المقترنة بالخطأ. |
| نوع | نوع الخطأ. على سبيل المثال، DataConversionError أو CsvParserError أو ServiceBusPropertyColumnMissingError. |
| بيانات | يحتوي على بيانات مفيدة لتحديد موقع مصدر الخطأ بدقة. عرضة للاقتطاع، اعتماداً على الحجم. |
اعتماداً على قيمة operationName، تحتوي أخطاء البيانات على المخطط التالي:
يحدث تسلسل الأحداث أثناء عمليات قراءة الحدث. تحدث عندما لا تفي البيانات الموجودة في الإدخال بمخطط الاستعلام لأحد الأسباب التالية:
عدم تطابق النوع أثناء تسلسل/إلغاء تسلسل الحدث: يحدد الحقل الذي يسبب الخطأ.
لا يمكن قراءة حدث، تسلسل غير صالح: يسرد معلومات حول الموقع في بيانات الإدخال حيث حدث الخطأ. يتضمن اسم الكائن الثنائي كبير الحجم لإدخال الكائن الثنائي كبير الحجم والإزاحة وعينة من البيانات.
يحدث إرسال الأحداث أثناء عمليات الكتابة. وهي تحدد حدث الدفق الذي تسبب في الخطأ.
أحداث عامة
تغطي الأحداث العامة كل شيء آخر.
| Name | الوصف |
|---|---|
| خطأ | (اختياري) معلومات الخطأ. عادة ما تكون معلومات الاستثناء إذا كانت متوفرة. |
| رسالة | رسالة السجل |
| نوع | نوع الرسالة. تعيين إلى التصنيف الداخلي للأخطاء. على سبيل المثال، JobValidationError أو BlobOutputAdapterInitializationFailure. |
| معرف الارتباط | GUID الذي يحدد تنفيذ المهمة بشكل فريد. جميع إدخالات سجل التنفيذ من وقت بدء المهمة حتى تتوقف المهمة لها نفس قيمة معرف الارتباط. |
للرجوع إليها، راجع قائمة بجميع أنواع فئات سجلات الموارد المدعومة في Azure Monitor أو جميع أنواع فئات سجل الموارد التي تم جمعها ل Azure Stream Analytics.