피드로 돌아가기
Debugging an LLM Bug at 3 AM: The Runbook I Wish I'd Had
Dev.toDev.to
AI/ML

LLM Quality Drift 대응을 위한 5가지 분기 기반 Incident Runbook 설계

Debugging an LLM Bug at 3 AM: The Runbook I Wish I'd Had

Gabriel Anhaia2026년 4월 18일11intermediate

Context

전통적인 시스템 모니터링과 달리 LLM 서비스는 HTTP 200 OK 상태에서도 출력 품질이 저하되는 Quality Drift 현상이 발생함. 단순한 메트릭 기반 알람만으로는 원인 파악에 많은 시간이 소요되어 신속한 장애 복구가 어려운 한계가 존재함.

Technical Solution

  • 장애 유형을 Provider Availability, Provider Quality, Self-inflicted Quality, Cost, Regulatory 5가지 Branch로 정형화하여 Triage 시간 단축
  • curl 기반의 Provider Status 확인과 promtool을 통한 Traffic 패턴 분석을 순차적으로 수행하여 외부 요인과 내부 요인을 빠르게 분리
  • git log 분석을 통한 Prompt 및 Retrieval 변경 사항 식별로 내부 배포로 인한 품질 저하 여부를 즉시 판별
  • LiteLLM, Portkey와 같은 Router 계층을 도입하여 장애 발생 시 코드 배포 없이 Config 변경만으로 Secondary Tier로 Failover 수행
  • 단순 HTTP Status가 아닌 LLM Judge Score 기반의 Quality-aware Circuit Breaker 설계로 보이지 않는 품질 저하에 대응

- LLM 서비스 도입 시 HTTP 상태 코드 외에 Judge Score 기반의 Quality 모니터링 파이프라인 구축 - 인프라 수준의 Router를 도입하여 다중 LLM Provider 간의 즉각적인 Failover 체계 마련 - Prompt 및 Config 변경 이력을 장애 분석 프로세스(Runbook)에 명시적으로 포함 - 모든 Incident 종료 후 메트릭만으로 탐지 불가능했던 Gap을 식별하고 이를 Observability 티켓으로 전환하여 개선

원문 읽기