# Metrik

Queuety menyediakan API metrik yang menghitung statistik per handler dari tabel log. Gunakan untuk pemantauan, dasbor, dan peringatan.

## Statistik handler

Dapatkan metrik untuk semua handler dalam rentang waktu tertentu:

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

Setiap entri dalam array yang dikembalikan berisi:

| Kolom | Deskripsi |
|---|---|
| `handler` | Nama handler |
| `completed` | Jumlah eksekusi yang berhasil |
| `failed` | Jumlah percobaan yang gagal (peristiwa log `failed` dan `buried`, sehingga satu pekerjaan dapat dihitung lebih dari sekali) |
| `avg_ms` | Rata-rata durasi eksekusi dalam milidetik |
| `p95_ms` | Durasi eksekusi persentil ke-95 |
| `error_rate` | Rasio kegagalan dari 0 hingga 1: `failed / (completed + failed)`, dibulatkan hingga empat angka desimal |

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

Contoh keluaran:

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

## Kasus penggunaan

- **Widget dasbor.** Tampilkan throughput dan tingkat kesalahan di admin WordPress.
- **Pemeriksaan kesehatan.** Beri peringatan saat tingkat kesalahan handler melampaui ambang batas.
- **Penyetelan performa.** Temukan handler yang lambat menggunakan `p95_ms` dan optimalkan.
- **Perencanaan kapasitas.** Lacak tren throughput untuk menentukan ukuran kumpulan worker Anda.