# Métriques

Queuety fournit une API de métriques qui calcule des statistiques par gestionnaire à partir de la table des journaux. Utilisez-la pour la supervision, les tableaux de bord et les alertes.

## Statistiques des gestionnaires

Obtenez les métriques de tous les gestionnaires sur une période donnée :

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

Chaque entrée du tableau renvoyé contient :

| Champ | Description |
|---|---|
| `handler` | Nom du gestionnaire |
| `completed` | Nombre d’exécutions réussies |
| `failed` | Nombre de tentatives échouées (les événements de journal `failed` et `buried` sont comptabilisés, une tâche peut donc l’être plusieurs fois) |
| `avg_ms` | Durée moyenne d’exécution en millisecondes |
| `p95_ms` | Durée d’exécution au 95e percentile |
| `error_rate` | Taux d’échec de 0 à 1 : `failed / (completed + failed)`, arrondi à quatre décimales |

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

Exemple de sortie :

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

## Cas d’utilisation

- **Widgets de tableau de bord.** Affichez le débit et les taux d’erreur dans l’interface d’administration WordPress.
- **Contrôles d’état.** Déclenchez une alerte lorsque le taux d’erreur d’un gestionnaire dépasse un seuil.
- **Optimisation des performances.** Repérez les gestionnaires lents à l’aide de `p95_ms` et optimisez-les.
- **Planification des capacités.** Suivez les tendances de débit pour dimensionner votre pool de workers.