البحث عن المعاملات والتشخيصات

يقدم Azure Monitor Application Insights بحث المعاملات لتحديد عناصر بيانات تتبع الاستخدام المحددة وتشخيص المعاملات لتحليل شامل للمعاملات من طرف إلى طرف.

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

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

البحث في المعاملات

البحث عن المعاملات هو ميزة في Application Insights التي تستخدمها للبحث عن واستكشاف عناصر بيانات تتبع الاستخدام الفردية، مثل طرق عرض الصفحة، والاستثناءات، أو طلبات الويب. يمكنك أيضا عرض تتبعات السجل والأحداث التي تقوم بتكوينها برمجيا.

للحصول على مزيد من الاستعلامات المعقدة على بياناتك، استخدم تحليلات السجل.

أين ترى البحث؟

يمكنك العثور على Search في مدخل Microsoft Azure أو Visual Studio.

في مدخل Microsoft Azure

يمكنك فتح البحث عن المعاملات من علامة التبويب Application Insights Overview في التطبيق. يمكنك أيضًا تحديد Search ضمن Investigate في القائمة اليمنى.

انتقل إلى القائمة المنسدلة أنواع الأحداث لمشاهدة قائمة بعناصر بيانات تتبع الاستخدام مثل طلبات الخادم وطرق عرض الصفحة والأحداث المخصصة التي قمت برمزها. يحتوي أعلى قائمة النتائج على مخطط ملخص يعرض عدد الأحداث بمرور الوقت.

ارجع من القائمة المنسدلة أو حدد تحديث للحصول على أحداث جديدة.

في Visual Studio

في Visual Studio، هناك أيضًا نافذة Application Insights Search. من المفيد للغاية عرض أحداث بيانات تتبع الاستخدام التي تم إنشاؤها بواسطة التطبيق الذي تقوم بتصحيحه. ولكن يمكنه أيضًا عرض الأحداث التي تم جمعها من تطبيقك المنشور على مدخل Microsoft Azure.

افتح نافذة البحث عن Application Insights في Visual Studio.

تحتوي نافذة بحث Application Insights على ميزات مشابهة لمدخل الويب:

تتوفر علامة التبويب تعقب العملية عند فتح طلب أو عرض صفحة. "العملية" هي سلسلة من الأحداث المقترنة بطلب واحد أو طريقة عرض صفحة واحدة. على سبيل المثال، قد تكون استدعاءات التبعية والاستثناءات وسجلات التتبع والأحداث المخصصة جزءًا من عملية واحدة. تعرض علامة التبويب تعقب العملية بيانيًّا توقيت ومدة هذه الأحداث فيما يتعلق بالطلب أو عرض الصفحة.

فحص العناصر الفردية

حدد أي عنصر قياس عن بعد لعرض حقول المفاتيح والعناصر المرتبطة.

يتم فتح العرض تفاصيل العمليات من طرف إلى طرف

تصفية أنواع الأحداث

افتح القائمة المنسدلة أنواع الأحداث واختر أنواع الأحداث التي تريد رؤيتها. إذا كنت تريد استعادة عوامل التصفية لاحقًا، فحدد Reset.

أنواع الأحداث هي:

• تتبع: سجلات التشخيص بما في ذلك TrackTrace، log4Net، NLog، وSystem.Diagnostic. استدعاءات التتبع.
• طلب: طلبات HTTP التي تلقاها تطبيق الخادم الخاص بك، بما في ذلك الصفحات والبرامج النصية والصور وملفات النمط والبيانات. يتم استخدام هذه الأحداث لإنشاء مخططات نظرة عامة على الطلب والاستجابة.
• عرض الصفحة: بيانات تتبع الاستخدام المرسلة من قبل عميل ويب، تستخدم لإنشاء تقارير عرض الصفحة.
• حدث مخصص - إذا قمت بإدراج مكالمات إلى TrackEvent()لمراقبة الاستخدام، فيمكنك البحث فيها هنا.
• استثناء: الاستثناءات غير المكتشفة في الخادم، وتلك التي تقوم بتسجيلها باستخدام TrackException().
• التبعية:المكالمات من تطبيق الخادم الخاص بك إلى خدمات أخرى مثل REST API أو قواعد البيانات، ومكالمات AJAX من رمز العميل الخاص بك.
• التوفر: نتائج اختبارات التوفر

تصفية قيم الخصائص

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

اختيار أي قيم خاصية معينة له نفس تأثير اختيار كافة القيم. يقوم بإيقاف التصفية على تلك الخاصية.

لاحظ أن الأعداد الموجودة على يمين قيم عوامل التصفية تظهر عدد مرات التواجد الموجودة في المجموعة الحالية التي تمت تصفيتها.

البحث عن أحداث بنفس الخاصية

للعثور على كافة العناصر التي لها نفس قيمة الخاصية، أدخلها في مربع البحث أو حدد خانة الاختيار عند البحث عن الخصائص في علامة التبويب Filter.

البحث في البيانات

إشعار

لكتابة استعلامات أكثر تعقيدًا، افتح سجلات (التحليلات) من أعلى جزء البحث.

يمكنك البحث عن مصطلحات في أي من قيم الخصائص. هذه الإمكانية مفيدة إذا قمت بكتابة أحداث مخصصة مع قيم الخصائص.

قد ترغب في تعيين نطاق زمني، لأن عمليات البحث عبر نطاق أقصر تكون أسرع.

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

السلسلة‬	لم يتم العثور عليه	تم العثور عليه
HomeController.About	home controller out	homecontroller about "homecontroller.about"
الولايات المتحدة	Uni ted	united states united AND states "united states"

يمكنك استخدام تعبيرات البحث التالية:

نموذج استعلام	التأثير
apple	ابحث عن كافة الأحداث في النطاق الزمني الذي تتضمن حقوله الكلمة apple.
apple AND banana apple banana	ابحث عن الأحداث التي تحتوي على الكلمتين. استخدم رأس المال AND، وليس and. الصيغة المختصرة.
apple OR banana	ابحث عن الأحداث التي تحتوي على أي من الكلمتين. استخدم OR، وليس or.
apple NOT banana	ابحث عن الأحداث التي تحتوي على كلمة واحدة ولكن ليس الأخرى.

أخذ عينات

إذا كان تطبيقك ينشئ بيانات تتبع استخدام كبيرة ويستخدم ASP.NET SDK الإصدار 2.0.0-beta3 أو أحدث، فإنه يقلل تلقائيا من مستوى الصوت المرسل إلى المدخل من خلال أخذ العينات التكيفية. ترسل هذه الوحدة جزءا تمثيليا فقط من الأحداث. يقوم بتحديد أو إلغاء تحديد الأحداث المتعلقة بنفس الطلب كمجموعة، ما يسمح لك بالتنقل بين الأحداث ذات الصلة.

تعرّف على المزيد عن أخذ العينات.

إنشاء عنصر عمل

يمكنك إنشاء خطأ في GitHub أو Azure DevOps مع التفاصيل من أي عنصر بيانات تتبع الاستخدام.

انتقل إلى عرض تفاصيل المعاملة الشاملة عن طريق تحديد أي عنصر بيانات تتبع الاستخدام. ثم حدد إنشاء عنصر عمل.

في المرة الأولى التي تجري فيها هذه الخطوة، يُطلب منك تكوين ارتباط إلى مؤسسة ومشروع Azure DevOps. يمكنك أيضًا تكوين الارتباط في علامة التبويب عناصر العمل.

إرسال المزيد من بيانات تتبع الاستخدام إلى Application Insights

بالإضافة إلى بيانات تتبع الاستخدام الجاهزة المرسلة من قبل Application Insights SDK، يمكنك:

• التقاط آثار السجل من إطار عمل التسجيل المفضل لديك في .NET أو Java. وهذا يعني أنه يمكنك البحث في آثار السجل وربطها مع طرق عرض الصفحة والاستثناءات والأحداث الأخرى.

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

تعلم كيفية إرسال السجلات وبيانات تتبع الاستخدام المخصصة إلى Application Insights.

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

ابحث عن إجابات على الأسئلة الشائعة.

ما مقدار البيانات التي يتم الاحتفاظ بها؟

راجع ملخص الحدود.

كيف يمكنني رؤية بيانات POST في طلبات الخادم؟

لا نسجل بيانات POST تلقائيًّا، ولكن يمكنك استخدام TrackTrace أو استدعاءات السجل. وضع بيانات POST في معلمة الرسالة. لا يمكنك التصفية على الرسالة بنفس الطريقة التي يمكنك بها التصفية على الخصائص، ولكن الحد الأقصى للحجم أطول.

لماذا لا يرجع بحث Azure Function أي نتائج؟

لا تسجل Azure Functions سلاسل استعلام URL.

تشخيص المعاملات

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

ما المقصود بالمكون؟

المكونات هي أجزاء موزعة بشكل مستقل من تطبيق الخدمات الموزعة أو الخدمات الصغيرة. لدى كل من المطورين وفرق العمليات رؤية على مستوى التعليمات البرمجية أو الوصول إلى القياس عن بعد الذي تم إنشاؤه باستخدام مكونات التطبيق هذه.

• تختلف المكونات عن التبعيات الخارجية "المرصودة"، مثل SQL ومراكز الأحداث، والتي قد لا يكون لفريقك أو مؤسستك حق الوصول إليها (التعليمات البرمجية أو بيانات تتبع الاستخدام).
• تشغيل المكونات على أي عدد من مثيلات الخادم أو الدور أو الحاوية.
• يمكن أن تكون المكونات مفاتيح أدوات Application Insights منفصلة، حتى إذا كانت الاشتراكات مختلفة. يمكن أن تكون المكونات أيضا أدوارا مختلفة تقوم بالإبلاغ إلى مفتاح تقرير عن حالة النظام في Application Insights واحد. تعرض التجربة الجديدة التفاصيل عبر جميع المكونات، بغض النظر عن كيفية إعدادها.

إشعار

هل تفتقد ارتباطات العناصر ذات الصلة؟ جميع بيانات تتبع الاستخدام ذات الصلة موجودة على الجانب الأيسر في القسمين العلوي والسفلى.

تجربة تشخيص المعاملات

تحتوي طريقة العرض هذه على أربعة أجزاء رئيسية:

• قائمة نتائج
• مخطط معاملات عبر المكونات
• قائمة بالتسلسل الزمني لجميع بيانات تتبع الاستخدام المتعلقة بهذه العملية
• جزء التفاصيل لأي عنصر محدد لبيانات تتبع الاستخدام

مخطط المعاملات عبر المكونات

يوفر هذا المخطط البياني خطًا زمنيًّا بأشرطة أفقية لمدة الطلبات والتبعيات عبر المكونات. يتم أيضًا تمييز أي استثناءات يتم جمعها في المخطط الزمني.

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

إشعار

تحتوي الاستدعاءات إلى مكونات أخرى على صفين. يمثل صف واحد المكالمة الصادرة (التبعية) من مكون المتصل. يتوافق الصف الآخر مع الطلب الوارد في المكون الذي تم استدعاؤه. تساعد الأيقونة البادئة والتصميم المميز لقضبان المدة على التمييز بينهما.

جميع بيانات تتبع الاستخدام عن بعد باستخدام معرف العملية

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

تفاصيل بيانات تتبع الاستخدام عن بعد المحدد

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

نتائج البحث

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

محلل ملفات التعريف ومصحح اللقطات

يساعد محلل ملفات تعريف Application Insights أو Snapshot Debugger في تشخيصات مستوى التعليمات البرمجية لمشكلات الأداء والفشل. باستخدام هذه التجربة، يمكنك مشاهدة تتبعات محلل ملفات التعريف أو لقطات من أي مكون مع تحديد واحد.

إذا لم تتمكن من تشغيل محلل ملفات التعريف، فاتصل ب serviceprofilerhelp@microsoft.com.

إذا لم تتمكن من تشغيل Snapshot Debugger، فاتصل ب snapshothelp@microsoft.com.

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

يقدم هذا القسم إجابات للأسئلة الشائعة.

لماذا أرى مكونا واحدا على المخطط وتظهر المكونات الأخرى فقط كتبعيات خارجية دون أي تفاصيل؟

الأسباب المحتملة:

• هل تم تجهيز المكونات الأخرى برؤى Application Insights
• هل يستخدمون أحدث إصدار مستقر من Application Insights SDK؟
• إذا كانت هذه المكونات موارد Application Insights منفصلة، فتحقق من أن لديك حق الوصول. إذا كان لديك حق الوصول وتم وضع الأدوات على المكونات باستخدام أحدث حزم SDK ل Application Insights، فقم بإعلامنا عبر قناة الملاحظات في الزاوية العلوية اليسرى.

أرى سجلات مكررة للتبعيات. هل هذا السلوك متوقع؟

حاليا، نعرض استدعاء التبعية الصادرة منفصلا عن الطلب الوارد. عادة، يبدو الاستدعاءان متطابقين مع اختلاف قيمة المدة فقط بسبب الرحلة ذهابا وإيابا للشبكة. تساعد الأيقونة البادئة والتصميم المميز لقضبان المدة على التمييز بينهما. هل هذا العرض التقديمي للبيانات مشكوك به؟ أعطنا تقييمك!

ماذا عن انحرافات الساعة عبر حالات المكون المختلفة؟

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

لماذا تفتقد التجربة الجديدة معظم استعلامات العناصر ذات الصلة؟

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

هل هناك طريقة لرؤية عدد أقل من الأحداث لكل معاملة عند استخدام Application Insights JavaScript SDK؟

تعرض تجربة تشخيص المعاملات جميع بيانات تتبع الاستخدام في عملية واحدة تشارك معرف العملية. بشكل افتراضي، تنشئ Application Insights SDK for JavaScript عملية جديدة لكل عرض صفحة فريد. في تطبيق من صفحة واحدة (SPA)، يتم إنشاء حدث عرض صفحة واحدة فقط ويتم استخدام معرف عملية واحد لجميع بيانات تتبع الاستخدام التي تم إنشاؤها. ونتيجة لذلك، قد ترتبط العديد من الأحداث بنفس العملية.

في هذه السيناريوهات، يمكنك استخدام "تتبع التوجيه التلقائي" لإنشاء عمليات جديدة للتنقل تلقائيا في SPA. يجب تشغيل enableAutoRouteTracking بحيث يتم إنشاء طريقة عرض صفحة في كل مرة يتم فيها تحديث مسار URL (تحدث طريقة عرض الصفحة المنطقية). إذا كنت تريد تحديث معرف العملية يدويا، فاتصل ب appInsights.properties.context.telemetryTrace.traceID = Microsoft.ApplicationInsights.Telemetry.Util.generateW3CId(). يؤدي تشغيل حدث PageView يدويا أيضا إلى إعادة تعيين معرف العملية.

لماذا لا تضيف مدد تفاصيل العمليات إلى مدة الطلب الأعلى؟

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

إن تم وضع علامة على جميع الاستدعاءات، في العملية هو السبب الجذري المحتمل للوقت المستغرق. أداة مفيدة لتشخيص المعالجة هي محلل ملفات تعريف Application Insights.

ماذا لو رأيت الرسالة خطأ في استرداد البيانات أثناء التنقل في Application Insights في مدخل Microsoft Azure؟

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

(راجع أيضًا )

• كتابة الاستعلامات المعقدة في التحليلات
• إرسال السجلات وبيانات تتبع الاستخدام المخصصة إلى Application Insights
• نظرة عامة على التوفر