# Metriky

Queuety poskytuje rozhraní API metrik, které z tabulky protokolu počítá statistiky pro jednotlivé obslužné rutiny. Využijte je ke sledování, tvorbě řídicích panelů a upozornění.

## Statistiky obslužných rutin

Získejte metriky pro všechny obslužné rutiny v daném časovém rozmezí:

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

Každá položka vráceného pole obsahuje:

| Pole | Popis |
|---|---|
| `handler` | Název obslužné rutiny |
| `completed` | Počet úspěšných spuštění |
| `failed` | Počet neúspěšných pokusů (události protokolu `failed` a `buried`, takže se jedna úloha může započítat vícekrát) |
| `avg_ms` | Průměrná doba zpracování v milisekundách |
| `p95_ms` | Doba zpracování na 95. percentilu |
| `error_rate` | Poměr selhání od 0 do 1: `failed / (completed + failed)`, zaokrouhlený na čtyři desetinná místa |

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

Ukázkový výstup:

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

## Příklady použití

- **Widgety řídicího panelu.** Zobrazte propustnost a chybovost v administraci WordPress.
- **Kontroly stavu.** Upozorněte, když chybovost obslužné rutiny překročí stanovenou mez.
- **Ladění výkonu.** Pomocí `p95_ms` vyhledejte pomalé obslužné rutiny a optimalizujte je.
- **Plánování kapacity.** Sledujte vývoj propustnosti a určete potřebnou velikost fondu workerů.