المراقبة#

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

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

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

graph TB
    subgraph "Deployments Tab"
        Map[World Map]:::proc --- Cards[Overview Cards]:::proc
        Cards --- List[Deployments List]:::decide
    end
    subgraph "Deployment Page"
        Metrics[Metrics Cards]:::out
        Overview[Overview Tab: Endpoint and Health Check]:::out
        Monitoring[Monitoring Tab]:::out
        Predict[Predict Tab]:::out
        Logs[Logs Tab]:::out
    end
    List --> Metrics
    List --> Overview
    List --> Monitoring
    List --> Predict
    List --> Logs

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

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

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

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

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

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

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

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

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

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

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

تعرض صفحة كل عملية نشر مقاييس آنية أعلى علامات التبويب Overview وMonitoring وPredict وLogs:

بطاقات المقاييس#

تعرض كل بطاقة مخططًا مصغرًا، وتُحدّث كل دقيقة، بجوار بطاقة ترتبط بالنموذج المنشور. تُجمع المقاييس لعمليات النشر الموجودة في حالة Ready فقط. وفي علامة تبويب Deployments، تُجلب المقاييس لأحدث 20 عملية نشر.

فحص الحالة#

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

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

علامة تبويب Monitoring#

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

أمثلة مؤقتة#

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

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

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

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

1. حدّد أمثلة فردية باستخدام مربعات الاختيار الخاصة بها، أو انقر على Select all.
2. انقر على Save to dataset.
3. اختر مجموعة بيانات موجودة تتطابق مهمتها مع مهمة النموذج المنشور. تُستثنى مجموعات البيانات ذات المصادر المتصلة؛ أنشئ مجموعة بيانات متوافقة أولًا إذا لم تتوفر واحدة.
4. انقر على الزر Save، الذي يعرض عدد الصور المحددة، ثم افتح مجموعة البيانات لمتابعة المعالجة.

تُنسخ الصور والتنبؤات المحددة عبر سير العمل القياسي لرفع مجموعة البيانات واستيعابها. وتسري الحصص المعتادة وتعيين الفئات ومعالجة التكرارات. لا يؤدي الحفظ إلى إزالة الأمثلة المؤقتة من المعرض؛ وتبقى صور مجموعة البيانات التي استُوعبت بنجاح بعد إعادة تشغيل نقطة النهاية وحذفها. راجع التسميات المتوقعة قبل استخدامها في التدريب. يسجّل كل مثال محفوظ deploymentId وdeploymentName وdeploymentRegion وdeploymentRegionName في البيانات الوصفية المخصصة، ويطابق بحث مجموعة البيانات هذه البيانات؛ وتُسجّل الأسماء كما كانت وقت الحفظ، وتحتفظ الصورة التي تم تخطيها باعتبارها مكررة ببياناتها الوصفية الحالية.

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

إحصاءات التنبؤ#

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

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

يقتصر السجل على 72 خانة ساعية و365 خانة يومية، ولا يتوفر إلا منذ بدء المثيل الحالي. وتعرض الفترة المحددة التي لم تُعالج فيها أي صور No images processed in this period.

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

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

السجلات#

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

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

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

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

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

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

import requests

# ⁨نقطة نهاية النشر⁩
url = "https://YOUR_DEPLOYMENT_URL.run.app/predict"

# ⁨الترويسات التي تتضمن مفتاح API الخاص بالنشر⁩
headers = {"Authorization": "Bearer YOUR_API_KEY"}

# ⁨معلمات الاستدلال⁩
data = {"conf": 0.25, "iou": 0.7, "imgsz": 640}

# ⁨إرسال صورة للاستدلال⁩
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 ساعة (مع حذف الساعات التي لم تُسجّل فيها طلبات)، بالإضافة إلى إجمالي الطلبات ومعدل الأخطاء وavgLatencyMs، وهو متوسط أزمنة الاستجابة عند P95 لكل ساعة. ومع view=overview، يحتوي summary على totalRequests وerrorRate وp95LatencyMs، بينما يحتوي timeSeries على requests وerrors وlatencyP95؛ وتستخدم بطاقات الإحصاءات في صفحة النشر هذا العرض وتُحدَّث تلقائيًا.

سجلات النشر#

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.

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

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

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