النشاط والسجلات
في هذه الصفحة
تغطي علامتا تبويب المراقبة: Activity (تحليلات مجمّعة) وLogs (سجل التدقيق لكل طلب). تشمل كلتاهما كل مفتاح API وكل خدمة متصلة، وكلتاهما تسجّلان البيانات الوصفية فقط، ولا يُخزَّن محتوى المطالبات والاستجابات أبدًا.
علامة التبويب Activity
تضم Activity أربعة عروض، هي Overview وTrends وPerformance وExplore، إضافة إلى زر Export. تتشارك جميع العروض عناصر التحكم في الترويسة: التصفية حسب Key / agent، والتصفية حسب Model، ومنتقي Range (Last 24 hours أو Last 7/30/90 days أو Year أو All time أو Custom range).
نظرة عامة
الشكل 1: ترويسة Activity (علامات تبويب العروض، وعوامل التصفية، والنطاق، وExport) وبطاقات مؤشرات الأداء الرئيسية
بطاقات مؤشرات الأداء الرئيسية، وتتضمن كل منها مقارنة بالفترة السابقة ("vs prev" / "No prior data"):
| مؤشر الأداء | المعنى |
|---|---|
| Spend this period | "Total spend over the selected date range."، مع متوسط التكلفة لكل طلب. |
| Requests | عدد الطلبات. |
| Token volume | إجمالي الرموز المميزة. |
| Error rate | "Share of requests in this period that returned an error." |
الشكل 2: Top API keys & agents وTop sources
ترتّب Top API keys & agents المفاتيح والخدمات المتصلة حسب الإنفاق، وتقسّم Top sources الاستخدام بين مفاتيح API والوكلاء ومهام سير العمل.
وأسفل ذلك، تعرض ثلاثة مخططات تفصيل الاستخدام حسب النموذج وحسب نوع الرمز المميز.
الشكل 3: Usage by model: الإنفاق بمرور الوقت لكل نموذج
الشكل 4: Request volume by model
الشكل 5: Token breakdown (رموز المطالبة والإكمال والاستدلال)
حيثما ينطبق التخزين المؤقت للمطالبات، تعرض بطاقة Prompt token caching قيمة Cache hit rate، أي "Share of prompt tokens served from the provider prompt cache."، إلى جانب أحجام الرموز المميزة المخزّنة مؤقتًا مقابل غير المخزّنة.
الشكل 6: Prompt token caching
الاتجاهات
الشكل 7: Trends: النماذج بمرور الوقت مع قائمة Trending؛ ويقع مبدّل المقياس (Tokens وSpend وRequests) أعلى اليمين
تعرض Trends التحركات: يُرسم مخطط لكل نموذج (ولكل مفتاح أو وكيل، في قسم خاص به) بمرور الوقت، مع قائمة Trending بالعناصر الصاعدة، بما في ذلك شارة New للعناصر التي لم يكن لها استخدام في الفترة السابقة.
الأداء
الشكل 8: Performance: مؤشرات وقت الاستجابة والإنتاجية والأخطاء، مع Average latency over time وErrors over time
| مؤشر الأداء | المعنى |
|---|---|
| Median latency | "Median (p50) end-to-end request duration over the selected range." |
| p95 latency | "95th-percentile request duration — the slow tail most users feel." |
| Avg time to first token | "Average delay before the first streamed token (streaming requests only)." |
| Throughput | "Average output generation speed across requests." (tok/s) |
| Error rate / Total errors | الأخطاء في الفترة المحددة. |
الشكل 9: Reliability & performance by model، مع Top failing models وTop failing keys & agents
يُعد الجدول الخاص بكل نموذج (الطلبات، ومعدل الأخطاء، ومتوسط وقت الاستجابة ووقت الاستجابة p95، والإنتاجية، والإنفاق) أسرع طريقة لاكتشاف نموذج يعمل بشكل غير سليم؛ وتشير قوائم العناصر المتعثرة مباشرة إلى ما يجب التحقيق فيه. إذا لم تكن هناك إخفاقات، فسترى "No errors in this period".
استكشاف
الشكل 10: Explore: جدول محوري لاستخدامك مع Metric وGroup by وThen by وShow top
Explore جدول محوري حر: اختر Metric (مثل Spend)، وGroup by (Model أو API key / agent أو Source أو Provider أو Status)، ويمكنك اختياريًا إضافة مستوى متداخل باستخدام Then by، وتحديد طول القائمة باستخدام Show top. والنتيجة تفصيل مرتّب مع Value و**% of Total**. تتيح لك إجراءات الصفوف Apply filters based on this model (أو المفتاح أو الوكيل) والانتقال إلى View in logs.
تصدير بيانات النشاط
انقر على Export لفتح مربع حوار التصدير:
الشكل 11: Export activity data: ما يُصدَّر، ونطاق التاريخ، وعوامل التصفية، والأعمدة
- ما يُصدَّر: Raw requests (صف CSV واحد لكل طلب) أو ملخص، وهو Summary by model أو Summary by key & agent أو Summary by source أو Summary by period.
- نطاق التاريخ وعوامل التصفية: يُنقل نطاق العرض الحالي وعوامل التصفية الخاصة به ويمكن تعديلها. يعرض مربع الحوار العدد التقريبي للصفوف ("approx. … requests")؛ ويبلغ الحد الأقصى لعمليات التصدير الأولية 25,000 صف (تظهر الرسالة "export is capped at 25,000" عندما يتجاوز النطاق ذلك).
- الأعمدة: في عمليات التصدير الأولية، اختر من Time (UTC) وRequest ID وModel وProvider وStatus وKey / agent وKey hash وSource وEnd user وPrompt/Completion/Total/Cached/Reasoning tokens وSpend (USD) وDuration (ms) وTTFT (ms) وTokens/sec وCache hit وZero completion وIP، مع Select all / Clear all.
علامة التبويب Logs
علامة التبويب Logs هي سجل التدقيق طلبًا بطلب.
الشكل 12: Logs: البحث، وعوامل التصفية، والتحديث المباشر، وجدول الطلبات
- البحث ("Search request ID, key, model…") إضافة إلى عوامل تصفية حسب Status (Success / Failed / All) وKey / agent وModel وProvider.
- إعدادات Range المسبقة: Last 15 minutes وLast hour وLast 24 hours (الافتراضي) وLast 7 days وLast 30 days، أو اختر تواريخ مخصصة.
- يقع Live بجوار النطاق ويحدّث الجدول تلقائيًا: اختر Off أو 10s أو 30s (الافتراضي) أو 60s. يعرض عدّاد تنازلي موعد التحديث التالي، ويفرض Refresh now تحديثًا فوريًا. يُخفى Live عندما ينتهي نطاق مخصص في الماضي.
الشكل 13: عنصر التحكم Live: تحديث Off أو 10s أو 30s أو 60s، بجوار منتقي النطاق
- يعرض المدرج التكراري حجم الطلبات على مدى النطاق (مع إبراز الأخطاء)؛ اسحب لتحديد منطقة منه لتكبير الجدول على تلك الفترة ("Showing logs for …"، مع Clear selection).
- يفتح Export مربع الحوار Export request logs: اختر الطلبات الأولية أو ملخصًا، ونطاق التاريخ، وعوامل التصفية (Key / agent وModel وProvider وStatus، إضافة إلى نص البحث الحالي)، والأعمدة في عمليات التصدير الأولية.
بالنسبة إلى الملخصات، يشير مربع الحوار إلى أن: "Summaries cover whole days, so a sub-day or graph selection is widened to full days." و*"The search text is not applied to summaries."*
يعرض كل صف التاريخ، ومعرّف الطلب، والنموذج، والمزوّد، ورموز الإدخال والإخراج، والوكيل أو المفتاح، والسرعة (tok/s)، والتكلفة، والحالة (success / failure). تميّز شارة No charge الاستجابات الفاشلة أو الفارغة التي لم تكلّف شيئًا. وتشير شارة cached على عدد رموز الإدخال إلى الرموز المقدَّمة من ذاكرة التخزين المؤقت للمطالبات، ويعرض التذييل "Showing … of …". وتعرض النتيجة الفارغة "No requests yet." أو "No requests match your filters."
تفاصيل الطلب
انقر على صف لفتح درج Request details:
الشكل 14: Request details: البيانات الوصفية، وأعداد الرموز المميزة، والتكلفة
| القسم | الحقول |
|---|---|
| Request | Request ID (قابل للنسخ)، وTime، وStatus، وModel (النموذج الذي خدم الطلب)، وRequested model (مثل auto عندما يختار Auto Router النموذج)، وProvider، وIP address، وCache hit، وLatency، وTime to first token، وAPI base (المضيف الأولي) عند تسجيله. |
| Tokens | Prompt tokens، وCompletion tokens، وTotal tokens، وSpeed، إضافة إلى Cached tokens (read/write) وReasoning tokens عند وجودها. |
| Cost | التكلفة الدقيقة للطلب. |
| Source | Key / Agent (مفتاح API أو الوكيل الذي أجرى الاستدعاء) وEnd user (معرّف المستخدم النهائي، إذا قدّمه المستدعي). |
لا يوجد عمدًا أي محتوى للمطالبات أو الاستجابات في أي مكان في السجلات.