# Målinger

Queuety leverer en målings-API, der beregner statistik pr. handler ud fra logtabellen. Brug den til overvågning, dashboards og alarmering.

## Handlerstatistik

Hent målinger for alle handlere inden for et tidsinterval:

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

Hver post i det returnerede array indeholder:

| Felt | Beskrivelse |
|---|---|
| `handler` | Handlernavn |
| `completed` | Antal vellykkede kørsler |
| `failed` | Antal mislykkede forsøg (hændelserne `failed` og `buried` logges, så ét job kan tælle flere gange) |
| `avg_ms` | Gennemsnitlig udførelsesvarighed i millisekunder |
| `p95_ms` | 95-percentil for udførelsesvarighed |
| `error_rate` | Fejlforhold fra 0 til 1: `failed / (completed + failed)`, afrundet til fire 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
```

Eksempel på output:

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

## Anvendelsesområder

- **Dashboard-widgets.** Vis gennemløb og fejlfrekvenser i WordPress-administrationen.
- **Tilstandskontroller.** Udløs en alarm, når en handlers fejlfrekvens overskrider en grænse.
- **Ydeevnejustering.** Find langsomme handlere ved hjælp af `p95_ms`, og optimér dem.
- **Kapacitetsplanlægning.** Følg tendenser i gennemløbet for at dimensionere din worker-pulje.