APILog
서비스 로그를 수집해 AI 리포트와 커스텀 위젯을 자동으로 생성하는 오픈소스 로그 분석 플랫폼
2025
2025.10 - 2025.11 (7주)
AI 리포트 파이프라인 및 위젯 생성 시스템 설계·구현
PythonFastAPILLMInfluxDBPydanticAgent
Problem
운영자는 수많은 로그와 대시보드를 가지고 있지만, '그래서 지금 서비스가 어떤 상태인지, 뭐가 문제인지'를 이해하기 위해 매번 수동으로 쿼리를 짜고 지표를 조합해야 했습니다. 저는 이 과정을 에이전트가 대신해 줄 수 없을까?라는 질문에서 APILog를 시작했습니다.
Approach & My Role
AI 리포트 파이프라인 설계 및 구현 - InfluxDB 로그 기반으로 LLM에게 질의해 운영 리포트를 자동 생성. FastAPI 백엔드의 모든 라우터를 코드 레벨에서 스캔하고 실제 응답 샘플을 자동 수집해 LLM 컨텍스트로 전달하는 구조 설계
신뢰도 높은 LLM 응답 설계 - Pydantic 기반 스키마로 LLM 응답을 구조적으로 파싱하고 검증. 일부 필드 오류 시 목업 값으로 대체하는 폴백 로직 구현으로 실서비스 안정성 확보
기본 위젯 및 AI 커스텀 위젯 생성 - 세션 통계, 이탈률, 인기 페이지 등 핵심 운영 지표 위젯을 직접 설계·구현. 사용자의 자연어 요청 + DB 스키마 정보를 LLM에 전달해 필요한 쿼리와 위젯 스펙을 자동 생성하고 대시보드에 등록
What I Learned
1
LLM을 '답변 봇'이 아니라, 쿼리/스펙/코드를 생성하는 에이전트로 활용하는 패턴
2
'LLM은 항상 틀릴 수 있다'는 전제를 두고, 스키마, 폴백, 샘플 기반 컨텍스트를 통해 사용 가능한 수준의 안정성을 확보하는 방법