# Metryki

Queuety udostępnia moduł metryk API, który oblicza statystyki dla poszczególnych modułów obsługi na podstawie tabeli dziennika. Używaj go do monitorowania, pulpitów nawigacyjnych i alertów.

## Statystyki modułów obsługi

Pobierz metryki wszystkich modułów obsługi z wybranego przedziału czasu:

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

Każdy wpis w zwróconej tablicy zawiera:

| Pole | Opis |
|---|---|
| `handler` | Nazwa modułu obsługi |
| `completed` | Liczba pomyślnych wykonań |
| `failed` | Liczba nieudanych prób (zdarzenia dziennika `failed` i `buried`, więc jedno zadanie może zostać policzone więcej niż raz) |
| `avg_ms` | Średni czas wykonania w milisekundach |
| `p95_ms` | 95. percentyl czasu wykonania |
| `error_rate` | Współczynnik niepowodzeń od 0 do 1: `failed / (completed + failed)`, zaokrąglony do czterech miejsc po przecinku |

## 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
```

Przykładowe dane wyjściowe:

```
+------------------+-----------+--------+--------+--------+------------+
| 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     |
+------------------+-----------+--------+--------+--------+------------+
```

## Zastosowania

- **Widżety pulpitu nawigacyjnego.** Wyświetlaj przepustowość i liczbę błędów w panelu administracyjnym WordPress.
- **Kontrole stanu.** Wysyłaj alert, gdy współczynnik błędów modułu obsługi przekroczy określony próg.
- **Dostrajanie wydajności.** Wykrywaj wolne moduły obsługi za pomocą `p95_ms` i optymalizuj je.
- **Planowanie pojemności.** Śledź trendy przepustowości, aby odpowiednio dobrać pulę procesów roboczych.