نموذج بيانات سياق بيانات تتبع استخدام Application Insights

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

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

البيانات التي تم جمعها بواسطة Application Insights نماذج نمط تنفيذ التطبيق النموذجي هذا:

¹availabilityResults غير متوفر بشكل افتراضي ويتطلب إعداد اختبارات التوفر.
²customEvents ولا customMetrics تتوفر إلا مع الأجهزة المخصصة.

إشعار

يخزن Application Insights السجلات في traces الجدول لأسباب قديمة. يتم تخزين امتدادات التتبعات الموزعةrequests في الجداول و dependencies . نحن نخطط لحل هذا في إصدار مستقبلي لتجنب أي ارتباك.

أنواع بيانات تتبع الاستخدام

يتم استخدام الأنواع التالية من بيانات تتبع الاستخدام لمراقبة تنفيذ التطبيق الخاص بك. يجمع Azure Monitor OpenTelemetry DistroوApplication Insights JavaScript SDK ما يلي:

نوع بيانات تتبع الاستخدام	اسم الجدول (Application Insights)	اسم الجدول (تحليلات السجل)	‏‏الوصف
‏‏التوفر	availabilityResults	AppAvailabilityResults	يراقب توفر التطبيق الخاص بك واستجابته عن طريق إرسال طلبات الويب على فترات منتظمة وتنبيهك إذا كان التطبيق لا يستجيب أو إذا كان وقت الاستجابة بطيئا جدا.
توقيت المستعرض	browserTimings	AppBrowserTimings	يقيس أداء صفحات الويب، بما في ذلك أوقات تحميل الصفحة ومدد الشبكة.
التبعية	dependencies	AppDependencies	يتعقب المكالمات من تطبيقك إلى خدمة أو تخزين خارجي، مثل واجهة برمجة تطبيقات REST أو قاعدة بيانات SQL، ويقيس مدة هذه المكالمات ونجاحها.
الحدث	customEvents	AppEvents	يستخدم عادة لالتقاط تفاعلات المستخدم والحوادث المهمة الأخرى داخل التطبيق الخاص بك، مثل النقرات على الزر أو سحب الطلبات، لتحليل أنماط الاستخدام.
استثناء	exceptions	AppExceptions	يلتقط معلومات الخطأ المهمة لاستكشاف الأخطاء وإصلاحها وفهم حالات الفشل.
قياس	performanceCounters customMetrics	AppPerformanceCounters AppMetrics	توفر عدادات الأداء بيانات رقمية حول جوانب مختلفة من أداء التطبيق والنظام، مثل استخدام وحدة المعالجة المركزية واستهلاك الذاكرة. بالإضافة إلى ذلك، تسمح لك المقاييس المخصصة بتحديد وتتبع قياسات معينة فريدة من نوعها للتطبيق الخاص بك، ما يوفر المرونة لمراقبة مؤشرات الأداء المخصصة.
طريقة عرض الصفحة	pageViews	AppPageViews	يتعقب الصفحات التي يعرضها المستخدمون، ويوفر رؤى حول تنقل المستخدم والتفاعل داخل التطبيق الخاص بك.
طلب	requests	AppRequests	سجلات الطلبات التي يتلقاها التطبيق الخاص بك، ما يوفر تفاصيل مثل معرف العملية والمدة وحالة النجاح أو الفشل.
أثر	traces	AppTraces	يسجل الأحداث الخاصة بالتطبيق، مثل الرسائل التشخيصية المخصصة أو عبارات التتبع، والتي تعد مفيدة لتصحيح أخطاء سلوك التطبيق ومراقبته بمرور الوقت.

هام

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

لمقارنة أسماء الحقول في مدخل Microsoft Azure، افتح Application Insights>Logs، وقم بتشغيل استعلام، وانسخ Id عنصر بيانات تتبع الاستخدام (على سبيل المثال، 1234a5b6c7de8f90). ثم افتح علامة تبويب جديدة في المستعرض، وانتقل إلى Log Analytics>Logs، والتبديل إلى وضع KQL، وقم بتشغيل الاستعلام:

AppDependencies // Notice that table names are also different.
| where Id == "1234a5b6c7de8f90"

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

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

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

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

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

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

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

الحقول الخاصة بالتوفر:

اسم الحقل (Application Insights)	اسم الحقل (تحليلات السجل)	‏‏الوصف
id	Id	المعرف الفريد لنتيجة اختبار التوفر، المستخدم للارتباط بين عمليات تنفيذ الاختبار الفردية التي يمكن أن تساعد في تتبع حالات فشل أو أنماط معينة بمرور الوقت. لمزيد من المعلومات، راجع ارتباط بيانات تتبع الاستخدام في Application Insights.
name	Name	اسم اختبار التوفر. يتم تعريفه عند إنشاء الاختبار (على سبيل المثال، "اختبار ping للصفحة الرئيسية").
location	Location	الموقع الجغرافي أو منطقة مركز البيانات التي تم تنفيذ اختبار التوفر منها (على سبيل المثال، غرب الولايات المتحدة وشمال أوروبا). يساعد على تحديد الانقطاعات الإقليمية أو مشكلات زمن الانتقال.
success	Success	يشير هذا الحقل إلى ما إذا كان اختبار التوفر ناجحا أم لا. إنها قيمة منطقية حيث true تعني أن الاختبار كان ناجحا ويعني false أنه فشل.
message	Message	رسالة وصفية تحتوي على تفاصيل حول نتيجة الاختبار. غالبا ما يحتوي على تفاصيل الاستثناء أو استجابات الخطأ.
duration	Duration	مقدار الوقت الذي استغرقه اختبار التوفر لتنفيذه. يساعد على قياس الأداء وتحديد مشكلات وقت الاستجابة. يتم قياس المدة عادة بالمللي ثانية.

للحصول على قائمة بجميع الحقول المتوفرة، راجع AppAvailabilityResults.

بيانات تتبع استخدام توقيت المستعرض

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

الحقول الخاصة بتوقيت المستعرض:

اسم الحقل (Application Insights)	اسم الحقل (تحليلات السجل)	‏‏الوصف
networkDuration	NetworkDurationMs	يصل العميل إلى DNS لحل اسم مضيف موقع الويب، ويستجيب DNS بعنوان IP. يقوم العميل بإنشاء TCP ثم تأكيد اتصال TLS مع خادم الويب.
sendDuration	SendDurationMs	يرسل العميل حمولة الطلب، وينتظر الخادم لتنفيذ الطلب، ويتلقى حزمة الاستجابة الأولى.
receiveDuration	ReceiveDurationMs	يتلقى العميل بقية وحدات بايت حمولة الاستجابة من خادم الويب.
processingDuration	ProcessingDurationMs	لدى العميل الآن حمولة استجابة كاملة و يجب عليه عرض المحتويات في المتصفح وتحميل DOM.
totalDuration	TotalDurationMs	مجموع جميع توقيتات المستعرض.

للحصول على قائمة بجميع الحقول المتوفرة، راجع AppBrowserTimings.

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

يمثل عنصر القياس عن بعد للتبعية تفاعلا للمكون المراقب مع مكون بعيد مثل SQL أو نقطة نهاية HTTP.

الحقول الخاصة بالتبعية:

اسم الحقل (Application Insights)	اسم الحقل (تحليلات السجل)	‏‏الوصف
id	Id	المعرف الفريد لمثيل استدعاء التبعية، المستخدم للارتباط بعنصر القياس عن بعد للطلب الذي يتوافق مع استدعاء التبعية هذا. لمزيد من المعلومات، راجع ارتباط بيانات تتبع الاستخدام في Application Insights.
target	Target	الموقع الهدف لاستدعاء التبعية. ومن الأمثلة على ذلك اسم الخادم وعنوان المضيف. لمزيد من المعلومات، راجع ارتباط بيانات تتبع الاستخدام في Application Insights.
type	DependencyType	اسم نوع التبعية. لديها قيمة أساسية منخفضة للتصنفين المنطقي للتبعيات وتفسير الحقول الأخرى مثل commandName و resultCode. ومن الأمثلة على ذلك SQL وجدول Azure وHTTP.
name	Name	اسم الأمر الذي بدأ مع استدعاء التبعية هذا. له قيمة أساسية منخفضة. الأمثلة هي اسم الإجراء المخزن وقالب مسار URL.
data	Data	الأمر الذي بدأه استدعاء التبعية هذا. الأمثلة هي SQL العبارة وعنوان URL HTTP مع كافة معلمات الاستعلام.
success	Success	يشير هذا الحقل إلى ما إذا كانت المكالمة ناجحة أم لا. إنها قيمة منطقية حيث true تعني أن الاستدعاء كان ناجحا ويعني false أنه فشل.
resultCode	ResultCode	رمز النتيجة لاستدعاء التبعية. ومن الأمثلة على ذلك رمز الخطأ SQL ورمز حالة HTTP.
duration	DurationMs	مدة الطلب بالتنسيق DD.HH:MM:SS.MMMMMM. يجب أن يكون أقل من 1000 أيام.

للحصول على قائمة بجميع الحقول المتوفرة، راجع AppDependencies.

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

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

لمعرفة المزيد حول إنشاء بيانات تتبع الاستخدام المخصصة للحدث، راجع إضافة وتعديل Azure Monitor OpenTelemetry لتطبيقات .NET وJava Node.jsوPython.

الحقول الخاصة بالحدث:

اسم الحقل (Application Insights)	اسم الحقل (تحليلات السجل)	‏‏الوصف
name	Name	للسماح بالت تجميع مناسب ومقاييس مفيدة، قم بتقييد التطبيق الخاص بك بحيث يقوم بإنشاء بعض أسماء الأحداث المنفصلة. على سبيل المثال، لا تستخدم اسمًا منفصلًا لكل مثيل أُنشئ لحدث ما.

للحصول على قائمة بجميع الحقول المتوفرة، راجع AppEvents.

بيانات تتبع الاستخدام للاستثناء

يمثل عنصر القياس عن بعد استثناء تمت معالجته أو لم تتم معالجته الذي حدث أثناء تنفيذ التطبيق المراقب.

الحقول الخاصة بالاستثناءات:

اسم الحقل (Application Insights)	اسم الحقل (تحليلات السجل)	‏‏الوصف
problemId	ProblemId	يحدد مكان طرح الاستثناء في التعليمات البرمجية. يتم استخدامه لتجميع الاستثناءات. عادة ما يكون مزيجا من نوع استثناء ودالة من مكدس الاستدعاءات.
type	ExceptionType	النوع المحدد من الاستثناء الذي حدث. يتضمن هذا عادة مساحة الاسم واسم الفئة، مثل System.NullReferenceException أو System.InvalidOperationException.
assembly	Assembly	التجميع حيث تم طرح الاستثناء. هذا مفيد لتحديد مكون التطبيق المسؤول عن الاستثناء.
method	Method	اسم الأسلوب داخل التجميع حيث تم طرح الاستثناء. يوفر هذا معلومات سياقية حول مكان حدوث الخطأ في التعليمات البرمجية.
outerType	OuterType	نوع الاستثناء الخارجي (الالتفاف)، إذا كان الاستثناء الحالي متداخلا ضمن استثناء آخر. هذا مفيد لفهم السياق الذي حدث فيه الاستثناء الداخلي ويمكن أن يساعد في تتبع تسلسل الأخطاء.
outerMessage	OuterMessage	توفر هذه الرسالة شرحا يمكن للبشر قراءته للاستثناء الخارجي ويمكن أن تكون مفيدة في فهم المشكلة الأوسع.
outerAssembly	OuterAssembly	التجميع حيث نشأ الاستثناء الخارجي.
outerMethod	OuterMethod	أسلوب الاستثناء الخارجي. يوفر هذا معلومات مفصلة حول نقطة الفشل داخل الاستثناء الخارجي.
severityLevel	SeverityLevel	يمكن أن يكون مستوى خطورة التتبع إحدى القيم التالية: Verboseأو InformationWarningErrorCritical.
details	Details	يحتوي على معلومات استثناء مثل رسالة الاستثناء ومكدس الاستدعاءات.

للحصول على قائمة بجميع الحقول المتوفرة، راجع AppExceptions.

القياس عن بعد القياسي

يدعم Application Insights نوعين من القياس عن بعد القياسي:

• قياس واحد له اسموقيمة.
• يأخذ القياس المجمع مسبقا قياسات متعددة في فترة تجميع مدتها دقيقة واحدة.

عدادات الأداء

عدادات الأداء هي دائما مقاييس قياس مفردة مع name و، ولكن تأتي مع الحقول valueالإضافية و categoryو لتطبيقات Windows أيضا counterinstance.

حقول خاصة بعداد الأداء:

اسم الحقل (Application Insights)	اسم الحقل (تحليلات السجل)	‏‏الوصف
name	Name	اسم المقياس الذي تريد رؤيته في مدخل Application Insights.
value	Value	القيمة الفردية للقياس. إنه مجموع القياسات الفردية للتجميع.
category	Category	يمثل مجموعة من عدادات الأداء ذات الصلة (على سبيل المثال، Process).
counter	Counter	تحديد مقياس الأداء المعين الذي يتم قياسه ضمن فئة (على سبيل المثال، IO Data Bytes/sec).
instance	Instance	يحدد تكرارا محددا لعداد ضمن فئة (على سبيل المثال، ??APP_WIN32_PROC??).

للحصول على قائمة بجميع الحقول المتوفرة، راجع AppPerformanceCounters.

لمعرفة المزيد حول المقاييس، راجع المقاييس في Application Insights. لمزيد من المعلومات حول Metrics REST API، راجع Metrics - Get.

مقاييس عداد النظام والمعالجة

اسم الشبكة.	‏‏الوصف
\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	عدد الطلبات التي تنتظر المعالجة في قائمة انتظار.

الخصائص المخصصة

يشير المقياس مع تعيين الخاصية CustomPerfCounter المخصصة إلى true أن المقياس يمثل عداد أداء Windows. يتم وضع هذه المقاييس في performanceCounters الجدول، وليس في customMetrics. أيضا، يتم تحليل اسم هذا المقياس لاستخراج أسماء الفئة والعداد والمثيل.

المقاييس المخصصة

المقاييس المخصصة هي مؤشرات الأداء أو المقاييس الخاصة بالأعمال التي تحددها وتجمعها للحصول على رؤى لا تغطيها المقاييس القياسية. لمعرفة المزيد حول المقاييس المخصصة، راجع المقاييس المخصصة في Azure Monitor (معاينة).

حقول مخصصة خاصة بالمقياس:

اسم الحقل (Application Insights)	اسم الحقل (تحليلات السجل)	قياس واحد	مقياس مجمع مسبقا
name	Name	هذا الحقل هو اسم المقياس الذي تريد رؤيته في مدخل Application Insights وواجهة المستخدم.
value	Value	هذا الحقل هو القيمة الفردية للقياس. إنه مجموع القياسات الفردية للتجميع.	بالنسبة إلى مقياس مجمع مسبقا، تساوي القيمةSum.
Max	Max	بالنسبة لمقياس قياس واحد، يساوي Maxالقيمة.	هذا الحقل هو الحد الأقصى لقيمة المقياس المجمع. لا ينبغي تعيينه للقياس.
Min	Min	بالنسبة لمقياس قياس واحد، الحد الأدنى يساوي القيمة.	هذا الحقل هو الحد الأدنى لقيمة المقياس المجمع. لا ينبغي تعيينه للقياس.
Sum	Sum	بالنسبة لمقياس قياس واحد، يساوي Sumالقيمة.	مجموع جميع قيم المقياس المجمع. لا ينبغي تعيينه للقياس.
Count	Count	بالنسبة لمقياس قياس واحد، يكون العدد هو 1.	عدد القياسات في فترة تجميع مدتها دقيقة واحدة. لا ينبغي تعيينه للقياس.

للحصول على قائمة بجميع الحقول المتوفرة، راجع AppMetrics.

إشعار

لحساب المتوسط، قسم Sum على Count.

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

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

يمكن فهم هذا التمييز بشكل أكبر في سياق التطبيقات أحادية الصفحة (SPAs)، حيث لا يرتبط التبديل بين الصفحات بإجراءات صفحة المستعرض. pageViews.duration هو الوقت الذي يستغرقه التطبيق لتقديم الصفحة للمستخدم.

الحقول الخاصة بعرض الصفحة:

اسم الحقل (Application Insights)	اسم الحقل (تحليلات السجل)	‏‏الوصف
name	Name	اسم الصفحة التي عرضها المستخدم (على سبيل المثال، "Home" أو "Shopping Cart").
url	Url	عنوان URL الكامل للصفحة التي تم عرضها. هذا الحقل مهم لتحليل نسبة استخدام الشبكة وسلوك المستخدم عبر التطبيق.
duration	DurationMs	المدة PageView من واجهة توقيت أداء المتصفح، PerformanceNavigationTiming.duration. إذا كان PerformanceNavigationTiming متوفرا، يتم استخدام هذه المدة. إذا لم يكن الأمر كذلك، يتم استخدام الواجهة المهملة PerformanceTiming يحدد المطور قيمة مدة عند تسجيل الأحداث المخصصة PageView باستخدام استدعاء واجهة برمجة تطبيقات trackPageView.

للحصول على قائمة بجميع الحقول المتوفرة، راجع AppPageViews.

إشعار

• بشكل افتراضي، يسجل Application Insights JavaScript SDK أحداثا فردية PageView على كل إجراء تحميل صفحة ويب للمستعرض، مع pageViews.duration ملؤها توقيت المستعرض. يمكن للمطورين توسيع تعقب إضافي للأحداث PageView باستخدام استدعاء واجهة برمجة تطبيقات trackPageView.

• الاحتفاظ بالسجلات الافتراضي هو 30 يوما. إذا كنت تريد عرض PageView الإحصائيات على مدى فترة زمنية أطول، يجب ضبط الإعداد.

طلب بيانات تتبع الاستخدام

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

يمكنك تجميع الطلبات حسب name منطقي وتحديد source لهذا الطلب. يمكن أن يؤدي تنفيذ التعليمات البرمجية إلى success أو fail وقد يكون لها duration معين. يمكنك تجميع عمليات تنفيذ النجاح والفشل باستخدام resultCode. يتم تحديد وقت البدء لبيانات تتبع الاستخدام للطلب على مستوى المغلف. يدعم القياس عن بعد للطلب نموذج القابلية للتوسعة القياسي باستخدام مخصص properties و measurements.

الحقول الخاصة بالطلب:

اسم الحقل (Application Insights)	اسم الحقل (تحليلات السجل)	‏‏الوصف
id	Id	المعرف الفريد لمثيل استدعاء الطلب، المستخدم للارتباط بين الطلب وعناصر بيانات تتبع الاستخدام الأخرى. يجب أن يكون المعرف فريدا عالميا. لمزيد من المعلومات، راجع ارتباط بيانات تتبع الاستخدام في Application Insights.
source	Source	المصدر هو مصدر الطلب. ومن الأمثلة على ذلك مفتاح تقرير عن حالة النظام للمتصل أو عنوان IP للمتصل. لمزيد من المعلومات، راجع ارتباط بيانات تتبع الاستخدام في Application Insights.
name	Name	هذا الحقل هو اسم الطلب ويمثل مسار التعليمات البرمجية المأخوذ لمعالجة الطلب. تسمح القيمة الأساسية المنخفضة بتجميع الطلبات بشكل أفضل. بالنسبة لطلبات HTTP، فإنه يمثل أسلوب HTTP وقالب مسار URL مثل GET /values/{id} بدون القيمة الفعلية id . يرسل Application Insights web SDK اسم طلب "كما هو" حول حالة الرسالة. التجميع على واجهة المستخدم حساس لحالة الأحرف، لذلك GET /Home/Index يتم حسابه بشكل منفصل عن على الرغم من GET /home/INDEX أنه غالبا ما يؤدي إلى نفس وحدة التحكم وتنفيذ الإجراء. والسبب في ذلك هو أن عناوين URL بشكل عام حساسة لحالة الأحرف. قد ترغب في معرفة ما إذا كانت جميع 404 الأخطاء قد حدثت لعناوين URL مكتوبة بأحرف كبيرة. يمكنك قراءة المزيد حول مجموعة أسماء الطلبات بواسطة ASP.NET web SDK في منشور المدونة.
url	Url	عنوان URL هو عنوان URL للطلب مع جميع معلمات سلسلة الاستعلام.
success	Success	يشير النجاح إلى ما إذا كانت المكالمة ناجحة أو غير ناجحة. هذا الحقل مطلوب. عندما لا يتم تعيين طلب بشكل صريح إلى false، فإنه يعتبر ناجحا. إذا قام استثناء أو إرجاع رمز نتيجة خطأ بمقاطعة العملية، فقم بتعيين هذه القيمة إلى false. بالنسبة لتطبيقات الويب، يعرف Application Insights الطلب على أنه ناجح عندما يكون رمز الاستجابة أقل من 400 أو يساوي 401. ومع ذلك، هناك حالات لا يتطابق فيها هذا التعيين الافتراضي مع دلالات التطبيق. قد تشير التعليمات البرمجية 404 للاستجابة إلى "لا توجد سجلات"، والتي يمكن أن تكون جزءا من التدفق العادي. قد يشير أيضا إلى ارتباط مقطوع. بالنسبة للارتباطات المقطوعة، يمكنك تنفيذ منطق أكثر تقدما. يمكنك وضع علامة على الارتباطات المقطوعة على أنها حالات فشل فقط عندما تكون هذه الارتباطات موجودة على نفس الموقع عن طريق تحليل محيل عنوان URL. أو يمكنك وضع علامة عليها على أنها حالات فشل عند الوصول إليها من تطبيق الشركة للأجهزة المحمولة. وبالمثل، 301 والإشارة 302 إلى الفشل عند الوصول إليها من العميل الذي لا يدعم إعادة التوجيه. قد يشير المحتوى 206 المقبول جزئيا إلى فشل طلب شامل. على سبيل المثال، قد تتلقى نقطة نهاية Application Insights دفعة من عناصر بيانات تتبع الاستخدام كطلب واحد. يتم إرجاعه 206 عندما لا تتم معالجة بعض العناصر في الدفعة بنجاح. يشير معدل متزايد من 206 إلى مشكلة تحتاج إلى التحقيق. ينطبق منطق مماثل على 207 Multi-Status، حيث قد يكون النجاح أسوأ رموز الاستجابة المنفصلة.
resultCode	ResultCode	رمز الاستجابة هو نتيجة تنفيذ طلب. إنه رمز حالة HTTP لطلبات HTTP. قد تكون HRESULT قيمة أو نوع استثناء لنوع الطلبات الأخرى.
duration	DurationMs	يتم تنسيق مدة الطلب ك DD.HH:MM:SS.MMMMMM. يجب أن تكون إيجابية وأقل من 1000 أيام. هذا الحقل مطلوب لأن بيانات تتبع الاستخدام للطلب تمثل العملية مع البداية والنهاية.

للحصول على قائمة بجميع الحقول المتوفرة، راجع طلبات التطبيقات.

تتبع بيانات تتبع الاستخدام

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

الحقول الخاصة بالتتبع:

اسم الحقل (Application Insights)	اسم الحقل (تحليلات السجل)	‏‏الوصف
message	Message	تتبع الرسالة.
severityLevel	SeverityLevel	تتبع مستوى الخطورة.

للحصول على قائمة بجميع الحقول المتوفرة، راجع AppTraces.

إشعار

severityLevel يتم تعداد قيم وخاصة بالنظام الأساسي.

الخصائص والقياسات المخصصة

الخصائص المخصصة

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

• الحد الأقصى لطول المفتاح: 150
• الحد الأقصى لطول القيمة: 8192

القياسات المخصصة

مجموعة من القياسات المخصصة: استخدم هذه المجموعة للإبلاغ عن القياسات المسماة المقترنة بعنصر بيانات تتبع الاستخدام. حالات الاستخدام النموذجية هـي:

• حجم حمولة بيانات تتبع الاستخدام للتبعية.
• عدد عناصر قائمة الانتظار التي تمت معالجتها عن طريق طلب بيانات تتبع الاستخدام.
• الوقت الذي استغرقه العميل لإنهاء خطوة المعالج لإكمال بيانات تتبع الاستخدام للحدث.

يمكنك الاستعلام عـن القياسات المخصصة في Application Analytics:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

إشعار

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

الحد الأقصى لطول المفتاح: 150

السياق

قد يكون لكل عنصر بيانات تتبع الاستخدام حقل سياق مكتوب بقوة. يتيح كل حقل سيناريو محدد للمراقبة. استخدم مجموعة الخصائص المخصصة لتخزين معلومات سياقية مخصصة أو خاصة بالتطبيق.

اسم الحقل (Application Insights)	اسم الحقل (تحليلات السجل)	‏‏الوصف
account_ID	user_AccountId	معرف الحساب، في التطبيقات متعددة المستأجرين، هو معرف حساب المستأجر أو الاسم الذي يعمل به المستخدم. يتم استخدامه لمزيد من تجزئة المستخدم عندما لا يكون معرف المستخدم ومعرف المستخدم المصادق عليه كافيين. قد تكون الأمثلة على ذلك معرف اشتراك لمدخل Azure أو اسم المدونة للنظام الأساسي للتدوين.
application_Version	AppVersion	تكون المعلومات في حقول سياق التطبيق دائما حول التطبيق الذي يرسل بيانات تتبع الاستخدام. يتم استخدام إصدار التطبيق لتحليل تغييرات الاتجاه في سلوك التطبيق وارتباطه إلى عمليات النشر.
appId	ResourceGUID	معرف فريد لمورد Application Insights لتمييز بيانات تتبع الاستخدام عن التطبيقات المختلفة.
appName	‏‫غير متوفر‬	في Application Insights، appName هو نفس _ResourceId.
client_Browser	ClientBrowser	اسم مستعرض الويب المستخدم من قبل العميل.
client_City	ClientCity	المدينة حيث كان العميل موجودا عند جمع بيانات تتبع الاستخدام (استنادا إلى الموقع الجغرافي ل IP).
client_CountryOrRegion	ClientCountryOrRegion	البلد أو المنطقة التي يوجد فيها العميل عند جمع بيانات تتبع الاستخدام (استنادا إلى الموقع الجغرافي ل IP).
client_IP	ClientIP	عنوان IP لجهاز العميل. يتم دعم كل من IPv4 وIPv6. عند إرسال بيانات تتبع الاستخدام من خدمة، يكون سياق الموقع حول المستخدم الذي بدأ العملية في الخدمة. يستخرج Application Insights معلومات الموقع الجغرافي من عنوان IP للعميل ثم يقتطعها. لا يمكن استخدام IP العميل في حد ذاته كمعلومات تعريف المستخدم.
client_OS	ClientOS	يشير إلى نظام تشغيل العميل الذي أنشأ بيانات تتبع الاستخدام.
client_StateorProvince	ClientStateOrProvince	الولاية أو المقاطعة حيث كان العميل موجودا عند جمع بيانات تتبع الاستخدام (استنادا إلى الموقع الجغرافي ل IP).
client_Type	ClientType	يصف نوع جهاز العميل الذي أرسل بيانات تتبع الاستخدام (على سبيل المثال، Browser أو PC.)
cloud_RoleInstance	AppRoleInstance	اسم المثيل حيث يتم تشغيل التطبيق. على سبيل المثال، إنه اسم الكمبيوتر المحلي أو اسم المثيل ل Azure.
cloud_RoleName	AppRoleName	اسم الدور الذي يكون التطبيق جزءا منه. يتم تعيينه مباشرة إلى اسم الدور في Azure. كما يمكن استخدامه لتمييز الخدمات المصغرة، والتي تعد جزءا من تطبيق واحد.
iKey	IKey	معرف فريد قديم يستخدم لربط بيانات تتبع الاستخدام بمورد Application Insights محدد.
itemId	‏‫غير متوفر‬	معرف فريد لعنصر بيانات تتبع الاستخدام محدد.
itemCount	ItemCount	عدد التكرارات أو الأعداد المقترنة بحدث بيانات تتبع الاستخدام واحد.
operation_Id	OperationId	المعرف الفريد لعملية الجذر. يسمح هذا المعرف بتجميع بيانات تتبع الاستخدام عبر العديد من المكونات. لمزيد من المعلومات، راجع ارتباط بيانات تتبع الاستخدام. إما أن الطلب أو طريقة عرض الصفحة تنشئ معرف العملية. تقوم جميع بيانات تتبع الاستخدام الأخرى بتعيين هذا الحقل إلى قيمة الطلب أو عرض الصفحة التي تحتوي على العملية.
operation_Name	OperationName	اسم (مجموعة) العملية. ينشئ طلب أو طريقة عرض صفحة اسم العملية. تقوم جميع عناصر بيانات تتبع الاستخدام الأخرى بتعيين هذا الحقل إلى القيمة الخاصة بالطلب أو عرض الصفحة التي تحتوي على العملية. يتم استخدام اسم العملية للعثور على جميع عناصر بيانات تتبع الاستخدام لمجموعة من العمليات (على سبيل المثال، GET Home/Index). يتم استخدام خاصية السياق هذه للإجابة عن أسئلة مثل ما هي الاستثناءات النموذجية التي تم طرحها في هذه الصفحة؟
operation_ParentId	ParentId	المعرف الفريد للأصل المباشر لعنصر بيانات تتبع الاستخدام. لمزيد من المعلومات، راجع ارتباط بيانات تتبع الاستخدام.
operation_SyntheticSource	SyntheticSource	اسم المصدر الاصطناعي. قد تمثل بعض بيانات تتبع الاستخدام من التطبيق نسبة استخدام الشبكة الاصطناعية. قد يكون متتبع ارتباطات الويب الذي يقوم بفهرسة موقع الويب أو اختبارات توفر الموقع أو التتبعات من مكتبات التشخيص مثل Application Insights SDK نفسه.
sdkVersion	SDKVersion	إصدار Application Insights SDK الذي يرسل بيانات تتبع الاستخدام. لمزيد من المعلومات، راجع إصدار SDK.
session_Id	SessionId	معرف جلسة العمل هو مثيل تفاعل المستخدم مع التطبيق. المعلومات في حقول سياق جلسة العمل هي دائما حول المستخدم. عند إرسال بيانات تتبع الاستخدام من خدمة، يكون سياق الجلسة حول المستخدم الذي بدأ العملية في الخدمة.
user_AuthenticatedId	UserAuthenticatedId	معرف المستخدم المصادق عليه هو عكس معرف مستخدم مجهول. يمثل هذا الحقل المستخدم باسم مألوف. يُجمع هذا المعرف بشكل افتراضي باستخدام AuthenticatedUserIdTelemetryInitializer الخاص بـ ASP.NET Framework SDK. استخدم Application Insights SDK لتهيئة معرف المستخدم المصادق عليه بقيمة تحدد المستخدم باستمرار عبر المتصفحات والأجهزة. وبهذه الطريقة، تنسب جميع عناصر بيانات تتبع الاستخدام إلى هذا المعرف الفريد. يتيح هذا المعرف الاستعلام عن جميع بيانات تتبع الاستخدام التي تم جمعها لمستخدم معين (رهنا بتكوينات أخذ العيناتوتصفية بيانات تتبع الاستخدام). يمكن الرجوع إلى معرفات المستخدم مع معرفات الجلسة لتوفير أبعاد بيانات تتبع الاستخدام الفريدة وإنشاء نشاط المستخدم على مدار مدة الجلسة.
user_Id	UserId	يمثل معرف المستخدم المجهول مستخدم التطبيق. عند إرسال بيانات تتبع الاستخدام من خدمة، يكون سياق المستخدم حول المستخدم الذي بدأ العملية في الخدمة. أخذ العينات هي واحدة من التقنيات لتقليل كمية بيانات تتبع الاستخدام التي تم جمعها. تحاول خوارزمية أخذ العينات إما أخذ عينة من جميع بيانات تتبع الاستخدام المرتبطة أو خارجها. يتم استخدام معرف مستخدم مجهول لإنشاء نقاط أخذ العينات، لذلك يجب أن يكون معرف المستخدم المجهول قيمة عشوائية كافية. عدد معرفات المستخدمين المجهولين ليس هو نفسه عدد مستخدمي التطبيق الفريدين. عادة ما يكون عدد معرفات المستخدمين المجهولين أعلى لأنه في كل مرة يفتح فيها المستخدم تطبيقك على جهاز أو مستعرض مختلف، أو ينظف ملفات تعريف ارتباط المستعرض، يتم تخصيص معرف مستخدم مجهول فريد جديد. قد يؤدي هذا الحساب إلى حساب نفس المستخدمين الفعليين عدة مرات. يمكن الرجوع إلى معرفات المستخدم مع معرفات الجلسة لتوفير أبعاد بيانات تتبع الاستخدام الفريدة وإنشاء نشاط المستخدم على مدار مدة الجلسة. يعد استخدام معرف مستخدم مجهول لتخزين اسم مستخدم إساءة استخدام للحقل. استخدم معرف مستخدم مصادق عليه.
_ResourceId	_ResourceId	معرف مورد Azure الكامل لمكون Application Insights، والذي يتضمن الاشتراك ومجموعة الموارد واسم المورد.

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

• مراجعة الأسئلة المتداولة (FAQ): الأسئلة المتداولة حول نموذج بيانات تتبع الاستخدام
• تحقق من الأنظمة الأساسية التي يدعمها Application Insights.
• تعرف على كيفية جمع بيانات تتبع الاستخدام المخصصة باستخدام Azure Monitor OpenTelemetry Distro.
• تعرف على كيفية استخدام واجهة برمجة تطبيقات Application Insights للأحداث والمقاييس المخصصة.
• تعرف على كيفية توسيع وتصفية بيانات تتبع الاستخدام.
• تعرف على كيفية استخدام أخذ العينات لتقليل مقدار بيانات تتبع الاستخدام استنادا إلى نموذج البيانات.