AI Agent 모니터링 및 운영
2026-02-05 작성2026-07-17 수정12분 읽기
이 문서에서는 Agentic AI 애플리케이션의 모니터링 아키텍처, 핵심 메트릭 설계, 알림 전략을 개념 수준에서 다룹니다.
실전 배포 가이드
Langfuse Helm 배포, AMP/AMG 구성, ServiceMonitor YAML, Grafana 대시보드 JSON 등 실전 구성은 모니터링 스택 구성 가이드를 참조하세요.
1. 개요
Agentic AI 애플리케이션은 복잡한 추론 체인과 다양한 도구 호출을 수행하기 때문에, 전통적인 APM(Application Performance Monitoring) 도구만으로는 충분한 가시성을 확보하기 어렵습니다. LLM 특화 관측성 도구인 Langfuse와 LangSmith는 다음과 같은 핵심 기능을 제공합니다:
- 트레이스 추적: LLM 호출, 도구 실행, 에이전트 추론 과정의 전체 흐름 추적
- 토큰 사용량 분석: 입력/출력 토큰 수 및 비용 계산
- 품질 평가: 응답 품질 점수화 및 피드백 수집
- 디버깅: 프롬프트 및 응답 내용 검토를 통한 문제 진단
대상 독자
이 문서는 플랫폼 운영자, MLOps 엔지니어, AI 개발자를 대상으로 합니다. Kubernetes와 Python에 대한 기본적인 이해가 필요합니다.
2. 모니터링 아키텍처
Langfuse 아키텍처 개요
Langfuse v3 (2024-12+)는 다음 컴포넌트로 구성됩니다. v3는 ClickHouse+Redis+S3 아키텍처로, v2 대비 셀프호스팅 복잡도가 증가했습니다:
AMP/AMG 통합 데이터 흐름
모니터링 데이터 계층
| 계층 | 수집 도구 | 메트릭 패턴 | 확인 가능 항목 |
|---|---|---|---|
| LLM 추론 | Langfuse | trace, generation | 토큰 사용량, 비용, TTFT, 사용자별 패턴 |
| 모델 서버 | vLLM Prometheus | vllm_* | 요청 수, 배치 크기, KV cache 사용률, TPS |
| GPU | DCGM Exporter | DCGM_FI_DEV_* | GPU 활용도, 온도, 전력, 메모리 사용량 |
| 인프라 | Node Exporter | node_* | CPU, 메모리, 네트워크, 디스크 I/O |
| 게이트웨이 | kgateway | envoy_* | 요청 수, 레이턴시, 에러율, 업스트림 상태 |
3. 핵심 모니터링 메트릭
Agentic AI 애플리케이션에서 추적해야 할 핵심 메트릭을 정의합니다.
메트릭 카테고리
Latency 메트릭
Latency 메트릭
| 메트릭 | 설명 | 목표값 | 알림 임계값 |
|---|---|---|---|
| agent_request_duration_seconds | 전체 요청 처리 시간 | P95 < 5s | P99 > 10s |
| llm_inference_duration_seconds | LLM 추론 시간 | P95 < 3s | P99 > 8s |
| tool_execution_duration_seconds | 도구 실행 시간 | P95 < 1s | P99 > 3s |
| vector_search_duration_seconds | 벡터 검색 시간 | P95 < 200ms | P99 > 500ms |
Token Usage 메트릭
Token Usage 메트릭
| 메트릭 | 설명 | 모니터링 목적 |
|---|---|---|
| llm_input_tokens_total | 입력 토큰 총합 | 프롬프트 최적화 |
| llm_output_tokens_total | 출력 토큰 총합 | 응답 길이 분석 |
| llm_total_tokens_total | 전체 토큰 총합 | 비용 추적 |
| llm_cost_dollars_total | 추정 비용 (USD) | 예산 관리 |
Error Rate 메트릭
Error Rate 메트릭
| 메트릭 | 설명 | 알림 임계값 |
|---|---|---|
| agent_errors_total | 에이전트 오류 총합 | 오류율 > 5% |
| llm_rate_limit_errors_total | Rate Limit 오류 | 분당 10회 이상 |
| tool_execution_errors_total | 도구 실행 오류 | 오류율 > 10% |
| agent_timeout_total | 타임아웃 발생 | 분당 5회 이상 |