# /metrics

`/metrics` 스킬은 AI 기반 메트릭 조회 도구입니다. 보고 싶은 내용을 설명하면 에이전트가 올바른 대상을 확인하고, 적절한 기간을 선택하며, 간결한 요약을 반환합니다. 읽기 전용이며 클러스터 상태를 변경하지 않습니다.

`/metrics` 스킬이 호출되면 에이전트는 실시간 데이터를 위해 `metrics-server`를, 이력 데이터를 위해 Prometheus를 쿼리하도록 지시받습니다. 필요한 도구가 없으면 에이전트가 설치를 제안합니다. 또한 출력이 제한되고 모델을 통해 효율적으로 처리되도록 데이터 표시 방법에 대한 지침도 제공받습니다.

```text
/metrics                                 # prompts for a target
/metrics api                             # current usage for the api workload
/metrics memory on checkout last 1h      # natural-language scoping
/metrics top pods by cpu in payments
```

자연어 범위 지정(네임스페이스, 레이블 셀렉터, 워크로드 이름, 기간, 메트릭 이름)이 지원됩니다([개요](/ko/reference/skills/overview/) 참조). 에이전트는 설명을 사용 가능한 출처에 대한 적절한 쿼리로 변환합니다.

---

## 데이터 출처

쿼리에 따라 우선순위 순으로 정렬된 출처:

- **`metrics-server`** — `kubectl top`을 통한 실시간 스냅샷에 사용됩니다. Prometheus를 사용할 수 없으면 모든 쿼리에 대해 이것으로 대체되며, 출력에 답변이 기간이 아닌 특정 시점 샘플임을 표시합니다.
- **Prometheus** — 에이전트가 클러스터 내 Prometheus를 감지하고 질문에 기간이 있을 때 사용됩니다. PromQL을 통해 클러스터 내 서비스로 쿼리됩니다.

스킬은 익스포터를 직접 스크레이프하지 않으며 클러스터 외부(예: DataDog, Grafana Cloud)에서 메트릭 엔드포인트를 읽지 않습니다.

---

## 에이전트에게 전달되는 내용

에이전트에게 데이터를 가져올 위치를 지시하는 것 외에도 스킬은 에이전트에게 어떻게 동작해야 하는지 안내합니다:

- 질문에 기간이 있을 때마다 `metrics-server`보다 Prometheus를 우선합니다; 실시간 스냅샷의 경우 `metrics-server`로 대체하지만 독자가 기간 설정에 대해 오해하지 않도록 출력에 `source: metrics-server` 레이블을 붙입니다.
- 전체 시리즈를 모델에 파이프하는 대신 요약 통계(p50, p95, max)를 보고합니다.
- 확인된 쿼리가 사용자가 의도한 것보다 더 많은 파드 또는 더 넓은 기간을 포함하면 확인된 쿼리를 표시하고 실행 전에 확인합니다.
- 테넌트 ID, 사용자 ID, 경로 세그먼트를 포함하는 레이블 세트를 잠재적으로 민감한 것으로 표시합니다; 사용자가 명시적으로 요청하지 않는 한 해당 레이블을 채팅에 다시 표시하지 않습니다.
- 이 스킬을 일반 관찰 도구로 확장하는 대신 아래 [핸드오프](#핸드오프) 섹션에 따라 라우팅합니다.

---

## 안전성

`/metrics`는 읽기 전용입니다. 설명한 대상에 대해 `kubectl top`과 Prometheus 범위 쿼리를 실행하며, 그 외에는 아무것도 하지 않습니다 — exec 없음, 쓰기 없음, 파드 내용이나 로그 접근 없음. 설명이 의도한 것보다 더 많은 파드 또는 더 넓은 기간으로 확인되면 에이전트가 확인된 쿼리를 표시하고 실행 전에 확인합니다.

메트릭 값 자체에는 민감한 데이터가 거의 없지만 레이블 세트에는 있을 수 있습니다 — 테넌트 ID, 사용자 ID, 경로 세그먼트를 포함하는 커스텀 메트릭 이름이나 레이블은 로그 라인과 동일한 방식으로 에이전트의 컨텍스트에 포함됩니다. 광범위한 와일드카드 대신 관심 있는 워크로드로 쿼리를 범위 지정하십시오. 전체 신뢰 모델은 [보안](/ko/concepts/security/)을 참조하십시오.

---

## 핸드오프

리소스 사용량 이외의 모든 경우 에이전트는 `/metrics`를 확장하는 대신 인접 스킬로 라우팅합니다:

- 파드의 CPU 또는 메모리가 변동한 *이유*를 보려면 [`/logs`](/ko/reference/skills/logs/)
- 사용량이 리소스 실패의 증상이고 근본 원인 컨텍스트가 필요하면 [`/investigate`](/ko/reference/skills/investigate/)
- 일회성 확인이 아닌 전체 적정 규모 스윕을 위해 [`/audit-cost`](/ko/reference/skills/audit-cost/)

---

## 옵션

`/metrics`는 MVP에서 스킬별 플래그를 사용하지 않습니다. 프롬프트 또는 후속 질문에서 자연어로 대상, 메트릭, 기간의 범위를 지정하십시오.

[개요](/ko/reference/skills/overview/)의 글로벌 플래그가 적용됩니다.