CODE_ASSISTANT/5_django_backend/deploy/langfuse/README.md

Langfuse 자체 호스팅 — -12 에 올리기

LLM 호출 관측(누가·언제·어떤 모델·프롬프트·답·토큰·시간). 백엔드가 LANGFUSE_HOST 있으면 자동으로 쏨(apps/gateway/langfuse.py). 공식 docker-compose.yml 그대로(2026-09-22 main). 컨테이너 6개, 밖으로 여는 건 웹 3000 하나.

1. 이미지 반입 (인터넷 되는 PC)

cd 5_django_backend/deploy/langfuse
docker compose pull
docker save $(grep -oE 'image: \S+' docker-compose.yml | cut -d' ' -f2 | sed 's/\${POSTGRES_VERSION:-17}/17/') | gzip > langfuse-images.tar.gz
ls -la langfuse-images.tar.gz     # 3~4GB. 메일 안 됨 — 인프라팀 반입 통로로

2. -12 에서 띄우기

docker load < langfuse-images.tar.gz
cd /www/abap-ito/code-assistant/5_django_backend/deploy/langfuse
cp .env.example .env && vi .env      # CHANGEME 전부 교체. NEXTAUTH_URL 은 사용자가 여는 주소
docker compose up -d
docker compose ps                    # 6개 healthy 까지 1~2분
curl -s http://127.0.0.1:3000/api/public/health

3. 백엔드 연결

5_django_backend/.env 에 (.env 의 INIT 키와 같은 값):

LANGFUSE_HOST=http://127.0.0.1:3000
LANGFUSE_PUBLIC_KEY=pk-lf-…
LANGFUSE_SECRET_KEY=sk-lf-…

bash deploy.sh 로 재기동 → 채팅 하나 보내고 Langfuse 웹(Traces)에 chat·fabrix trace 뜨면 끝.

운영

• 웹 UI 접속은 -12 의 3000 → 인프라팀이 외부 포트(8915 등) 매핑해줘야 고객사 PC 에서 열림
• 중지 docker compose down (데이터 볼륨 남음) / 완전 삭제 docker compose down -v
• 로그 docker compose logs -f langfuse-web
• 백엔드는 Langfuse 죽어 있어도 멀쩡(전송 실패는 warning 로그만)