سجلات التدقيق

سجلات التدقيق هي سجل بالطلبات المقدّمة إلى Performance Hub في منظمتك. وتشمل الطلبات المقدّمة من الأشخاص الذين يستخدمون Performance Hub في متصفح أو في التطبيق، ومن الأدوات المتصلة مثل مفاتيح API، ووكلاء الذكاء الاصطناعي المتصلين عبر MCP، وModel Router. استخدمها للإجابة عن أسئلة مثل من فتح بابًا، أو لماذا لم يُحفظ تغيير ما، أو متى توقف تكامل عن العمل، سواء أكانت مواقعك مكاتب أم متاجر أم مقاهي أم أماكن فعاليات أم عيادات أم حرمًا جامعية أم نوادي رياضية.

مرجع سريع

مكان الوصول إليها: الإعدادات (رمز الترس، أسفل اليسار) ← سجلات التدقيق

من يمكنه استخدامها: تحتاج إلى دور يتضمن سجلات التدقيق وIdentity & Access Management في منظمتك، مثل Organisation Administrator. راجع من يمكنه استخدام سجلات التدقيق.

الغرض: معرفة من فعل ماذا في Performance Hub، ومعرفة سبب فشل طلب ما

الشكل 1: لوحة معلومات سجلات التدقيق: النافذة الزمنية، والأرقام الرئيسية، والخط الزمني للطلبات

ما الذي يُسجَّل

كل إدخال في السجل هو طلب واحد مقدَّم إلى Performance Hub. ويعرض:

• من قدّم الطلب: عنوان البريد الإلكتروني للمستخدم.
• من أين: عنوان IP، والمتصفح أو الأداة التي أرسلته.
• ما الذي استُدعي: الطريقة (على سبيل المثال GET للقراءة أو POST للإنشاء) ونقطة النهاية، وهي الجزء من Performance Hub الذي كان الطلب موجّهًا إليه، مثل /api/door-gate-access/doors/front-entrance/unlock.
• النتيجة: حالة الاستجابة، على سبيل المثال 200 للنجاح أو 403 عندما لا يملك الشخص الإذن.
• المدة التي استغرقها، بالمللي ثانية.
• مصدره: شارة مصدر، مثل web لشخص يستخدم Performance Hub أو api-key لتكامل. راجع شارات المصدر.

بالنسبة إلى الطلبات الحديثة، يحتفظ إدخال السجل أيضًا بما أُرسل وما عاد. راجع قراءة إدخال سجل.

علامتا التبويب

من يمكنه استخدام سجلات التدقيق

تحتاج إلى دور يتضمن سجلات التدقيق وIdentity & Access Management في منظمتك، مثل Organisation Administrator. إذا لم تتمكن من رؤية سجلات التدقيق في قائمة الإعدادات، فإن دورك لا يتضمنها.

• المنظمات التي تراها: المنظمات التي يتضمن فيها دورك كلًا من سجلات التدقيق وIdentity & Access Management. تعرض علامة التبويب Logs عددها، على سبيل المثال "Viewing logs for 1 organisation".
• قوالب الأدوار: يتضمن القالب Organisation Administrator سجلات التدقيق. ويستبعدها القالبان Site Manager وSite Owner. راجع قوالب الأدوار.
• الأدوار المخصصة: للسماح لدور مخصص باستخدام سجلات التدقيق، أدرج كلًا من سجلات التدقيق وIdentity & Access Management في الوصول إلى الوحدات الخاص به. راجع نطاق الوصول والوصول إلى الوحدات.

تعرض سجلات التدقيق عناوين البريد الإلكتروني للأشخاص وعناوين IP وما أرسلوه، لذا لا تمنح الوصول إليها إلا لمن يحتاج إليها.

مدة الاحتفاظ بالسجلات

يحدد الاحتفاظ بسجلات التدقيق مدة حفظها: 90 يومًا لكل إدخال سجل، و7 أيام لحمولات الطلب والاستجابة الكاملة الخاصة به.

تنص قائمة Range في علامة التبويب Logs على ما يلي:

"يتم الاحتفاظ بسجلات التدقيق لمدة 90 يوماً. ويتم الاحتفاظ بحمولات الطلبات والاستجابات الكاملة لمدة 7 أيام، وبعد ذلك يتبقى معاينة قصيرة. هل تحتاج إلى سجل أطول؟ اتصل بالدعم (تطبق رسوم إضافية)."

لذا يمكنك الرجوع إلى 90 يومًا مضت. خلال الأيام السبعة الأولى، يحتفظ إدخال السجل بالطلب والاستجابة كاملين. بعد ذلك، تُقتطع المحتويات الأطول إلى معاينة قصيرة. راجع بعد 7 أيام: المعاينات.

ما يمكنك فعله

• قراءة لوحة المعلومات: اطّلع على حجم الطلبات ومعدلات الأخطاء وأكثر نقاط النهاية والمستخدمين نشاطًا لنافذة زمنية.
• البحث عن الطلبات: صفِّ حسب النطاق الزمني، وعنوان البريد الإلكتروني، وعنوان IP، ونقطة النهاية، والمنظمة، والمنشأة، والطريقة، والحالة، وشارك عرضًا مُصفّى.
• قراءة إدخال سجل: اعرف من قدّم الطلب، ومن أين، وما الذي أُرسل وأُعيد. وبالنسبة إلى الطلب الفاشل، احصل على ملخص للخطأ بلغة واضحة.
• تصدير السجلات: نزّل السجلات المحمّلة بصيغة ملف CSV.
• اتباع مثال تحقيق: إجابات خطوة بخطوة عن أسئلة شائعة، مثل من فتح بابًا أو لماذا توقف تكامل عن المزامنة.
• الأسئلة الشائعة

صفحات ذات صلة

• قوالب الأدوار: القوالب التي تتضمن سجلات التدقيق
• نطاق الوصول والوصول إلى الوحدات: امنح دورًا مخصصًا وصولًا إلى سجلات التدقيق
• Door & Gate Access: سجلات الوصول: السجل المنفصل لكل محاولة فتح باب أو بوابة