#DevOps

AI가 전사 알림을 두 번 죽이다

AI가 전사 알림을 두 번 죽이다
01

Summary

AI 에이전트에게 인프라를 맡겼더니 전사 알림이 두 번이나 날아갔습니다

Claude Code의 치명적 삽질을 15개의 실전 가드레일과 시스템 방어벽으로 극복한 DevOps 엔지니어의 120일 분투기

본 아티클은 AI 에이전트를 실제 인프라 운영에 투입하면서 겪은 치명적인 장애 사례들과 이를 해결하기 위한 실전 가드레일 구축기를 다룹니다. LLM의 구조적 한계를 극복하기 위해 다중 방어선 아키텍처를 설계하고 모니터링 체계와 포스트모템 자동화를 구축하여 가용성을 비약적으로 높인 생생한 기술적 성취를 제시합니다.

  • 01Datadog Slack API 오호출로 인한 3일간의 전사 알림 마비 사고 분석
  • 02컨텍스트 윈도우 한계로 인해 발생한 동일 장애의 재발 원인과 방어책
  • 03서비스 가용성 99.981% 달성 및 애플리케이션 에러율 90% 감축 성과
  • 04Slack 이모지 하나로 5 Whys 보고서와 Notion 페이지를 생성하는 자동화 구현
  • 05AI 에이전트의 4가지 실패 패턴(Side Effects, Bad Math 등) 규명

RECOMMENDATION

AI 에이전트를 실무 및 인프라 운영에 안전하게 연동하고자 하는 DevOps, SRE 및 플랫폼 엔지니어들에게 적극 추천합니다. LLM의 망각 한계를 시스템적으로 메우고 실행 가능한 가이드라인을 이식하는 실질적인 해결책을 얻을 수 있습니다.

The Problem

AI 에이전트(Claude Code)를 실무 인프라 운영에 적용하는 과정에서 API 오호출, 산수 오류 및 시스템 영향 범위 미파악 등으로 인해 전사 알림 중단과 같은 치명적인 장애가 발생했습니다. 또한 초기에 인프라 모니터링 체계와 가용성 측정 기준이 미비하여 장애 발생 시 즉각적인 대응에 어려움이 있었습니다.

The Solution

120일 동안 15건의 AI 사고를 겪으며 CLAUDE.md와 MEMORY.md를 활용해 구체적인 행동 가이드라인(가드레일)을 지속적으로 구축하고 정교화했습니다. 동시에 AWS Lambda, Bedrock, Slack을 활용한 포스트모템 분석 및 이벤트 긴급 대응 자동화 파이프라인을 구축하고 Datadog 모니터링 시스템을 전면 보강했습니다.

The Result

서비스 가용성이 99.963%에서 99.981%로 향상되었고 타겟 5xx 에러율은 이전 대비 90% 급감했습니다. 모니터링 수가 75개에서 191개로 확장되었으며 장애 발생 시 복구 시간(MTTR)을 평균 24.3분에서 5분으로 단축하는 데 성공했습니다.

Trade-off

AI가 세션이 길어지면 초기 설정된 가드레일을 망각하는 컨텍스트 윈도우의 한계가 있어 CLAUDE.md와 MEMORY.md에 다중 방어선을 설계하고 지속적으로 지침을 갱신해야 하는 관리 공수가 요구됩니다.

03

Key Concepts

Concept · 01

CLAUDE.md 가드레일

Claude Code가 개발 세션을 시작할 때 자동으로 참조하는 프로젝트 규칙서입니다. AI 에이전트가 실행해야 할 명령과 금지해야 할 파라미터, 환경별 주의사항 등을 구체적인 정책 문서 형태로 기술하여 오류를 사전에 차단합니다.

  • Datadog Slack API의 PUT 메서드 호출을 강제로 제한하여 알림 중단 사고의 재발을 방지함
  • CloudFront origin 변경 전 타겟 그룹의 인스턴스 활성화 여부를 필수 검증하도록 체크리스트 명시
Concept · 02

컨텍스트 윈도우와 메모리 다중화

대형 언어 모델(LLM)이 대화 과정에서 기억할 수 있는 맥락 정보의 범위와 이를 보완하는 영구 기억 장치입니다. 세션이 장기화되면 초기에 주입된 규칙이 누락되는 문제를 해결하기 위해 필수 정책을 다각도로 영속화해야 합니다.

  • 세션에 관계없이 유지되는 MEMORY.md 파일에 영구 정보를 겹쳐 써 AI가 영구히 보존하게 함
  • 최우선 핵심 금지 명령어를 세션 시작 시 인지되는 컨텍스트 전면에 배치하는 이중화 구조 적용
Concept · 03

Serverless 기반 운영 자동화

인프라 변경 및 모니터링 관리 공수를 낮추기 위해 AWS Lambda, EventBridge, Bedrock 및 Slack을 연계한 자동 제어 파이프라인입니다. 사람의 개입을 줄여 에러 발생률을 낮추고 장애 처리 속도를 극대화합니다.

  • 특정 이모지 반응 시 Bedrock Claude가 Slack 스레드를 분석하여 타임라인 작성 및 Notion 등록 자동화
  • Slack /event 커맨드를 통해 대용량 트래픽 대비용 CloudFront origin을 ALB 전용으로 완전 자동 제어