汽车旅馆
本地 OpenTeleometry 摄入 + TUI 浏览器用于开发, 由 SQLite (英语). 将您的应用程序的 OTLP/ HTTP 导入到本地的汽车旅馆服务器 并调试实时证据——来自终端,内置网络 UI,或直接取自AI编码代理.
对于代理商:安装汽车旅馆调试技能
motel 教授克洛德密码 OpenCode的伴奏技巧,
光标、 Codex 和 40 + 其他代理 如何调试运行时的证据
通过查询汽车旅馆的本地OTLP商店。 安装一次,任何未来
项目中的代理会话将知道如何使用它.
# Project-local (adds to .claude/skills, .agents/skills, etc.)
npx skills add kitlangton/motel --skill motel-debug
# Or globally, for every project
npx skills add kitlangton/motel --skill motel-debug -g
见全能在 skills/motel-debug/SKILL.md。 。 。 .
对人类:安装和运行TUI
汽车旅馆在npm上发行 @kitlangton/motel二进制是一个 Bun
剧本,所以Bun一定在你身上 PATH 运行时间 :
# one-off (no install)
bunx @kitlangton/motel
# or install globally
bun add -g @kitlangton/motel
motel
# npm also works (Bun still required to run it)
npm install -g @kitlangton/motel
没有邦?
curl -fsSL https://bun.sh/install | bash
motel 启动本地 OTLP 摄入服务器
http://127.0.0.1:27686 并发射TUI. 新闻 ? 一次进去
键盘作弊表,或 c 复制粘贴准备设置指令
用于任何您想要跟踪的效果/OTEL应用程序.
所需经费: 阿宝 v1.1 或较新.
您的应用程序如何连接
一旦汽车旅馆开业,请将您的应用程序的 OTLP/HTTP 出口商指向这些 本地端点 :
http://127.0.0.1:27686/v1/traces
http://127.0.0.1:27686/v1/logs
Motel将一切保存在一个机器全球本地SQLite数据库中
${XDG_STATE_HOME:-~/.local/state}/motel/telemetry.sqlite一个管理
守护进程在本地项目中共享 。 无多克,无云帐.
该店默认保留了7天的遥测,目标为1GB
使用边框背景批次的活数据上限。 保存最近的数据时
最古老的完成的痕迹和日志先被取出。 配置策略
与 MOTEL_OTEL_RETENTION_HOURS, (中文(简体) ), MOTEL_OTEL_MAX_DB_SIZE_MB, (中文(简体) ),
MOTEL_OTEL_RETENTION_TRACE_BATCH, (中文(简体) ), MOTEL_OTEL_RETENTION_LOG_BATCH,以及
MOTEL_OTEL_RETENTION_INTERVAL_SECONDS。没有创建现有数据库
增量自动真空在启动时永远不会默写; 删除页面
重新使用,但缩小这样的历史文件需要明确的离线
SQL 点 VACUUM 由用户选择.
代理连接方式
特工与 motel-debug 已安装的技能将自动使用
汽车旅馆的HTTP API。 完整的 OpenAPI 光谱在
http://127.0.0.1:27686/openapi.json -关键终点是:
GET /api/health liveness check
GET /api/services services reporting telemetry
GET /api/traces?service=<service> recent traces for a service
GET /api/traces/<trace-id> full trace tree
GET /api/spans/<span-id> single span + logs
GET /api/logs?service=<service> recent logs
GET /api/traces/search?... structured trace search
GET /api/logs/search?... structured log search
GET /api/ai/calls AI SDK call inspector
TUI 密钥
?键盘作弊表j编号 :k或者说↑编号 :↓——移动选择enter编号 :esc- 钻入/后出(跟踪-瀑布-跨度细节)[编号 :]——开关服务tab切换服务日志/- 过滤器痕迹s周期类型(最近) 出错t--周期主题c——复制另一应用程序的粘贴准备设置指令o——在浏览器中打开所选的跟踪q——退出
隐私说明
汽车旅馆是本地开发工具 但你的应用可以发出敏感的信号 遥测. 相关日志可能包括秘密、标志或PII,如果您 app登录它们;AI调用痕迹可能包含全部即时内容并 响应文本。 将本地 SQLite 商店视为敏感开发 数据当指汽车旅馆 真正的工作量.