# Метрики

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` і оптимізуйте їх.
- **Планування потужностей.** Відстежуйте тенденції пропускної здатності, щоб визначити розмір пулу воркерів.