المراقبة#

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

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

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

graph TB
    subgraph Dashboard
        Map[World Map]:::proc --- Cards[Overview Cards]:::proc
        Cards --- List[Deployments List]:::decide
    end
    subgraph "Per Ready Deployment"
        Metrics[Metrics Row]:::out
        Health[Health Check]:::out
        Logs[Logs Tab]:::out
        Code[Code Tab]:::out
        Predict[Predict Tab]:::out
    end
    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

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

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

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

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

تُظهر خريطة العالم التفاعلية:

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

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

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

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

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

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

صف المقاييس#

تتم تحديث المقاييس تلقائياً. نقاط النهاية التي لم تقم بخدمة أي طلب تُظهر "لا توجد حركة مرور حتى الآن"، ويتم جمع المقاييس فقط لعمليات النشر في حالة الجهوزية (Ready). على لوحة معلومات عمليات النشر، يتم جلب المقاييس لأحدث 20 بعملية نشر.

فحص الصحة#

تُظهر عمليات النشر قيد التشغيل مؤشراً للتحقق من السلامة:

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

السجلات#

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

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

يظهر كل إدخال سجل:

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

أمثلة برمجية#

تتضمن كل بطاقة نشر علامة تبويب Code تعرض كود واجهة برمجة التطبيقات الجاهز للاستخدام مع إدخال عنوان 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 الخاصة بالنموذج، ولكنها تقوم بتنفيذ الاستدلال من خلال نقطة نهاية النشر بدلاً من الخدمة المشتركة. هذا مفيد لاختبار نقطة نهاية منشورة مباشرة من المتصفح. راجع Inference للحصول على تفاصيل المعلمات وتنسيقات الاستجابة.

نقاط نهاية 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)

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

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

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

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

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

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