Meet YOLO26: next-gen vision AI.

Link to this sectionالمراقبة#

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

بطاقات نظرة عامة وخريطة العالم لصفحة النشر في Ultralytics Platform

Link to this sectionلوحة تحكم عمليات النشر#

تعمل صفحة 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

Link to this sectionبطاقات النظرة العامة#

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

أربع بطاقات نظرة عامة لصفحة النشر في Ultralytics Platform

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

يتم تمييز بطاقة معدل الخطأ باللون الأحمر عندما يتجاوز المعدل 5%. تحقق من علامة التبويب Logs في عمليات النشر الفردية لتشخيص الأخطاء.

Link to this sectionخريطة العالم#

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

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

خريطة العالم لصفحة النشر في Ultralytics Platform مع المناطق المنشورة

Link to this sectionقائمة عمليات النشر#

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

عرضالوصف
بطاقاتبطاقات تفصيلية كاملة تحتوي على علامات تبويب للمقاييس والسجلات والتعليمات البرمجية والتنبؤ
مدمج (Compact)شبكة من البطاقات الأصغر (1-4 أعمدة) مع المقاييس الرئيسية
جدولجدول بيانات (DataTable) مع أعمدة قابلة للفرز: الاسم، المنطقة، الحالة، الطلبات، P95، الأخطاء
التحديثات في الوقت الفعلي

تقوم لوحة التحكم بالاقتراع كل 15 ثانية لتحديثات حالة النشر. عندما تكون عمليات النشر في حالة انتقالية (creating أو deploying أو stopping)، يزداد معدل الاقتراع إلى كل 3 ثوانٍ. يتم تحديث مخططات المقاييس كل 60 ثانية. انقر فوق زر التحديث للحصول على تحديثات فورية.

Link to this sectionمقاييس كل عملية نشر#

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

Link to this sectionصف المقاييس#

المقياسالوصف
الطلباتعدد الطلبات (24 ساعة) مع الأيقونة
زمن الاستجابة P95زمن الاستجابة للشريحة المئوية 95
معدل الخطأنسبة الطلبات الفاشلة

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

Link to this sectionفحص الصحة#

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

المؤشرالمعنى
قلب أخضرسليم - يظهر زمن استجابة الطلب
قلب أحمرغير سليم - يظهر رسالة خطأ
أيقونة تدورالتحقق من السلامة قيد التقدم

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

بطاقة نشر Ultralytics Platform مع حالة سلامة سليمة وزمن استجابة

تحمل البدء البارد

يستخدم التحقق من السلامة مهلة 55 ثانية لحساب أوقات البدء البارد في نقاط النهاية التي يتم تحجيمها إلى الصفر (حتى حوالي 45 ثانية في أسوأ الحالات). بمجرد إحماء نقطة النهاية، تكتمل عمليات التحقق من السلامة في أجزاء من الثانية.

Link to this sectionالسجلات#

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

علامة تبويب السجلات في بطاقة نشر Ultralytics Platform مع عامل تصفية الخطورة

Link to this sectionإدخالات السجل#

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

الحقلالوصف
الخطورةشريط مرمّز بالألوان (انظر أدناه)
الطابع الزمنيوقت الطلب (بالتنسيق المحلي)
الرسالةمحتوى السجل
معلومات HTTPرمز الحالة وزمن الاستجابة (إن وجد)

قم بتصفية السجلات حسب الخطورة باستخدام أزرار التصفية:

المستوىاللونالوصف
DEBUGرماديرسائل التصحيح
INFOأزرقالطلبات العادية
WARNINGأصفرمشكلات غير حرجة
ERRORأحمرالطلبات الفاشلة
CRITICALأحمر داكنالإخفاقات الحرجة

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

سير عمل التصحيح

عند التحقيق في الأخطاء: انقر أولاً على Errors للتصفية لإدخالات ERROR و WARNING، ثم راجع الطوابع الزمنية ورموز حالة HTTP. انسخ السجلات إلى الحافظة لمشاركتها مع فريقك.

Link to this sectionأمثلة برمجية#

تتضمن كل بطاقة نشر علامة تبويب 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())
بيانات الاعتماد المعبأة تلقائياً

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

Link to this sectionتوقع النشر#

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

Link to this sectionنقاط نهاية API#

Link to this sectionنظرة عامة على المراقبة#

GET /api/monitoring

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

Link to this sectionمقاييس النشر#

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

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

المعاملالنوعالوصف
sparklineمنطقي (bool)تضمين بيانات المخطط المصغر
rangestringالنطاق الزمني: 1h أو 6h أو 24h أو 7d أو 30d

Link to this sectionسجلات النشر#

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

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

المعاملالنوعالوصف
limitintالحد الأقصى للإدخالات المراد إرجاعها (الافتراضي: 50، الحد الأقصى: 200)
severitystringعامل تصفية الخطورة مفصول بفواصل
pageTokenstringرمز الترقيم من الاستجابة السابقة

Link to this sectionصحة النشر#

GET /api/deployments/{deploymentId}/health

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

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

Link to this sectionتحسين الأداء#

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

إذا كان زمن الانتقال مرتفعًا جدًا:

  1. تحقق من عدد المثيلات (قد تحتاج إلى المزيد)
  2. تحقق من أن حجم النموذج مناسب
  3. فكر في منطقة أقرب
  4. تحقق من أحجام الصور التي يتم إرسالها
تقليل زمن الانتقال

قم بالتبديل من imgsz=1280 إلى imgsz=640 للحصول على تسريع بمقدار ~4 أضعاف مع حد أدنى من فقدان الدقة لمعظم حالات الاستخدام. انشر في منطقة أقرب إلى مستخدميك للحصول على زمن انتقال أقل للشبكة.

Link to this sectionالأسئلة الشائعة#

Link to this sectionما المدة التي يتم فيها الاحتفاظ بالبيانات؟#

نوع البياناتالاحتفاظ
المقاييس (Metrics)30 يومًا
السجلات7 أيام

Link to this sectionهل يمكنني إعداد مراقبة خارجية؟#

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

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

Link to this sectionما مدى دقة أرقام زمن الانتقال؟#

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

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

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

Link to this sectionلماذا تتأخر مقاييسي؟#

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

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

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

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

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

التعليقات