# المقاييس

توفر Queuety واجهة مقاييس API تحسب إحصاءات كل معالج من جدول السجل. استخدمها للمراقبة ولوحات المعلومات والتنبيهات.

## إحصاءات المعالجات

احصل على مقاييس جميع المعالجات ضمن نطاق زمني:

```php
$stats = Queuety::metrics()->handler_stats( 60 ); // last 60 minutes
```

يتضمن كل عنصر في المصفوفة المعادة ما يلي:

| الحقل | الوصف |
|---|---|
| `handler` | اسم المعالج |
| `completed` | عدد مرات التنفيذ الناجح |
| `failed` | عدد المحاولات الفاشلة (أحداث السجل `failed` و`buried`، لذا قد تُحتسب المهمة الواحدة أكثر من مرة) |
| `avg_ms` | متوسط مدة التنفيذ بالمللي ثانية |
| `p95_ms` | مدة التنفيذ عند المئين 95 |
| `error_rate` | نسبة الإخفاق من 0 إلى 1: `failed / (completed + failed)`، مقربة إلى أربعة أرقام عشرية |

## CLI

```bash
# Metrics for the last 60 minutes (default)
wp queuety metrics

# Metrics for the last 24 hours
wp queuety metrics --minutes=1440

# JSON output
wp queuety metrics --format=json
```

مثال على المخرجات:

```
+------------------+-----------+--------+--------+--------+------------+
| handler          | completed | failed | avg_ms | p95_ms | error_rate |
+------------------+-----------+--------+--------+--------+------------+
| send_email       | 142       | 3      | 45     | 120    | 0.0207     |
| process_image    | 87        | 0      | 230    | 450    | 0          |
| call_openai      | 31        | 5      | 2100   | 4500   | 0.1389     |
+------------------+-----------+--------+--------+--------+------------+
```

## حالات الاستخدام

- **عناصر لوحة المعلومات.** اعرض معدل الإنجاز ومعدلات الأخطاء في لوحة الإدارة WordPress.
- **فحوصات السلامة.** أرسل تنبيهًا عندما يتجاوز معدل أخطاء المعالج حدًا معينًا.
- **ضبط الأداء.** حدّد المعالجات البطيئة باستخدام `p95_ms` وحسّنها.
- **تخطيط السعة.** تتبّع اتجاهات معدل الإنجاز لتحديد حجم مجموعة العمال لديك.