التشخيص ومراقبة أداء المستخدمين الموثوقين
يصدر وقت تشغيل المستخدمين الموثوقين أحداث EventSource و وعدادات الأداء. توفر هذه الإرشادات تفاصيل حول كيفية عمل الخدمة عن بعد وكيفية استكشاف الأخطاء وإصلاحها ومراقبة الأداء.
أحداث EventSource
اسم موفر EventSource لوقت تشغيل المستخدمين الموثوقين هو "Microsoft-ServiceFabric-Actors ". تظهر الأحداث من مصدر الحدث هذا في نافذة أحداث التشخيص عند تصحيح أخطاء تطبيق المستخدم في Visual Studio.
أمثلة على الأدوات والتقنيات التي تساعد في جمع و/أو عرض أحداث EventSource هي PerfView وAzure Diagnostics و Semantic Logging و Microsoft TraceEvent Library.
الكلمات الأساسية
ترتبط جميع الأحداث المتعلقة بـ EventSource للمستخدمين الموثوقين بكلمة رئيسية واحدة أو أكثر. يتيح ذلك تصفية الأحداث التي يتم تجميعها. يتم تعريف بتات الكلمات الرئيسية التالية.
| Bit | الوصف |
|---|---|
| 0x1 | مجموعة من الأحداث الهامة التي تلخص عملية وقت تشغيل Fabric Actors. |
| 0x2 | مجموعة من الأحداث التي تصف استدعاء أسلوب المستخدم. لمزيد من المعلومات، راجع مقدمة حول المستخدمين. |
| 0x4 | مجموعة من الأحداث المتعلقة بحالة المستخدم. لمزيد من المعلومات، راجع الموضوع الخاص بإدارة حالة المستخدم. |
| 0x8 | مجموعة من الأحداث المتعلقة بالتزامن القائم على الأدوار في المستخدم. لمزيد من المعلومات، راجع الموضوع الخاص بـ التزامن. |
عدادات الأداء
يحدد وقت تشغيل المستخدمين الموثوقين فئات عداد الأداء التالية.
| الفئة | الوصف |
|---|---|
| مستخدم Service Fabric | عدادات خاصة بالمستخدمين الموثوقين في Azure Service Fabric، على سبيل المثال، الوقت المستغرق لحفظ حالة المستخدم |
| أسلوب مستخدم Service Fabric | عدادات خاصة بالأساليب التي ينفذها المستخدمين في Service Fabric، على سبيل المثال عدد المرات التي يستدعى فيها أسلوب المستخدم |
تحتوي كل فئة من الفئات السابقة على عداد واحد أو أكثر.
يمكن استخدام تطبيق مراقبة أداء Windows المتوفر افتراضياً في نظام التشغيل Windows لجمع بيانات عداد الأداء وعرضها. تشخيص Azure هو خيار آخر لجمع بيانات عداد الأداء وتحميلها إلى جداول Azure.
أسماء مثيل عداد الأداء
ستضم نظام المجموعة التي بها عدد كبير من خدمات المستخدمين أو أقسام خدمة المستخدمين عدد كبير أيضًا من مثيلات عدّاد الأداء للمستخدم. يمكن أن تساعد أسماء مثيل عداد الأداء في تحديد القسم المعني وأسلوب المستخدم (عند لزومه التي يقترن بها مثيل عداد الأداء).
فئة مستخدم Service Fabric
بالنسبة للفئة Service Fabric Actor، تكون أسماء مثيلات العداد بالتنسيق التالي:
ServiceFabricPartitionID_ActorsRuntimeInternalID
ServiceFabricPartitionID هو تمثيل سلسلة معرف قسم Service Fabric الذي يقترن به مثيل عداد الأداء. معرف القسم هو GUID، ويتم إنشاء تمثيل السلسلة خاصته من خلال طريقة Guid.ToString باستخدام محدد التنسيق "D".
ServiceRuntimeInternalID هو تمثيل سلسلة عدد صحيح 64 بت الذي يتم إنشاؤه بواسطة وقت تشغيل Fabric Actors للاستخدام الداخلي. يتم تضمين ذلك في اسم مثيل عداد الأداء لضمان تفرده وتجنب تشابهه مع أسماء مثيل عداد الأداء الأخرى. يجب ألا يحاول المستخدمون تفسير هذا الجزء من اسم مثيل عداد الأداء.
فيما يلي مثال على اسم مثيل عداد لعداد ينتمي إلى الفئة Service Fabric Actor:
2740af29-78aa-44bc-a20b-7e60fb783264_635650083799324046
في المثال أعلاه، 2740af29-78aa-44bc-a20b-7e60fb783264 هو تمثيل سلسلة معرف Service Fabric، و 635650083799324046 هو معرف 64 بت الذي تم إنشاؤه للاستخدام الداخلي لوقت التشغيل.
فئة أسلوب مستخدم Service Fabric
بالنسبة للفئة Service Fabric Actor Method، تكون أسماء مثيلات العداد بالتنسيق التالي:
MethodName_ActorsRuntimeMethodId_ServiceFabricPartitionID_ActorsRuntimeInternalID
MethodName هو اسم أسلوب الخدمة المقترن بمثيل عداد الأداء. يتم تحديد تنسيق اسم الأسلوب بناء على منطق وقت تشغيل Fabric Actors الذي يوازن بين إمكانية قراءة الاسم والقيود المفروضة على الحد الأقصى لطول أسماء مثيل عداد الأداء على نظام التشغيل Windows.
ServiceRuntimeMethodId هو تمثيل سلسلة عدد صحيح 32 بت الذي يتم إنشاؤه بواسطة وقت تشغيل Fabric Actors للاستخدام الداخلي. يتم تضمين ذلك في اسم مثيل عداد الأداء لضمان تفرده وتجنب تشابهه مع أسماء مثيل عداد الأداء الأخرى. يجب ألا يحاول المستخدمون تفسير هذا الجزء من اسم مثيل عداد الأداء.
ServiceFabricPartitionID هو تمثيل سلسلة معرف قسم Service Fabric الذي يقترن به مثيل عداد الأداء. معرف القسم هو GUID، ويتم إنشاء تمثيل السلسلة خاصته من خلال طريقة Guid.ToString باستخدام محدد التنسيق "D".
ServiceRuntimeInternalID هو تمثيل سلسلة عدد صحيح 64 بت الذي يتم إنشاؤه بواسطة وقت تشغيل Fabric Actors للاستخدام الداخلي. يتم تضمين ذلك في اسم مثيل عداد الأداء لضمان تفرده وتجنب تشابهه مع أسماء مثيل عداد الأداء الأخرى. يجب ألا يحاول المستخدمون تفسير هذا الجزء من اسم مثيل عداد الأداء.
فيما يلي مثال على اسم مثيل عداد لعداد ينتمي إلى الفئة Service Fabric Actor Method:
ivoicemailboxactor.leavemessageasync_2_89383d32-e57e-4a9b-a6ad-57c6792aa521_635650083804480486
في المثال أعلاه، ivoicemailboxactor.leavemessageasync هو اسم الأسلوب، 2 هو معرف 32 بت الذي تم إنشاؤه للاستخدام الداخلي لوقت التشغيل، و 89383d32-e57e-4a9b-a6ad-57c6792aa521 هو تمثيل السلسلة لمعرف قسم Service Fabric، و 635650083804480486 هو معرف 64 بت الذي تم إنشاؤه للاستخدام الداخلي لوقت التشغيل.
قائمة الأحداث وعدادات الأداء
أحداث أسلوب المستخدم وعدادات الأداء
يصدر وقت تشغيل المستخدمين الموثوقين الأحداث التالية المتعلقة بأساليب الممثلين.
| اسم الحدث | معرف الحدث | المستوى | كلمة أساسية | الوصف |
|---|---|---|---|---|
| ActorMethodStart | 7 | مطول | 0x2 | وقت تشغيل المستخدمين على وشك استدعاء أسلوب المستخدم. |
| ActorMethodStop | 8 | مطول | 0x2 | انتهى تنفيذ أسلوب المستخدم. وهذا يعني انتهاء كل من استدعاء وقت التشغيل غير المتزامن لأسلوب المستخدم، ومهمة إرجاع أسلوب المستخدم. |
| ActorMethodThrewException | 9 | تحذير | 0x3 | تم طرح استثناء أثناء تنفيذ أسلوب المستخدم، إما أثناء استدعاء وقت التشغيل غير المتزامن لأسلوب المستخدم أو أثناء تنفيذ المهمة التي أرجعها أسلوب المستخدم. يشير هذا الحدث إلى نوع من الفشل في التعليمات البرمجية للمستخدم الذي يحتاج لتحقيق. |
ينشر تشغيل الخدمة الموثوقة عدادات الأداء التالية الخاصة بتنفيذ أساليب المستخدم.
| اسم الفئة | اسم العداد | الوصف |
|---|---|---|
| أسلوب مستخدم Service Fabric | الاستدعاءات/في الثانية | عدد مرات استدعاء أسلوب خدمة المستخدم في الثانية |
| أسلوب مستخدم Service Fabric | متوسط المللي ثانية لكل استدعاء | الوقت المستغرق لتنفيذ أسلوب خدمة المستخدم بالمللي ثانية |
| أسلوب مستخدم Service Fabric | الاستثناءات التي تم طرحها/في الثانية | عدد مرات طرح أسلوب خدمة المستخدم استثناء في الثانية |
أحداث التزامن وعدادات الأداء
يصدر وقت تشغيل المستخدمين الموثوقين الأحداث التالية المتعلقة التزامن.
| اسم الحدث | معرف الحدث | المستوى | كلمة أساسية | الوصف |
|---|---|---|---|---|
| ActorMethodCallsWaitingForLock | 12 | مطول | 0x8 | يكتب هذا الحدث في بداية كل مرحلة جديدة للمستخدم. وهو يحتوي على عدد استدعاءات المستخدم المعلقة وفي انتظار الحصول على تأمين لكل مستخدم يفرض التزامن القائم على الأدوار. |
ينشر تشغيل خدمة المستخدمين الموثوقين عدادات الأداء التالية الخاصة بتنفيذ أساليب التزامن.
| اسم الفئة | اسم العداد | الوصف |
|---|---|---|
| مستخدم Service Fabric | # من استدعاءات المستخدم في انتظار تأمين المستخدم | وهو يحتوي على عدد استدعاءات المستخدم المعلقة وفي انتظار الحصول على تأمين كل مستخدم يفرض التزامن القائم على الأدوار |
| مستخدم Service Fabric | متوسط المللي ثانية لكل طلب انتظار تأمين | الوقت المستغرق (بالمللي ثانية) للحصول على تأمين لكل مستخدم يفرض التزامن القائم على الأدوار |
| مستخدم Service Fabric | تثبيت متوسط ميلي ثانية لتأمين المستخدم | الوقت (بالمللي ثانية) الذي يتم فيه تثبيت تأمين كل ممثل |
أحداث إدارة حالة المستخدم وعدادات الأداء
يصدر وقت تشغيل المستخدمين الموثوقين الأحداث التالية المتعلقة إدارة حالة المستخدم.
| اسم الحدث | معرف الحدث | المستوى | كلمة أساسية | الوصف |
|---|---|---|---|---|
| ActorSaveStateStart | 10 | مطول | 0x4 | وقت تشغيل المستخدمين على وشك حفظ حالة المستخدم. |
| ActorSaveStateStop | 11 | مطول | 0x4 | انتهى وقت تشغيل المستخدمين من حفظ حالة المستخدم. |
ينشر وقت تشغيل المستخدمين الموثوقين عدادات الأداء التالية الخاصة بإدارة حالة المستخدم.
| اسم الفئة | اسم العداد | الوصف |
|---|---|---|
| مستخدم Service Fabric | متوسط المللي ثانية لكل عملية حفظ حالة | الوقت المستغرق لحفظ حالة المستخدم بالمللي ثانية |
| مستخدم Service Fabric | متوسط المللي ثانية لكل عملية حفظ حالة | الوقت المستغرق لتحميل حالة المستخدم بالمللي ثانية |
الأحداث المتعلقة بالنسخ المتماثلة للمستخدمين
يصدر وقت تشغيل المستخدمين الموثوقين الأحداث التالية المتعلقة النسخ المتماثلة للمستخدمين.
| اسم الحدث | معرف الحدث | المستوى | كلمة أساسية | الوصف |
|---|---|---|---|---|
| ReplicaChangeRoleToPrimary | 1 | معلوماتي | 0x1 | نسخة متماثلة للمستخدم غيرت دورها إلى نسخة أساسية. هذا يعني أنه سيتم إنشاء المستخدمين لهذا القسم داخل هذه النسخة المتماثلة. |
| ReplicaChangeRoleFromPrimary | 2 | معلوماتي | 0x1 | نسخة متماثلة للمستخدم غيرت دورها إلى نسخة غير أساسية. هذا يعني أنه لن يتم إنشاء المستخدمين لهذا القسم داخل هذه النسخة المتماثلة. لن يتم تسليم أي طلبات جديدة إلى المستخدمين الموجودين بالفعل داخل هذه النسخة المتماثلة. سيتم إنهاء المستخدمين بعد اكتمال أي طلبات قيد التنفيذ. |
أحداث تنشيط المستخدم وإلغاء تنشيطه وعدادات الأداء
يصدر وقت تشغيل المستخدمين الموثوقين الأحداث التالية المتعلقة تنشيط المستخدم وإلغاء تنشيطه.
| اسم الحدث | معرف الحدث | المستوى | كلمة أساسية | الوصف |
|---|---|---|---|---|
| ActorActivated | 5 | معلوماتي | 0x1 | تم تنشيط مستخدم. |
| ActorDeactivated | 6 | معلوماتي | 0x1 | تم إلغاء تنشيط مستخدم. |
ينشر وقت تشغيل المستخدمين الموثوقين عدادات الأداء التالية الخاصة بتنشيط المستخدم وإلغاء تنشيطه.
| اسم الفئة | اسم العداد | الوصف |
|---|---|---|
| مستخدم Service Fabric | متوسط OnActivateAsync مللي ثانية | الوقت المستغرق لتنفيذ طريقة OnActivateAsync بالمللي ثانية |
عدادات أداء معالجة طلبات الخدمة
عندما يستدعي مستخدم أسلوب عبر وكيل عنصر مستخدم الخدمة، فإنه يؤدي إلى إرسال رسالة طلب عبر الشبكة إلى خدمة المستخدم عن بعد. تقوم الخدمة بمعالجة رسالة الطلب وإرسال رد إلى العميل. ينشر وقت تشغيل المستخدمين الموثوقين عدادات الأداء التالية الخاصة بمعالجة طلب المستخدم.
| اسم الفئة | اسم العداد | الوصف |
|---|---|---|
| مستخدم Service Fabric | # من عدد الطلبات المعلقة | عدد الطلبات التي تتم معالجتها في الخدمة |
| مستخدم Service Fabric | متوسط المللي ثانية لكل طلب | الوقت الذي تستغرقه الخدمة (بالمللي ثانية) لمعالجة الطلب |
| مستخدم Service Fabric | متوسط المللي ثانية لإلغاء تسلسل الطلب | الوقت المستغرق (بالمللي ثانية) لإلغاء تسلسل رسالة طلب الخدمة عند استلامها في الخدمة |
| مستخدم Service Fabric | متوسط المللي ثانية لتسلسل الاستجابة | الوقت المستغرق (بالمللي ثانية) لتسلسل رسالة استجابة الخدمة في الخدمة قبل إرسال الاستجابة إلى العميل |