콘텐츠로 이동

/metrics

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

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

/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

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

데이터 출처

섹션 제목: “데이터 출처”

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

  • 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, 경로 세그먼트를 포함하는 커스텀 메트릭 이름이나 레이블은 로그 라인과 동일한 방식으로 에이전트의 컨텍스트에 포함됩니다. 광범위한 와일드카드 대신 관심 있는 워크로드로 쿼리를 범위 지정하십시오. 전체 신뢰 모델은 보안을 참조하십시오.

핸드오프

섹션 제목: “핸드오프”

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

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

옵션

섹션 제목: “옵션”

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

개요의 글로벌 플래그가 적용됩니다.