别再靠猜了:给 Cloudflare Worker 加上日志,问题一眼就知道
本文首发于 栏轩·阁欢迎访问阅读原文获取更好的阅读体验。什么是 Workers LogsWorkers Logs 是 Cloudflare 为 Workers 提供的内置日志服务。你在代码里写console.log输出会自动采集到 Cloudflare 仪表盘无需额外配置日志服务器。支持console.log、console.warn、console.error用法和浏览器/Node.js 完全一致。免费额度套餐每日额度保留时长Free20 万条/天3 天Paid2000 万条/月 $0.6/百万条7 天个人项目完全够用。开启方式在wrangler.json中添加 observability 配置{observability:{enabled:true,head_sampling_rate:1}}enabled: 开启日志采集head_sampling_rate: 采样率1 表示 100% 请求都记录0.1 表示只记录 10%部署后日志自动生效。查看日志有两种方式1. Cloudflare 仪表盘登录 dash.cloudflare.com → Workers Pages → 选择你的 Worker →Logs标签。在这里可以看到所有console.log输出的消息和结构化字段。2. 命令行实时查看npx wranglertail只查看错误npx wranglertail--statuserror适合开发调试时实时观察日志输出。日志格式建议基本写法console.log(用户登录成功,{userId:123,role:admin});console.warn(API 返回空数据,{url:https://api.xxx.com/data,status:200});console.error(数据库查询失败,{error:Connection timeout});推荐规则第一个参数用字符串写描述让人一眼看懂第二个参数传 JSON 对象Dashboard 会自动提取为结构化字段支持筛选和排序JSON 键名用英文方便 Dashboard 识别console.log记正常流程console.warn记预期内的异常console.error记真正的错误在哪些位置打日志外部 API 调用请求 URL、返回状态码、数据条数缓存操作命中/未命中错误处理catch 块中记异常信息和上下文请求入口/出口请求参数、处理结果避免记录的内容API Token、密钥等敏感信息用户密码、邮箱等个人数据大块完整数据记录条数或摘要即可常见问题日志怎么删除Workers Logs不支持主动删除。免费计划保留 3 天3 天后自动过期。日志量太大怎么办调低采样率{observability:{enabled:true,head_sampling_rate:0.1}}这样只记录 10% 的请求。日志能导出吗付费计划支持 Logpush推送到 R2、S3、Datadog 等和 OTel Export导出到 Sentry、Honeycomb 等 APM 平台。常用 APIWorkers Logs 提供三个 API 接口可用于程序化查询日志适合自动化巡检或集成到自己的后台。Base URLhttps://api.cloudflare.com/client/v4/accounts/{account_id}/workers/observability/telemetry认证方式Authorization: Bearer API Token需要workers_observability:read权限。查询日志POST /query查询 Workers 日志数据支持按字段筛选和时间范围过滤。返回console.log输出的消息和结构化字段。示例请求体{limit:20,filters:[{key:module,type:eq,value:platform}]}查看可查询的字段POST /keys返回所有可用的日志字段名方便你构建筛选条件。查看字段的取值POST /values查看某个字段有哪些可能的取值比如查看module字段有哪些模块名。实际应用场景定时查询最近 N 分钟的console.error日志发现异常自动告警统计某个外部 API 的调用失败率在自己的管理后台嵌入日志面板替代 Cloudflare 仪表盘分析各模块的调用频率和错误分布总结Workers Logs 是 Cloudflare Workers 最实用的功能之一配置简单加一行配置就行免费额度对于个人项目完全够用。核心要点在代码中加console.log日志自动采集到 Dashboard推荐用console.log(中文描述, { key: value })的格式兼顾可读性和结构化筛选遇到接口异常时日志能帮你快速定位问题原因不用再手动 curl 猜三个 API 接口可以在需要时用于程序化查询日志

相关新闻

MFC树控件节点删除实战:HTREEITEM机制与内存泄漏防范

MFC树控件节点删除实战:HTREEITEM机制与内存泄漏防范

1. 项目概述:为什么MFC树控件的节点删除值得深究?在Windows桌面应用开发的老兵圈里,MFC(Microsoft Foundation Classes)和VC(Visual C)这两个词,总是带着一股子“经典”的味道。你可…

2026/11/19 12:30:39 阅读更多 →
微信小程序横屏手写签名组件开发:Canvas API、横屏适配与性能优化实战

微信小程序横屏手写签名组件开发:Canvas API、横屏适配与性能优化实战

1. 项目缘起:为什么我们需要一个横屏签名板?最近在做一个政务类的微信小程序项目,里面有个环节需要用户在线签署一份电子告知书。产品经理的原型图里,签名区域是一个横着的长条,要求用户用手指或者触控笔在上面签名。一…

2026/11/19 14:11:52 阅读更多 →
C++内存五大区详解:栈、堆、静态区、常量区与代码区

C++内存五大区详解:栈、堆、静态区、常量区与代码区

1. 项目概述:为什么C程序员必须搞懂内存五大区?干了这么多年C,我越来越觉得,内存管理是区分“会用C”和“真正懂C”的一道分水岭。很多新手写代码,变量随手一放,指针随便一用,程序跑起来看似没问…

2026/11/19 3:40:32 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/19 21:38:27 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/19 21:38:49 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/19 21:39:09 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/19 21:36:50 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/19 21:37:45 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/19 21:36:20 阅读更多 →

日新闻

周新闻

月新闻