نظرة عامة على لوحة التحكم
تتيح لك لوحة تحكم FourA إدارة مفاتيح API ومستخدمي proxy، وتشغيل طلبات الاختبار، ومراقبة الأداء، وإدارة الفوترة، وتكوين حسابك. تستعرض هذه الصفحة شاشة Overview الرئيسية وأقسام الشريط الجانبي.
الوصول إلى لوحة التحكم
سجل الدخول عبر foura.ai/dashboard. تحتاج إلى حساب FourA: سجل هنا إذا لم يكن لديك حساب بعد.
منتجان في مجموعة صفحات واحدة
تفتح كل من Overview وMetrics وActivity على محدد Product بخيارين:
| Product | ما يتم احتسابه | الوحدة |
|---|---|---|
| API | الطلبات التي ترسلها إلى /api/single و/api/proxy و/api/browser و/api/auto |
Requests وcredits |
| Proxy | الأنفاق التي تفتحها أدواتك عبر proxy.foura.ai |
Tunnels وbytes |
ينقل النفق كل ما يرسله عميلك من خلاله، وما يحدث داخل CONNECT هو حركة مرور مشفرة خاصة بك. لذلك تحسب واجهات Proxy الأنفاق والبايتات ولا تحسب الطلبات أو الرصيد مطلقا. اقرأ Proxy Port للتعرف على المنتج نفسه.
يكون المحدد دائما على أحد الخيارين، ويتم حفظه بين الزيارات، ويظهر في العنوان مثل #overview/proxy أو #metrics/proxy أو #activity/proxy. يؤدي لصق أحد هذه الروابط إلى فتح الصفحة على ذلك المنتج مباشرة.
لا تخلط بين منتج Proxy وشريحة endpoint المسماة Proxy Finder. إن Proxy Finder هي POST /api/proxy/، وهي إحدى نقاط نهاية API الأربع. أما منتج Proxy فهو منفذ proxy.
صفحة Overview لمنتج API
تعرض صفحة الهبوط بعد تسجيل الدخول أرقامك الرئيسية للفترة التي تحددها.
قبل إرسال طلبك الأول
حتى يصل طلبك الأول، تعرض واجهة API بيانات توضيحية مع علامة Sample على كل لوحة ومخطط، تحت شعار This is sample data. الذي يتضمن خطوتين: Create API key (حيث يفتح المفتاح الجديد مع أمر اختبار)، وOpen Playground لإرسال طلب. على الهاتف أو الجهاز اللوحي، توجهك الخطوات إلى Playground، لأن الهاتف لا يمكنه تشغيل الأمر. يؤدي أول طلب حقيقي إلى استبدال البيانات التوضيحية نهائيا.
تحتوي واجهة Proxy على شعار خاص بها وهو No traffic yet. مع خياري Create proxy user وOpen Proxy، ويستمر ظهورهما حتى يقوم أحد مستخدمي proxy بنقل حركة مرور. يؤدي إغلاق أي من الشعارين إلى إخفاء كليهما.
بطاقات الملخص
خمس لوحات في الجزء العلوي، ولوحة سادسة عندما ينفذ Auto عمليات خلال الفترة المحددة:
| اللوحة | ما تعرضه |
|---|---|
| التزامن (Concurrency) | طلبات قيد التشغيل في نفس الوقت حاليا، بالإضافة إلى المتوسط والحد الأقصى للفترة |
| الطلبات (Requests) | إجمالي الاستدعاءات، ثم Single وProxy وBrowser وAuto، مع نسبة كل منها من الإجمالي أدناه. يُحسب استدعاء Auto مرة واحدة، تحت Auto. |
| محاولات Auto | تظهر فقط عند تشغيل Auto لأي شيء خلال الفترة. طلبات Single وProxy وBrowser التي أجراها Auto خلف استدعاءات Auto الخاصة بك، مع المحاولات لكل استدعاء Auto. لا تُحسب أبدا كطلبات أو ضمن معدل النجاح، وتكون أرصدتها مشمولة داخل أرصدة Auto. ولكنها تُحتسب ضمن حدود معدل الاستخدام والتزامن لكل من Single وProxy وBrowser. |
| الأرصدة (Credits) | الأرصدة المفوترة كقيمة أساسية، والأرصدة المستهلكة أدناها، للإجمالي ولكل منتج، بما في ذلك Auto |
| البايتات (Bytes) | البيانات المنقولة: الوارد (In) هو ما أرسلته، والصادر (Out) هو ما تم استلامه، والمميز (Premium) هو جزء حركة المرور الذي مر عبر مخرج مميز، سواء أدى هذا المخرج إلى تسليم الصفحة أم لا. يقع Premium داخل الإجماليين ولا يُضاف إليهما مطلقا. |
| زمن الاستجابة (Response Time) | المتوسط، والحد الأدنى، والحد الأقصى خلال الفترة |
المفوتر والمستهلك رقمان مختلفان. يتم فوترة الطلب الناجح فقط، لذا فإن المفوتر هو ما تدفع ثمنه. أما المستهلك فيشمل كل النتائج، لأن الطلب الفاشل يظل يستهلك proxy أو متصفحا. قراءة أحدهما باسم الآخر تجعل الحساب نفسه يبدو وكأنه حسابان مختلفان في صفحتين مختلفتين. راجع نتائج الطلبات لمعرفة النتائج الخاضعة للفوترة.
تسمي لوحتا Requests وCredits نقاط النهاية الأربع Single وProxy وBrowser وAuto. يسمي صف مرشح نقاط النهاية أعلاهما نقطة النهاية Proxy باسم Proxy Finder، وهو نفس الشيء: POST /api/proxy/.
لا يتطابق مجموع الأربعة دائما مع الإجمالي. يوجد عدد قليل من الاستدعاءات لا ينتمي لأي منها، ويتم احتسابها في الإجمالي دون احتسابها في أي نقطة نهاية.
المخططات البيانية للجدول الزمني
أسفل اللوحات، ترسم ستة مخططات بيانية زمنية حجم الطلبات، واستهلاك الرصيد، وتفصيل النتائج، وزمن الاستجابة، وعرض النطاق الترددي، والتزامن. يحتوي كل مخطط على مفتاح تبديل في رأسه للتبديل بين الرسم البياني والجدول الأساسي.
صفحة النظرة العامة، منتج Proxy
قم بتبديل المنتج إلى Proxy وستعرض الصفحة نفسها البيانات عبر الأنفاق (Tunnels). أربع لوحات:
| اللوحة | ما تعرضه |
|---|---|
| الأنفاق في نفس الوقت (Tunnels at Once) | الأنفاق المفتوحة في اللحظة ذاتها. يغطي Current الثواني القليلة الماضية ويتم تحديثه كل 5 ثوان؛ ويغطي Avg وMax الفترة المحددة. تحدد خطتك هذا الحد عبر جميع مستخدمي proxy معا. |
| الأنفاق (Tunnels) | الناجحة (Success) والفاشلة (Failed)، مع نسبة كل منها من الإجمالي. يشمل Failed كل نتيجة أخرى، ويوضح صف Outcome نوعها. |
| حركة المرور (Traffic) | الوارد (In) هو ما أرسلته أدواتك، والصادر (Out) هو ما تم استلامه، والمميز (Premium) هو الجزء الذي خرج عبر الشبكة المميزة، ومحسوب داخل الإجماليات وليس مضافا إليها. |
| وقت الإعداد (Setup Time) | متوسط (Avg) وحد أدنى (Min) وحد أقصى (Max) لوقت الانتظار قبل تسليم النفق، للأنفاق الناجحة فقط. إنه وقت الانتظار قبل وصول أول بايت لك، وليس سرعة الموقع خلف النفق. |
توجد خمسة مخططات زمنية أسفلها: Tunnel Timeline، وOutcome Timeline، وSetup Time Timeline، وTraffic Timeline، وTunnels at Once Timeline. يحتوي كل منها على نفس زر التبديل بين المخطط والجدول الموجود في مخططات API.
تصبح ثلاثة ألواح خافتة عند تفعيل خيار Outcome، والسبب في كل حالة هو عدم وجود الرقم لتلك النتيجة. يصبح لوح Tunnels at Once خافتاً تحت أي نتيجة. بينما يصبح لوحا Setup Time وTraffic خافتين عند نتيجة الفشل ويحملان شارة Success only، لأن النفق الفاشل لم يتم تسليمه مطلقاً ولم ينقل أي بيانات.
Period وDetail
يمثل Period النطاق الزمني للبيانات السابقة التي تستعرضها. ثمانية خيارات بالإضافة إلى Custom:
| Pill | Window |
|---|---|
| 30M | آخر 30 دقيقة |
| 3H | آخر 3 ساعات |
| 12H | آخر 12 ساعة |
| 24H | آخر 24 ساعة |
| 7D | آخر 7 أيام |
| 30D | آخر 30 يوماً |
| 90D | آخر 90 يوماً |
| 1Y | آخر 12 شهراً |
يفتح Custom نافذة حوارية تحتوي على أربعة إعدادات مسبقة: This month، وLast month، وLast 6 months، وAll time، بالإضافة إلى حقلي التاريخ From وTo. يمتد النطاق الزمني حتى نهاية اليوم الذي حددته، ولا يتجاوز اللحظة الحالية أبداً.
يمثل Detail عرض كل شريط: لكل دقيقة، أو كل 5 دقائق، أو كل 30 دقيقة، أو كل ساعة، أو كل 6 ساعات، أو يومياً، أو أسبوعياً، أو شهرياً. القيمة الافتراضية هي Auto، والتي تختار أكبر خطوة زمنية تُبقي 15 شريطاً على الأقل في المخطط، بحيث تظهر السنة كشكل واضح بدلاً من 365 خطاً دقيقاً. يوضح خيار Auto اسم الخطوة التي اختارها.
ينطبق كل من Period وDetail على كلا المنتجين.
تظهر خطوات Detail التي تتجاوز المدة الزمنية التي يحتفظ بها FourA بدقة البيانات بلون رمادي بدلاً من إخفائها:
| الدقة | إلى أي مدى زمني ترجع |
|---|---|
| Per-request | 7 أيام |
| 5-minute | 30 يوماً |
| Hourly | 12 شهراً |
| Daily | السجل بالكامل |
اختر فترة زمنية أقدم مما يسمح به المستوى وستظهر الخيارات الأكثر دقة بلون رمادي. لا يختار Auto أياً منها أبداً، لذلك لا يكون المخطط فارغاً بسبب تجميع البيانات.
Filters
تتراكم الفلاتر وتتكامل معاً، ويوجد Period وDetail إلى جانبها.
| Filter | Product | ما يفعله |
|---|---|---|
| Product | كلاهما | API أو Proxy |
| Endpoints | API | تحديد النطاق لـ endpoint واحد: Single، أو Proxy Finder، أو Browser، أو Auto. يتم احتساب استدعاء Auto مرة واحدة، تحت Auto؛ وتظهر طلبات Single وProxy وBrowser التي نفذتها عملياته التلقائية بالاسم في لوح محاولات Auto، ولا تظهر مطلقاً كطلبات منفصلة. |
| Outcome | كلاهما | عزل فئة واحدة. يوفر API جميع الفئات السبع؛ بينما يوفر منتج Proxy الفئات الخمس التي يمكن أن ينتهي بها النفق. |
| Owner | كلاهما | Everything، أو Personal، أو إحدى مؤسساتك. يظهر فقط عندما تنتمي إلى مؤسسة واحدة على الأقل. |
| Key | API | التقييد بمفتاح API واحد |
| Proxy user | Proxy | التقييد بمستخدم proxy واحد |
لا يقبل لوح ومخطط Concurrency في جانب API فلتر Endpoints أو Outcome. يصبح كلاهما خافتاً أثناء تفعيل أي منهما، ويوضح المخطط ذلك في الترويسة الخاصة به.
فلتر Owner
تُجيب القائمة المنسدلة Owner عن سؤال "ما هي حركة المرور التي أعرضها حالياً". وهي تتيح الخيارات Everything وPersonal، بالإضافة إلى خيار لكل مؤسسة تنتمي إليها. وتتبع نفس أداة التحكم في صفحات Metrics وActivity وAPI Keys وProxy اختيارك، بحيث تتطابق البيانات عبر الصفحات دائماً.
لا تتأثر صفحتا Usage & Limits وBilling بهذا التحديد عن قصد، فهما تُجيبان عن سؤال "ما هي التكاليف المحتسبة عليّ"، والتي تشمل مفاتيحك الشخصية ومستخدمي proxy الخاصين بك، إلى جانب مفاتيح ومستخدمي المؤسسات التي تملكها. راجع Organizations.
Sidebar Sections
أحد عشر قسماً موزعة على أربع مجموعات: Dashboard وTools وAccess وAccount.
Dashboard: Overview, Metrics, Activity
الصفحات الثلاث التي تُجيب عن "ماذا حدث". تحتوي جميعها على مفتاح تبديل Product.
صفحة Overview هي الصفحة الموضحة أعلاه، وهي دائماً نقطة البداية بعد تسجيل الدخول.
تتضمن صفحة Metrics لوحة Usage: تفصيل مجمّع حسب API key أو عنوان IP للعميل أو النطاق في جانب API، وحسب مستخدم proxy أو الهدف أو بلد الخروج أو عنوان IP للعميل أو النتيجة في جانب Proxy، مع بطاقات إحصائية للمدة بأكملها أعلى جدول مقسم لصفحات. راجع Metrics guide.
صفحة Activity هي بث مباشر لبيانات الساعة الأخيرة. يمثل كل صف في جانب API طلباً واحداً: الطريقة والنطاق المستهدف والحالة والنتيجة والمدة وحجم النقل والرصيد المستهلك. وفي جانب Proxy، يمثل كل صف نفقاً واحداً: مستخدم proxy والهدف ونقطة الخروج والنتيجة والإعداد والمدة وعدد البايتات وعنوان IP للعميل. راجع Activity Log.
Tools: Playground, Extension
اختبر الطلبات المباشرة باستخدام API key الحقيقي الخاص بك دون كتابة أي كود برمجي. اختر Auto أو Single أو Proxy أو Browser، وحدد URL، واضبط المعلمات والمهلات، ثم اضغط على Send. يمكنك حفظ التهيئات الشائعة كإعدادات مسبقة، وإعادة تشغيل أي من آخر 20 عملية تشغيل من History.
يُحسب الاستخدام من حصة المفتاح، تماماً كما هو الحال مع استدعاءات الإنتاج الفعلية. راجع Playground guide.
قسم Extension، المميز بعلامة Beta، هو المكان المخصص لتنزيل إضافة FourA لمتصفح Chrome. تتيح لك نافذتها المنبثقة توجيه حركة مرور Chrome عبر أحد مستخدمي proxy لديك، كما تحول علامة تبويب FourA في DevTools أي طلب ترسله الصفحة إلى استدعاء API جاهز. راجع Chrome Extension.
Access: API Keys, Proxy
قسم API Keys هو المكان المخصص لإنشاء وعرض وإدارة المفاتيح التي تستخدمها تطبيقاتك للاتصال بـ API. تستخدم المفاتيح البادئة pk_live_. راجع Managing API Keys.
قسم Proxy هو المكان المخصص لإنشاء مستخدمي proxy ونسخ سلسلة الاتصال لأي عميل يدعم عنوان proxy URL. تُحسب الأنفاق وحركة المرور عبر المنفذ من خطتك، تماماً مثل API. راجع Proxy Users ومرجع Proxy Port.
Account: Organizations, Usage & Limits, Billing, Settings
يتيح قسم Organizations مشاركة مفاتيح API ومستخدمي proxy مع الزملاء تحت مظلة مالك واحد. يمكنك إضافة الأعضاء عبر البريد الإلكتروني وتحديد أدوارهم ونقل ملكية المؤسسة عند الحاجة. يُحسب الاستخدام الخاص ببيانات اعتماد المؤسسة من خطة مالك المؤسسة. راجع Organizations.
يعرض قسم Usage & Limits خطتك، وما استهلكته خلال فترة الفاتورة الحالية، وجميع الحدود المفروضة عليك، مع تفصيل لكل مفتاح، ولكل endpoint، ولكل مستخدم proxy. راجع Usage & Limits.
يدير قسم Billing اشتراكك، وشراء المزيد من الرصيد أو حركة المرور، والاحتفاظ بوسائل الدفع والفواتير، كما يعرض الرصيد وحركة المرور وحركة المرور المتميزة لهذه الفترة مقارنة بخطتك. راجع Billing & Subscriptions.
يحتوي قسم Settings على اسم العرض الخاص بك، وكلمة المرور، والجلسات النشطة، وموفري تسجيل الدخول المتصلين. تغيير البريد الإلكتروني غير متاح في لوحة التحكم: تواصل مع الدعم الفني.
Tips
- استخدم Playground قبل كتابة التعليمات البرمجية. إذا كنت لا تعرف المحرك الذي يحتاجه موقع جديد، ابدأ بالخيار Auto ودعه يحدد ذلك تلقائيا.
- قارن بين الرصيد المفوتر والمستهلك في بطاقة الرصيد. إذا كان الفرق كبيرا بينهما عند نقطة نهاية endpoint معينة، فهذا يعني أنها تفشل بشكل متكرر، ويوضح تقرير المحاولات السبب.
- في منتج Proxy، وجود كتلة Rate Limited في المخطط الزمني للنتائج يشير إلى حدود خطتك، وليس رفض الموقع المستهدف لك. يحدد عرض النتائج في Metrics أيهما المعني.
- حافظ على أمان مفاتيح API ومستخدمي proxy. عطل أيا منها على الفور إذا ساورك شك في تعرضه للاختراق.
Next Steps
- Authentication: تفاصيل إنشاء مفاتيح API وإدارتها
- Quick Start: نفذ أول request لك عبر CLI
- How Your Plan Is Metered: الرصيد وحركة المرور والحد الأقصى المطبق عليك
- Usage & Limits: تتبع الرصيد وحركة المرور مقارنة بخطتك
- API Endpoints: استخدم API مباشرة