# Mérőszámok

A Queuety mérőszámokat biztosít API formájában, amely a naplótáblából kezelőnkénti statisztikákat számít. Megfigyelésre, vezérlőpultokra és riasztásokra használható.

## Kezelői statisztikák

Mérőszámok lekérése az összes kezelőhöz egy adott időablakban:

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

A visszaadott tömb minden eleme a következőket tartalmazza:

| Mező | Leírás |
|---|---|
| `handler` | Kezelő neve |
| `completed` | Sikeres végrehajtások száma |
| `failed` | Sikertelen próbálkozások száma (az `failed` és `buried` naplóeseményeket jelenti, így egy feladat többször is beleszámíthat) |
| `avg_ms` | Átlagos végrehajtási időtartam ezredmásodpercben |
| `p95_ms` | A végrehajtási időtartam 95. percentilise |
| `error_rate` | Hibaarány 0 és 1 között: `failed / (completed + failed)`, négy tizedesjegyre kerekítve |

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

Példa a kimenetre:

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

## Felhasználási esetek

- **Vezérlőpult-elemek.** Jelenítse meg az átviteli sebességet és a hibaarányokat a WordPress adminisztrációs felületén.
- **Állapotellenőrzések.** Riasztást kaphat, ha egy kezelő hibaaránya meghalad egy küszöbértéket.
- **Teljesítményhangolás.** Azonosítsa a lassú kezelőket a `p95_ms` használatával, majd optimalizálja őket.
- **Kapacitástervezés.** Kövesse az átviteli sebesség trendjeit a munkafolyamat-készlet méretezéséhez.