# Metriken

Queuety stellt eine Metrik-API bereit, die Statistiken je Handler aus der Protokolltabelle berechnet. Nutze sie für Monitoring, Dashboards und Benachrichtigungen.

## Handler-Statistiken

Rufe Metriken für alle Handler innerhalb eines Zeitraums ab:

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

Jeder Eintrag im zurückgegebenen Array enthält:

| Feld | Beschreibung |
|---|---|
| `handler` | Handlername |
| `completed` | Anzahl erfolgreicher Ausführungen |
| `failed` | Anzahl fehlgeschlagener Versuche (Ereignisse `failed` und `buried` werden protokolliert, daher kann ein Job mehrfach zählen) |
| `avg_ms` | Durchschnittliche Ausführungsdauer in Millisekunden |
| `p95_ms` | Ausführungsdauer am 95. Perzentil |
| `error_rate` | Fehlerquote von 0 bis 1: `failed / (completed + failed)`, auf vier Dezimalstellen gerundet |

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

Beispielausgabe:

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

## Anwendungsfälle

- **Dashboard-Widgets.** Zeige Durchsatz und Fehlerraten im WordPress-Adminbereich.
- **Integritätsprüfungen.** Lass dich benachrichtigen, wenn die Fehlerrate eines Handlers einen Grenzwert überschreitet.
- **Leistungsoptimierung.** Finde langsame Handler mithilfe von `p95_ms` und optimiere sie.
- **Kapazitätsplanung.** Verfolge Durchsatztrends, um die Größe deines Worker-Pools festzulegen.