البحث عن الطلبات

تسرد علامة التبويب Logs الطلبات المقدّمة في منظمتك، بدءًا من الأحدث. استخدم عوامل التصفية في الأعلى لتضييق القائمة إلى شخص واحد، أو عنوان IP واحد، أو جزء واحد من Performance Hub، أو نوع واحد من النتائج، ثم انقر على طلب لعرض تفاصيله.

مرجع سريع

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

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

الغرض: العثور على الطلبات التي تقف وراء سؤال ما، مثل من غيّر شيئًا أو لماذا فشل شيء ما

الشكل 1: علامة التبويب Logs: عوامل التصفية في الأعلى، والطلبات المطابقة على اليسار، والطلب المحدد على اليمين

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

• شريط التصفية: عوامل التصفية في الأعلى، مع Live وزر التحديث وتصدير CSV على اليمين.
• القائمة: الطلبات المطابقة، بدءًا من الأحدث. ويظهر فوقها "Viewing logs for 1 organisation" (أو عدد المنظمات التي يمكنك رؤيتها). يعرض كل صف رمز الحالة، والطريقة، وشارة المصدر، والتاريخ والوقت، ونقطة النهاية، وعنوان البريد الإلكتروني للمستخدم، ووقت الاستجابة بالمللي ثانية.
• التفاصيل: الطلب الذي حددته. راجع قراءة إدخال سجل.

تحمّل القائمة مزيدًا من الطلبات أثناء التمرير. وفي نهاية القائمة، تعرض عدد الطلبات المطابقة، على سبيل المثال "End of results · 5 logs".

تصفية القائمة

1. انقر على عامل تصفية في شريط التصفية، على سبيل المثال Endpoint.
2. اختر خيارًا، أو اكتب قيمة. على سبيل المثال، اكتب /api/door-gate-access/* في Endpoint وانقر على Apply.
3. يعرض عامل التصفية القيمة التي اخترتها، وتتحدّث القائمة. أضف مزيدًا من عوامل التصفية لتضييقها أكثر: يجب أن يطابق الطلب كل عوامل التصفية حتى يظهر.
4. لإزالة عامل تصفية واحد، انقر على × الموجودة عليه. ولإزالتها جميعًا، انقر على Clear، الذي يظهر بمجرد تعيين أي عامل تصفية.

الشكل 2: شريط التصفية: Range وEmail وIP وEndpoint وOrg وFacility وMethod وStatus، ثم Live والتحديث وExport CSV

يتطلب Email وIP القيمة كاملة

لا يعثر Email وIP إلا على المطابقات التامة. اكتب عنوان البريد الإلكتروني كاملًا، مثل ruby.castellano@example.com، أو عنوان IP كاملًا. أما جزء من العنوان، مثل ruby أو 203.0.113، فلا يعثر على شيء.

للعثور على شخص دون عنوانه الكامل، استخدم Top Users في لوحة القيادة، أو افتح أحد طلباته وانسخ العنوان من الحقل User.

النطاق الزمني

انقر على Range لاختيار المدى الزمني الذي تريد الرجوع إليه.

• الإعدادات المسبقة: Last 15 minutes وLast hour وLast 12 hours وLast 24 hours وLast 7 days وLast 30 days وLast 90 days.
• التواريخ: اختر تاريخ بدء وتاريخ انتهاء في التقويم ذي الشهرين، ثم انقر على Apply. انقر على Cancel لإغلاق القائمة دون تغيير النطاق. لا يمكن اختيار تواريخ تزيد على 90 يومًا مضت.

توضّح الملاحظة أسفل القائمة مدة الاحتفاظ بالسجلات: "Audit logs are kept for 90 days. Full request and response payloads are kept for 7 days, after which a short preview remains. Need a longer history? Contact Support (additional charges apply)."

الشكل 3: Range: اختر إعدادًا مسبقًا أو تواريخ من التقويم. توضّح الملاحظة مدة الاحتفاظ بالسجلات

نقطة النهاية وأحرف البدل

نقطة النهاية هي المسار الذي أُرسل إليه الطلب، مثل /api/door-gate-access/doors/front-entrance/unlock. وهي تخبرك بالجزء من Performance Hub الذي كان الطلب موجّهًا إليه.

• بدون *، يطابق أي جزء من المسار. على سبيل المثال، يعثر unlock على كل طلب يتضمن "unlock" في مساره.
• مع *، يجب أن يظهر كل جزء بين النجوم في المسار. على سبيل المثال، يعثر /api/door-gate-access/* على كل طلب في Door & Gate Access، ويعثر /partner/v1/* على كل طلب من تكامل يستخدم Partner API.

الشكل 4: يقبل Endpoint حرف البدل *، على سبيل المثال لكل طلبات الأبواب

الشكل 5: القائمة بعد التصفية حسب نمط نقطة نهاية

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

الحالة

انقر على Status للتصفية حسب حالة الاستجابة. اكتب في Search… للعثور على حالة بسرعة، على سبيل المثال "403". اختر Any لعرض كل الحالات.

تُسرد الحالات بأسمائها، مثل 200 OK و201 Created و400 Bad Request و401 Unauthorised و403 Forbidden و404 Not Found و409 Conflict و429 Too Many Requests و500 Server Error و503 Service Unavailable. راجع رموز الحالة لمعرفة معانيها.

الشكل 6: التصفية حسب حالة الاستجابة

التحديث المباشر والتحديث اليدوي

في علامة التبويب Logs، يكون Live على Off افتراضيًا، فتبقى القائمة ثابتة أثناء التحقيق. شغّله واختر عدد مرات تحديث القائمة لمتابعة وصول الطلبات الجديدة. انقر على زر التحديث (السهمان الدائريان) لإعادة تحميل القائمة مرة واحدة.

مشاركة عرض مُصفّى أو وضع إشارة مرجعية عليه

تُحفظ عوامل التصفية في عنوان الصفحة. ضع إشارة مرجعية على الصفحة للعودة إلى العرض نفسه، أو أرسل العنوان إلى زميل. وسيرى القائمة المُصفّاة نفسها إذا كان لديه وصول إلى سجلات التدقيق وإلى المنظمة نفسها.

على سبيل المثال، يفتح عنوان ينتهي بـ /audit-logs/logs?email=priya.shah%40example.com القائمة مُصفّاة لذلك الشخص، ويفتح عنوان ينتهي بـ /audit-logs/logs?endpoint=%2Fapi%2Fdoor-gate-access%2F* كل طلبات الأبواب.

التنقل في القائمة

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

لا توجد نتائج

إذا لم يطابق أي شيء، تعرض القائمة "No logs match these filters" و"Try widening the time range or clearing a filter."

الشكل 7: لا توجد طلبات مطابقة: وسّع النطاق الزمني أو امسح عامل تصفية

للعثور على ما تبحث عنه:

• اختر Range أطول، مثل Last 7 days.
• تحقق من أن Email وIP يحتويان على العنوان كاملًا. فجزء من العنوان لا يعثر على شيء.
• أزل عامل تصفية واحدًا في كل مرة باستخدام × الخاصة به، أو انقر على Clear.

صفحات ذات صلة

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