在智能体工作流中添加
--json。检查失败时，会返回一个稳定的 next 字段。从快速检查开始
首条遥测数据缺失时的恢复
在修改 SDK 配置之前，先运行以下只读命令：logbrew doctor 会检查 API 访问、身份验证、项目、接入密钥、接入状态、遥测数据和日志可见性。它不会修改项目。阅读 doctor 报告中的总体 status 和每项检查。退出码 0 并不表示每项检查都已通过。
报告的状态也可能是
auth_invalid、project_missing、api_unreachable 或 check_failed。doctor 报告给出了每种状态的下一步。
状态为 ready 的项目仍可能没有日志，因为每种信号类型是独立的。logs 检查的结果可能是 empty 或 unavailable。日志读取失败不等于结果为空。
发送一个安全的测试信号
从已安装的 SDK 发送一条带有唯一消息的测试日志。不要包含令牌、用户数据或请求体。记录项目 ID、服务、环境、版本、UTC 开始时间和 SDK 版本号。等待投递完成，然后在同一项目中读取一个较短的时间范围。投递尚未完成时，不要再发送更多测试信号。查找缺失的日志
先读取一个小而精确的范围：- 项目 ID 属于发送该信号的那个应用。
- 服务、版本和环境完全一致，包括大小写和空格。
- 时间范围包含信号的发生时间。LogBrew 以 UTC 返回发生时间。
--until是不包含在内的上限。 - 没有搜索或严重程度筛选条件把信号隐藏。
- 应用发送的信号类型就是你读取的类型。日志不会创建问题或链路。
- 保持项目不变，扩大时间范围。
- 移除版本筛选条件。
- 移除环境筛选条件。
- 移除服务筛选条件。
- 移除搜索和严重程度筛选条件。
一页结果不等于总数。使用
--pagination cursor 时，用返回的 next_cursor 继续读取，并保持相同的筛选条件。请参阅游标分页。
检查控制台视图
控制台显示的是每个列表的快照。在日志视图中打开实时，新日志到达时就会添加进来。其他视图不会实时更新。重新加载页面可获取新的快照。过时的快照与空结果不是一回事。 LogBrew 只存储应用发送的遥测数据。发送之前，移除凭据、请求体、查询参数值和个人信息。按照控制采集的数据中的方法检查你选择的字段。检查问题和链路
使用 LogBrew 返回的问题 ID 或 Trace ID。切勿自行编造。--status 接受 unresolved（未解决）、resolved（已解决）和 archived（已归档）。ignored 选择的问题与 archived 相同。
问题状态和链路状态是两回事。链路状态值 not_linked、not_found 和 unavailable 的含义各不相同。各个值的含义请参阅排查问题。在解决、归档或重新打开问题之前，先阅读该问题及其日志。
处理 CLI 和 API 错误
在 JSON 模式下，CLI 错误包含ok、error、message 和 next：
error 为 api_error。该错误还包含 status（HTTP 状态）、api_code（API 的 code）、api_error 和 api_next。如果是 rate_limited 错误，还包含 retry_after_seconds。CLI 不会自动重试。
各错误码请参阅 API 错误。
保护可能已泄露的账号
如果其他人可能持有账号访问令牌、刷新令牌或会话 Cookie，让所有 LogBrew 客户端退出登录。按照在整个账号范围内退出登录的步骤进行。这一步必须由人批准。logbrew logout 和在浏览器中退出登录都只会结束一个客户端，因此不够。
在整个账号范围内退出登录，还会停止此前批准的所有 MCP 连接。成功后，在每个客户端上清除本地的 LogBrew 凭据，并从受信任的客户端重新登录。确认可以信任 MCP 客户端之后，再重新批准它们。如果没有收到响应，不要报告所有客户端都已退出登录，也不要自动重复该请求。
在整个账号范围内退出登录不会轮换项目接入密钥。如果接入密钥已泄露，请轮换接入密钥。
安全地进行故障排除
CLI 读取使用账号访问凭据。项目范围的接入凭据只用于 SDK 写入。不要把令牌、授权请求头、原始日志、客户数据、请求体、本地路径或源代码放进命令、聊天或支持工单中。 报告问题之前，用仍然失败的最小范围重复一次读取。记录命令（不含凭据值）、错误码、项目 ID 和筛选条件的值。如果这些检查无法解决故障，请报告问题。相关页面
快速入门
发送并读取第一个安全信号。
使用 CLI
使用精确的筛选条件和 JSON 输出。
排查问题
修改状态之前，先阅读问题证据。
API 错误
按错误码进行恢复。