테마
트러블슈팅·Observability
고급 트랙 · AWS 사전 요건
이 페이지는 AWS 계정과 자격 증명이 준비된 사용자를 위한 고급 트랙입니다. AWS 계정, 적절한 IAM 권한(예: ReadOnlyAccess 또는 SecurityAudit), aws configure 또는 SSO 로그인이 필요합니다. 준비가 안 됐다면 이 페이지는 건너뛰고 나중에 진행하세요.
목표
Kiro CLI를 활용하여 AWS 환경을 파악하고, 네트워크 문제를 진단하며, Observability(관측성) 데이터를 분석하는 클라우드 운영 역량을 체험합니다.
사전 준비
- Kiro CLI 로그인 완료
- AWS 환경 접근 가능 (CloudFormation 스택 배포 완료 시 최적)
- 기본 AWS 서비스 개념 이해 (VPC, EC2, CloudWatch)
해볼 것
1단계: AWS 환경 파악
Kiro CLI 세션에서 아래 프롬프트로 현재 인프라 구조를 탐색합니다:
현재 AWS 계정의 CloudFormation 스택 목록을 보여주고, 각 스택의 목적과 리소스를 요약해주세요.2단계: 네트워크 트러블슈팅
현재 VPC 구성을 분석해주세요:
- 서브넷 구성 (퍼블릭/프라이빗)
- 라우팅 테이블 확인
- 보안 그룹 규칙 검토
- 네트워크 ACL 확인
문제가 있을 수 있는 부분을 식별하고 해결 방안을 제시해주세요.3단계: Observability 확인
CloudWatch에서 다음 정보를 확인해주세요:
- 최근 24시간 EC2 인스턴스의 CPU 사용률
- 비정상적인 메트릭 패턴 식별
- 로그 그룹 목록과 최근 에러 로그
개선 권장 사항을 포함해주세요.4단계: VPC Flow Log 분석
VPC Flow Log를 분석해주세요:
- 거부된 트래픽 패턴 확인
- 상위 소스/목적지 IP 식별
- 비정상적인 포트 접근 시도
보안 관점에서의 권장 사항을 제시해주세요.5단계: Kiro 자체 문제 자가 진단
AWS 인프라 문제 외에, Kiro 사용 중 겪을 수 있는 일반적인 증상도 스스로 점검할 수 있습니다.
로그 확인 방법: 명령 팔레트(Cmd/Ctrl+Shift+P)를 열고 "log"를 검색하면 Kiro 관련 로그 출력 명령을 찾을 수 있습니다.
자주 겪는 증상별 1차 점검 체크리스트:
응답 지연/멈춤
- 네트워크 연결 상태 확인
- 모델 서비스 혼잡 가능성 (잠시 후 재시도)
#codebase로 너무 넓은 컨텍스트를 전달하고 있지 않은지 확인 →#file이나#folder로 범위 축소
코드 적용이 안 됨
- Supervised 모드에서 변경 승인을 누락하지 않았는지 확인
- 대상 파일에 쓰기 권한이 있는지 확인 (읽기 전용 파일 여부)
컨텍스트 인식 실패 (엉뚱한 답변)
- 프로젝트 폴더가 Kiro에서 실제로 열려 있는지 확인
#file경로가 정확한지 확인 (오타·상대경로 오류)- 세션이 길어졌다면 새 세션을 시작하여 맥락 초기화
기대 결과
- AWS 인프라 전체 구조를 자연어로 요약 받음
- 네트워크 설정 문제를 자동 식별하고 해결 방안 제시
- CloudWatch 메트릭/로그를 자연어로 분석 결과 획득
- VPC Flow Log 기반 보안 인사이트 확보
- CloudFormation 스택 구조 파악필수
- VPC/서브넷/보안 그룹 분석 완료필수
- CloudWatch 메트릭 확인 및 이상 탐지필수
- Flow Log 분석으로 보안 인사이트 획득선택
🚨 문제 해결
- 권한 오류(AccessDenied): IAM 사용자/역할에 필요한 권한(EC2 Read, CloudWatch Read, Logs Read) 확인.
- 리소스 없음: CloudFormation 스택이 배포된 리전에서 실행 중인지 확인.
AWS_DEFAULT_REGION환경 변수 점검. - Flow Log 데이터 없음: VPC에 Flow Log가 활성화되어 있는지 확인. 활성화 후 데이터 수집에 몇 분 소요.
- CLI 프로파일/리전 꼬임:
AWS_PROFILE,AWS_DEFAULT_REGION환경 변수 값을 확인하세요.aws sts get-caller-identity로 현재 자격 증명 주체를 확인할 수 있습니다. - 속도가 느림: 대상 리전이 물리적으로 먼 경우 지연이 발생할 수 있습니다. 필요한 리소스에 범위를 좁혀 질문하세요.
- 응답이 실제 리소스와 다름: Kiro가 캐시된 맥락으로 답할 수 있습니다. "최신 상태를 다시 조회해주세요"로 강제 새로고침을 요청하세요.