تخطي إلى المحتوى

المراقبة

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

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

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

في 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

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

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

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

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

تنبيه معدل الخطأ

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

خريطة العالم

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

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

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

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

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

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

تحديثات في الوقت الفعلي

تقوم لوحة التحكم بإجراء استطلاعات كل 30 ثانية للحصول على تحديثات المقاييس. عندما تكون عمليات النشر في حالة انتقالية (إنشاء، نشر)، تزداد الاستطلاعات إلى كل 3 ثوانٍ. انقر فوق زر التحديث للحصول على تحديثات فورية.

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

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

صف المقاييس

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

يتم جلب المقاييس من نقطة نهاية واجهة برمجة تطبيقات sparkline ويتم تحديثها كل 60 ثانية.

فحص السلامة

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

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

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

فحص صحة بطاقة نشر Ultralytics سليمة مع زمن انتقال

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

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

السجلات

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

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

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

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

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

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

المستوىاللونالوصف
تصحيح الأخطاءرماديرسائل التصحيح
معلوماتأزرقطلبات عادية
تحذيرأصفرمشاكل غير حرجة
خطأأحمرطلبات فاشلة
حرجأحمر غامقأعطال حرجة
التحكمالوصف
الأخطاءتصفية إدخالات ERROR و WARNING
كلإظهار جميع إدخالات السجل
نسخنسخ جميع السجلات المرئية إلى الحافظة
تحديثإعادة تحميل إدخالات السجل

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

تصحيح أخطاء سير العمل

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

أمثلة برمجية

تتضمن كل بطاقة نشر 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())
// Build form data with image and parameters
const formData = new FormData();
formData.append("file", fileInput.files[0]);
formData.append("conf", "0.25");
formData.append("iou", "0.7");
formData.append("imgsz", "640");

// Send image for inference
const response = await fetch(
  "https://predict-abc123.run.app/predict",
  {
    method: "POST",
    headers: { Authorization: "Bearer YOUR_API_KEY" },
    body: formData,
  }
);

const result = await response.json();
console.log(result);
# Send image for inference
curl -X POST "https://predict-abc123.run.app/predict" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@image.jpg" \
  -F "conf=0.25" \
  -F "iou=0.7" \
  -F "imgsz=640"

بيانات الاعتماد المملوءة تلقائيًا

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

تنبؤ النشر

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

نقاط نهاية واجهة برمجة التطبيقات

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

GET /api/monitoring

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

مقاييس النشر

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

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

المعلمةالنوعالوصف
sparklineمنطقيتضمين بيانات الخطوط البيانية الصغيرة
rangeسلسلة نصيةالنطاق الزمني: 1h, 6h, 24h, 7d، أو 30d

سجلات النشر

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

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

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

صحة الانتشار

GET /api/deployments/{deploymentId}/health

يعرض حالة فحص الصحة مع زمن استجابة الاستجابة.

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

تحسين الأداء

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

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

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

تقليل زمن الاستجابة

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

إذا كانت الأخطاء تحدث:

  1. مراجعة سجلات الأخطاء في Logs علامة تبويب
  2. تحقق من تنسيق الطلب (يلزم نموذج متعدد الأجزاء)
  3. تحقق من صلاحية مفتاح API
  4. تحقق من حدود المعدل

إذا وصلت إلى السعة القصوى:

  1. النظر في مناطق متعددة
  2. تحسين تجميع الطلبات
  3. زيادة موارد CPU والذاكرة

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

كم من الوقت يتم الاحتفاظ بالبيانات؟

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

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

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

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

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

تقيس مقاييس زمن الاستجابة:

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

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

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

تتأخر المقاييس بحوالي دقيقتين بسبب:

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

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

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

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



📅 تم الإنشاء قبل 1 شهر ✏️ تم التحديث قبل 5 أيام
glenn-jochersergiuwaxmann

تعليقات