实时日志

通过实时日志，你可以近乎实时地访问全球发生的所有日志事件。实时日志有助于获得即时反馈，例如新部署的状态。

实时日志捕获调用日志、自定义日志、错误和未捕获的异常。对于高流量应用，实时日志可能进入采样模式，这意味着部分消息会被丢弃，并在日志中显示警告。

要使用 Cloudflare 仪表板查看任何已部署 Worker 的实时日志：

1. 在 Cloudflare 仪表板中，前往 Workers & Pages 页面。

   Go to Workers & Pages ↗

2. 在 Overview（概览） 中，选择你的 Worker。

3. 选择 Logs（日志）。

4. 在右侧导航栏中，选择 Live（实时）。

要使用 Wrangler 查看任何已部署 Worker 的实时日志：

1. 进入 Worker 项目目录。
2. 运行 npx wrangler tail。

这将在本地终端中记录应用的任何传入请求。

每个 wrangler tail 日志的输出是结构化 JSON 对象：

{
	"outcome": "ok",
	"scriptName": null,
	"exceptions": [],
	"logs": [],
	"eventTimestamp": 1590680082349,
	"event": {
		"request": {
			"url": "https://www.bytesized.xyz/",
			"method": "GET",
			"headers": {},
			"cf": {}
		}
	}
}

通过将输出管道到 jq ↗ 等工具，你可以查询和操作请求以查找特定信息：

npx wrangler tail | jq .event.request.url

"https://www.bytesized.xyz/"
"https://www.bytesized.xyz/component---src-pages-index-js-a77e385e3bde5b78dbf6.js"
"https://www.bytesized.xyz/page-data/app-data.json"

你可以自定义 wrangler tail 的工作方式以满足需求。请参阅 wrangler tail 文档了解可用配置选项。

• 实时日志不存储 Workers Logs。要存储日志，请使用 Workers Logs。
• 若 Worker 流量很大，实时日志可能进入采样模式。这将导致部分消息被丢弃，并在日志中显示警告。
• Worker 使用的任何 Durable Objects 的日志将显示在仪表板中。
• 最多 10 个客户端可同时查看 Worker 的日志。这可以是仪表板会话或 wrangler tail 调用的组合。
• 将 wrangler tail 与 WebSocket 事件处理器 一起使用时，这些处理器中的任何 console.log 语句在 WebSocket 客户端关闭连接之前会被隐藏。收到 close 后，所有消息会被刷新，一次性打印到终端。

日志可通过 Workers Logs 持久化、过滤和分析。要将日志发送到第三方，请使用 Workers Logpush 或 Tail Workers。

• 错误和异常 - 查看常见 Workers 错误。
• 本地开发 - 在本地开发和测试 Workers。
• Workers Logs - 收集、存储、过滤和分析 Cloudflare Workers 发出的日志数据。
• Logpush - 了解如何将 Workers Trace Event Logs 推送到支持的目标。
• Tail Workers - 了解如何附加 Tail Workers 以转换日志并发送到 HTTP 端点。
• Source maps 和堆栈跟踪 - 了解如何启用 source maps 并为 Workers 生成堆栈跟踪。