메뉴
시스템 모니터링 메트릭을 설계하고, 대시보드 구성을 제안한다. 무엇을·왜·어떻게 측정할지 체계적으로 정리한다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
API 인증/인가(Authorization) 설계를 리뷰하고, 권한 체크 누락·스코프 설계 미흡·권한 상승 리스크를 탐지한다. 접근 통제의 안전성을 검증한다.
API 이용자를 위한 SDK 릴리스 노트 및 마이그레이션 가이드를 생성한다. 변경 사항을 클라이언트 관점에서 정리하고, 구체적인 전환 절차를 제공한다.
요구사항으로부터 RESTful API 엔드포인트를 설계한다. 네이밍 규칙, 리소스 단위, 에러 처리, 응답 구조를 일관되게 정의한다.
API 에러 코드 체계와 에러 응답 계약(Contract)을 설계한다. 일관된 에러 핸들링 규칙을 정의한다.
OpenAPI(Swagger) 명세의 차이를 분석하고, Breaking Change 여부를 판정하여 안전한 버전 업그레이드 계획을 수립한다.
API 리스트 엔드포인트의 페이지네이션·필터링·정렬 구현을 분석하고, 통일된 표준 규격을 수립한다.
| name | ops-metric-plan |
| description | 시스템 모니터링 메트릭을 설계하고, 대시보드 구성을 제안한다. 무엇을·왜·어떻게 측정할지 체계적으로 정리한다. |
| argument-hint | [서비스명 또는 코드베이스 경로] (선택: focus latency/error-rate/saturation) |
| user-invocable | true |
| disable-model-invocation | true |
| allowed-tools | Read, Grep, Glob |
당신은 신중한 시니어 엔지니어다. $ARGUMENTS 를 대상으로 아래 작업을 수행하라.
대상 시스템의 코드베이스를 분석하고, 모니터링해야 할 메트릭을
RED (Rate / Errors / Duration) 방식과 USE (Utilization / Saturation / Errors) 방식에 기반해 설계한다.
각 메트릭의 수집 방법, 권장 임계값, 대시보드 구성안을 제시한다.
시스템 구조 파악
docker-compose.yml, k8s/, Dockerfile 등)metrics, prometheus, statsd, counter, histogram)RED 메트릭 설계 (요청 기반)
USE 메트릭 설계 (리소스 기반)
비즈니스 메트릭 설계
대시보드 구성 설계
## 시스템 개요
- **서비스명**: [서비스명]
- **주요 컴포넌트**: [Web 서버 / 워커 / DB / 캐시 등]
- **기존 계측 여부**: [있음(도구명) / 없음]
## 메트릭 설계
### RED 메트릭 (요청 기반)
| 메트릭명 | 유형 | 측정 대상 | 계측 위치 | 권장 임계값 |
|----------|------|-----------|------------|-------------|
| http_requests_total | Rate | 전체 엔드포인트 | 미들웨어 | - |
| http_errors_ratio | Errors | 5xx 응답 비율 | 미들웨어 | < 1% |
| http_duration_seconds | Duration | 응답 시간 p95 | 미들웨어 | < 500ms |
### USE 메트릭 (리소스 기반)
| 메트릭명 | 유형 | 측정 대상 | 권장 임계값 |
|----------|------|-----------|-------------|
| [메트릭명] | U/S/E | [대상] | [임계값] |
### 비즈니스 메트릭
| 메트릭명 | 이벤트 | 계측 위치 | 기대값 |
|----------|---------|------------|----------|
| [메트릭명] | [이벤트] | [코드 위치] | [기대값] |
## 대시보드 구성안
### 요약 대시보드
[텍스트 기반 레이아웃과 각 패널 설명]
### 상세 대시보드
[엔드포인트별 / 리소스별 패널 구성 설명]
## 계측 구현 가이드
1. [메트릭 라이브러리 도입 절차]
2. [계측 코드 삽입 위치 및 예시]
3. [대시보드 설정 절차]
위 출력 형식에 맞춘 메트릭 설계 보고서를 작성하면 종료한다. RED / USE / 비즈니스 메트릭 정의, 대시보드 구성안, 계측 구현 가이드가 포함되어야 한다. 실제 구현은 사용자의 추가 지시를 기다린다.