# 지표

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`를 사용해 느린 핸들러를 찾아 최적화합니다.
- **용량 계획.** 처리량 추세를 추적해 작업자 풀의 규모를 정합니다.