mcpField
W
workers-profiling

workers-profiling

github.com/cloudflare开发3.2k15.0k 次安装今天更新
代码仓库

关于 workers-profiling

用于分析已部署 Cloudflare Workers 和 Durable Objects 性能问题的技能,面向需要定位 CPU、延迟或内存开销的开发者。它指导采集和检查 pprof 性能数据,并据此提出最小代码修改。

主要功能

  1. 01识别 CPU、延迟及内存症状
  2. 02选择 CPU 或堆分析
  3. 03通过 cf CLI 采集性能数据
  4. 04检查 pprof 热点与源码位置
  5. 05提出可验证的最小优化

适用场景

  1. 01定位 Worker 中耗时较高的函数
  2. 02分析 Durable Object 的内存增长
  3. 03依据性能数据提出代码优化
  4. 04验证优化对指标的影响

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/cloudflare/skills --skill workers-profiling

安装后在 Claude Code 中输入/workers-profiling确认已加载。

详细介绍

Workers 性能分析

查找已部署代码中的高开销函数或内存分配,并提出优化方案。

获取文档

先阅读生产环境性能分析指南,了解 Workers 和 Durable Objects 的性能分析方式。

性能分析步骤

  1. 确认症状和受影响的工作负载:CPU 使用率、延迟、分配压力或内存增长。
  2. 与用户确认账户、Worker、环境和已部署版本。
  3. 对于 Durable Object,还要确认其所属 Worker、命名空间和实例。
  4. 根据当前指南中支持的类型及其含义,选择 CPU 或堆性能分析。

在可行的情况下,使用 cf CLI 捕获性能分析数据。如果用户要求使用 cf,请检查已安装版本的命令帮助和可用的架构。

如果无法使用 cf,可以询问用户是否要安装它。

性能分析 API 会返回 pprof 文件,你可以直接分析该文件,也可以使用 Go 的 pprof 实用工具等合适的工具进行分析。

检查证据

  • 读取 pprof 文件并分析其中的热点
  • 在证据充分时,将热点关联到函数和源代码位置;报告缺失的符号或源代码映射。
  • 如果文件名和函数名指向生成的 JavaScript,可以建议用户启用源代码映射并重新进行性能分析。

优化

提出能够解决已发现问题、且有捕获数据支持的最小代码更改。

报告发现

返回简洁的报告,其中包括:

  • 每项发现的证据:文件、函数、源代码位置,以及可用的指标和单位。
  • 最小且可执行的更改,以及如何验证其效果。

评论

支持 Markdown