# Μετρικές

Το Queuety παρέχει ένα API μετρικών που υπολογίζει στατιστικά ανά χειριστή από τον πίνακα καταγραφών. Χρησιμοποιήστε το για παρακολούθηση, πίνακες ελέγχου και ειδοποιήσεις.

## Στατιστικά χειριστών

Λάβετε μετρικές για όλους τους χειριστές σε ένα χρονικό διάστημα:

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

Κάθε εγγραφή στον πίνακα που επιστρέφεται περιέχει:

| Πεδίο | Περιγραφή |
|---|---|
| `handler` | Όνομα χειριστή |
| `completed` | Αριθμός επιτυχημένων εκτελέσεων |
| `failed` | Αριθμός αποτυχημένων προσπαθειών (συμβάντα καταγραφής `failed` και `buried`, επομένως μία εργασία μπορεί να μετρηθεί περισσότερες από μία φορές) |
| `avg_ms` | Μέση διάρκεια εκτέλεσης σε χιλιοστά του δευτερολέπτου |
| `p95_ms` | Διάρκεια εκτέλεσης στο 95ο εκατοστημόριο |
| `error_rate` | Αναλογία αποτυχιών από 0 έως 1: `failed / (completed + failed)`, στρογγυλοποιημένη σε τέσσερα δεκαδικά ψηφία |

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

Παράδειγμα εξόδου:

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

## Περιπτώσεις χρήσης

- **Γραφικά στοιχεία πίνακα ελέγχου.** Εμφανίστε την απόδοση και τα ποσοστά σφαλμάτων στον διαχειριστή του WordPress.
- **Έλεγχοι εύρυθμης λειτουργίας.** Ειδοποιηθείτε όταν το ποσοστό σφαλμάτων ενός χειριστή υπερβαίνει ένα όριο.
- **Βελτιστοποίηση επιδόσεων.** Εντοπίστε αργούς χειριστές με το `p95_ms` και βελτιστοποιήστε τους.
- **Σχεδιασμός χωρητικότητας.** Παρακολουθήστε τις τάσεις απόδοσης για να καθορίσετε το μέγεθος του συνόλου εργαζομένων.