Cloudflare 中文文档
Pages
编辑这个页面
跳转官方原文档
Set theme to dark (⇧+D)

调试和日志记录

使用 Cloudflare 仪表板或 Wrangler CLI访问功能日志。

日志是一种功能强大的调试工具,可帮助你在部署 Pages 函数后对其行为进行测试和监控。Pages 项目的每次部署都有日志。

日志提供有关事件的详细信息,并能让人深入了解:

  • 你的功能请求成功或失败。
  • 函数抛出的未捕获异常。
  • 在函数中声明自定义 console.logs 。
  • 不容易复制的生产问题。
  • 实时查看传入应用程序的请求。

启动记录会话有两种方法:

  1. 在终端运行 wrangler pages deployment tail
  2. 使用 Cloudflare dashboard

​​ 添加自定义日志

自定义日志是你自己添加到函数中的 console.log() 语句。在为包含这些 Functions 的部署生成流式日志时,这些语句将同时出现在 wrangler pages deployment tail 和仪表板输出中。

下面是在页面函数中自定义 console.log 语句的示例:

部署完上述代码后,在终端运行 wrangler pages deployment tail。然后访问 Function 所在的路由。终端将显示

运行 <code>wrangler 页面部署 tail</code>

仪表板将显示

按照上述步骤访问仪表板中的自定义日志

​​ 使用 Wrangler 查看日志

wrangler pages deployment tail 使开发人员能够对特定项目和部署的日志进行直播。

要开始使用,请在 Pages 项目目录下运行 wrangler pages deployment tail。这将在本地终端中记录任何传入应用程序的请求。

每个 wrangler 页面部署 tail 日志的输出都是一个结构化的 JSON 对象:

wrangler pages deployment tail 允许你自定义日志会话,以更好地满足你的需求。有关可用的配置选项,请参阅wrangler pages deployment tail 文档

​​ 在 Cloudflare 控制面板中查看日志

要查看与任何部署相关的 “生产 “或 “预览 “环境的日志:

  1. 登录 Cloudflare 仪表板 并选择你的账户。
  2. 账户主页,选择工作者和页面
  3. 选择页面项目,转到要查看日志的部署,然后选择 查看详情> 功能

记录功能适用于所有客户(免费、付费、企业)。

​​ Limits

以下限制适用于功能日志:

  • 日志不存储。你可以随时启动和停止数据流以查看它们,但它们不会持久存在。
  • 如果在过去 5 分钟内,功能的每秒请求数超过 100,日志将不会显示。
  • 你的函数绑定的任何 持久对象 的日志都将显示在 Cloudflare 仪表板中。
  • 一次最多可有 10 个客户端查看部署日志。这可以是仪表板会话或 wrangler pages deployment tail调用的组合。

​​ Sourcemaps

如果你正在调试未捕获的异常,你可能会发现日志中的 堆栈跟踪包含生成的 JavaScript 文件的行号。使用 Pages 对 source maps的支持,你可以获得与原始源代码的行号和符号相匹配的堆栈跟踪。

请参阅 源映射和堆栈跟踪 以获取更深入的解释。