هناك حالات متعددة قد لا تسير فيها عملية جمع بيانات الملفات الشخصية على النحو المتوقّع:
- تعذّر جمع الملفات الشخصية بسبب خطأ داخلي. في هذه الحالة، يخبرك واجهة برمجة التطبيقات
ProfilingResultبالأخطاء. - يتعذّر جمع بيانات الملفات الشخصية بسبب الحدّ الأقصى المسموح به لمعدّل الزحف. لمزيد من المعلومات، يُرجى الاطّلاع على طريقة عمل الحدّ الأقصى لعدد الطلبات.
- تنجح عملية جمع الملف الشخصي، ولكن لا يتم إشعار التطبيق على الفور.
يمكن أن يحدث ذلك إذا تعذّر إكمال عمليات جمع البيانات الطويلة للملفات الشخصية بسبب تعطُّل التطبيق. إذا تم إغلاق التطبيق، سيتوقف النظام تلقائيًا عن تسجيل الملف الشخصي ويحفظه. يتم إعلام التطبيق بالملف الشخصي الذي تم جمعه عند إعادة تشغيله وتسجيل أداة معالجة عامة باستخدام
ProfilingManager.
طريقة عمل تحديد عدد الطلبات
يتضمّن ProfilingManager أداة لتحديد المعدّل لكلّ من التطبيقات الفردية والنظام بأكمله. يمنع أداة تحديد المعدّل التطبيقات من استخدام الكثير من موارد النظام من خلال تسجيل عدد كبير جدًا من الملفات الشخصية، لأنّ جلسة تحليل الأداء الكاملة تستخدم الكثير من الموارد.
يحدّد كلّ من أداتَي تحديد معدّل الاستخدام في التطبيق والنظام تكلفة لكل نوع من أنواع الملفات الشخصية التي يتم جمعها، لأنّ بعض الملفات الشخصية تتطلّب موارد أكثر من غيرها. يتحكّم أداة تحديد سقف الإنفاق للتطبيق في مقدار التسجيل الذي يمكن أن يجريه تطبيق فردي استنادًا إلى إجمالي تكلفته. في المقابل، يتحكّم أداة تحديد الحد الأقصى للنظام في التكلفة الإجمالية لجميع الملفات الشخصية التي تسجّلها جميع التطبيقات.
يحدّد أداة تحديد المعدّل إجمالي التكلفة التي يمكن لكل تطبيق استخدامها (وهذه التكلفة هي نفسها لجميع التطبيقات). يستخدم كل ملف شخصي جزءًا من هذه التكلفة الإجمالية، وذلك حسب نوعه.
يستخدم أداة تحديد المعدّل ثلاث فترات زمنية:
- في الساعة: هناك حد أقصى للتكلفة المسموح بها في الساعة.
- في اليوم: هناك حدّ أقصى للتكلفة المسموح بها في اليوم.
- في الأسبوع: هناك حدّ أقصى للتكلفة المسموح بها في الأسبوع.
يحدّد أداة تحديد المعدّل إجمالي التكلفة التي يمكن استخدامها خلال كل فترة من هذه الفترات. على سبيل المثال، قد يُسمح لأحد التطبيقات بتسجيل X ملف شخصي في الساعة وY ملف شخصي في اليوم وZ ملف شخصي في الأسبوع. إذا بلغ تطبيقك الحدّ الأقصى خلال أي من هذه الفترات، سيؤدي ذلك إلى ظهور خطأ ERROR_FAILED_RATE_LIMIT_PROCESS عند طلب أي ملفات شخصية مستقبلية.
وتعمل هذه الفترات الزمنية بشكلٍ مشابه في ما يتعلّق بالحدّ الأقصى لعدد الطلبات على مستوى النظام. ومع ذلك، فإنّ أداة تحديد المعدّل في النظام هي حدّ أقصى عام تشترك فيه جميع التطبيقات. يتم ضبط هذا الحد بشكل منفصل عن حصص التطبيقات الفردية، ولكن يساهم كل ملف شخصي في هذا الحد، باستخدام الفترات الزمنية نفسها بالساعة واليوم والأسبوع. في حال بلوغ هذا الحدّ الأقصى العام، ستتلقّى الخطأ ERROR_FAILED_RATE_LIMIT_SYSTEM.