langgraph dev) 및 로컬 Docker 서버(langgraph up) 모두에서 LangGraph CLI와 LangGraph Server가 데이터를 처리하는 방식을 설명합니다. 또한 호스팅된 Studio 프론트엔드와 상호작용할 때 추적되는 데이터에 대해서도 설명합니다.
CLI
LangGraph CLI는 LangGraph 애플리케이션을 빌드하고 실행하기 위한 커맨드 라인 인터페이스입니다. 자세한 내용은 CLI 가이드를 참조하세요. 기본적으로 대부분의 CLI 명령 호출은 실행 시 단일 분석 이벤트를 로깅합니다. 이는 CLI 사용 경험 개선의 우선순위를 더 잘 정하는 데 도움이 됩니다. 각 텔레메트리 이벤트에는 호출 프로세스의 OS, OS 버전, Python 버전, CLI 버전, 명령어 이름(dev, up, run 등), 그리고 플래그가 명령어에 전달되었는지를 나타내는 불린 값이 포함됩니다. 전체 분석 로직은 여기에서 확인할 수 있습니다.
LANGGRAPH_CLI_NO_ANALYTICS=1을 설정하여 모든 CLI 텔레메트리를 비활성화할 수 있습니다.
LangGraph Server
LangGraph Server는 애플리케이션 상태의 체크포인트, 장기 메모리, 스레드 메타데이터, 어시스턴트 및 유사한 리소스를 로컬 파일 시스템 또는 데이터베이스에 저장하는 내구성 있는 실행 런타임을 제공합니다. 저장 위치를 의도적으로 사용자 정의하지 않은 경우, 이 정보는 로컬 디스크(langgraph dev의 경우) 또는 PostgreSQL 데이터베이스(langgraph up 및 모든 배포의 경우)에 기록됩니다.
LangSmith Tracing
LangGraph 서버(인메모리 또는 Docker)를 실행할 때, LangSmith 추적을 활성화하여 더 빠른 디버깅을 용이하게 하고 프로덕션 환경에서 그래프 상태 및 LLM 프롬프트의 관찰 가능성을 제공할 수 있습니다. 서버의 런타임 환경에서LANGSMITH_TRACING=false를 설정하여 언제든지 추적을 비활성화할 수 있습니다.
인메모리 개발 서버
langgraph dev는 빠른 개발 및 테스트를 위해 설계된 단일 Python 프로세스로 인메모리 개발 서버를 실행합니다. 이는 현재 작업 디렉토리의 .langgraph_api 디렉토리 내 디스크에 모든 체크포인트 및 메모리 데이터를 저장합니다. CLI 섹션에서 설명한 텔레메트리 데이터를 제외하고, 추적을 활성화하지 않았거나 그래프 코드가 명시적으로 외부 서비스에 연결하지 않는 한 어떠한 데이터도 장치 외부로 전송되지 않습니다.
독립형 서버
langgraph up은 로컬 패키지를 Docker 이미지로 빌드하고 세 개의 컨테이너로 구성된 데이터 플레인으로 서버를 실행합니다: API 서버, PostgreSQL 컨테이너, Redis 컨테이너입니다. 모든 영구 데이터(체크포인트, 어시스턴트 등)는 PostgreSQL 데이터베이스에 저장됩니다. Redis는 이벤트의 실시간 스트리밍을 위한 pub-sub 연결로 사용됩니다. 유효한 LANGGRAPH_AES_KEY 환경 변수를 설정하여 데이터베이스에 저장하기 전에 모든 체크포인트를 암호화할 수 있습니다. 또한 langgraph.json에서 체크포인트 및 크로스 스레드 메모리에 대한 TTL을 지정하여 데이터가 저장되는 기간을 제어할 수 있습니다. 모든 저장된 스레드, 메모리 및 기타 데이터는 관련 API 엔드포인트를 통해 삭제할 수 있습니다.
서버에 유효한 라이선스가 있는지 확인하고 실행된 run과 task의 수를 추적하기 위해 추가 API 호출이 수행됩니다. API 서버는 주기적으로 제공된 라이선스 키(또는 API 키)를 검증합니다.
추적을 비활성화한 경우, 그래프 코드가 명시적으로 외부 서비스에 연결하지 않는 한 어떠한 사용자 데이터도 외부에 저장되지 않습니다.
Studio
Studio는 LangGraph 서버와 상호작용하기 위한 그래픽 인터페이스입니다. 이는 개인 데이터를 저장하지 않습니다(서버에 전송하는 데이터는 LangSmith로 전송되지 않습니다). Studio 인터페이스는 smith.langchain.com에서 제공되지만, 브라우저에서 실행되며 로컬 LangGraph 서버에 직접 연결되므로 LangSmith로 데이터를 전송할 필요가 없습니다. 로그인한 경우, LangSmith는 디버깅 사용자 경험 개선에 도움이 되도록 일부 사용 분석 데이터를 수집합니다. 여기에는 다음이 포함됩니다:- 페이지 방문 및 탐색 패턴
- 사용자 작업(버튼 클릭)
- 브라우저 유형 및 버전
- 화면 해상도 및 뷰포트 크기
빠른 참조
요약하자면, CLI 분석을 끄고 추적을 비활성화하여 서버 측 텔레메트리를 거부할 수 있습니다.| 변수 | 목적 | 기본값 |
|---|---|---|
LANGGRAPH_CLI_NO_ANALYTICS=1 | CLI 분석 비활성화 | 분석 활성화됨 |
LANGSMITH_API_KEY | LangSmith 추적 활성화 | 추적 비활성화됨 |
LANGSMITH_TRACING=false | LangSmith 추적 비활성화 | 환경에 따라 다름 |
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.