# Mätvärden

Queuety tillhandahåller ett mätvärdes-API som beräknar statistik per hanterare från loggtabellen. Använd det för övervakning, instrumentpaneler och aviseringar.

## Hanterarstatistik

Hämta mätvärden för alla hanterare inom ett tidsintervall:

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

Varje post i den returnerade arrayen innehåller:

| Fält | Beskrivning |
|---|---|
| `handler` | Hanterarnamn |
| `completed` | Antal lyckade körningar |
| `failed` | Antal misslyckade försök (`failed`- och `buried`-logghändelser, så ett jobb kan räknas flera gånger) |
| `avg_ms` | Genomsnittlig körningstid i millisekunder |
| `p95_ms` | 95:e percentilen för körningstid |
| `error_rate` | Felfrekvens från 0 till 1: `failed / (completed + failed)`, avrundad till fyra decimaler |

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

Exempel på utdata:

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

## Användningsområden

- **Instrumentpaneler.** Visa genomströmning och felfrekvenser i administratörsgränssnittet för WordPress.
- **Hälsokontroller.** Skicka en avisering när en hanterares felfrekvens överskrider en gräns.
- **Prestandajustering.** Identifiera långsamma hanterare med `p95_ms` och optimera dem.
- **Kapacitetsplanering.** Följ trender i genomströmningen för att dimensionera arbetargruppen.