# Mittarit

Queuety tarjoaa mittari-APIn, joka laskee käsittelijäkohtaiset tilastot lokitaulusta. Käytä sitä valvontaan, koontinäyttöihin ja hälytyksiin.

## Käsittelijätilastot

Hae kaikkien käsittelijöiden mittarit aikaväliltä:

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

Jokainen palautetun taulukon alkio sisältää:

| Kenttä | Kuvaus |
|---|---|
| `handler` | Käsittelijän nimi |
| `completed` | Onnistuneiden suoritusten määrä |
| `failed` | Epäonnistuneiden yritysten määrä (`failed`- ja `buried`-lokitapahtumat, joten sama työ voidaan laskea useammin kuin kerran) |
| `avg_ms` | Suorituksen keskimääräinen kesto millisekunteina |
| `p95_ms` | Suorituksen keston 95. persentiili |
| `error_rate` | Virhesuhde välillä 0–1: `failed / (completed + failed)`, pyöristetty neljään desimaaliin |

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

Esimerkkituloste:

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

## Käyttötapaukset

- **Kojelaudan pienoisohjelmat.** Näytä läpimeno ja virheasteet WordPress-hallintapaneelissa.
- **Kuntotarkistukset.** Hälytä, kun käsittelijän virheaste ylittää raja-arvon.
- **Suorituskyvyn optimointi.** Tunnista hitaat käsittelijät `p95_ms`-toiminnolla ja optimoi ne.
- **Kapasiteetin suunnittelu.** Seuraa läpimenon kehitystä työntekijäjoukon koon määrittämiseksi.