Skip to content

docs: update continuous profiling runtime support - #780

Open
kylewanginchina wants to merge 2 commits into
mainfrom
update-continuous-profiling-docs
Open

docs: update continuous profiling runtime support#780
kylewanginchina wants to merge 2 commits into
mainfrom
update-continuous-profiling-docs

Conversation

@kylewanginchina

Copy link
Copy Markdown
Contributor

背景

持续剖析产品文档未覆盖最新的 Node.js/V8、PHP、Lua 和 Python 解释器剖析能力,中英文版本在能力矩阵、配置路径和 Java CPU Profiling 内容上也存在漂移。

修改内容

  • 更新四种解释器的版本、架构、Profile 类型、内核前置条件和降级行为。
  • 同步最新默认 Process Matcher、语言开关及 On-CPU、Off-CPU、Memory 配置。
  • 补充 eBPF 查询字段、JS/PHP 栈帧识别和解释器栈排障说明。
  • 同步英文文档,修复符号表路径并补齐 Java CPU Profiling 章节。

影响范围

仅修改 Continuous Profiling 的六个中英文 Markdown 页面,不改变代码、配置默认值或生成文件。

验证

  • git diff --check 通过。
  • 6 个 Markdown 文件和 16 个 YAML 示例解析通过。
  • 中英文配置示例与最新 server/agent_config/template.yaml 逐项一致。
  • VuePress 全站构建仍被基线中未检入的生成型 Agent 配置页面链接阻断;失败同时出现在多个未修改文件,本次新增链接未产生独立错误。

检查项

  • 不需要更新依赖
  • 仅文档修改,无代码路径测试要求
  • 已同步中英文内容

**复现步骤**

现有持续剖析产品文档缺少 Node.js/V8 和 PHP,Python 版本及 Lua Off-CPU 声明也已落后于最新 Agent 实现;中英文配置和数据说明存在漂移。

**原因和解决方案**

基于最新 Agent runtime unwinder、内核选择逻辑、Server Profile 字段和 agent_config 模板,更新中英文能力矩阵、内核与降级边界、默认 Process Matcher、语言开关、查询字段及脚本栈排障说明。同时补齐英文 Java CPU Profiling 章节并修正符号表配置路径。

**影响范围**

仅修改 Continuous Profiling 的六个中英文 Markdown 页面,不改变代码、配置默认值或生成文件。

**验证方案**

通过 git diff --cached --check;六个 Markdown 文件和十六个 YAML 示例解析通过;中英文配置示例与最新 template.yaml 逐项一致。VuePress 全站构建仍被基线中未检入的生成型 Agent 配置页面链接阻断。

**涉及分支**

* main

**检查项**

- [ ] 需要更新依赖
- [x] 是共性问题(中英文多页面内容漂移)
- [ ] 编译通过(全站构建受基线链接问题阻断)
- [ ] 单元测试通过(仅文档修改,不适用)
@kylewanginchina
kylewanginchina force-pushed the update-continuous-profiling-docs branch from e7d3616 to 703598d Compare September 2, 2026 04:17
**复现步骤**

持续剖析能力矩阵仅将 HBM Profile 归类为 CUDA,未明确 Python/PyTorch/vLLM 进程通过 CUDA API 分配显存时同样可以采集 hbm-alloc 和 hbm-inuse。

**原因和解决方案**

补充 Python HBM 能力、受支持 CUDA API、Worker 子进程匹配、动态 uprobe 挂载时序、启动期漏采及 Caching Allocator 边界。同步更新中英文能力矩阵、配置说明和数据类型说明;Lua/LuaJIT 仍仅列为 On-CPU 支持。

**影响范围**

仅更新持续剖析产品文档,不修改运行时代码、配置默认值、依赖或生成文件。

**验证方案**

运行 git diff --check;使用仓库 VuePress Markdown 渲染器解析 6 个修改文件并校验跨页锚点。全站 VuePress 构建被现有 Release Notes 无效链接阻断,与本次修改无关。

**涉及分支**

* main

**检查项**

- [x] 不需要更新依赖
- [x] 目标 Markdown 渲染通过
- [x] git diff --check 通过
- [x] 无需代码单元测试(纯文档)
- [ ] 全站 VuePress 构建通过(受现有无效链接阻断)
@kylewanginchina
kylewanginchina force-pushed the update-continuous-profiling-docs branch from 703598d to 122bf67 Compare September 2, 2026 04:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant