سجل النشاطات
يعرض Activity Log أحدث حركة مرور لديك. يتم تحميله عند فتح الصفحة؛ انقر فوق زر التحديث بجانب العنوان لجلب أحدث الصفوف. استخدمه لتصحيح أخطاء الاستدعاءات الفردية، والتحقق من رموز الاستجابة، والتأكد من أن التكامل الجديد يعمل بنجاح.
المنتج
تفتح الصفحة على مفتاح تبديل Product: خيار API للطلبات التي ترسلها إلى نقاط نهاية API، وخيار Proxy للأنفاق التي تفتحها أدواتك الخاصة عبر proxy.foura.ai. يغطي كلا المصدرين الساعة الأخيرة، وكلاهما يستخدم نفس محدد الحد. يتم تذكر هذا التبديل ويمكن ربطه مباشرة كـ #activity/proxy.
يشرح باقي هذه الصفحة مصدر API أولاً، ثم مصدر Proxy.
ما ستراه في مصدر API
يعرض السجل الطلبات التي تمت خلال الساعة الأخيرة، مع ظهور الأحدث في الأعلى. تسعة أعمدة تغطي تفاصيل كل صف:
| العمود | ما يعرضه |
|---|---|
| Time | وقت إرسال الطلب |
| Key | مفتاح API المستخدم |
| Request | الاستدعاء نفسه: علامة ملونة لنقطة النهاية (Single أو Proxy أو Browser أو Auto)، وطريقة HTTP، والنطاق الهدف. الترتيب حسب النطاق. |
| Status | قيمتان في خلية واحدة، مفصولتان بشرطة مائلة: حالة HTTP لاستدعائك إلى FourA، ثم الحالة التي أرجعها الهدف. تعني الشرطة أن الهدف لم يستجب أبداً. |
| Outcome | تصنيف الطلب (Success أو Client Error أو Rate Limited وما إلى ذلك) |
| Duration | إجمالي وقت الاستجابة بالمللي ثانية |
| Bytes | نقل البيانات في كلا الاتجاهين في خلية واحدة: سهم لأسفل لحمولة الطلب، وسهم لأعلى للاستجابة. يحمل الصف الذي استخدم حركة مرور مدفوعة علامة premium على هذه الخلية، بما في ذلك الصفوف التي جرى فيها تجربة مخرج مدفوع بينما أجاب التجمع القياسي؛ تُحسب حركة المرور تلك ضمن حركة المرور المدفوعة لديك. |
| Credits | الأرصدة المستهلكة في الاستدعاء (انظر Response Headers) |
| Client IP | العنوان الذي أرسل الطلب. تعرض الطلبات المرسلة من Playground أو خادم MCP المستضاف لدى FourA القيمة FourA بدلاً من العنوان. |
انقر فوق أي رأس عمود لفرز الجدول حسب ذلك العمود؛ تتنقل اتجاهات الفرز بين تنازلي، ثم تصاعدي، ثم إيقاف. يؤدي النقر مع الضغط على Ctrl أو Cmd إلى إعادة التعيين للوضع الافتراضي (الأحدث أولاً).
التصفية
توجد أربعة عناصر تحكم لتضييق نطاق السجل.
حسب المالك
إذا كنت تنتمي إلى مؤسسة واحدة على الأقل، فستظهر القائمة المنسدلة Owner أولاً: Everything، أو Personal، أو إحدى مؤسساتك. يؤدي تغييرها إلى إعادة بناء القائمة المنسدلة للمفاتيح المجاورة لها، بحيث لا يمكن لمفتاح ينتمي إلى المالك السابق البقاء بعد التبديل وإرجاع نتائج فارغة دون تنبيه. يتبع نفس عنصر التحكم في Overview وMetrics وAPI Keys اختيارك. انظر Organizations.
حسب مفتاح API
استخدم القائمة المنسدلة لمفتاح API لعرض الطلبات الصادرة من مفتاح محدد. تظهر فقط المفاتيح التي لديك حق الوصول إليها: مفاتيحك الشخصية ومفاتيح المؤسسات التي تنتمي إليها.
حسب نقطة النهاية
عند ضبط Product على API، يمكنك التصفية حسب نقطة نهاية واحدة باستخدام علامات Single / Proxy Finder / Browser / Auto. يُعد هذا مفيداً عندما ترغب في تصحيح أخطاء حالات الفشل المقتصرة على المتصفح بشكل منفصل عن الطلبات الفردية. يعرض خيار Auto استدعاءات Auto الخاصة بك، بمعدل صف واحد لكل استدعاء.
حسب الحد
يبلغ الحد الافتراضي لسجل النشاط 50 مدخلة. استخدم محدد الحد لتغيير عدد المدخلات المعروضة:
| الحد | ملاحظات |
|---|---|
| 10 | فحص سريع |
| 50 | الافتراضي |
| 100 | عرض موسع |
| 200 | الحد الأقصى |
جميع المدخلات من الساعة الأخيرة. للحصول على بيانات تاريخية، استخدم قسم المقاييس، والذي يجمع البيانات على مدار أيام وأسابيع.
استدعاءات Auto
يمثل صف Auto استدعاء واحدا. يوضح سطره الثاني عدد المحاولات التي أجراها Auto وعدد المحاولات الناجحة، وتعد Credits وBytes هي إجماليات تلك المحاولات. لثوان معدودة بعد انتهاء الاستدعاء، يظهر attempts settling…، ثم يكتمل محتوى الصف تلقائيا. الاستدعاء الذي يتم رفضه قبل أن يحاول Auto تنفيذ أي شيء يظهر عبارة no attempts recorded.
افتح الصف لعرض جدول Attempts: المحرك، وRung، والحالة، والنتيجة، والوقت، وBytes، وCredits. تحتسب المحاولات ضمن حدود Single وProxy Finder وBrowser الخاصة بك، ولكنها لا تدخل مطلقا في عدد request أو معدل النجاح.
فتح Request
انقر فوق أي صف لفتح لوحة تفاصيل تتضمن معاينة كاملة لحمولة request وresponse. تفتح اللوحة على شبكة بيانات وصفية مبنية من الصف نفسه، لذا تظل مفيدة حتى بعد انتهاء صلاحية الحمولة المخزنة: الوقت، ومفتاح API، وIP العميل، والهدف، وحالة HTTP، وحالة التطبيق، والنتيجة، وGateway total (الاستدعاء بالكامل كما رآه FourA)، وUpstream fetch (الوقت المستغرق في المحاولة التي أجابت)، وBytes، وCredits، وX-FourA-Request-Id الخاص بالطلب. عند انطباقها، تعرض أيضا سلسلة proxy لاستدعاء Proxy Finder (كل محاولة proxy، بما في ذلك محاولات إعادة المحاولة)، والـ proxy المستخدم، وحجم نص response، وخطأ المحرك.
أسفل الشبكة، يتم عرض جزء واحد في كل مرة، محدد بواسطة علامة تبويب:
| علامة التبويب | ما تعرضه |
|---|---|
| Request | نص JSON منسق بدقة لنص الطلب الفعلي المرسل |
| Response headers | الـ headers التي أرجعها الهدف، كتلة واحدة لكل قفزة إعادة توجيه. عند إعادة توجيه الهدف، تعرض علامة التبويب عدد القفزات. |
| Response body | معاينة نص الاستجابة المخزن، مع شارات truncated وbinary عند انطباقها |
| Other fields | أي شيء آخر أرجعه المحرك بخلاف الحالة والتوقيتات والـ proxy والـ headers. مخفي عند عدم وجود بيانات إضافية. |
ينسخ زر Copy أيا كان الجزء المفتوح حاليا. يتم الاحتفاظ بالحمولات لمدة 24 ساعة، بحد أقصى آخر 200 حمولة لكل مفتاح API. الصفوف الأقدم من ذلك تعرض الصف فقط، بدون حمولة.
رسائل جزء نص الاستجابة
يستخدم جزء نص الاستجابة نصوصا نائبة مختلفة اعتمادا على ما حدث:
| الرسالة | المعنى |
|---|---|
(no body — the request failed: <error>) |
حدث خطأ في الـ request قبل أن يرجع الهدف نصا |
(no body captured for this request) |
انتهت صلاحية الحمولة أو لم يتم تخزينها |
(empty body — the server returned 0 bytes) |
أرجع الهدف استجابة فارغة فعلية |
فتح في Playground
يتضمن مربع حوار التفاصيل زر Open in Playground. انقر فوقه لتحميل كل من الـ request والأرشيف والـ response المؤرشفة في نموذج Playground. ومن هناك، يمكنك تعديل المعلمات وإعادة الإرسال عبر الـ API الفعلي، أو فحص البيانات المسترجعة فقط دون إعادة تشغيل الـ request.
الزر معطل لاستدعاءات Auto ولحمولات البيانات غير القابلة لإعادة التشغيل (نصوص request الأولية كبيرة الحجم والمسارات غير التابعة للـ API)، مع تلميح يوضح السبب.
موجز Proxy
قم بتبديل Product إلى Proxy وسيتحول الموجز إلى صف واحد لكل نفق، أيضًا من الساعة الأخيرة. النفق هو اتصال واحد فتحته أداتك؛ وما أرسلته بداخله هو حركة مرورك المشفرة الخاصة، لذا يوضح الصف وجهة الاتصال، وكيف خرج، ومدة فتحه، وحجم البيانات المنقولة.
| Column | What it shows |
|---|---|
| Time | وقت انتهاء النفق، مع عمر نسبي بجانبه |
| Proxy user | أي proxy user تم استخدامه |
| Target | الـ host والـ port اللذان اتجه إليهما النفق |
| Exit | مشترك (Shared) أو Premium، بالإضافة إلى دولة الخروج عندما تكون معروفة |
| Outcome | نجاح، أو Client Error، أو Service Error، أو Service Fail، أو Rate Limited، مع ذكر السبب بمصطلحاتك الخاصة عند الرفض |
| Setup | الوقت المستغرق من اتصال أداتك حتى تسليم النفق |
| Duration | المدة التي ظل فيها النفق مفتوحًا |
| Bytes | كلا الاتجاهين في خلية واحدة، مع علامة premium عندما يكون الخروج عبر شبكة premium |
| Client IP | العنوان الذي صدر منه الاتصال |
لا توجد أعمدة لـ Status أو Credits أو الحمولة، ولا يوجد مربع حوار تفاصيل. لا يحتوي CONNECT على حالة من الوجهة ولا على body لتخزينه في FourA.
تعمل القائمة المنسدلة Owner ومحدد الحد بالطريقة نفسها. وبدلاً من القائمة المنسدلة للمفتاح، تحدد القائمة المنسدلة Proxy user نطاق الموجز لبيانات اعتماد واحدة. كل عمود يدعم الترتيب.
الصف الذي يظهر Rate Limited يتعلق بحدود خطتك، وليس برفض من الوجهة المستهدفة. يوضح السبب نوع الحد المعني: الأنفاق المتزامنة، أو عمليات الفتح في الدقيقة، أو استهلاك حركة المرور بالكامل، أو عدم توفر premium، أو عدم تضمين الـ port في خطتك. راجع Proxy Port.
استخدام Request ID
تحمل كل استجابة API ترويسة X-Foura-Request-Id. سجله لديك، ويمكنك لصقه في تذكرة دعم للإشارة إلى الـ request المحدد بدقة في Activity Log. هذا المعرف هو نفسه المستخدم في مربع الحوار هذا ويطابق الـ X-Foura-Request-Id الذي يتم إرجاعه بواسطة الـ API. راجع Response Headers للحصول على التفاصيل.
مواضيع ذات صلة
- المقاييس والتحليلات: بيانات الأداء المجمعة على مدى فترات أطول، لكلا المنتجين
- منفذ Proxy: المنتج الذي يقدم موجز Proxy تقارير عنه
- بيئة الاختبار (Playground): إعادة تشغيل الطلبات من سجل النشاط
- ترويسات Response: مصدر معرف request والأرصدة
- نقاط نهاية API: هياكل request وresponse
- المؤسسات: ما يغطيه عامل تصفية المالك
- استكشاف الأخطاء وإصلاحها: المشكلات الشائعة والحلول