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

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:#fffLink to this sectionبطاقات النظرة العامة#
أربع بطاقات ملخصة في أعلى الصفحة تعرض:

| المقياس | الوصف |
|---|---|
| إجمالي الطلبات (24 ساعة) | الطلبات عبر جميع نقاط النهاية |
| عمليات النشر النشطة | نقاط النهاية قيد التشغيل حالياً |
| معدل الخطأ (24 ساعة) | نسبة الطلبات الفاشلة |
| زمن الاستجابة P95 (24 ساعة) | زمن الاستجابة للشريحة المئوية 95 |
يتم تمييز بطاقة معدل الخطأ باللون الأحمر عندما يتجاوز المعدل 5%. تحقق من علامة التبويب Logs في عمليات النشر الفردية لتشخيص الأخطاء.
Link to this sectionخريطة العالم#
تُظهر خريطة العالم التفاعلية:
- دبابيس المنطقة لجميع المناطق الـ 43 المتاحة
- دبابيس خضراء للمناطق التي تم النشر فيها
- دبابيس زرقاء متحركة للمناطق التي توجد بها عمليات نشر نشطة قيد التقدم
- حجم الدبوس يختلف بناءً على حالة النشر وزمن الاستجابة

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) في نقاط النهاية التي يتم تحجيمها إلى الصفر.

يستخدم التحقق من السلامة مهلة 55 ثانية لحساب أوقات البدء البارد في نقاط النهاية التي يتم تحجيمها إلى الصفر (حتى حوالي 45 ثانية في أسوأ الحالات). بمجرد إحماء نقطة النهاية، تكتمل عمليات التحقق من السلامة في أجزاء من الثانية.
Link to this sectionالسجلات#
تتضمن كل بطاقة نشر علامة تبويب Logs لعرض إدخالات السجل الحديثة:

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) | تضمين بيانات المخطط المصغر |
range | string | النطاق الزمني: 1h أو 6h أو 24h أو 7d أو 30d |
Link to this sectionسجلات النشر#
GET /api/deployments/{deploymentId}/logs?limit=50&severity=ERROR,WARNINGتُرجع إدخالات السجل الحديثة مع عامل تصفية اختياري للخطورة وترقيم الصفحات.
| المعامل | النوع | الوصف |
|---|---|---|
limit | int | الحد الأقصى للإدخالات المراد إرجاعها (الافتراضي: 50، الحد الأقصى: 200) |
severity | string | عامل تصفية الخطورة مفصول بفواصل |
pageToken | string | رمز الترقيم من الاستجابة السابقة |
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تحسين الأداء#
استخدم بيانات المراقبة لتحسين عمليات النشر الخاصة بك:
إذا كان زمن الانتقال مرتفعًا جدًا:
- تحقق من عدد المثيلات (قد تحتاج إلى المزيد)
- تحقق من أن حجم النموذج مناسب
- فكر في منطقة أقرب
- تحقق من أحجام الصور التي يتم إرسالها
قم بالتبديل من 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هل يمكنني مراقبة نقاط نهاية متعددة معًا؟#
نعم، تعرض صفحة عمليات النشر جميع نقاط النهاية مع بطاقات نظرة عامة مجمعة. استخدم عرض الجدول لمقارنة الأداء عبر عمليات النشر.