본문으로 건너뛰기

로그 및 모니터링

로그 확인​

통합 로그 뷰어​

모든 서비스의 로그를 실시간으로 통합 확인합니다:

cd /home/kopens/plantpulse-ai/bin
./log-viewer.sh

개별 서비스 로그​

각 모듈에도 개별 로그 뷰어가 제공됩니다:

# AI Chat Web
/home/kopens/plantpulse-ai/web/bin/log-viewer.sh

# TimeSeries
/home/kopens/plantpulse-ai/timeseries/bin/log-viewer.sh

# LightRAG (RAG)
docker logs -f lightrag

로그 파일 위치​

서비스로그 파일
시스템 (전체)logs/application.log
시스템 (전체)logs/system.log
설치 로그logs/setup.log
AI Chat Webweb/logs/system.log
TimeSeriestimeseries/logs/system.log
LightRAG (RAG)docker logs lightrag

AI 에이전트 관찰 — 작업 보기​

정보

2026-07 개편으로 Arize Phoenix는 스택에서 제거되었습니다. 에이전트 실행 흐름은 AI Chat Web의 작업 보기(AgentTraceStore)에서 확인합니다.

내장 에이전트는 직전 턴의 도구 호출 과정(입력 → 도구 호출 → 출력)을 인메모리로 보관하여, 채팅 화면의 "작업 보기"에서 어떤 도구가 어떤 인자로 호출되고 어떤 결과가 반환되었는지 추적할 수 있습니다.

서비스 상태 모니터링​

status.sh​

cd /home/kopens/plantpulse-ai/bin
./status.sh

포트 기반으로 모든 서비스의 가동 상태를 확인합니다. [OK]는 정상, [DOWN]은 비정상입니다.

헬스 체크 엔드포인트​

서비스헬스 체크 URL
AI Chat Webhttp://127.0.0.1/actuator/health
LightRAG (RAG)http://127.0.0.1:7114/health
TimeSerieshttp://127.0.0.1:8970/health
LiteLLMhttp://127.0.0.1:4000/health
Qdranthttp://127.0.0.1:6333/healthz
정보

통합 MCP는 PlantPulse 플랫폼 server-web에서 제공되므로 헬스 체크도 플랫폼 측을 확인합니다.

로그 정리​

디스크 공간이 부족할 때:

cd /home/kopens/plantpulse-ai/bin
./clean.sh

정리 대상:

  • 모든 logs/ 디렉토리의 로그 파일
  • 각 서비스의 임시 캐시
  • 빌드 아티팩트
경고

clean.sh 실행 전 필요한 로그는 반드시 백업하세요.