Latitude

Latitude란 무엇인가요?

Latitude는 Claude Code가 수행하는 모든 단계를 모니터링하도록 설계된 오픈소스 AI 에이전트 관측 및 모니터링 플랫폼입니다. 에이전트 세션의 상세 트레이스를 캡처합니다—예를 들어 프롬프트, 도구 호출, 명령 출력, 그리고 에이전트가 건드린 파일—팀이 프로덕션에서 발생한 실패를 이해하고 수정이 제대로 작동했는지 확인할 수 있도록 합니다.

Latitude의 핵심 목적은 에이전트 동작을 엔드투엔드 관측 가능하게 만드는 것입니다. 가능한 문제를 감지하고, 세션 중 실제로 발생한 일을 조사하며, 세션 수준의 비용과 사용량을 추적하는 데 도움을 줍니다.

주요 기능

• 턴당 세션 트레이스: Latitude는 세션 동안 Claude Code가 실행한 내용을 기록합니다. 각 단계의 프롬프트, 도구 호출, Bash 출력, 에이전트가 건드린 파일을 포함합니다.
• 런타임 시스템 프롬프트 및 도구 스키마 캡처: 트레이스에는 예상했던 것이 아닌, Claude Code가 런타임에 실제로 구성한 시스템 프롬프트와 도구 스키마가 포함됩니다.
• 실패 감지 및 문제 모니터링: 플랫폼은 프로덕션에서 실패한 내용을 모니터링 신호로 표시하여 근본 원인을 조사할 수 있게 합니다.
• 세션당 비용 가시성: 캡처된 세션 활동을 기반으로 프롬프트, 세션, 워크스페이스 수준의 비용을 확인할 수 있습니다.
• 사용 통계 및 비용 규제: Latitude는 토큰 사용량을 추적하여 장기적으로 비용을 규제하는 데 도움을 줍니다.
• 평가를 위한 실시간 트래픽 캡처: 실제 입력, 출력, 컨텍스트를 실시간 트래픽에서 캡처하여 실패 발견, 평가 스타일 분석, 인간 피드백 워크플로를 지원합니다.

Latitude 사용 방법

1. 로컬에 텔레메트리 설치: 제공된 명령어를 실행하여 Claude Code용 Latitude 텔레메트리를 설치하세요 (사이트에 npx -y @latitude-data/claude-code-telemetry install 명령어가 표시됩니다).
2. 훅/프리로드 및 에이전트 런처 설정: 설치 프로그램이 머신 모니터링 설정의 일부로 훅, 프리로드, launchctl .plist를 구성합니다.
3. 무료 Latitude 계정 생성: 프로젝트 전반의 에이전트 동작을 모니터링하려면 Latitude에 가입하세요.
4. 모니터링 시작 및 트레이스 검토: 설정 후 트레이스와 모니터링 뷰를 사용하여 턴, 도구 호출, 출력, 관련 파일을 검사하고 사용량 및 비용을 추적하세요.

사용 사례

• 프로덕션 에이전트 실패 디버깅: Claude Code가 실패할 때 Latitude의 캡처된 트레이스(프롬프트, 도구 호출, Bash 출력, 건드린 파일)를 사용하여 해당 세션에서 무엇이 잘못되었는지 식별하세요.
• 수정 작동 확인: 프롬프트, 도구, 워크플로 변경 후 결과 세션 트레이스를 비교하여 새로운 시스템 프롬프트/도구 스키마와 후속 도구 호출이 의도대로 작동했는지 확인하세요.
• 에이전트 실제 동작 감사: 에이전트가 건드린 정확한 파일과 각 턴의 명령 출력을 검토하여 규정 준수 또는 안전 관련 문제를 조사하세요.
• 토큰 지출 관리: 세션당 비용 가시성과 토큰 사용 통계를 사용하여 프롬프트/세션/워크스페이스 수준의 작업 비용을 이해하고 비용을 규제하세요.
• 실제 트래픽으로부터 평가 구축: 실시간 세션의 실제 입력, 출력, 컨텍스트를 캡처하여 인간 피드백, 실패 발견, 평가 워크플로를 지원하세요.

자주 묻는 질문

Latitude는 Claude Code 전용인가요? Latitude는 Claude Code 동작을 모니터링하며, 런타임에 구성하는 시스템 프롬프트와 도구 스키마를 포함합니다.

Latitude는 세션 중 어떤 데이터를 수집하나요? 페이지에 따르면 프롬프트, 도구 호출, Bash 출력, 에이전트가 건드린 파일을 캡처하며, 런타임에 사용되는 시스템 프롬프트와 도구 스키마도 기록합니다.

모니터링을 어떻게 시작하나요? 사이트에 따르면 npx 설치 명령어로 로컬에 Latitude 텔레메트리를 설치한 후, 프로젝트 전반의 동작을 모니터링하기 위해 Latitude에 가입합니다.

Latitude가 비용 가시성을 제공하나요? 네. “세션당 비용”을 나열하며, 프롬프트당, 세션당, 워크스페이스당 수준으로 가시성을 설명합니다.

Latitude가 평가 및 피드백 워크플로를 지원하나요? 페이지에 따르면 실시간 트래픽에서 실제 입력/출력/컨텍스트를 캡처하여 “인간 피드백”, “실패 발견”, “Playground”, “Evals”를 지원합니다.

대안

• LLM 앱을 위한 OpenTelemetry 기반 계측: OpenTelemetry 중심의 관측성 스택을 원하시면, 에이전트 실행 주위에 사용자 지정 트레이스를 구축할 수 있습니다. Latitude는 Claude Code 동작을 위한 에이전트 중심 관측성 레이어로 자리매김합니다.
• 일반 애플리케이션 모니터링 (로그/메트릭/트레이스): 시스템 상태(로그/메트릭/APM)에 초점을 맞춘 도구는 실패를 감지하는 데 도움이 될 수 있지만, 시스템 프롬프트, 도구 스키마, 턴별 도구 호출 세부 사항 같은 에이전트 특정 컨텍스트를 포착하지 못할 수 있습니다.
• 에이전트 평가 프레임워크: 평가 중심 도구는 데이터셋에 대한 프롬프트와 에이전트 동작 테스트를 도울 수 있지만, 종종 합성 입력이 필요합니다. Latitude는 실제 입력과 출력을 위해 라이브 트래픽에서 캡처하는 데 중점을 둡니다.