نموذج بيانات سياق بيانات تتبع استخدام Application Insights
يرسل Application Insights بيانات تتبع الاستخدام من تطبيق الويب الخاص بك إلى مدخل Microsoft Azure بحيث يمكنك تحليل أداء التطبيق واستخدامه. نموذج بيانات تتبع الاستخدام موحد، لذلك من الممكن إنشاء مراقبة مستقلة عن النظام الأساسي واللغة.
البيانات التي تم جمعها بواسطة Application Insights نماذج نمط تنفيذ التطبيق النموذجي هذا.
تُستخدم الأنواع التالية من بيانات تتبع الاستخدام لمراقبة تنفيذ تطبيقك. تجمع Application Insights SDK من إطار عمل تطبيق الويب تلقائيا هذه الأنواع الثلاثة:
الطلب: تم إنشاؤه لتسجيل طلب تلقاه تطبيقك. على سبيل المثال، تُنشئ Application Insights web SDK تلقائيًا عنصر طلب تتبع عن بُعد لكل طلب HTTP يتلقاها تطبيق الويب الخاص بك.
تتكون العملية من مؤشرات ترابط التنفيذ التي تعالج طلبا. يمكنك أيضا كتابة التعليمات البرمجية لمراقبة أنواع أخرى من العمليات، مثل "التنبيه" في مهمة ويب أو وظيفة تقوم بمعالجة البيانات بشكل دوري. كل عملية لها معرف. يمكن استخدام المعرف لتجميع جميع بيانات تتبع الاستخدام التي تم إنشاؤها أثناء معالجة التطبيق للطلب. كل عملية إما تنجح أو تفشل ولها مدة زمنية.
الاستثناء: يمثل عادة استثناء يؤدي إلى فشل عملية.
التبعية: تمثل مكالمة من تطبيقك إلى خدمة خارجية أو تخزين خارجي، مثل واجهة برمجة تطبيقات REST أو SQL. في ASP.NET، يتم تعريف استدعاءات التبعية إلى SQL بواسطة
System.Data. يتم تعريف المكالمات إلى نقاط نهاية HTTP بواسطةSystem.Net.
يوفر Application Insights ثلاثة أنواع بيانات لبيانات تتبع الاستخدام المخصصة:
- التتبع: يستخدم إما مباشرة أو من خلال محول لتنفيذ تسجيل التشخيص باستخدام إطار عمل الأجهزة المألوف لك، مثل
Log4NetأوSystem.Diagnostics. - الحدث: يستخدم عادة لتسجيل تفاعل المستخدم مع خدمتك لتحليل أنماط الاستخدام.
- القياس: يستخدم للإبلاغ عن القياسات العددية الدورية.
يمكن لكل عنصر بيانات تتبع الاستخدام تحديد معلومات السياق مثل إصدار التطبيق أو معرف جلسة المستخدم. السياق عبارة عن مجموعة من الحقول التي تم كتابتها بقوة والتي تقوم بإلغاء حظر سيناريوهات معينة. عند تهيئة إصدار التطبيق بشكل صحيح، يمكن لـApplication Insights اكتشاف الأنماط الجديدة في سلوك التطبيق المرتبط بإعادة النشر.
يمكنك استخدام معرف جلسة العمل لحساب انقطاع أو تأثير مشكلة على المستخدمين. يمنحك حساب العدد المميز لقيم معرف جلسة العمل لتبعية فاشلة معينة أو تتبع الأخطاء أو استثناء هام فهما جيدا للتأثير.
يحدد نموذج بيانات تتبع الاستخدام Application Insights طريقة لربط بيانات تتبع الاستخدام بالعملية التي يكون جزءا منها. على سبيل المثال، يمكن لطلب إجراء استدعاء قاعدة بيانات SQL وتسجيل معلومات التشخيص. يمكنك تعيين سياق الارتباط لعناصر القياس عن بُعد التي تربطه مرة أخرى بقياس بيانات تتبع الاستخدام.
تحسينات المخطط
نموذج بيانات Application Insights هو طريقة أساسية ولكنها قوية لنمذجة بيانات تتبع الاستخدام للتطبيق الخاص بك. نحن نسعى جاهدين للحفاظ على النموذج بسيطا ونحيلا لدعم السيناريوهات الأساسية والسماح بتوسيع المخطط للاستخدام المتقدم.
للإبلاغ عن مشاكل واقتراحات نموذج البيانات أو المخطط، استخدم مستودع GitHub الخاص بنا.
طلب
يمثل عنصر القياس عن بعد للطلب في Application Insights التسلسل المنطقي للتنفيذ الذي تم تشغيله بواسطة طلب خارجي إلى التطبيق الخاص بك. يتم تحديد كل تنفيذ طلب بواسطة فريد id ويحتوي url على جميع معلمات التنفيذ.
يمكنك تجميع الطلبات حسب name منطقي وتحديد source لهذا الطلب. يمكن أن يؤدي تنفيذ التعليمات البرمجية إلى success أو fail وقد يكون لها duration معين. يمكنك تجميع عمليات تنفيذ النجاح والفشل باستخدام resultCode. يتم تحديد وقت البدء لبيانات تتبع الاستخدام للطلب على مستوى المغلف.
يدعم القياس عن بعد للطلب نموذج القابلية للتوسعة القياسي باستخدام مخصص properties و measurements.
إشعار
في 31 مارس 2025، سينتهي دعم إدخال مفاتيح الأجهزة. سيستمر استيعاب مفتاح الأجهزة في العمل ولكننا لن نقوم بتوفير تحديثات أو أي دعم للميزة. الانتقال إلى سلاسل الاتصال للاستفادة من الإمكانات الجديدة.
الاسم
هذا الحقل هو اسم الطلب ويمثل مسار التعليمات البرمجية المأخوذ لمعالجة الطلب. تسمح القيمة الأساسية المنخفضة بتجميع الطلبات بشكل أفضل. بالنسبة لطلبات HTTP، فإنه يمثل أسلوب HTTP وقالب مسار URL مثل GET /values/{id} بدون القيمة الفعلية id .
يرسل Application Insights web SDK اسم طلب "كما هو" حول حالة الرسالة. التجميع على واجهة المستخدم حساس لحالة الأحرف، لذلك GET /Home/Index يتم حسابه بشكل منفصل عن على الرغم من GET /home/INDEX أنه غالبا ما يؤدي إلى نفس وحدة التحكم وتنفيذ الإجراء. والسبب في ذلك هو أن عناوين URL بشكل عام حساسة لحالة الأحرف. قد ترغب في معرفة ما إذا كانت جميع 404 الأخطاء قد حدثت لعناوين URL مكتوبة بأحرف كبيرة. يمكنك قراءة المزيد حول مجموعة أسماء الطلبات بواسطة ASP.NET web SDK في منشور المدونة.
الحد الأقصى للطول: 1024 حرفا
بطاقة تعريف
المعرف هو معرف مثيل استدعاء الطلب. يتم استخدامه للارتباط بين الطلب وعناصر بيانات تتبع الاستخدام الأخرى. يجب أن يكون المعرف فريدا عالميا. لمزيد من المعلومات، راجع ارتباط بيانات تتبع الاستخدام في Application Insights.
الحد الأقصى للطول: 128 حرفا
عنوان URL
عنوان URL هو عنوان URL للطلب مع جميع معلمات سلسلة الاستعلام.
الحد الأقصى للطول: 2048 حرفا
المصدر
المصدر هو مصدر الطلب. ومن الأمثلة على ذلك مفتاح تقرير عن حالة النظام للمتصل أو عنوان IP للمتصل. لمزيد من المعلومات، راجع ارتباط بيانات تتبع الاستخدام في Application Insights.
الحد الأقصى للطول: 1024 حرفا
المدة
يتم تنسيق مدة الطلب ك DD.HH:MM:SS.MMMMMM. يجب أن تكون إيجابية وأقل من 1000 أيام. هذا الحقل مطلوب لأن بيانات تتبع الاستخدام للطلب تمثل العملية مع البداية والنهاية.
الاستجابة للتعليمة البرمجية
رمز الاستجابة هو نتيجة تنفيذ طلب. إنه رمز حالة HTTP لطلبات HTTP. قد تكون HRESULT قيمة أو نوع استثناء لنوع الطلبات الأخرى.
الحد الأقصى للطول: 1024 حرفا
نجاح
يشير النجاح إلى ما إذا كانت المكالمة ناجحة أو غير ناجحة. هذا الحقل مطلوب. عندما لا يتم تعيين طلب بشكل صريح إلى false، فإنه يعتبر ناجحا. إذا قام استثناء أو إرجاع رمز نتيجة خطأ بمقاطعة العملية، فقم بتعيين هذه القيمة إلى false.
بالنسبة لتطبيقات الويب، يعرف Application Insights الطلب على أنه ناجح عندما يكون رمز الاستجابة أقل من 400 أو يساوي 401. ومع ذلك، هناك حالات لا يتطابق فيها هذا التعيين الافتراضي مع دلالات التطبيق.
قد تشير التعليمات البرمجية 404 للاستجابة إلى "لا توجد سجلات"، والتي يمكن أن تكون جزءا من التدفق العادي. قد يشير أيضا إلى ارتباط مقطوع. بالنسبة للارتباطات المقطوعة، يمكنك تنفيذ منطق أكثر تقدما. يمكنك وضع علامة على الارتباطات المقطوعة على أنها حالات فشل فقط عندما تكون هذه الارتباطات موجودة على نفس الموقع عن طريق تحليل محيل عنوان URL. أو يمكنك وضع علامة عليها على أنها حالات فشل عند الوصول إليها من تطبيق الشركة للأجهزة المحمولة. وبالمثل، 301 والإشارة 302 إلى الفشل عند الوصول إليها من العميل الذي لا يدعم إعادة التوجيه.
قد يشير المحتوى 206 المقبول جزئيا إلى فشل طلب شامل. على سبيل المثال، قد تتلقى نقطة نهاية Application Insights دفعة من عناصر بيانات تتبع الاستخدام كطلب واحد. يتم إرجاعه 206 عندما لا تتم معالجة بعض العناصر في الدفعة بنجاح. يشير معدل متزايد من 206 إلى مشكلة تحتاج إلى التحقيق. ينطبق منطق مماثل على 207 Multi-Status، حيث قد يكون النجاح أسوأ رموز الاستجابة المنفصلة.
الخصائص المخصصة
مجموعة قيمة الاسم للخصائص المخصصة: تستخدم هذه المجموعة لتوسيع بيانات تتبع الاستخدام القياسية مع الأبعاد المخصصة. ومن الأمثلة على ذلك فتحة التوزيع التي أنتجت بيانات تتبع الاستخدام أو الخاصية الخاصة بعنصر بيانات تتبع الاستخدام مثل رقم الطلب.
- الحد الأقصى لطول المفتاح: 150
- الحد الأقصى لطول القيمة: 8192
القياسات المخصصة
مجموعة القياسات المخصصة: استخدم هذه المجموعة للإبلاغ عن القياسات المسماة المقترنة بعنصر القياس عن بعد. حالات الاستخدام النموذجية هـي:
- حجم حمولة بيانات تتبع الاستخدام للتبعية.
- عدد عناصر قائمة الانتظار التي تمت معالجتها عن طريق طلب بيانات تتبع الاستخدام.
- الوقت الذي استغرقه العميل لإنهاء خطوة المعالج لإكمال بيانات تتبع الاستخدام للحدث.
يمكنك الاستعلام عـن القياسات المخصصة في Application Analytics:
customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)
إشعار
- ترتبط القياسات المُخصصة ببيانات تتبع الاستخدام الذي تنتمي إليه. يخضعون لأخذ العينات باستخدام عنصر بيانات تتبع الاستخدام الذي يحتوي على تلك القياسات. لتعقب قياس له قيمة مستقلة عن أنواع بيانات تتبع الاستخدام الأخرى، استخدم القياس عن بعد القياسي.
- لا تستخدم قيم السلسلة للقياسات المخصصة. يتم اعتماد القيم الرقمية فقط.
الحد الأقصى لطول المفتاح: 150
Dependency
يمثل القياس عن بعد للتبعية (في Application Insights) تفاعلا للمكون المراقب مع مكون بعيد مثل SQL أو نقطة نهاية HTTP.
الاسم
هذا الحقل هو اسم الأمر الذي تم بدؤه باستدعاء التبعية هذا. له قيمة أساسية منخفضة. الأمثلة هي اسم الإجراء المخزن وقالب مسار URL.
بطاقة تعريف
المعرف هو معرف مثيل استدعاء التبعية. يتم استخدامه للارتباط بعنصر القياس عن بعد للطلب الذي يتوافق مع استدعاء التبعية هذا. لمزيد من المعلومات، راجع ارتباط بيانات تتبع الاستخدام في Application Insights.
بيانات
هذا الحقل هو الأمر الذي بدأه استدعاء التبعية هذا. الأمثلة هي SQL العبارة وعنوان URL HTTP مع كافة معلمات الاستعلام.
نوع
هذا الحقل هو اسم نوع التبعية. لديها قيمة أساسية منخفضة للتصنفين المنطقي للتبعيات وتفسير الحقول الأخرى مثل commandName و resultCode. ومن الأمثلة على ذلك SQL وجدول Azure وHTTP.
استهداف
هذا الحقل هو الموقع الهدف لاستدعاء تبعية. ومن الأمثلة على ذلك اسم الخادم وعنوان المضيف. لمزيد من المعلومات، راجع ارتباط بيانات تتبع الاستخدام في Application Insights.
المدة
مدة الطلب بالتنسيق DD.HH:MM:SS.MMMMMM. يجب أن يكون أقل من 1000 أيام.
رمز النتيجة
هذا الحقل هو رمز النتيجة لاستدعاء تبعية. ومن الأمثلة على ذلك رمز الخطأ SQL ورمز حالة HTTP.
نجاح
هذا الحقل هو إشارة إلى مكالمة ناجحة أو غير ناجحة.
الخصائص المخصصة
مجموعة قيمة الاسم للخصائص المخصصة: تستخدم هذه المجموعة لتوسيع بيانات تتبع الاستخدام القياسية مع الأبعاد المخصصة. ومن الأمثلة على ذلك فتحة التوزيع التي أنتجت بيانات تتبع الاستخدام أو الخاصية الخاصة بعنصر بيانات تتبع الاستخدام مثل رقم الطلب.
- الحد الأقصى لطول المفتاح: 150
- الحد الأقصى لطول القيمة: 8192
القياسات المخصصة
مجموعة القياسات المخصصة: استخدم هذه المجموعة للإبلاغ عن القياسات المسماة المقترنة بعنصر القياس عن بعد. حالات الاستخدام النموذجية هـي:
- حجم حمولة بيانات تتبع الاستخدام للتبعية.
- عدد عناصر قائمة الانتظار التي تمت معالجتها عن طريق طلب بيانات تتبع الاستخدام.
- الوقت الذي استغرقه العميل لإنهاء خطوة المعالج لإكمال بيانات تتبع الاستخدام للحدث.
يمكنك الاستعلام عـن القياسات المخصصة في Application Analytics:
customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)
إشعار
- ترتبط القياسات المُخصصة ببيانات تتبع الاستخدام الذي تنتمي إليه. يخضعون لأخذ العينات باستخدام عنصر بيانات تتبع الاستخدام الذي يحتوي على تلك القياسات. لتعقب قياس له قيمة مستقلة عن أنواع بيانات تتبع الاستخدام الأخرى، استخدم القياس عن بعد القياسي.
- لا تستخدم قيم السلسلة للقياسات المخصصة. يتم اعتماد القيم الرقمية فقط.
الحد الأقصى لطول المفتاح: 150
الاستثناء
في Application Insights، يمثل مثيل الاستثناء استثناء تمت معالجته أو لم تتم معالجته الذي حدث أثناء تنفيذ التطبيق المراقب.
معرف المشكلة
يحدد معرف المشكلة مكان طرح الاستثناء في التعليمات البرمجية. يتم استخدامه لتجميع الاستثناءات. عادة ما يكون مزيجا من نوع استثناء ودالة من مكدس الاستدعاءات.
الحد الأقصى للطول: 1024 حرفا
مستوى الخطورة
هذا الحقل هو مستوى خطورة التتبع. يمكن أن تكون Verboseالقيمة أو InformationWarningأو Errorأو أو .Critical
تفاصيل الاستثناءات
(يتم تمديده)
الخصائص المخصصة
مجموعة قيمة الاسم للخصائص المخصصة: تستخدم هذه المجموعة لتوسيع بيانات تتبع الاستخدام القياسية مع الأبعاد المخصصة. ومن الأمثلة على ذلك فتحة التوزيع التي أنتجت بيانات تتبع الاستخدام أو الخاصية الخاصة بعنصر بيانات تتبع الاستخدام مثل رقم الطلب.
- الحد الأقصى لطول المفتاح: 150
- الحد الأقصى لطول القيمة: 8192
القياسات المخصصة
مجموعة القياسات المخصصة: استخدم هذه المجموعة للإبلاغ عن القياسات المسماة المقترنة بعنصر القياس عن بعد. حالات الاستخدام النموذجية هـي:
- حجم حمولة بيانات تتبع الاستخدام للتبعية.
- عدد عناصر قائمة الانتظار التي تمت معالجتها عن طريق طلب بيانات تتبع الاستخدام.
- الوقت الذي استغرقه العميل لإنهاء خطوة المعالج لإكمال بيانات تتبع الاستخدام للحدث.
يمكنك الاستعلام عـن القياسات المخصصة في Application Analytics:
customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)
إشعار
- ترتبط القياسات المُخصصة ببيانات تتبع الاستخدام الذي تنتمي إليه. يخضعون لأخذ العينات باستخدام عنصر بيانات تتبع الاستخدام الذي يحتوي على تلك القياسات. لتعقب قياس له قيمة مستقلة عن أنواع بيانات تتبع الاستخدام الأخرى، استخدم القياس عن بعد القياسي.
- لا تستخدم قيم السلسلة للقياسات المخصصة. يتم اعتماد القيم الرقمية فقط.
الحد الأقصى لطول المفتاح: 150
Trace
يمثل printfتتبع تتبع الاستخدام في Application Insights عبارات تتبع النمط التي يتم البحث فيها عن النص. تتم ترجمة الإدخالات Log4Net وNLog، وكذلك إدخالات ملفات السجل الأخرى المستندة إلى النصوص إلى مثيلات من هذا النوع. لا يحتوي التتبع على قياسات على أنها قابلة للتوسعة.
رسالة
تتبع الرسالة.
الحد الأقصى للطول: 32768 حرفا
مستوى الخطورة
تتبع مستوى الخطورة.
القيم: Verboseو InformationWarningو ErrorCritical
الخصائص المخصصة
مجموعة قيمة الاسم للخصائص المخصصة: تستخدم هذه المجموعة لتوسيع بيانات تتبع الاستخدام القياسية مع الأبعاد المخصصة. ومن الأمثلة على ذلك فتحة التوزيع التي أنتجت بيانات تتبع الاستخدام أو الخاصية الخاصة بعنصر بيانات تتبع الاستخدام مثل رقم الطلب.
- الحد الأقصى لطول المفتاح: 150
- الحد الأقصى لطول القيمة: 8192
الحدث
يمكنك إنشاء عناصر بيانات تتبع الاستخدام للأحداث (في Application Insights) لتمثيل حدث وقع في التطبيق الخاص بك. عادة ما يكون تفاعل المستخدم مثل النقر فوق زر أو سحب طلب. يمكن أن يكون أيضا حدث دورة حياة التطبيق مثل التهيئة أو تحديث التكوين.
من الناحية الدلالية، قد تكون الأحداث مرتبطة بالطلبات أو قد لا تكون مرتبطة بها. إذا تم استخدامه بشكل صحيح، فإن بيانات تتبع الاستخدام للحدث أكثر أهمية من الطلبات أو التتبعات. تمثل الأحداث بيانات تتبع الاستخدام للأعمال ويجب أن تخضع لأخذ عينات منفصلة وأقل عدوانية.
الاسم
اسم الحدث: للسماح بالت تجميع مناسب ومقاييس مفيدة، قم بتقييد التطبيق الخاص بك بحيث يقوم بإنشاء بعض أسماء الأحداث المنفصلة. على سبيل المثال، لا تستخدم اسمًا منفصلًا لكل مثيل أُنشئ لحدث ما.
الحد الأقصى للطول: 512 حرفا
الخصائص المخصصة
مجموعة قيمة الاسم للخصائص المخصصة: تستخدم هذه المجموعة لتوسيع بيانات تتبع الاستخدام القياسية مع الأبعاد المخصصة. ومن الأمثلة على ذلك فتحة التوزيع التي أنتجت بيانات تتبع الاستخدام أو الخاصية الخاصة بعنصر بيانات تتبع الاستخدام مثل رقم الطلب.
- الحد الأقصى لطول المفتاح: 150
- الحد الأقصى لطول القيمة: 8192
القياسات المخصصة
مجموعة القياسات المخصصة: استخدم هذه المجموعة للإبلاغ عن القياسات المسماة المقترنة بعنصر القياس عن بعد. حالات الاستخدام النموذجية هـي:
- حجم حمولة بيانات تتبع الاستخدام للتبعية.
- عدد عناصر قائمة الانتظار التي تمت معالجتها عن طريق طلب بيانات تتبع الاستخدام.
- الوقت الذي استغرقه العميل لإنهاء خطوة المعالج لإكمال بيانات تتبع الاستخدام للحدث.
يمكنك الاستعلام عـن القياسات المخصصة في Application Analytics:
customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)
إشعار
- ترتبط القياسات المُخصصة ببيانات تتبع الاستخدام الذي تنتمي إليه. يخضعون لأخذ العينات باستخدام عنصر بيانات تتبع الاستخدام الذي يحتوي على تلك القياسات. لتعقب قياس له قيمة مستقلة عن أنواع بيانات تتبع الاستخدام الأخرى، استخدم القياس عن بعد القياسي.
- لا تستخدم قيم السلسلة للقياسات المخصصة. يتم اعتماد القيم الرقمية فقط.
الحد الأقصى لطول المفتاح: 150
Metric
يدعم Application Insights نوعين من القياس عن بعد القياسي: القياس الفردي والمقياس المجمع مسبقا. القياس الفردي هو مجرد اسم وقيمة. يحدد المقياس المجمع مسبقا الحد الأدنى والحد الأقصى لقيمة المقياس في الفاصل الزمني للتجميع والانحراف المعياري له.
يفترض القياس عن بعد القياسي المجمع مسبقا أن فترة التجميع كانت دقيقة واحدة.
يدعم Application Insights العديد من أسماء المقاييس المعروفة. يتم وضع هذه المقاييس في performanceCounters الجدول.
يعرض الجدول التالي المقاييس التي تمثل عدادات النظام والعملية.
| اسم الشبكة. | اسم النظام الأساسي غير محدد | الوصف |
|---|---|---|
\Processor(_Total)\% Processor Time |
جار العمل... | إجمالي وحدة المعالجة المركزية للجهاز. |
\Memory\Available Bytes |
جار العمل... | إظهار مقدار الذاكرة الفعلية بالبايت المتوفرة للعمليات التي تعمل على الكمبيوتر. يتم حسابه عن طريق جمع مقدار المساحة على قوائم الذاكرة الصفرية والخالية والاستعدادية. الذاكرة الحرة جاهزة للاستخدام. تتكون الذاكرة الصفرية من صفحات ذاكرة مليئة بالأصفار لمنع العمليات اللاحقة من رؤية البيانات المستخدمة من قبل عملية سابقة. ذاكرة الاستعداد هي الذاكرة التي تمت إزالتها من مجموعة عمل العملية (ذاكرتها الفعلية) في الطريق إلى القرص ولكنها لا تزال متاحة لاسترجاعها. راجع عنصر الذاكرة. |
\Process(??APP_WIN32_PROC??)\% Processor Time |
جار العمل... | وحدة المعالجة المركزية للعملية التي تستضيف التطبيق. |
\Process(??APP_WIN32_PROC??)\Private Bytes |
جار العمل... | الذاكرة المستخدمة من قبل العملية التي تستضيف التطبيق. |
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec |
جار العمل... | معدل عمليات الإدخال/الإخراج التي تشغلها العملية التي تستضيف التطبيق. |
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec |
جار العمل... | معدل الطلبات التي تتم معالجتها بواسطة أحد التطبيقات. |
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec |
جار العمل... | معدل الاستثناءات التي يطرحها أحد التطبيقات. |
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time |
جار العمل... | متوسط وقت تنفيذ الطلب. |
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue |
جار العمل... | عدد الطلبات التي تنتظر المعالجة في قائمة انتظار. |
لمزيد من المعلومات حول Metrics REST API، راجع Metrics - Get.
الاسم
هذا الحقل هو اسم المقياس الذي تريد رؤيته في مدخل Application Insights وواجهة المستخدم.
القيمة
هذا الحقل هو القيمة الفردية للقياس. إنه مجموع القياسات الفردية للتجميع.
عدد
هذا الحقل هو الوزن المتري للمقياس المجمع. لا ينبغي تعيينه للقياس.
Min
هذا الحقل هو الحد الأدنى لقيمة المقياس المجمع. لا ينبغي تعيينه للقياس.
الحد الأقصى
هذا الحقل هو الحد الأقصى لقيمة المقياس المجمع. لا ينبغي تعيينه للقياس.
الانحراف المعياري
هذا الحقل هو الانحراف المعياري للمقياس المجمع. لا ينبغي تعيينه للقياس.
الخصائص المخصصة
يشير المقياس مع تعيين الخاصية CustomPerfCounter المخصصة إلى true أن المقياس يمثل عداد أداء Windows. يتم وضع هذه المقاييس في performanceCounters الجدول، وليس في customMetrics. أيضا، يتم تحليل اسم هذا المقياس لاستخراج أسماء الفئة والعداد والمثيل.
مجموعة قيمة الاسم للخصائص المخصصة: تستخدم هذه المجموعة لتوسيع بيانات تتبع الاستخدام القياسية مع الأبعاد المخصصة. ومن الأمثلة على ذلك فتحة التوزيع التي أنتجت بيانات تتبع الاستخدام أو الخاصية الخاصة بعنصر بيانات تتبع الاستخدام مثل رقم الطلب.
- الحد الأقصى لطول المفتاح: 150
- الحد الأقصى لطول القيمة: 8192
pageView
يتم تسجيل PageView Telemetry (في Application Insights) عندما يفتح مستخدم تطبيق صفحة جديدة من تطبيق مراقب. Page في هذا السياق هي وحدة منطقية يحددها المطور لتكون علامة تبويب تطبيق أو شاشة ولا ترتبط بالضرورة بتحميل صفحة ويب مستعرض أو إجراء تحديث. يمكن فهم هذا التمييز بشكل أكبر في سياق التطبيقات أحادية الصفحة (SPAs)، حيث لا يرتبط التبديل بين الصفحات بإجراءات صفحة المستعرض. pageViews.duration هو الوقت الذي يستغرقه التطبيق لتقديم الصفحة للمستخدم.
إشعار
- بشكل افتراضي، يسجل Application Insights SDKs أحداثا فردية
PageViewعلى كل إجراء تحميل صفحة ويب للمستعرض، معpageViews.durationملء توقيت المستعرض. يمكن للمطورين توسيع تعقب إضافي للأحداثPageViewباستخدام استدعاء واجهة برمجة تطبيقات trackPageView. - الاحتفاظ بالسجلات الافتراضي هو 30 يوما. إذا كنت تريد عرض
PageViewالإحصائيات على مدى فترة زمنية أطول، يجب ضبط الإعداد.
قياس browserTiming في Application Insights
المستعرضات الحديثة تعرض قياسات لإجراءات تحميل الصفحة باستخدام واجهة برمجة تطبيقات الأداء. Application Insights يبسط هذه القياسات من خلال دمج التوقيتات ذات الصلة في مقاييس المتصفح القياسية كما هو محدد من خلال تعريفات وقت المعالجة هذه:
العميل <-> DNS: يصل العميل إلى DNS لحل اسم مضيف موقع الويب، ويستجيب DNS بعنوان IP.
Client <--> Web Server: ينشئ العميل TCP ثم يصافح TLS مع خادم الويب.
Client <--> Web Server: يرسل العميل حمولة الطلب، وينتظر الخادم لتنفيذ الطلب، ويتلقى حزمة الاستجابة الأولى.
Client <--Web Server: يتلقى العميل بقية وحدات بايت حمولة الاستجابة من خادم الويب.
العميل: العميل لديه الآن حمولة استجابة كاملة ولديه لعرض المحتويات في المتصفح وتحميل DOM.
browserTimings/networkDuration= #1 + #2browserTimings/sendDuration= #3browserTimings/receiveDuration= #4browserTimings/processingDuration= #5browsertimings/totalDuration= #1 + #2 + #3 + #4 + #5pageViews/durationالمدة
PageViewمن واجهة توقيت أداء المتصفح،PerformanceNavigationTiming.duration.إذا كان
PerformanceNavigationTimingمتوفرا، يتم استخدام هذه المدة.إذا لم يكن الأمر كذلك، يتم استخدام الواجهة المهملة
PerformanceTimingويتم حساب دلتا بينNavigationStartوLoadEventEnd.يحدد المطور قيمة مدة عند تسجيل الأحداث المخصصة
PageViewباستخدام استدعاء واجهة برمجة تطبيقات trackPageView.
السياق
قد يكون لكل عنصر بيانات تتبع الاستخدام حقل سياق مكتوب بقوة. يتيح كل حقل سيناريو محدد للمراقبة. استخدم مجموعة الخصائص المخصصة لتخزين معلومات سياقية مخصصة أو خاصة بالتطبيق.
إصدار التطبيق
تكون المعلومات في حقول سياق التطبيق دائما حول التطبيق الذي يرسل بيانات تتبع الاستخدام. يتم استخدام إصدار التطبيق لتحليل تغييرات الاتجاه في سلوك التطبيق وارتباطه إلى عمليات النشر.
الحد الأقصى للطول: 1,024
عنوان IP للعميل
هذا الحقل هو عنوان IP لجهاز العميل. يتم دعم كل من IPv4 وIPv6. عند إرسال بيانات تتبع الاستخدام من خدمة، يكون سياق الموقع حول المستخدم الذي بدأ العملية في الخدمة. يقوم Application Insights باستخراج معلومات الموقع الجغرافي من عنوان IP الخاصة بالعميل ثم اقتطاعه بعد ذلك. لا يمكن استخدام IP العميل في حد ذاته كمعلومات تعريف المستخدم.
الحد الأقصى للطول: 46
نوع الجهاز
في الأصل، تم استخدام هذا الحقل للإشارة إلى نوع الجهاز الذي يستخدمه مستخدم التطبيق. اليوم يتم استخدامه بشكل أساسي لتمييز بيانات تتبع الاستخدام JavaScript مع نوع Browser الجهاز من بيانات تتبع الاستخدام من جانب الخادم مع نوع PCالجهاز .
الحد الأقصى للطول: 64
معرف العملية
هذا الحقل هو المعرف الفريد لعملية الجذر. يسمح هذا المعرف بتجميع بيانات تتبع الاستخدام عبر العديد من المكونات. لمزيد من المعلومات، راجع ارتباط بيانات تتبع الاستخدام. إما أن الطلب أو طريقة عرض الصفحة تنشئ معرف العملية. تقوم جميع بيانات تتبع الاستخدام الأخرى بتعيين هذا الحقل إلى قيمة الطلب أو عرض الصفحة التي تحتوي على العملية.
الحد الأقصى للطول: 128
معرف العملية الأصلية
هذا الحقل هو المعرف الفريد للأصل المباشر لعنصر بيانات تتبع الاستخدام. لمزيد من المعلومات، راجع ارتباط بيانات تتبع الاستخدام.
الحد الأقصى للطول: 128
اسم العملية
هذا الحقل هو اسم (مجموعة) العملية. ينشئ طلب أو طريقة عرض صفحة اسم العملية. تقوم جميع عناصر بيانات تتبع الاستخدام الأخرى بتعيين هذا الحقل إلى القيمة الخاصة بالطلب أو عرض الصفحة التي تحتوي على العملية. يتم استخدام اسم العملية للعثور على جميع عناصر بيانات تتبع الاستخدام لمجموعة من العمليات (على سبيل المثال، GET Home/Index). يتم استخدام خاصية السياق هذه للإجابة عن أسئلة مثل ما هي الاستثناءات النموذجية التي تم طرحها في هذه الصفحة؟
الحد الأقصى للطول: 1,024
المصدر الاصطناعي للعملية
هذا الحقل هو اسم المصدر الاصطناعي. قد تمثل بعض بيانات تتبع الاستخدام من التطبيق نسبة استخدام الشبكة الاصطناعية. قد يكون متتبع ارتباطات الويب الذي يقوم بفهرسة موقع الويب أو اختبارات توفر الموقع أو التتبعات من مكتبات التشخيص مثل Application Insights SDK نفسه.
الحد الأقصى للطول: 1,024
معرف جلسة العمل:
معرف جلسة العمل هو مثيل تفاعل المستخدم مع التطبيق. المعلومات في حقول سياق جلسة العمل هي دائما حول المستخدم. عند إرسال بيانات تتبع الاستخدام من خدمة، يكون سياق الجلسة حول المستخدم الذي بدأ العملية في الخدمة.
الحد الأقصى للطول: 64
معرف مستخدم مجهول
يمثل معرف المستخدم المجهول (User.Id) مستخدم التطبيق. عند إرسال بيانات تتبع الاستخدام من خدمة، يكون سياق المستخدم حول المستخدم الذي بدأ العملية في الخدمة.
أخذ العينات هي واحدة من التقنيات التي تقلل من مقدار بيانات تتبع الاستخدام المُجمعة. تحاول خوارزمية أخذ العينات إما أخذ عينة من جميع بيانات تتبع الاستخدام المرتبطة أو خارجها. يتم استخدام معرف مستخدم مجهول لإنشاء نقاط أخذ العينات، لذلك يجب أن يكون معرف المستخدم المجهول قيمة عشوائية كافية.
إشعار
عدد معرفات المستخدمين المجهولين ليس هو نفسه عدد مستخدمي التطبيق الفريدين. عادة ما يكون عدد معرفات المستخدمين المجهولين أعلى لأنه في كل مرة يفتح فيها المستخدم تطبيقك على جهاز أو مستعرض مختلف، أو ينظف ملفات تعريف ارتباط المستعرض، يتم تخصيص معرف مستخدم مجهول فريد جديد. قد يؤدي هذا الحساب إلى حساب نفس المستخدمين الفعليين عدة مرات.
يمكن الرجوع إلى معرفات المستخدم مع معرفات الجلسة لتوفير أبعاد بيانات تتبع الاستخدام الفريدة وإنشاء نشاط المستخدم على مدار مدة الجلسة.
يعد استخدام معرف مستخدم مجهول لتخزين اسم مستخدم إساءة استخدام للحقل. استخدم معرف مستخدم مصادق عليه.
الحد الأقصى للطول: 128
معرف المستخدم المصدّق عليه
معرف المستخدم المصادق عليه هو عكس معرف مستخدم مجهول. يمثل هذا الحقل المستخدم باسم مألوف. يُجمع هذا المعرف بشكل افتراضي باستخدام AuthenticatedUserIdTelemetryInitializer الخاص بـ ASP.NET Framework SDK.
استخدم Application Insights SDK لتهيئة معرف المستخدم المصادق عليه بقيمة تحدد المستخدم باستمرار عبر المتصفحات والأجهزة. وبهذه الطريقة، تنسب جميع عناصر بيانات تتبع الاستخدام إلى هذا المعرف الفريد. يتيح هذا المعرف الاستعلام عن جميع بيانات تتبع الاستخدام التي تم جمعها لمستخدم معين (رهناً بـ أشكال أخذ العينات وتصفية بيانات تتبع الاستخدام).
يمكن الرجوع إلى معرفات المستخدم مع معرفات الجلسة لتوفير أبعاد بيانات تتبع الاستخدام الفريدة وإنشاء نشاط المستخدم على مدار مدة الجلسة.
الحد الأقصى للطول: 1,024
معرف الحساب
معرف الحساب، في التطبيقات متعددة المستأجرين، هو معرف حساب المستأجر أو الاسم الذي يعمل به المستخدم. يتم استخدامه لمزيد من تجزئة المستخدم عندما لا يكون معرف المستخدم ومعرف المستخدم المصادق عليه كافيين. قد تكون الأمثلة على ذلك معرف اشتراك لمدخل Azure أو اسم المدونة للنظام الأساسي للتدوين.
الحد الأقصى للطول: 1,024
دور شبكة النظير
هذا الحقل هو اسم الدور الذي يكون التطبيق جزءا منه. يتم تعيينه مباشرة إلى اسم الدور في Azure. كما يمكن استخدامه لتمييز الخدمات المصغرة، والتي تعد جزءا من تطبيق واحد.
الحد الأقصى للطول: 256
مثيل دور السحابة
هذا الحقل هو اسم المثيل حيث يتم تشغيل التطبيق. على سبيل المثال، إنه اسم الكمبيوتر المحلي أو اسم المثيل ل Azure.
الحد الأقصى للطول: 256
داخلي: إصدار SDK
لمزيد من المعلومات، راجع إصدار SDK.
الحد الأقصى للطول: 64
داخلي: اسم العقدة
يمثل هذا الحقل اسم العقدة المستخدم في أغراض الفوترة. استخدمه لتجاوز الكشف القياسي عن العقد.
الحد الأقصى للطول: 256
الأسئلة الشائعة
يقدم هذا القسم إجابات للأسئلة الشائعة.
كيف يمكنني قياس تأثير حملة المراقبة؟
يتضمن القياس عن بعد PageView عنوان URL ويمكنك تحليل معلمة UTM باستخدام دالة regex في Kusto.
في بعض الأحيان، قد تكون هذه البيانات مفقودة أو غير دقيقة إذا عطل المستخدم أو المؤسسة إرسال عامل المستخدم في إعدادات المستعرض. قد لا تتضمن سجلات محلل UA جميع معلومات الجهاز. أو ربما لم تعتمد Application Insights آخر التحديثات.
لماذا ينجح القياس المخصص دون خطأ ولكن السجل لا يظهر؟
يمكن أن يحدث هذا إذا كنت تستخدم قيم السلسلة. تعمل القيم الرقمية فقط مع القياسات المخصصة.
الخطوات التالية
تعرف على كيفية استخدام واجهة برمجة تطبيقات Application Insights للأحداث والمقاييس المخصصة، بما في ذلك:
- بيانات تتبع الاستخدام للطلب المخصص
- القياس عن بعد للتبعية المخصصة
- تتبع مخصص لبيانات تتبع الاستخدام
- القياس عن بعد للحدث المخصص
- القياس عن بعد للقياس المخصص
إعداد تتبع التبعية ل:
لمعرفة المزيد:
- تحقق من الأنظمة الأساسية التي تدعمها Application Insights.
- تحقق منالتكوين القياسي لمجموعة خصائص السياق.
- استكشاف سجلات تتبع .NET في Application Insights.
- استكشاف سجلات تتبع Java في Application Insights.
- تعرف على التكامل المضمن في Azure Functions مع Application Insights لمراقبة عمليات تنفيذ الوظائف.
- تعرف على كيفية تكوين تطبيق ASP.NET Core باستخدام Application Insights.
- تعرّف على كيفية تشخيص الاستثناءات في تطبيقات الويب باستخدام Application Insights.
- تعرف على كيفية توسيع وتصفية بيانات تتبع الاستخدام.
- استخدم أخذ العينات لتقليل كمية بيانات تتبع الاستخدام استنادا إلى نموذج البيانات.