# Metrikos

Queuety pateikia metrikų API, kuri apskaičiuoja kiekvienos apdorojimo funkcijos statistiką iš žurnalų lentelės. Naudokite ją stebėjimui, skydelėms ir įspėjimams.

## Apdorojimo funkcijų statistika

Gaukite visų apdorojimo funkcijų metrikas per pasirinktą laikotarpį:

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

Kiekviename grąžinto masyvo įraše yra:

| Laukas | Aprašymas |
|---|---|
| `handler` | Apdorojimo funkcijos pavadinimas |
| `completed` | Sėkmingų vykdymų skaičius |
| `failed` | Nesėkmingų bandymų skaičius (žurnaluose registruojami įvykiai `failed` ir `buried`, todėl viena užduotis gali būti skaičiuojama kelis kartus) |
| `avg_ms` | Vidutinė vykdymo trukmė milisekundėmis |
| `p95_ms` | 95-asis vykdymo trukmės procentilis |
| `error_rate` | Nesėkmių dalis nuo 0 iki 1: `failed / (completed + failed)`, suapvalinta iki keturių skaitmenų po kablelio |

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

Pavyzdinė išvestis:

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

## Naudojimo atvejai

- **Skydelės valdikliai.** Rodykite spartą ir klaidų dažnį WordPress administravimo sąsajoje.
- **Būklės patikros.** Siųskite įspėjimą, kai apdorojimo funkcijos klaidų dažnis viršija ribą.
- **Našumo derinimas.** Naudodami `p95_ms` nustatykite lėtai veikiančias apdorojimo funkcijas ir jas optimizuokite.
- **Pajėgumų planavimas.** Stebėkite spartos tendencijas, kad galėtumėte tinkamai parinkti vykdytojų skaičių.