# Metrieken

Queuety biedt een metriek-API die statistieken per handler berekent op basis van de logtabel. Gebruik deze voor monitoring, dashboards en waarschuwingen.

## Handlerstatistieken

Haal metriekgegevens op voor alle handlers binnen een tijdsvenster:

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

Elke vermelding in de geretourneerde array bevat:

| Veld | Beschrijving |
|---|---|
| `handler` | Handlernaam |
| `completed` | Aantal succesvolle uitvoeringen |
| `failed` | Aantal mislukte pogingen (`failed`- en `buried`-loggebeurtenissen, dus één taak kan meerdere keren meetellen) |
| `avg_ms` | Gemiddelde uitvoeringsduur in milliseconden |
| `p95_ms` | Uitvoeringsduur op het 95e percentiel |
| `error_rate` | Foutverhouding van 0 tot 1: `failed / (completed + failed)`, afgerond op vier decimalen |

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

Voorbeelduitvoer:

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

## Toepassingen

- **Dashboardwidgets.** Toon doorvoer en foutpercentages in het WordPress-beheergebied.
- **Statuscontroles.** Ontvang een waarschuwing wanneer het foutpercentage van een handler een drempel overschrijdt.
- **Prestatieafstemming.** Spoor trage handlers op met `p95_ms` en optimaliseer ze.
- **Capaciteitsplanning.** Volg trends in de doorvoer om de omvang van uw workerpool te bepalen.