المراقبة

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

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

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

graph TB
    subgraph Dashboard
        Map[World Map] --- Cards[Overview Cards]
        Cards --- List[Deployments List]
    end
    subgraph "Per Deployment"
        Metrics[Metrics Row]
        Health[Health Check]
        Logs[Logs Tab]
        Code[Code Tab]
        Predict[Predict Tab]
    end
    List --> Metrics
    List --> Health
    List --> Logs
    List --> Code
    List --> Predict

    style Dashboard fill:#f5f5f5,color:#333
    style Map fill:#2196F3,color:#fff
    style Cards fill:#FF9800,color:#fff
    style List fill:#4CAF50,color:#fff

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

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

خريطة العالم

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

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

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

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

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

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

صف المقاييس

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

فحص الصحة (Health Check)

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

تتم إعادة محاولة فحوصات الحالة تلقائيًا كل 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())

تنبؤ النشر (Deployment Predict)

توفر علامة التبويب 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
}

تحسين الأداء

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

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

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

هل يمكنني إعداد مراقبة خارجية؟

نعم، تعمل عناوين URL لنقاط النهاية مع أدوات المراقبة الخارجية:

• مراقبة وقت التشغيل (Pingdom، UptimeRobot)
• أدوات APM (Datadog، New Relic)
• فحوصات الصحة المخصصة عبر نقطة النهاية /health

ما مدى دقة أرقام زمن الانتقال؟

تقيس مقاييس زمن الانتقال:

• P50: وقت الاستجابة المتوسط
• P95: النسبة المئوية 95
• P99: النسبة المئوية 99

تمثل هذه الأرقام وقت المعالجة من جانب الخادم، ولا تشمل زمن انتقال الشبكة إلى مستخدميك.

لماذا تتأخر المقاييس الخاصة بي؟

تتمتع المقاييس بتأخير يبلغ ~دقيقتين بسبب:

• خط أنابيب تجميع المقاييس
• نوافذ التجميع
• تخزين لوحة المعلومات مؤقتاً

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

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

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