UStackUStack
Latitude icon

Latitude

Latitude 面向 Claude Code 的开源可观测性:监控每个 agent 回合,完整会话追踪,故障检测,并查看成本/用量可视化。

Latitude

Latitude 是什么?

Latitude 是一个开源 AI 代理可观测性和监控平台,专为监控 Claude Code 的每一步操作而设计。它捕获代理会话的详细追踪——如提示词、工具调用、命令输出和触及的文件——帮助团队理解生产环境中的故障,并验证修复是否生效。

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 是否支持评估和反馈工作流?
页面提到捕获实时流量的真实输入/输出/上下文,以支持“human feedback”、“故障发现”、“Playground”和“Evals”。

替代方案

  • 基于 OpenTelemetry 的 LLM 应用插桩:如果您想要以 OpenTelemetry 为中心的可观测性栈,可以围绕 agent 运行构建自定义追踪。Latitude 将自身定位为针对 Claude Code 行为的 agent 专注可观测性层。
  • 通用应用监控(日志/指标/追踪):专注于系统健康(日志/指标/APM)的工具可以帮助检测故障,但它们可能无法捕获 agent 特定上下文,如系统提示、工具 schema 和每次回合的工具调用细节。
  • Agent 评估框架:专注于评估的工具可以帮助使用数据集测试提示和 agent 行为,但它们通常需要合成输入;Latitude 强调从实时流量捕获真实输入和输出。