# Показатели

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