# Metriky

Queuety poskytuje rozhranie API metrík, ktoré vypočítava štatistiky jednotlivých obslužných rutín z tabuľky protokolov. Použite ho na monitorovanie, informačné panely a upozornenia.

## Štatistiky obslužných rutín

Získajte metriky všetkých obslužných rutín za zvolené časové obdobie:

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

Každá položka vráteného poľa obsahuje:

| Pole | Opis |
|---|---|
| `handler` | Názov obslužnej rutiny |
| `completed` | Počet úspešných vykonaní |
| `failed` | Počet neúspešných pokusov (udalosti protokolu `failed` a `buried`, takže jedna úloha sa môže započítať viackrát) |
| `avg_ms` | Priemerné trvanie vykonávania v milisekundách |
| `p95_ms` | Trvanie vykonávania na 95. percentile |
| `error_rate` | Pomer zlyhaní od 0 do 1: `failed / (completed + failed)`, zaokrúhlený na štyri desatinné miesta |

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

Príklad výstupu:

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

## Prípady použitia

- **Prvky informačného panela.** Zobrazte priepustnosť a chybovosť v administrácii WordPress.
- **Kontroly stavu.** Upozornite, keď chybovosť obslužnej rutiny prekročí stanovenú hranicu.
- **Ladenie výkonu.** Pomocou `p95_ms` nájdite pomalé obslužné rutiny a optimalizujte ich.
- **Plánovanie kapacity.** Sledujte trendy priepustnosti a určite potrebnú veľkosť fondu pracovníkov.