# Meritve

Queuety zagotavlja vmesnik za meritve API, ki iz dnevniške tabele izračuna statistiko za posamezne obravnavalnike. Uporabite ga za spremljanje, nadzorne plošče in opozarjanje.

## Statistika obravnavalnikov

Pridobite meritve za vse obravnavalnike v časovnem obdobju:

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

Vsak vnos v vrnjenem polju vsebuje:

| Polje | Opis |
|---|---|
| `handler` | Ime obravnavalnika |
| `completed` | Število uspešnih izvajanj |
| `failed` | Število neuspešnih poskusov (dogodki dnevnika `failed` in `buried`, zato se lahko isto opravilo šteje večkrat) |
| `avg_ms` | Povprečno trajanje izvajanja v milisekundah |
| `p95_ms` | 95. percentil trajanja izvajanja |
| `error_rate` | Delež napak od 0 do 1: `failed / (completed + failed)`, zaokroženo na štiri decimalna mesta |

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

Primer izhoda:

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

## Primeri uporabe

- **Gradniki nadzorne plošče.** Prikažite prepustnost in stopnjo napak v skrbniškem vmesniku WordPress.
- **Preverjanje stanja.** Nastavite opozorilo, ko stopnja napak obravnavalnika preseže prag.
- **Prilagajanje zmogljivosti.** Poiščite počasne obravnavalnike z uporabo `p95_ms` in jih optimizirajte.
- **Načrtovanje zmogljivosti.** Spremljajte trende prepustnosti za določitev velikosti skupine delavcev.