استكشاف أخطاء خدمة Azure Video Analyzer وإصلاحها

مقالة
05/04/2022
قراءة خلال 6 دقائق

بدلا من ذلك، تحقق من استكشاف الأخطاء وإصلاحها على الحافة.

ملاحظة

نحن نوقف خدمة معاينة Azure Video Analyzer، وينصحك بنقل تطبيقاتك من Video Analyzer بحلول 01 ديسمبر 2022.

لا يتأثر محلل فيديو Azure للوسائط بهذا الإيقاف. يتم الآن تغيير العلامة التجارية إلى Azure Video Indexer. انقر هنا لقراءة المزيد.

الإجراء مطلوب: لتقليل تعطيل أحمال العمل الخاصة بك، قم بنقل التطبيق الخاص بك من Video Analyzer لكل اقتراحات موصوفة في هذا الدليل قبل 01 ديسمبر 2022. بعد 1 ديسمبر 2022، لن يعمل حساب Azure Video Analyzer. اعتبارا من 2 مايو 2022، لن تتمكن من إنشاء حسابات محلل فيديو جديدة.

تتناول هذه المقالة خطوات استكشاف الأخطاء وإصلاحها لسيناريوهات الخطأ الشائعة التي قد تراها أثناء استخدام الخدمة.

تمكين التشخيص

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

في مدخل Microsoft Azure، انتقل إلى قسم Monitoring في حساب Video Analyzer وحدد Diagnostic settings.
انقر فوق Add diagnostic setting لتمكين سجلات أنواع الأحداث المطلوبة: Diagnostics، ، Audit. Operational لمزيد من التفاصيل، راجع هنا

عرض التشخيصات

بمجرد تمكين التشخيصات، يمكنك الوصول إلى السجلات كما يلي:

تلميح

يوصي بتنشيط مسار مباشر واحد على الأقل لإرسال الأحداث.

في المدخل، حدد موقع حساب التخزين الذي تمت كتابة السجلات إليه
افتح جزء الإدارة لحساب التخزين هذا
انتقل إلى مستكشف التخزين -> ثم قم بتوسيع حساب التخزين الخاص بك وسترى حاوية Blob "insights-logs-category". سيكون لهذا الكائن الثنائي كبير الحجم سجلات بتنسيق ملف JSON. يمكنك تنزيل هذه السجلات للتحقيق في المشكلة

عرض القياسات

يصدر محلل الفيديو أيضا مقاييس لمسارات الاستيعاب & ، والتي يمكن أن تساعد في تحديد المشكلات على النحو التالي.

IngressBytes - إجمالي عدد وحدات البايت المستلمة بواسطة البنية الأساسية لبرنامج ربط العمليات التجارية. تشير القيمة المتزايدة باطراد إلى أن البنية الأساسية لبرنامج ربط العمليات التجارية سليمة، وتتلقى بيانات الفيديو من كاميرا RTSP
البنية الأساسية لبرنامج ربط العمليات التجارية - يساعد في التحقق من حالة البنية الأساسية لبرنامج ربط العمليات التجارية والأعداد.

عرض سجلات النشاط

يتم إنشاء سجل نشاط تلقائيا ويمكن الوصول إليه عن طريق الانتقال إلى قسم "سجل النشاط" من شفرة إدارة حساب محلل الفيديو على مدخل Microsoft Azure. يمكنك مشاهدة محفوظات مكالمات واجهة برمجة تطبيقات ARM التي تم إجراؤها على حسابك، والتفاصيل ذات الصلة.

سيناريوهات الخطأ الشائعة

بعض الأخطاء الشائعة التي ستواجهها مع خدمة محلل الفيديو موضحة أدناه.

تعذر تشغيل الفيديو بعد تنشيط البنية الأساسية لبرنامج ربط العمليات التجارية المباشرة

إذا كنت تستخدم عنصر واجهة مستخدم محلل الفيديو لتشغيل الفيديو، فحاول استخدام مدخل Microsoft Azure إذا كان لديك حق الوصول إليه. إذا تم تشغيل الفيديو في مدخل Microsoft Azure، ولكن ليس في عنصر واجهة المستخدم، فيجب عليك المتابعة للتحقق من قسم عنصر واجهة المستخدم أدناه
إذا لم يتم تشغيل الفيديو مرة أخرى في مدخل Microsoft Azure، فتحقق مما إذا كانت خدمة محلل الفيديو تتلقى بيانات الفيديو من كاميرا RTSP. حدد مقياس "Ingress Bytes" عن طريق الانتقال إلى قسم Monitoring-Metrics> في المدخل. إذا كان التجميع يتزايد، فإن الاتصال بين كاميرا RTSP والخدمة سليم، سيكون مجموع وحدات بايت الدخول متوفرا أسفل الرسم البياني.
إذا كانت الخدمة لا تتلقى بيانات الفيديو من كاميرا RTSP، فإن الخطوة التالية هي عرض سجلات التشخيص ذات الصلة. من المحتمل أن ترى خطأ مثل ProtocolError، ويمكنك استكشاف الأخطاء وإصلاحها بشكل أكبر كما هو موضح أدناه.

تحتوي سجلات التشخيص على ProtocolError مع التعليمات البرمجية 401

إذا رأيت Microsoft.VideoAnalyzer.Diagnostics.ProtocolError في سجلات التشخيص، مع تعيين رمز إلى 401 كما يلي، فإن الخطوة الأولى هي إعادة التحقق من بيانات اعتماد RTSP. نموذج الحدث الذي ستجده هو كما يلي:

{
     "time": "2021-10-15T02:56:18.7890000Z",
     "resourceId": "/SUBSCRIPTIONS/{GUID}/RESOURCEGROUPS/8AVA/PROVIDERS/MICROSOFT.MEDIA/VIDEOANALYZERS/AVASAMPLEZ2OHI3VBIRQPC",
     "region": "westcentralus",
     "category": "Diagnostics",
     "operationName": "Microsoft.VideoAnalyzer.Diagnostics.ProtocolError",
     "operationVersion": "1.0",
     "level": "Error",
     "traceContext": "{\n  \"traceId\": \"f728d155-b4fd-4aec-8307-bbe2a324f4c3\"\n}",
     "properties": {
         "subject": "/livePipelines/your-pipeline/sources/rtspSource",
         "body": {
             "code": "401",
             "target": "rtsp://127.0.0.1:33643/some-path",
             "protocol": "rtsp"
         }
     }
}

إذا كنت تستخدم مسارا مباشرا للاتصال بكاميرا يمكن الوصول إليها عبر الإنترنت، فتحقق من عنوان URL واسم المستخدم وكلمة المرور RTSP التي تم استخدامها عند إنشاء البنية الأساسية لبرنامج ربط العمليات التجارية المباشرة. يمكنك استدعاء GET على المسار المباشر لعرض عنوان URL واسم المستخدم، ولكن لن يتم رد كلمة المرور مرة أخرى. يجب التحقق من التعليمات البرمجية التي تم استخدامها لإنشاء البنية الأساسية لبرنامج ربط العمليات التجارية المباشرة.
إذا كنت تستخدم محول جهاز بعيد، فجرب الخطوات التالية.
- تحقق من إرفاق مركز IoT بحساب محلل الفيديو الخاص بك. وهو مطلوب لاستخدام محول جهاز بعيد.
- تشغيل remoteDeviceAdapterList أسلوب مباشر على وحدة الحافة والتحقق من عنوان IP. يتم عرض نموذج الطلب والاستجابة هنا
- افحص الاستجابة لمحول الجهاز البعيد الذي تستخدمه في البنية الأساسية لبرنامج ربط العمليات التجارية المباشرة التي تواجه المشكلة، وقارنها بالمثال الوارد في هذه المقالة. تحقق من صحة عنوان IP للكاميرا
- انتقل إلى حساب Azure portal-Video> Analyzer -> Live -> Pipelines -> Edit live pipeline -> أعد إدخال اسم المستخدم وكلمة المرور RTSP. تحقق من أن عنوان URL ل RTSP الذي توفره يبدأ ب rtsp://localhost:554/…. هنا، localhost استخدام مطلوب.
إذا لم تساعد الخطوات المذكورة أعلاه في حل المشكلة ولا يزال تشغيل الفيديو لا يعمل، فقم بتسجيل الدخول إلى مدخل Microsoft Azure وافتح تذكرة دعم. قد تحتاج إلى إرفاق السجلات من وحدة حافة محلل الفيديو، راجع قسم "استخدام الأمر حزمة الدعم" في مستند استكشاف أخطاء الحافة وإصلاحها

تعذر التسجيل إلى مورد فيديو

باستخدام Video Analyzer، يجب استخدام مورد فيديو مميز عند التسجيل من كاميرا RTSP مميزة. ستحتاج أيضا إلى التبديل إلى مورد فيديو جديد إذا قمت بتغيير إعدادات الكاميرا (على سبيل المثال الدقة). تحتوي بعض طبولوجيا البنية الأساسية لبرنامج ربط العمليات التجارية النموذجية على أسماء ذات تعليمات برمجية مضمنة لمورد الفيديو في خصائص عقدة متلقي الفيديو. إذا كنت تستخدم هذه الطوبولوجيا مباشرة مع كاميرات مختلفة، فستواجه هذه المشكلة. تعديل الخاصية videoName في عقدة متلقي الفيديو لضمان التفرد.

مقاطع التسجيل أو التشغيل

عند إنشاء مسار مباشر، يطلب منك تحديد الحد الأقصى لمرات البت (bitrateKbps) التي سترسل فيها كاميرا RTSP الفيديو إلى الخدمة. إذا تجاوزت الكاميرا هذا الحد، فسيتم قطع اتصال خدمة Video Analyzer بالكاميرا لفترة وجيزة. يمكن إعادة محاولة الاتصال بالكاميرا في حالة وجود ارتفاع مؤقت في معدل البت. يمكنك تحديد هذا الموقف من خلال البحث عن حدث Microsoft.VideoAnalyzer.Diagnostics.RtspIngestionSessionEnded في سجلات التشخيص، مع SourceBitrateExceeded رمز خطأ. لحل هذه المشكلة، قم إما بتقليل إعداد معدل البت على الكاميرا، أو زيادة bitrateKbps قيمة البنية الأساسية لبرنامج ربط العمليات التجارية المباشرة لمطابقة إعداد الكاميرا.

إذا تلقيت خطأ "منع الوصول" في عنصر واجهة مستخدم محلل الفيديو، فيجب أن تشاهد حدث تحذير في سجل التدقيق.

تأكد من إنشاء رمز JWT المميز لواجهة برمجة تطبيقات العميل ونهج الوصول المطابق، راجع الوثائق لإنشاء رمز مميز وإنشاء نهج الوصول. لن يعمل اللاعب إذا لم يتم إعداد نهج الوصول بشكل صحيح، ولا يتطابق رمز JWT المميز مع النهج.
إذا لم يتم حل المشكلة، فاجمع سجلات عنصر واجهة المستخدم، وقم بتقديم تذكرة دعم باستخدام مدخل Microsoft Azure
تجميع سجلات عنصر واجهة المستخدم:
- اضغط على F12 لتمكين أدوات المطور المستعرض، وانتقل إلى علامة التبويب وحدة التحكم، ومكن تسجيل "جميع المستويات".
- من أيقونة الإعدادات ، حدد تفضيلات --> وحدة التحكم --> إظهار الطوابع الزمنية. احفظ السجلات.

جمع سجلات لإرسال تذكرة دعم

عندما لا تحل خطوات استكشاف الأخطاء وإصلاحها الموجهة ذاتيا مشكلتك وهناك المزيد من المشكلات التي قد تحتاج إلى مساعدة بشأنها، يرجى فتح تذكرة دعم باستخدام مدخل Microsoft Azure مع التفاصيل ذات الصلة حول المشكلة & إرفاق ملفات سجل JSON التشخيصية التي تم تنزيلها من حساب التخزين الخاص بك. يمكنك أيضا التواصل معنا عن طريق إرسال بريد إلكتروني على videoanalyzerhelp@microsoft.com.

تحذير

قد تحتوي السجلات على معلومات تعريف شخصية (PII) مثل عنوان IP الخاص بك. سيتم حذف جميع النسخ المحلية من السجلات بمجرد الانتهاء من فحصها وإغلاق تذكرة الدعم.

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

الأسئلة المتداولة