Claude Code 기반 K8s Observability 및 FinOps 플랫폼 구축 기록

Context

실시간 Kubernetes 클러스터 모니터링 및 자동화된 Runbook 생성 필요성 대두. 기존 Prometheus 기반 수동 쿼리 방식의 낮은 운영 효율성과 Stateless한 데이터 처리 구조. 단순 모니터링을 넘어 비용 최적화와 이력 관리가 가능한 FinOps 체계 부족.

Technical Solution

• Claude Code의 Slash Commands를 활용해 Prometheus 및 kubectl과 연동되는 오케스트레이터 Sentinel 설계
• .claude/commands 내에 메트릭 수집, 포드 분석, 심각도 분류를 담당하는 전용 Sub-agent 구조 배치
• CLAUDE.md 파일을 프로젝트의 Operational Memory로 활용하여 엔드포인트 및 임계치 정보를 유지하는 컨텍스트 관리 전략
• 반복적인 Port-forward 설정 작업을 자동화하는 Startup Agent를 도입해 운영 마찰 제거
• 실시간 쿼리의 성능 한계를 극복하기 위해 Go Agent와 PostgreSQL을 도입한 지속적 데이터 수집 아키텍처로 전환
• MCP Servers를 통해 Prometheus 및 Kubernetes API와의 통신 인터페이스 표준화

Key Takeaway

AI 에이전트를 단순 코드 생성 도구가 아닌 아키텍처 설계 파트너로 활용하여 인프라 가시성을 빠르게 확보하는 전략. 특정 LLM 공급자에 대한 의존성을 줄이기 위해 멀티 모델 전략을 유지하며 코드 보안성과 신뢰성을 검증하는 프로세스의 중요성.