المراقبة#

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

لوحة معلومات عمليات النشر#

تعمل صفحة Deploy في الشريط الجانبي كلوحة معلومات للمراقبة لجميع عمليات النشر لديك. وهي تجمع خريطة العالم ومقاييس النظرة العامة وإدارة عمليات النشر في عرض واحد. راجع نقاط النهاية المخصصة لإنشاء عمليات النشر وإدارتها.

graph TB
    subgraph Dashboard
        Map[World Map]:::proc --- Cards[Overview Cards]:::proc
        Cards --- List[Deployments List]:::decide
    end
    subgraph "Per Ready Deployment"
        Monitoring[Monitoring Tab: Paid Endpoints]:::out
        Metrics[Metrics Row]:::out
        Health[Health Check]:::out
        Logs[Logs Tab]:::out
        Code[Code Tab]:::out
        Predict[Predict Tab]:::out
    end
    List --> Monitoring
    List --> Metrics
    List --> Health
    List --> Logs
    List --> Code
    List --> Predict

    classDef proc fill:#2196F3,color:#fff
    classDef decide fill:#FF9800,color:#fff
    classDef out fill:#9C27B0,color:#fff

بطاقات النظرة العامة#

تعرض أربع بطاقات تلخيصية في أعلى الصفحة ما يلي:

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

خريطة العالم#

تعرض خريطة العالم التفاعلية ما يلي:

• دبابيس المناطق لجميع المناطق المتاحة وعددها 42
• دبابيس خضراء للمناطق التي تضم عملية نشر جاهزة
• دبابيس زرقاء متحركة للمناطق التي تتقدم فيها عمليات نشر نشطة
• يختلف حجم الدبوس استنادًا إلى حالة النشر وزمن الاستجابة

انقر على أي منطقة لفتح مربع الحوار New Deployment. تُخفى الخريطة على الشاشات الصغيرة.

قائمة عمليات النشر#

أسفل بطاقات النظرة العامة، تعرض قائمة عمليات النشر جميع نقاط النهاية عبر مشاريعك. استخدم مفتاح تبديل وضع العرض للتبديل بين ما يلي:

المقاييس لكل عملية نشر#

تعرض كل بطاقة نشر (في عرض البطاقات) مقاييس في الوقت الفعلي. ولا يظهر صف المقاييس وفحص السلامة وعلامات التبويب Logs وCode وPredict الموضحة أدناه إلا أثناء وجود عملية النشر في حالة جاهز:

صف المقاييس#

تُحدّث المقاييس تلقائيًا. وتعرض نقاط النهاية التي لم تخدم أي طلب بعد العبارة "لا توجد حركة مرور بعد"، ولا تُجمع المقاييس إلا لعمليات النشر الموجودة في حالة جاهز. وفي لوحة معلومات عمليات النشر، تُجلب المقاييس لأحدث 20 عملية نشر.

فحص الحالة#

تعرض عمليات النشر قيد التشغيل مؤشرًا لفحص السلامة:

تُعيد فحوصات السلامة المحاولة تلقائيًا أثناء عدم السلامة، وتتوقف بمجرد استجابة نقطة النهاية. انقر على أيقونة التحديث لتشغيل فحص السلامة يدويًا، وهو ما يعمل أيضًا على تهيئة نقطة النهاية التي جرى تحجيمها إلى الصفر قبل إرسال حركة المرور.

علامة تبويب المراقبة#

افتح النشر (Deploy)، وانتقل إلى عرض البطاقات (Cards)، وحدد المراقبة (Monitoring) على نقطة نهاية مخصصة مدفوعة وجاهزة (Ready). أرسل صورة عبر علامة تبويب التنبؤ (Predict) الخاصة بها أو واجهة برمجة تطبيقات نقطة النهاية لملء الأمثلة المؤقتة (Temporary Examples) وإحصائيات التنبؤ (Prediction Statistics). قبل معالجة الصورة الأولى، تعرض علامة التبويب لم يتم معالجة أي صور.

الأمثلة المؤقتة#

يحتوي المعرض على عينة متجددة من الصور المعالجة مع تراكبات التنبؤ. افتح صورة لفحص تنبؤاتها في عارض ملء الشاشة واستخدم عناصر تحكم الرؤية لتعديل التراكبات. يعرض المعرض في البداية ما يصل إلى 12 مثالاً؛ ويقوم خيار عرض الكل بتوسيع المعرض.

• أخذ العينات: ما يصل إلى مثالين في البداية، ثم ما يصل إلى صورة إضافية واحدة في الدقيقة. الالتقاط هو جهد أقصى؛ ولا ينتظر الاستدلال ترميز الأمثلة.
• السعة: ما لا يزيد عن 100 صورة ضمن ميزانية ذاكرة مشتركة تبلغ 100 ميغابايت للصور المضغوطة، والبيانات الوصفية للتنبؤ، والأصول المرتبطة. تسمي واجهة الاستخدام هذه الميزانية 100 ميغابايت.
• الاستبدال: يتم استبدال الأمثلة الأقدم عند الوصول إلى أي من الحدين. قد تصبح الأمثلة غير متوفرة أثناء عرضها.
• التخزين: تبقى الأمثلة المؤقتة في ذاكرة نقطة النهاية. يؤدي حفظها في مجموعة بيانات إلى استخدام حدود التخزين والمعالجة العادية لمساحة العمل.

حفظ الأمثلة في مجموعة بيانات#

يمكن لأعضاء مساحة العمل الذين يمتلكون إذن تحرير المحتوى حفظ الأمثلة في مجموعة بيانات ضمن مساحة عمل نقطة النهاية:

1. حدد الأمثلة الفردية باستخدام مربعات الاختيار الخاصة بها، أو انقر فوق تحديد الكل.
2. انقر فوق حفظ في مجموعة البيانات.
3. اختر مجموعة بيانات موجودة لها نفس المهمة الخاصة بالنموذج المنشور. يتم استبعاد مجموعات البيانات ذات المصدر المتصل؛ أنشئ مجموعة بيانات متوافقة أولاً إذا لم تكن أي منها متوفرة.
4. انقر فوق زر الحفظ، الذي يُظهر عدد الصور المحددة، ثم افتح مجموعة البيانات لمتابعة المعالجة.

يتم نسخ الصور والتنبؤات المحددة عبر سير عمل تحميل واستيعاب مجموعات البيانات القياسي. تنطبق الحصة العادية، وتعيين الفئات، ومعالجة التكرار. يترك الحفظ الأمثلة المؤقتة في المعرض؛ وتنجو صور مجموعة البيانات المستوعبة بنجاح من عمليات إعادة تشغيل نقطة النهاية وحذفها. راجع التسميات المتنبأ بها قبل استخدامها للتدريب.

لإزالة الأمثلة المؤقتة، استخدم عنصر تحكم سلة المهملات الذي يظهر عند تحويم الماوس فوق الصورة أو حدد الأمثلة وانقر فوق زر سلة المهملات المجمعة، ثم أكد الحذف. لا يؤدي حذف الأمثلة إلى تغيير إحصائيات التنبؤ الإجمالية وال이미ജات التي تم حفظها مسبقاً في مجموعات البيانات.

إحصائيات التنبؤ#

تجمع الإحصائيات الصور المعالجة بشكل مستقل عن أخذ عينات المعرض. لا يؤدي حذف مثال أو استبداله إلى طرح مساهمته. يعرض الملخص الصور، والتنبؤات، وال이미ജات بدون تنبؤات للفترة المحددة؛ وتظهر نماذج العمق تعداد الصور.

يستند محدد التاريخ افتراضياً إلى آخر 30 يوماً ويقبل نطاقات تصل إلى 365 يوماً. تستخدم التواريخ المحددة حدود التوقيت العالمي المنسق (UTC)؛ وتُعرض الطوابع الزمنية للمخططات بالتوقيت المحلي. تستخدم النطاقات الحديثة التي تصل إلى ثلاثة أيام السجل الساعي عندما يقع النطاق الكامل ضمن آخر 72 ساعة؛ وتستخدم النطاقات الأخرى السجل اليومي. يقوم نطاق التاريخ بتصفية الإحصائيات، بينما يستمر المعرض في عرض الأمثلة المؤقتة الحالية.

يتم تقييد السجل بـ 72 مجموعة ساعية و365 مجموعة يومية، وهو متوفر فقط منذ بدء تشغيل المثيل الحالي. تعرض الفترة المحددة التي لا تحتوي على صور معالجة رسالة لم يتم معالجة أي صور في هذه الفترة.

تعتمد المخططات المتوفرة على المهمة والتنبؤات المجمعة:

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

السجلات#

تتضمن كل بطاقة نشر علامة تبويب Logs لعرض أحدث إدخالات السجل:

إدخالات السجل#

يعرض كل إدخال في السجل ما يلي:

تعرض واجهة المستخدم أحدث 20 إدخالًا وتخفي الإدخالات الفارغة. وتستخدم API افتراضيًا 50 إدخالًا لكل طلب (بحد أقصى 200)، وتُرجع nextPageToken للترحيل إلى إدخالات أقدم.

أمثلة التعليمات البرمجية#

تتضمن كل بطاقة نشر علامة تبويب Code تعرض تعليمات برمجية لواجهة API جاهزة للاستخدام، مع تعبئة عنوان URL لنقطة النهاية. وبالنسبة إلى مالكي مساحة العمل، يُدرج مفتاح API المرتبط بالنشر، ويكون جاهزًا للنسخ والتشغيل. أما غير المالكين، فتظهر لهم قيمة نائبة YOUR_API_KEY:

import requests

# Deployment endpoint
url = "https://YOUR_DEPLOYMENT_URL.run.app/predict"

# Headers with your deployment API key
headers = {"Authorization": "Bearer YOUR_API_KEY"}

# Inference parameters
data = {"conf": 0.25, "iou": 0.7, "imgsz": 640}

# Send image for inference
with open("image.jpg", "rb") as f:
    response = requests.post(url, headers=headers, data=data, files={"file": f})

print(response.json())

التنبؤ عبر النشر#

توفر علامة التبويب Predict في كل بطاقة نشر لوحة تنبؤ مضمنة — وهي الواجهة نفسها الموجودة في علامة التبويب Predict للنموذج، لكنها تُجري الاستدلال عبر نقطة نهاية النشر بدلًا من الخدمة المشتركة. يفيد ذلك في اختبار نقطة نهاية منشورة مباشرةً من المتصفح. راجع الاستدلال لمعرفة تفاصيل المعلمات وتنسيقات الاستجابة.

نقاط نهاية API#

يُعنون كل نشر باسم مالكه واسم النشر، وتتطلب كل مساراته مفتاح API. راجع مرجع API للحصول على تفاصيل المصادقة.

مقاييس النشر#

GET /api/deployments/{owner}/{deployment}/metrics?range=24h

Python SDK: client.deployments.metrics(owner, deployment, range="24h")

يعيد حمولة المقاييس الكاملة للنشر: كتلة summary التي تتضمن إجمالي الطلبات، وعدد الأخطاء ومعدلها، ومتوسط زمن الاستجابة وP50 وP95 وP99، بالإضافة إلى مصفوفات timeSeries للطلبات والأخطاء وزمن استجابة P50 وP95 واستخدام CPU والذاكرة وعدد المثيلات.

مع sparkline=true، تكون الاستجابة بالشكل الموجز الذي تستخدمه بطاقات النشر — أعداد الطلبات لكل ساعة على مدار 24 ساعة، بالإضافة إلى إجمالي الطلبات ومعدل الأخطاء ومتوسط زمن الاستجابة. هذا هو الاستدعاء الذي يُحدّث كل 60 ثانية.

سجلات النشر#

GET /api/deployments/{owner}/{deployment}/logs?limit=50&severity=ERROR,WARNING

Python SDK: client.deployments.logs(owner, deployment, limit=50, severity="ERROR,WARNING")

يعيد إدخالات السجل الحديثة مع مرشح اختياري لدرجة الخطورة وترقيم الصفحات.

سلامة النشر#

GET /api/deployments/{owner}/{deployment}/health

Python SDK: client.deployments.health(owner, deployment)

يرسل طلب اختبار إلى النشر ويعيد حالة سلامته مع زمن الاستجابة ذهابًا وإيابًا المقاس:

{
    "healthy": true,
    "status": 200,
    "latencyMs": 142
}

تحذف الاستجابة غير السليمة status عندما يتعذر الوصول إلى نقطة النهاية على الإطلاق، وتضيف رسالة error.

تحسين الأداء#

استخدم بيانات المراقبة لتحسين عمليات النشر:

الأسئلة الشائعة#