운영 장애를 변경 없이 조사하는 읽기 전용 CLI 프롬프트

언제 사용하나

운영 서비스에서 오류율·응답 시간·자원 사용량이 급격히 변했지만, 원인이 확인되기 전에 서버나 코드를 건드리면 안 되는 상황에 사용한다.

준비할 정보

• {{INCIDENT_WINDOW}}: 장애 발생·탐지 시간과 timezone
• {{SYMPTOMS}}: 사용자 영향, alert, 대표 오류
• {{ENVIRONMENT}}: 대상 환경과 서비스. prod/dev를 명시한다.
• {{ACCESS}}: 사용 가능한 로그·메트릭·배포 이력 조회 명령
• {{KNOWN_CHANGES}}: 최근 배포·설정·인프라 변경

복사해서 쓰는 CLI agent 프롬프트

{{ENVIRONMENT}}에서 발생한 장애를 읽기 전용으로 조사해줘.

장애 구간: {{INCIDENT_WINDOW}}
증상과 사용자 영향: {{SYMPTOMS}}
조회 수단: {{ACCESS}}
알고 있는 최근 변경: {{KNOWN_CHANGES}}

규칙:
1. 먼저 현재 접속 환경, 계정, 시간대, 대상 서비스를 확인해.
2. 장애 직전·중·직후를 비교할 timeline을 만들어.
3. 배포, 설정, 외부 의존성, 자원 고갈, 데이터 오류로 가설을 나누고 각 가설의 확인 명령을 먼저 보여줘.
4. 로그의 비밀값·개인정보는 출력하지 말고 필요한 구간만 요약해.
5. 관찰 사실, 해석, 추정을 분리하고 근거 없이 원인을 확정하지 마.
6. 파일 수정, 재시작, scale 변경, 배포, rollback, DB write는 실행하지 마.
7. 상태를 바꾸는 조치가 필요하면 예상 효과·위험·되돌리기 방법을 제시하고 승인을 기다려.

결과는 '현재 영향 / timeline / 확인한 사실 / 가설별 판정 / 추가 조사 / 복구 선택지 / 미확인 위험' 순서로 보고해.

허용·금지 경계

• 허용: 로그·메트릭·process·container·배포 이력 조회, git log, git diff, health endpoint 조회
• 승인 필요: 재시작, 스케일 변경, cache 삭제, traffic 전환, rollback
• 금지: 근거 없는 수정, 운영 DB write, secret 출력, 로그 전체 반출

검수 및 종료 조건

장애 구간과 배포 시각을 UTC와 현지 시간으로 대조한다. 핵심 가설은 최소 두 개의 독립된 근거로 확인한다. 접근 권한이 부족하거나 보안상 민감한 정보가 필요하면 우회하지 말고 중단한다.

관련 자료

• Google SRE, Managing Incidents: https://sre.google/sre-book/managing-incidents/