المراقبة
توفر 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
بطاقات النظرة العامة
تظهر أربع بطاقات ملخصة في أعلى الصفحة ما يلي:

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

قائمة عمليات النشر
أسفل بطاقات النظرة العامة، تعرض قائمة عمليات النشر جميع نقاط النهاية في مشاريعك. استخدم مفتاح تبديل وضع العرض للتبديل بين:
| عرض | الوصف |
|---|---|
| بطاقات | بطاقات تفصيلية كاملة مع المقاييس والسجلات والرموز وعلامات التبويب التنبؤية |
| مضغوط | شبكة من البطاقات الأصغر حجماً (1-4 أعمدة) مع المقاييس الرئيسية |
| جدول | جدول بيانات مع أعمدة قابلة للفرز: الاسم، المنطقة، الحالة، الطلبات، P95، الأخطاء |
تحديثات في الوقت الفعلي
تقوم لوحة التحكم بإجراء استطلاعات كل 30 ثانية للحصول على تحديثات المقاييس. عندما تكون عمليات النشر في حالة انتقالية (إنشاء، نشر)، تزداد الاستطلاعات إلى كل 3 ثوانٍ. انقر فوق زر التحديث للحصول على تحديثات فورية.
مقاييس لكل عملية نشر
تُظهر كل بطاقة نشر (في عرض البطاقات) المقاييس في الوقت الفعلي:
صف المقاييس
| مقياس (Metric) | الوصف |
|---|---|
| الطلبات | عدد الطلبات (24 ساعة) مع رمز |
| P95 زمن الاستجابة | وقت الاستجابة في الشريحة المئوية 95 |
| معدل الخطأ | النسبة المئوية للطلبات الفاشلة |
يتم جلب المقاييس من نقطة نهاية واجهة برمجة تطبيقات sparkline ويتم تحديثها كل 60 ثانية.
فحص السلامة
تظهر عمليات النشر قيد التشغيل مؤشر فحص الحالة:
| مؤشر | المعنى |
|---|---|
| القلب الأخضر | صحي — يظهر زمن استجابة |
| قلب أحمر | غير صحي — تظهر رسالة خطأ |
| رمز الدوران | فحص الصحة قيد التقدم |
تتم إعادة محاولة الفحوصات الصحية تلقائيًا كل 20 ثانية في حالة عدم صحتها. انقر على أيقونة التحديث لتشغيل الفحص الصحي يدويًا. يستخدم الفحص الصحي مهلة 55 ثانية لاستيعاب عمليات البدء البارد على نقاط النهاية القابلة للتحجيم إلى الصفر.

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

إدخالات السجل
يُظهر كل إدخال سجل ما يلي:
| الحقل | الوصف |
|---|---|
| الخطورة | شريط ملون (انظر أدناه) |
| الطابع الزمني | وقت الطلب (التنسيق المحلي) |
| الرسالة | محتوى السجل |
| معلومات 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
}
تحسين الأداء
استخدم بيانات المراقبة لتحسين عمليات النشر:
إذا كان زمن الاستجابة مرتفعًا جدًا:
- تحقق من عدد النسخ (قد تحتاج إلى المزيد)
- تحقق من أن حجم النموذج مناسب
- فكر في منطقة أقرب
- تحقق من أحجام الصور المرسلة
تقليل زمن الاستجابة
التبديل من imgsz=1280 إلى imgsz=640 لزيادة السرعة بمقدار 4 أضعاف مع الحد الأدنى من فقدان الدقة في معظم حالات الاستخدام. قم بالنشر في منطقة أقرب إلى المستخدمين لتقليل زمن انتقال الشبكة.
إذا كانت الأخطاء تحدث:
- مراجعة سجلات الأخطاء في
Logsعلامة تبويب - تحقق من تنسيق الطلب (يلزم نموذج متعدد الأجزاء)
- تحقق من صلاحية مفتاح API
- تحقق من حدود المعدل
إذا وصلت إلى السعة القصوى:
- النظر في مناطق متعددة
- تحسين تجميع الطلبات
- زيادة موارد CPU والذاكرة
الأسئلة الشائعة
كم من الوقت يتم الاحتفاظ بالبيانات؟
| نوع البيانات | الاحتفاظ |
|---|---|
| مقاييس (Metrics) | 30 يومًا |
| السجلات | 7 أيام |
هل يمكنني إعداد مراقبة خارجية؟
نعم، تعمل عناوين URL لنقاط النهاية مع أدوات المراقبة الخارجية:
- مراقبة وقت التشغيل (Pingdom, UptimeRobot)
- أدوات APM (Datadog, New Relic)
- فحوصات صحية مخصصة عبر
/healthنقطة النهاية
ما مدى دقة أرقام زمن الاستجابة؟
تقيس مقاييس زمن الاستجابة:
- P50: متوسط زمن الاستجابة
- P95: المئوي 95
- P99: المئوي 99
تمثل هذه الأوقات زمن المعالجة من جانب الخادم، ولا تشمل زمن انتقال الشبكة إلى المستخدمين.
لماذا تتأخر مقاييسي؟
تتأخر المقاييس بحوالي دقيقتين بسبب:
- مسار تجميع المقاييس
- نوافذ التجميع
- تخزين لوحة المعلومات المؤقت
للتصحيح في الوقت الفعلي، تحقق من السجلات التي تكون فورية تقريبًا.
هل يمكنني مراقبة نقاط نهاية متعددة معًا؟
نعم، تعرض صفحة عمليات النشر جميع نقاط النهاية مع بطاقات النظرة العامة المجمعة. استخدم عرض الجدول لمقارنة الأداء عبر عمليات النشر.