아티클 목록으로
개발/코드2026-10-26

포트키 AI 게이트웨이와 포스트호그 기반 LLM 모니터링 구축법

인
인프라 엔지니어링 랩
포트키 AI 게이트웨이와 포스트호그 기반 LLM 모니터링 구축법

Portkey와 PostHog 핵심 요약

프로덕션 LLM 서비스의 성패는 비용 통제와 서비스 안정성에 달려 있습니다. Portkey AI 게이트웨이로 공급자 장애 시 자동 폴백과 캐싱을 걸어두고, PostHog로 사용자 반응과 지연 시간 상관관계를 추적하면 운영 효율을 3배 높일 수 있습니다.

클라우드 LLM API 장애와 눈먼 토큰 비용 누수를 막는 아키텍처

개발팀이 흔히 겪는 위기는 OpenAI 서버 장애로 인한 서비스 전면 중단이나 예기치 못한 프롬프트 루프로 인한 수백만 원 대의 월말 요금 폭탄입니다.

Portkey AI는 모든 LLM 요청의 통로가 되는 리버스 프록시 게이트웨이입니다. 주 모델이 응답하지 않으면 0.1초 만에 백업 모델로 요청을 우회시키며 자주 묻는 동일 질문은 캐시에서 0원으로 즉시 반환합니다. 이 데이터를 PostHog 제품 분석 대시보드로 전달하여 어떤 프롬프트가 사용자 이탈을 유발하는지 실시간 분석합니다.

직접 API 호출 방식 vs Portkey PostHog 관측 아키텍처 비교표

비교 항목단일 제공자 SDK 직접 호출 방식Portkey 게이트웨이 및 PostHog 관측 스택
공급자 서버 다운 시 대응클라이언트 앱 500 에러 발생 및 서비스 중단예비 모델로 밀리초 단위 자동 무중단 우회
반복되는 동일 질문 비용매번 전체 토큰 비용 100퍼센트 그대로 청구시맨틱 캐싱 히트로 API 비용 0원 즉각 응답
사용자 세션과 비용 추적비용 대시보드와 사용자 로그가 분리됨PostHog 안에서 유저 ID별 토큰 사용량 통합 추적
민감 정보 PII 필터링개발자가 정규식으로 직접 마스킹 구현게이트웨이 레벨에서 주민번호 카드번호 자동 차단
코드 수정 최소성모델 변경 시 클라이언트 코드 전체 재배포단 1줄의 baseURL 수정으로 수십 개 모델 교체

Next.js 백엔드에 Portkey와 PostHog 연동하는 3단계

1단계. portkey-ai 및 posthog-js 패키지 설치

npm install portkey-ai posthog-node 명령어를 터미널에서 실행하여 SDK를 프로젝트에 추가합니다.

2단계. Portkey 클라이언트로 OpenAI 호출 래핑

createHeaders 메서드로 가상 키와 폴백 재시도 정책 config를 설정한 후 기본 OpenAI 인스턴스를 초기화합니다.

3단계. LLM 응답 완료 시 PostHog로 커스텀 이벤트 전송

응답 소요 시간과 생성된 토큰 수 토큰 비용을 posthog.capture 이벤트 속성으로 적재하여 시각화 차트를 구성합니다.

자주 묻는 질문 FAQ

Q. 게이트웨이를 거치면 요청 지연 시간이 더 늘어나지 않나요?
Portkey는 글로벌 엣지 네트워크에서 Rust 기반으로 구동되므로 추가 지연 시간은 20밀리초 미만으로 무시할 수 있는 수준입니다.

Q. 사내 보안 규정상 외부 프록시를 경유하기 어려운 경우는 어떻게 하나요?
Portkey는 오픈소스 코드로 공개되어 있어 사내 프라이빗 도커 컨테이너 환경에 셀프 호스팅으로 직접 구축할 수 있습니다.

Q. 특정 사용자가 악의적으로 과도한 요청을 보낼 때 차단 가능한가요?
네, 사용자 ID 단위로 분당 요청 한도 Rate Limit을 대시보드에서 설정하여 비정상적인 트래픽을 즉각 차단할 수 있습니다.

관련 키워드 태그

#포트키#portkey ai#포스트호그#posthog llm#llm 게이트웨이#토큰 비용 모니터링