المراقبة#

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

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

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

graph TB
    subgraph Dashboard
        Map[World Map]:::proc --- Cards[Overview Cards]:::proc
        Cards --- List[Deployments List]:::decide
    end
    subgraph "Per 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

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

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

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

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

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

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

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

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

تعرض كل بطاقة نشر (في عرض البطاقات) مقاييس في الوقت الفعلي:

صف المقاييس#

يتم جلب المقاييس من نقطة نهاية API الخاصة بالمخططات الصغيرة (sparkline) ويتم تحديثها كل 60 ثانية.

فحص الصحة#

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

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

السجلات#

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

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

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

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

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

تتضمن كل بطاقة نشر علامة تبويب Code تعرض تعليمات برمجية جاهزة للاستخدام مع API باستخدام عنوان URL الفعلي لنقطة النهاية ومفتاح API الخاص بك:

import requests

# Deployment endpoint
url = "https://predict-abc123.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#

نظرة عامة على المراقبة#

GET /api/monitoring

تُرجع مقاييس مجمعة لجميع عمليات النشر المملوكة للمستخدم المصدق. واعية بمساحة العمل عبر معلمة الاستعلام الاختيارية owner.

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

GET /api/deployments/{deploymentId}/metrics?sparkline=true&range=24h

تُرجع بيانات المخطط المصغر (sparkline) ومقاييس ملخصة لنشر معين. الفاصل الزمني للتحديث: 60 ثانية.

سجلات النشر#

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

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

صحة النشر#

GET /api/deployments/{deploymentId}/health

تُرجع حالة التحقق من الصحة مع زمن انتقال الاستجابة.

{
    "healthy": true,
    "status": 200,
    "latencyMs": 142,
    "serverTiming": { "db": 8, "ping": 142, "total": 150 }
}

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

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

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

ما المدة التي يتم فيها الاحتفاظ بالبيانات؟#

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

هل يمكنني مراقبة نقاط نهاية متعددة معًا؟#

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