抢先体验仅限邀请,SDK 尚未发布。申请邀请
跳到正文
文档

命令行工具

在终端中使用 Lyrelog。搜索和实时跟踪事件,查看错误、会话和用户,管理项目、密钥和组织。

lyrelog 就是终端里的控制台。它用 Explorer 的筛选条件搜索事件,实时跟踪事件,并显示错误、会话、用户、版本、Insights 和用量。 它还能管理项目、密钥、组织和你的账户。删除账户或项目,以及更改登录方式(通行密钥、关联账户、两步验证),仍然只能在控制台中进行: Lyrelog 会拒绝来自 CLI 的这些操作,这样即使 CLI 会话被人复制,也无法把你锁在门外或抹掉你的数据。

它为两类使用者而设计。人看到的是表格和颜色;程序或编程 agent 只会得到 JSON。工具会自动识别是谁在运行它 (参见输出如何切换)。

尚未发布

和 SDK 一样,命令行工具在抢先体验期间不会发布。在发布之前,下面的 go install 会失败: 代码仓库是私有的,而且还没有任何发布版本。

安装

需要 Go 1.26 或更高版本:

go install go.lyrelog.com/cli/cmd/lyrelog@latest

这会把 lyrelog 放到 $(go env GOPATH)/bin 中,请确认该文件夹在你的 PATH 里。目前还没有发布预编译的二进制文件; Homebrew(brew install GonzaloFuentes28/tap/lyrelog)会随第一个版本一起提供。

第一步

登录

lyrelog login

浏览器会打开控制台。批准这台电脑后,终端就会完成登录。通过 SSH 时还有另一种方式,参见登录。

选择项目

lyrelog projects
lyrelog use tilefall          # its slug, its name or its id
   Project   Slug      Events  People  Errors  Last event  24 hours
●  Tilefall  tilefall   7,291     205     187  7m ago      ▂▄▃▅▃▄▅▆▆▇██▆▃▁▂▁▁▁▁▂▃▅▂

除非你传入 -p <project>,命令都会使用这个项目。如果你只能看到一个项目,lyrelog login 会替你选好它。

查看事件

lyrelog events --level error --since 7d
Tilefall · production · last 7 days

10:30:07 ▌error    cloud_save_failed  sync  reason=schema_mismatch record=progress status=422
10:27:43 ▌error    cloud_save_failed  sync  reason=schema_mismatch record=progress status=422
10:24:48 ▌error    cloud_save_failed  sync  reason=schema_mismatch record=progress status=422

接下来,试试 lyrelog errors:问题按组归并,最严重的排在最前。或者用 lyrelog events -f 实时观察到达的事件。

功能一览

查看你的数据
events像 Explorer 一样搜索事件;-f 实时跟踪新事件。另有 events get、summary、values、attributes
errors按分类和事件名归组的问题,最严重的排在最前
sessions会话:谁、多长时间、发生了什么、有哪些错误
people项目的用户,使用项目自己的称呼
person单个用户:总数、最近的会话和事件;导出或删除其数据
releases每个应用版本的健康状况
insights趋势、比率和漏斗
usage本月事件数与套餐额度的对比
配置及其他
projects、use列出、查看、修改和创建项目,并选择默认项目
keys列出、创建和吊销 API 密钥
orgs组织、组织的成员和邀请
account你的名字,以及你在哪些地方登录了
tokens用于 CI 的访问令牌:列出、创建、更改有效期、吊销
login、logout、whoami登录和退出
open在控制台中打开对应的页面
api以登录身份调用任意控制台 API 路由

每个命令都有 --help,并附带示例。

输出如何切换

在终端中,lyrelog 用 Lyrelog 的配色绘制表格。以下情况下它会改为输出 JSON:

  • 输出被导入管道或文件(lyrelog errors | jq),或者
  • 由编程 agent 或 CI 运行(Claude Code、Cursor、Codex 等,通过它们设置的环境变量识别)。

--json 和 --human 可以强制使用其中一种。在 JSON 模式下,stdout 只输出数据,错误是 stderr 上的一行 JSON, 退出码说明出了什么问题。参见供 agent 和脚本使用。

颜色会适配浅色和深色终端。如果判断有误,请设置 LYRELOG_THEME=dark 或 light。NO_COLOR=1 或 --no-color 可以关闭颜色。