# Métricas

Queuety proporciona una API de métricas que calcula estadísticas por controlador a partir de la tabla de registros. Úsela para la supervisión, los paneles y las alertas.

## Estadísticas del controlador

Obtenga métricas de todos los controladores en un intervalo de tiempo:

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

Cada entrada de la matriz devuelta contiene:

| Campo | Descripción |
|---|---|
| `handler` | Nombre del controlador |
| `completed` | Número de ejecuciones correctas |
| `failed` | Número de intentos fallidos (eventos de registro `failed` y `buried`, por lo que un trabajo puede contar más de una vez) |
| `avg_ms` | Duración media de ejecución en milisegundos |
| `p95_ms` | Duración de ejecución en el percentil 95 |
| `error_rate` | Proporción de fallos de 0 a 1: `failed / (completed + failed)`, redondeada a cuatro decimales |

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

Ejemplo de salida:

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

## Casos de uso

- **Widgets del panel.** Muestre el rendimiento y las tasas de error en el área de administración de WordPress.
- **Comprobaciones de estado.** Genere una alerta cuando la tasa de errores de un controlador supere un umbral.
- **Optimización del rendimiento.** Identifique los controladores lentos con `p95_ms` y optimícelos.
- **Planificación de capacidad.** Haga un seguimiento de las tendencias de rendimiento para dimensionar su grupo de trabajadores.