# Indicatori

Queuety oferă un API pentru indicatori care calculează statistici per handler din tabelul de jurnale. Folosiți-l pentru monitorizare, tablouri de bord și alerte.

## Statistici pentru handler

Obțineți indicatori pentru toți handlerii într-un interval de timp:

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

Fiecare element din matricea returnată conține:

| Câmp | Descriere |
|---|---|
| `handler` | Numele handlerului |
| `completed` | Numărul execuțiilor reușite |
| `failed` | Numărul încercărilor eșuate (evenimentele de jurnal `failed` și `buried`, astfel că o sarcină poate fi numărată de mai multe ori) |
| `avg_ms` | Durata medie a execuției în milisecunde |
| `p95_ms` | Durata execuției la percentila 95 |
| `error_rate` | Rata de eșecuri, de la 0 la 1: `failed / (completed + failed)`, rotunjită la patru zecimale |

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

Exemplu de rezultat:

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

## Cazuri de utilizare

- **Widgeturi pentru tabloul de bord.** Afișați debitul și ratele de erori în panoul de administrare WordPress.
- **Verificări de stare.** Declanșați o alertă când rata de erori a unui handler depășește un prag.
- **Optimizarea performanței.** Identificați handlerii lenți cu ajutorul `p95_ms` și optimizați-i.
- **Planificarea capacității.** Urmăriți tendințele de debit pentru a dimensiona grupul de workeri.