企业官网建设流程全解析

如何查看已部署 Reflex 应用的运行日志、部署历史和构建日志？

【免费下载链接】reflex🕸️ Web apps in pure Python 🐍项目地址: https://gitcode.com/GitHub_Trending/re/reflex

应用部署到 Reflex 托管服务（Reflex Cloud）之后，日常会遇到的排查需求有三类：查看应用运行时的日志输出、回看每次部署的历史记录、以及查看某次部署的构建日志。本文基于 Logs 文档 和 App Management 文档，给出在 Web 控制台（Dashboard）和 CLI 下查看这三类信息的完整操作路径。

前提条件

• 应用已经通过reflex deploy成功部署，并且你在 Reflex Cloud 控制台能看到这个应用（部署流程见 Quick Start 文档）。
• 需要部署的账号已执行过reflex login完成认证，CLI 命令依赖该登录状态。
• 托管服务要求reflex>=0.6.6（来自部署前置条件说明）。

在开始之前，建议先记下两个标识符，CLI 命令需要用到：

• APP_ID：在 Dashboard 的Settings > General页面可以看到 app ID；
• DEPLOYMENT_ID：在History页面的部署记录列表中可以找到。

查看运行时日志

方式一：Dashboard 的 Logs 页面

打开Deployments，选择目标应用，再选择Logs。每个托管应用都有Deployment、Logs、History、Custom Domain和Settings五个页面，Logs 页是查看运行时输出的入口。

日志查看器支持以下操作：

• 全文搜索（Full-text search）；
• 按最旧优先或最新优先排序（Oldest-first / Newest-first）；
• 以 UTC 或本地时区显示时间；
• 选择时间范围（Time-range）；
• 按区域过滤（Region filtering）；
• 应用运行期间实时刷新（Refresh）。

官方给出的排查建议是：先使用与问题相关的最小时间范围和最小区域范围，如果没找到预期事件，再逐步放宽过滤条件。

方式二：CLI

在本地终端执行：

reflex cloud apps logs [OPTIONS] [APP_ID]

APP_ID为可选参数，省略时使用当前项目对应的应用。CLI 版本适合本地调试、自动化脚本或纯终端排查场景。注意它会分批（batches）拉取日志，在加载下一页之前会先给出提示（prompts），属于交互式分页，不能一次性无交互地取完。

查看部署历史

每次部署都会出现在History页面，记录包含 deployment ID、state（状态）、actor（操作者）和 timestamp（时间戳）四个字段。其中正在运行的部署标记为Current，较早的记录标记为Historical。

也可以用 CLI 列出同样的历史：

reflex cloud apps history [OPTIONS] [APP_ID]

App Management 文档 中给出的等价写法为reflex cloud apps history <APP_ID>，即直接把APP_ID作为位置参数传入。

部署历史不仅用于回看：如果你需要回退到旧版本，可以在 History 中找到带有可用Rollback deployment操作的历史部署执行回滚。回滚有明确限制——需要部署权限，且 Reflex 仍保留当前托管提供商与托管模式下的兼容镜像；如果项目开启了Require approval to deploy，Rollback 会被禁用，需走正常审批流程部署目标版本。

查看某次部署的构建日志

方式一：部署详情页

1. 打开History；
2. 点击目标部署的 deployment ID，进入详情页；
3. 详情页展示 deployment note、域名、backend URL、Reflex 与 Python 版本、部署统计信息，以及Build logs部分。

构建失败或需要核对部署版本时，直接在这里查看该次部署的完整构建输出。

方式二：CLI

针对某一次部署单独拉取构建输出：

reflex cloud apps build-logs <DEPLOYMENT_ID>

<DEPLOYMENT_ID>替换为 History 页面（或reflex cloud apps history输出）中对应部署的 ID。

三类信息的适用场景小结

使用限制说明

• CLI 的apps logs是分页交互式的，自动化脚本中如果依赖非交互批量取日志，需要考虑其分批拉取和翻页提示的行为；
• 构建日志按部署维度查看，build-logs命令只接受DEPLOYMENT_ID，不支持直接按应用列出所有构建日志，需先通过apps history拿到 ID；
• 所有 CLI 命令都需要reflex login之后的认证状态，且操作的对象是 Reflex 托管服务上的已部署应用，本地reflex run的进程不走这套接口。

更多管理操作（停止/启动应用、回滚、部署备注、删除应用等）可参考 App Management 文档；CLI 命令总览见 CLI 参考。

【免费下载链接】reflex🕸️ Web apps in pure Python 🐍项目地址: https://gitcode.com/GitHub_Trending/re/reflex