From 7333da25bf9a6e37ec931b156ade18fb8dbeab77 Mon Sep 17 00:00:00 2001 From: Jiping Yin Date: Tue, 8 Sep 2026 21:02:21 +0800 Subject: [PATCH 1/7] docs: clarify kernel support matrix --- docs/zh/02-ce-install/01-overview.md | 36 +++++++++++-------- .../translated/02-ce-install/01-overview.md | 36 +++++++++++-------- 2 files changed, 42 insertions(+), 30 deletions(-) diff --git a/docs/zh/02-ce-install/01-overview.md b/docs/zh/02-ce-install/01-overview.md index 7c668636..503cc7e0 100644 --- a/docs/zh/02-ce-install/01-overview.md +++ b/docs/zh/02-ce-install/01-overview.md @@ -28,21 +28,22 @@ permalink: /ce-install/overview # 运行权限及内核要求 DeepFlow 中的 eBPF 能力（AutoTracing、AutoProfiling）对内核版本的要求如下： -| 体系架构 | 发行版 | 内核版本 | kprobe [1] | Golang uprobe | OpenSSL uprobe | perf | -| -------- | ------ | ------- | ---------- | ------------- | -------------- | ---- | -| X86 | CentOS 7.9 | 3.10.0-940+ **[2]** | Y | Y **[3]** | Y **[3]** | Y | -| | RedHat 7.6 | 3.10.0-940+ **[2]** | Y | Y **[3]** | Y **[3]** | Y | -| | \* | 4.14 **[4]** | Y | Y **[3]** | | Y | -| | \* | 4.15 | Y | Y **[3]** | | Y | -| | \* | 4.16 | Y | Y | | Y | -| | \* | 4.17+ | Y | Y | Y | Y | -| | SUSE 12 SP5 | 4.12 [5] | Y | Y | | Y | -| ARM | CentOS 8 | 4.18 | Y | Y | Y | Y | -| | EulerOS | 5.10+ [6]| Y | Y | Y | Y | -| | 麒麟 KylinOS V10 SP1 | 4.19.90-23 [7] | Y | Y | Y | Y | -| | 麒麟 KylinOS V10 SP2 | 4.19.90-25.24+ [8] | Y | Y | Y | Y | -| | 麒麟 KylinOS V10 SP3 | 4.19.90-52.24+ | Y | Y | Y | Y | -| | 其他发行版 | 5.8+ | Y | Y | Y | Y | + +| 体系架构 | 发行版 | 内核版本 | kprobe [1] | Golang uprobe | OpenSSL uprobe | perf [9] | TCP Option Trace | CPU Balancer | +| -------- | ------ | -------- | ---------- | ------------- | -------------- | ---- | ---------------- | ------------ | +| X86 | CentOS 7.9 | 3.10.0-940+ **[2]** | Y | Y **[3]** | Y **[3]** | Y | | | +| | RedHat 7.6 | 3.10.0-940+ **[2]** | Y | Y **[3]** | Y **[3]** | Y | | | +| | \* | 4.14 **[4]** | Y | Y **[3]** | | Y | | | +| | \* | 4.15 | Y | Y **[3]** | | Y | | Y **[11]** | +| | \* | 4.16 | Y | Y | | Y | | Y **[11]** | +| | \* | 4.17+ | Y | Y | Y | Y | 5.10+ **[10]** | Y **[11]** | +| | SUSE 12 SP5 | 4.12 [5] | Y | Y | | Y | | | +| ARM | CentOS 8 | 4.18 | Y | Y | Y | Y | | Y **[11]** | +| | EulerOS | 5.10+ [6] | Y | Y | Y | Y | Y **[10]** | Y **[11]** | +| | 麒麟 KylinOS V10 SP1 | 4.19.90-23 [7] | Y | Y | Y | Y | | Y **[11]** | +| | 麒麟 KylinOS V10 SP2 | 4.19.90-25.24+ [8] | Y | Y | Y | Y | | Y **[11]** | +| | 麒麟 KylinOS V10 SP3 | 4.19.90-52.24+ | Y | Y | Y | Y | | Y **[11]** | +| | 其他发行版 | 5.8+ | Y | Y | Y | Y | 5.10+ **[10]** | Y **[11]** | 对内核版本的额外说明： @@ -63,6 +64,11 @@ DeepFlow 中的 eBPF 能力（AutoTracing、AutoProfiling）对内核版本的 - 4.19.90-vhulk2211.3.0.h1543.eulerosv2r10.aarch64 - [7]: 已验证 KylinOS V10 SP1 的部分 aarch64 内核（如 4.19.90-23.48.v2101.ky10.aarch64）可以正常运行 deepflow-agent，但不保证 KylinOS V10 SP1 的所有内核版本均能正常运行。 - [8]: KylinOS V10 SP2 某些内核如：4.19.90-24.4.v2101.ky10.aarch64 由于不支持 `bpf_probe_read_user()` 无法读取用户态的任何数据因而不支持 AutoTracing 功能，但可支持持续剖析和文件读写追踪功能。 +- [9]: `perf` 表示通用 eBPF Profiling 能力。其中，以下增强能力有额外的内核要求： + - [DWARF 栈回溯（DWARF Unwind）](../features/continuous-profiling/auto-profiling/#解释器运行时)：支持 Linux 5.2+，以及 Kylin V10 SP3 v2207 的 `4.19.90-*.v2207.ky10.*` 白名单内核。 + - [解释器脚本函数栈展开（Node.js/V8、PHP、Lua、Python Profiling）](../features/continuous-profiling/auto-profiling/#解释器运行时)：支持 Linux 5.2+，以及 Kylin V10 SP3 v2207 的 `4.19.90-*.v2207.ky10.*` 白名单内核。 +- [10]: TCP Option Trace 要求 Linux 5.10+，并启用 cgroup v2。 +- [11]: CPU Balancer 要求 Linux 4.15+，且内核支持 XDP 和 CPUMAP。 deepflow-agent 运行权限的要求： diff --git a/translate/translated/02-ce-install/01-overview.md b/translate/translated/02-ce-install/01-overview.md index 949f94e6..600019ad 100644 --- a/translate/translated/02-ce-install/01-overview.md +++ b/translate/translated/02-ce-install/01-overview.md @@ -29,21 +29,22 @@ If you currently do not have suitable resources to deploy DeepFlow, you can log # Running Permissions and Kernel Requirements The eBPF capabilities (AutoTracing, AutoProfiling) in DeepFlow have the following kernel version requirements: -| Architecture | Distribution | Kernel Version | kprobe [1] | Golang uprobe | OpenSSL uprobe | perf | -| -------- | ------ | ------- | ---------- | ------------- | -------------- | ---- | -| X86 | CentOS 7.9 | 3.10.0-940+ **[2]** | Y | Y **[3]** | Y **[3]** | Y | -| | RedHat 7.6 | 3.10.0-940+ **[2]** | Y | Y **[3]** | Y **[3]** | Y | -| | \* | 4.14 **[4]** | Y | Y **[3]** | | Y | -| | \* | 4.15 | Y | Y **[3]** | | Y | -| | \* | 4.16 | Y | Y | | Y | -| | \* | 4.17+ | Y | Y | Y | Y | -| | SUSE 12 SP5 | 4.12 [5] | Y | Y | | Y | -| ARM | CentOS 8 | 4.18 | Y | Y | Y | Y | -| | EulerOS | 5.10+ [6]| Y | Y | Y | Y | -| | KylinOS V10 SP1 | 4.19.90-23 [7] | Y | Y | Y | Y | -| | KylinOS V10 SP2 | 4.19.90-25.24+ [8] | Y | Y | Y | Y | -| | KylinOS V10 SP3 | 4.19.90-52.24+ | Y | Y | Y | Y | -| | Other Distributions | 5.8+ | Y | Y | Y | Y | + +| Architecture | Distribution | Kernel Version | kprobe [1] | Golang uprobe | OpenSSL uprobe | perf [9] | TCP Option Trace | CPU Balancer | +| ------------ | ------------ | -------------- | ---------- | ------------- | -------------- | ---- | ---------------- | ------------ | +| X86 | CentOS 7.9 | 3.10.0-940+ **[2]** | Y | Y **[3]** | Y **[3]** | Y | | | +| | RedHat 7.6 | 3.10.0-940+ **[2]** | Y | Y **[3]** | Y **[3]** | Y | | | +| | \* | 4.14 **[4]** | Y | Y **[3]** | | Y | | | +| | \* | 4.15 | Y | Y **[3]** | | Y | | Y **[11]** | +| | \* | 4.16 | Y | Y | | Y | | Y **[11]** | +| | \* | 4.17+ | Y | Y | Y | Y | 5.10+ **[10]** | Y **[11]** | +| | SUSE 12 SP5 | 4.12 [5] | Y | Y | | Y | | | +| ARM | CentOS 8 | 4.18 | Y | Y | Y | Y | | Y **[11]** | +| | EulerOS | 5.10+ [6] | Y | Y | Y | Y | Y **[10]** | Y **[11]** | +| | KylinOS V10 SP1 | 4.19.90-23 [7] | Y | Y | Y | Y | | Y **[11]** | +| | KylinOS V10 SP2 | 4.19.90-25.24+ [8] | Y | Y | Y | Y | | Y **[11]** | +| | KylinOS V10 SP3 | 4.19.90-52.24+ | Y | Y | Y | Y | | Y **[11]** | +| | Other Distributions | 5.8+ | Y | Y | Y | Y | 5.10+ **[10]** | Y **[11]** | Additional notes on kernel versions: @@ -64,6 +65,11 @@ Additional notes on kernel versions: - 4.19.90-vhulk2211.3.0.h1543.eulerosv2r10.aarch64 - [7]: Some aarch64 kernels of KylinOS V10 SP1 (e.g., 4.19.90-23.48.v2101.ky10.aarch64) have been verified to run deepflow-agent correctly. However, not all kernel versions of KylinOS V10 SP1 are guaranteed to be compatible. - [8]: Some kernels of KylinOS V10 SP2, such as 4.19.90-24.4.v2101.ky10.aarch64, do not support `bpf_probe_read_user()` and cannot read any user-space data, thus not supporting AutoTracing functionality, but can support continuous profiling and file read/write tracing functions. +- [9]: `perf` indicates the generic eBPF Profiling capability. The following enhanced capabilities have additional kernel requirements: + - [DWARF stack unwinding](../features/continuous-profiling/auto-profiling/#interpreter-runtimes): Linux 5.2 or later, or a whitelisted Kylin V10 SP3 v2207 kernel matching `4.19.90-*.v2207.ky10.*`. + - [Interpreter-level script stack unwinding (Node.js/V8, PHP, Lua, and Python Profiling)](../features/continuous-profiling/auto-profiling/#interpreter-runtimes): Linux 5.2 or later, or a whitelisted Kylin V10 SP3 v2207 kernel matching `4.19.90-*.v2207.ky10.*`. +- [10]: TCP Option Trace requires Linux 5.10 or later with cgroup v2 enabled. +- [11]: CPU Balancer requires Linux 4.15 or later and kernel support for XDP and CPUMAP. Requirements for running permissions of deepflow-agent: From 880dfa6323ca916cc238a0dee140260dfeace8ae Mon Sep 17 00:00:00 2001 From: Jiping Yin Date: Tue, 8 Sep 2026 21:09:46 +0800 Subject: [PATCH 2/7] docs: add Kylin V10 SP2 kernel support --- docs/zh/02-ce-install/01-overview.md | 5 +++-- translate/translated/02-ce-install/01-overview.md | 5 +++-- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/zh/02-ce-install/01-overview.md b/docs/zh/02-ce-install/01-overview.md index 503cc7e0..ad20f5c8 100644 --- a/docs/zh/02-ce-install/01-overview.md +++ b/docs/zh/02-ce-install/01-overview.md @@ -41,7 +41,8 @@ DeepFlow 中的 eBPF 能力（AutoTracing、AutoProfiling）对内核版本的 | ARM | CentOS 8 | 4.18 | Y | Y | Y | Y | | Y **[11]** | | | EulerOS | 5.10+ [6] | Y | Y | Y | Y | Y **[10]** | Y **[11]** | | | 麒麟 KylinOS V10 SP1 | 4.19.90-23 [7] | Y | Y | Y | Y | | Y **[11]** | -| | 麒麟 KylinOS V10 SP2 | 4.19.90-25.24+ [8] | Y | Y | Y | Y | | Y **[11]** | +| | 麒麟 KylinOS V10 SP2 | 4.19.90-24.4.v2101.ky10.aarch64 **[8]** | Y | | | Y | | Y **[11]** | +| | | 4.19.90-25.24+ | Y | Y | Y | Y | | Y **[11]** | | | 麒麟 KylinOS V10 SP3 | 4.19.90-52.24+ | Y | Y | Y | Y | | Y **[11]** | | | 其他发行版 | 5.8+ | Y | Y | Y | Y | 5.10+ **[10]** | Y **[11]** | @@ -63,7 +64,7 @@ DeepFlow 中的 eBPF 能力（AutoTracing、AutoProfiling）对内核版本的 - 4.19.90-vhulk2204.1.0.h1160.eulerosv2r10.aarch64 - 4.19.90-vhulk2211.3.0.h1543.eulerosv2r10.aarch64 - [7]: 已验证 KylinOS V10 SP1 的部分 aarch64 内核（如 4.19.90-23.48.v2101.ky10.aarch64）可以正常运行 deepflow-agent，但不保证 KylinOS V10 SP1 的所有内核版本均能正常运行。 -- [8]: KylinOS V10 SP2 某些内核如：4.19.90-24.4.v2101.ky10.aarch64 由于不支持 `bpf_probe_read_user()` 无法读取用户态的任何数据因而不支持 AutoTracing 功能，但可支持持续剖析和文件读写追踪功能。 +- [8]: KylinOS V10 SP2 内核 4.19.90-24.4.v2101.ky10.aarch64 不支持 `bpf_probe_read_user()`，无法读取用户态数据，因此不支持 AutoTracing、Golang uprobe 和 OpenSSL uprobe；支持通用持续剖析和文件读写追踪功能。 - [9]: `perf` 表示通用 eBPF Profiling 能力。其中，以下增强能力有额外的内核要求： - [DWARF 栈回溯（DWARF Unwind）](../features/continuous-profiling/auto-profiling/#解释器运行时)：支持 Linux 5.2+，以及 Kylin V10 SP3 v2207 的 `4.19.90-*.v2207.ky10.*` 白名单内核。 - [解释器脚本函数栈展开（Node.js/V8、PHP、Lua、Python Profiling）](../features/continuous-profiling/auto-profiling/#解释器运行时)：支持 Linux 5.2+，以及 Kylin V10 SP3 v2207 的 `4.19.90-*.v2207.ky10.*` 白名单内核。 diff --git a/translate/translated/02-ce-install/01-overview.md b/translate/translated/02-ce-install/01-overview.md index 600019ad..cb64eec1 100644 --- a/translate/translated/02-ce-install/01-overview.md +++ b/translate/translated/02-ce-install/01-overview.md @@ -42,7 +42,8 @@ The eBPF capabilities (AutoTracing, AutoProfiling) in DeepFlow have the followin | ARM | CentOS 8 | 4.18 | Y | Y | Y | Y | | Y **[11]** | | | EulerOS | 5.10+ [6] | Y | Y | Y | Y | Y **[10]** | Y **[11]** | | | KylinOS V10 SP1 | 4.19.90-23 [7] | Y | Y | Y | Y | | Y **[11]** | -| | KylinOS V10 SP2 | 4.19.90-25.24+ [8] | Y | Y | Y | Y | | Y **[11]** | +| | KylinOS V10 SP2 | 4.19.90-24.4.v2101.ky10.aarch64 **[8]** | Y | | | Y | | Y **[11]** | +| | | 4.19.90-25.24+ | Y | Y | Y | Y | | Y **[11]** | | | KylinOS V10 SP3 | 4.19.90-52.24+ | Y | Y | Y | Y | | Y **[11]** | | | Other Distributions | 5.8+ | Y | Y | Y | Y | 5.10+ **[10]** | Y **[11]** | @@ -64,7 +65,7 @@ Additional notes on kernel versions: - 4.19.90-vhulk2204.1.0.h1160.eulerosv2r10.aarch64 - 4.19.90-vhulk2211.3.0.h1543.eulerosv2r10.aarch64 - [7]: Some aarch64 kernels of KylinOS V10 SP1 (e.g., 4.19.90-23.48.v2101.ky10.aarch64) have been verified to run deepflow-agent correctly. However, not all kernel versions of KylinOS V10 SP1 are guaranteed to be compatible. -- [8]: Some kernels of KylinOS V10 SP2, such as 4.19.90-24.4.v2101.ky10.aarch64, do not support `bpf_probe_read_user()` and cannot read any user-space data, thus not supporting AutoTracing functionality, but can support continuous profiling and file read/write tracing functions. +- [8]: KylinOS V10 SP2 kernel 4.19.90-24.4.v2101.ky10.aarch64 does not support `bpf_probe_read_user()` and cannot read user-space data. Therefore, AutoTracing, Golang uprobe, and OpenSSL uprobe are unavailable; generic continuous profiling and file I/O tracing remain supported. - [9]: `perf` indicates the generic eBPF Profiling capability. The following enhanced capabilities have additional kernel requirements: - [DWARF stack unwinding](../features/continuous-profiling/auto-profiling/#interpreter-runtimes): Linux 5.2 or later, or a whitelisted Kylin V10 SP3 v2207 kernel matching `4.19.90-*.v2207.ky10.*`. - [Interpreter-level script stack unwinding (Node.js/V8, PHP, Lua, and Python Profiling)](../features/continuous-profiling/auto-profiling/#interpreter-runtimes): Linux 5.2 or later, or a whitelisted Kylin V10 SP3 v2207 kernel matching `4.19.90-*.v2207.ky10.*`. From 4772ee2b930971ed886391be97fe13dcd4c6f0bd Mon Sep 17 00:00:00 2001 From: Jiping Yin Date: Wed, 9 Sep 2026 05:46:54 +0800 Subject: [PATCH 3/7] docs: refine kernel support notes --- docs/zh/02-ce-install/01-overview.md | 9 ++++----- translate/translated/02-ce-install/01-overview.md | 9 ++++----- 2 files changed, 8 insertions(+), 10 deletions(-) diff --git a/docs/zh/02-ce-install/01-overview.md b/docs/zh/02-ce-install/01-overview.md index ad20f5c8..f1020515 100644 --- a/docs/zh/02-ce-install/01-overview.md +++ b/docs/zh/02-ce-install/01-overview.md @@ -41,8 +41,7 @@ DeepFlow 中的 eBPF 能力（AutoTracing、AutoProfiling）对内核版本的 | ARM | CentOS 8 | 4.18 | Y | Y | Y | Y | | Y **[11]** | | | EulerOS | 5.10+ [6] | Y | Y | Y | Y | Y **[10]** | Y **[11]** | | | 麒麟 KylinOS V10 SP1 | 4.19.90-23 [7] | Y | Y | Y | Y | | Y **[11]** | -| | 麒麟 KylinOS V10 SP2 | 4.19.90-24.4.v2101.ky10.aarch64 **[8]** | Y | | | Y | | Y **[11]** | -| | | 4.19.90-25.24+ | Y | Y | Y | Y | | Y **[11]** | +| | 麒麟 KylinOS V10 SP2 | 4.19.90-25.24+ [8] | Y | Y | Y | Y | | Y **[11]** | | | 麒麟 KylinOS V10 SP3 | 4.19.90-52.24+ | Y | Y | Y | Y | | Y **[11]** | | | 其他发行版 | 5.8+ | Y | Y | Y | Y | 5.10+ **[10]** | Y **[11]** | @@ -64,10 +63,10 @@ DeepFlow 中的 eBPF 能力（AutoTracing、AutoProfiling）对内核版本的 - 4.19.90-vhulk2204.1.0.h1160.eulerosv2r10.aarch64 - 4.19.90-vhulk2211.3.0.h1543.eulerosv2r10.aarch64 - [7]: 已验证 KylinOS V10 SP1 的部分 aarch64 内核（如 4.19.90-23.48.v2101.ky10.aarch64）可以正常运行 deepflow-agent，但不保证 KylinOS V10 SP1 的所有内核版本均能正常运行。 -- [8]: KylinOS V10 SP2 内核 4.19.90-24.4.v2101.ky10.aarch64 不支持 `bpf_probe_read_user()`，无法读取用户态数据，因此不支持 AutoTracing、Golang uprobe 和 OpenSSL uprobe；支持通用持续剖析和文件读写追踪功能。 +- [8]: KylinOS V10 SP2 某些内核如：4.19.90-24.4.v2101.ky10.aarch64 由于不支持 `bpf_probe_read_user()` 无法读取用户态的任何数据因而不支持 AutoTracing 功能，但可支持持续剖析和文件读写追踪功能。 - [9]: `perf` 表示通用 eBPF Profiling 能力。其中，以下增强能力有额外的内核要求： - - [DWARF 栈回溯（DWARF Unwind）](../features/continuous-profiling/auto-profiling/#解释器运行时)：支持 Linux 5.2+，以及 Kylin V10 SP3 v2207 的 `4.19.90-*.v2207.ky10.*` 白名单内核。 - - [解释器脚本函数栈展开（Node.js/V8、PHP、Lua、Python Profiling）](../features/continuous-profiling/auto-profiling/#解释器运行时)：支持 Linux 5.2+，以及 Kylin V10 SP3 v2207 的 `4.19.90-*.v2207.ky10.*` 白名单内核。 + - DWARF 栈回溯（DWARF Unwind）：支持 Linux 5.2+，以及 Kylin V10 SP3 v2207 的 `4.19.90-*.v2207.ky10.*` 白名单内核。 + - 解释器脚本函数栈展开（Node.js/V8、PHP、Lua、Python Profiling）：支持 Linux 5.2+，以及 Kylin V10 SP3 v2207 的 `4.19.90-*.v2207.ky10.*` 白名单内核。 - [10]: TCP Option Trace 要求 Linux 5.10+，并启用 cgroup v2。 - [11]: CPU Balancer 要求 Linux 4.15+，且内核支持 XDP 和 CPUMAP。 diff --git a/translate/translated/02-ce-install/01-overview.md b/translate/translated/02-ce-install/01-overview.md index cb64eec1..9423c938 100644 --- a/translate/translated/02-ce-install/01-overview.md +++ b/translate/translated/02-ce-install/01-overview.md @@ -42,8 +42,7 @@ The eBPF capabilities (AutoTracing, AutoProfiling) in DeepFlow have the followin | ARM | CentOS 8 | 4.18 | Y | Y | Y | Y | | Y **[11]** | | | EulerOS | 5.10+ [6] | Y | Y | Y | Y | Y **[10]** | Y **[11]** | | | KylinOS V10 SP1 | 4.19.90-23 [7] | Y | Y | Y | Y | | Y **[11]** | -| | KylinOS V10 SP2 | 4.19.90-24.4.v2101.ky10.aarch64 **[8]** | Y | | | Y | | Y **[11]** | -| | | 4.19.90-25.24+ | Y | Y | Y | Y | | Y **[11]** | +| | KylinOS V10 SP2 | 4.19.90-25.24+ [8] | Y | Y | Y | Y | | Y **[11]** | | | KylinOS V10 SP3 | 4.19.90-52.24+ | Y | Y | Y | Y | | Y **[11]** | | | Other Distributions | 5.8+ | Y | Y | Y | Y | 5.10+ **[10]** | Y **[11]** | @@ -65,10 +64,10 @@ Additional notes on kernel versions: - 4.19.90-vhulk2204.1.0.h1160.eulerosv2r10.aarch64 - 4.19.90-vhulk2211.3.0.h1543.eulerosv2r10.aarch64 - [7]: Some aarch64 kernels of KylinOS V10 SP1 (e.g., 4.19.90-23.48.v2101.ky10.aarch64) have been verified to run deepflow-agent correctly. However, not all kernel versions of KylinOS V10 SP1 are guaranteed to be compatible. -- [8]: KylinOS V10 SP2 kernel 4.19.90-24.4.v2101.ky10.aarch64 does not support `bpf_probe_read_user()` and cannot read user-space data. Therefore, AutoTracing, Golang uprobe, and OpenSSL uprobe are unavailable; generic continuous profiling and file I/O tracing remain supported. +- [8]: Some kernels of KylinOS V10 SP2, such as 4.19.90-24.4.v2101.ky10.aarch64, do not support `bpf_probe_read_user()` and cannot read any user-space data, thus not supporting AutoTracing functionality, but can support continuous profiling and file read/write tracing functions. - [9]: `perf` indicates the generic eBPF Profiling capability. The following enhanced capabilities have additional kernel requirements: - - [DWARF stack unwinding](../features/continuous-profiling/auto-profiling/#interpreter-runtimes): Linux 5.2 or later, or a whitelisted Kylin V10 SP3 v2207 kernel matching `4.19.90-*.v2207.ky10.*`. - - [Interpreter-level script stack unwinding (Node.js/V8, PHP, Lua, and Python Profiling)](../features/continuous-profiling/auto-profiling/#interpreter-runtimes): Linux 5.2 or later, or a whitelisted Kylin V10 SP3 v2207 kernel matching `4.19.90-*.v2207.ky10.*`. + - DWARF stack unwinding: Linux 5.2 or later, or a whitelisted Kylin V10 SP3 v2207 kernel matching `4.19.90-*.v2207.ky10.*`. + - Interpreter-level script stack unwinding (Node.js/V8, PHP, Lua, and Python Profiling): Linux 5.2 or later, or a whitelisted Kylin V10 SP3 v2207 kernel matching `4.19.90-*.v2207.ky10.*`. - [10]: TCP Option Trace requires Linux 5.10 or later with cgroup v2 enabled. - [11]: CPU Balancer requires Linux 4.15 or later and kernel support for XDP and CPUMAP. From eb8e004bf50ce6e6332db84d1b355993e7bdbf6c Mon Sep 17 00:00:00 2001 From: Jiping Yin Date: Wed, 9 Sep 2026 07:15:53 +0800 Subject: [PATCH 4/7] Profile add kernel support --- .../01-auto-profiling.md | 69 ++++++++++--------- .../01-auto-profiling.md | 69 ++++++++++--------- 2 files changed, 70 insertions(+), 68 deletions(-) diff --git a/docs/zh/05-features/04-continuous-profiling/01-auto-profiling.md b/docs/zh/05-features/04-continuous-profiling/01-auto-profiling.md index b6ee1e47..8988f6dd 100644 --- a/docs/zh/05-features/04-continuous-profiling/01-auto-profiling.md +++ b/docs/zh/05-features/04-continuous-profiling/01-auto-profiling.md @@ -15,41 +15,42 @@ permalink: /features/continuous-profiling/auto-profiling 支持的 eBPF Profiling 数据类型： -| 类型 | 支持语言/库 | 社区版 | 企业版 | -| ---------- | ----------- | ------ | ------ | -| on-cpu | Java | ✔ | ✔ | -| | C/C++ | ✔ | ✔ | -| | Rust | ✔ | ✔ | -| | Golang | ✔ | ✔ | -| | CUDA | ✔ | ✔ | -| | Node.js/V8 | | ✔ | -| | PHP | | ✔ | -| | Lua | | ✔ | -| | Python | | ✔ | -| off-cpu | Java | | ✔ | -| | C/C++ | | ✔ | -| | Rust | | ✔ | -| | Golang | | ✔ | -| | CUDA | | ✔ | -| | Node.js/V8 | | ✔ | -| | PHP | | ✔ | -| | Python | | ✔ | -| on-gpu | CUDA `*` | | ✔ | -| mem-alloc | Java `**` | | ✔ | -| | Rust | | ✔ | -| | Golang `*` | | ✔ | -| | Python | | ✔ | -| mem-inuse | Rust | | ✔ | -| | Python | | ✔ | -| hbm-alloc | CUDA `*` | | ✔ | -| | Python（调用 CUDA） | | ✔ | -| hbm-inuse | CUDA `*` | | ✔ | -| | Python（调用 CUDA） | | ✔ | -| rdma | C/C++ `*` | | ✔ | +| 类型 | 支持语言/库 | 支持的内核版本 | 社区版 | 企业版 | +| ---------- | ----------- | -------------- | ------ | ------ | +| on-cpu | Java | Linux 4.14+ | ✔ | ✔ | +| | C/C++ | Linux 4.14+ | ✔ | ✔ | +| | Rust | Linux 4.14+ | ✔ | ✔ | +| | Golang | Linux 4.14+ | ✔ | ✔ | +| | CUDA | Linux 4.14+ | ✔ | ✔ | +| | Node.js/V8 | Linux 5.2+/白名单内核 `***` | | ✔ | +| | PHP | Linux 5.2+/白名单内核 `***` | | ✔ | +| | Lua | Linux 5.2+/白名单内核 `***` | | ✔ | +| | Python | Linux 5.2+/白名单内核 `***` | | ✔ | +| off-cpu | Java | Linux 4.14+ | | ✔ | +| | C/C++ | Linux 4.14+ | | ✔ | +| | Rust | Linux 4.14+ | | ✔ | +| | Golang | Linux 4.14+ | | ✔ | +| | CUDA | Linux 4.14+ | | ✔ | +| | Node.js/V8 | Linux 5.2+/白名单内核 `***` | | ✔ | +| | PHP | Linux 5.2+/白名单内核 `***` | | ✔ | +| | Python | Linux 5.2+/白名单内核 `***` | | ✔ | +| on-gpu | CUDA `*` | Linux 4.14+ | | ✔ | +| mem-alloc | Java `**` | Linux 4.14+ | | ✔ | +| | Rust | Linux 4.14+ | | ✔ | +| | Golang `*` | Linux 4.14+ | | ✔ | +| | Python | Linux 5.2+/白名单内核 `***` | | ✔ | +| mem-inuse | Rust | Linux 4.14+ | | ✔ | +| | Python | Linux 5.2+/白名单内核 `***` | | ✔ | +| hbm-alloc | CUDA `*` | Linux 4.14+ | | ✔ | +| | Python（调用 CUDA） | Linux 5.2+/白名单内核 `***` | | ✔ | +| hbm-inuse | CUDA `*` | Linux 4.14+ | | ✔ | +| | Python（调用 CUDA） | Linux 5.2+/白名单内核 `***` | | ✔ | +| rdma | C/C++ `*` | Linux 4.14+ | | ✔ | 说明： - `*`: features in development - `**`: 运行 Java 程序的 JVM 须有符号表，参考[检查方法](#jvm-符号表检查) +- `***`: 已适配的麒麟 V2207 内核：版本以 `4.19.90-` 开头且包含 `.v2207.ky10.` - 类型： - on-cpu：函数在 CPU 上消耗的时间 - off-cpu：函数等待 CPU 的时间 @@ -108,9 +109,9 @@ Off-CPU Profiling 功能**仅会**采集如下调用栈： 支持的 Java Profiling 数据类型： -| 类型 | 支持语言/库 | 社区版 | 企业版 | -| ---- | ----------- | ------ | ------ | -| cpu | Java | | ✔ | +| 类型 | 支持语言/库 | 支持的内核版本 | 社区版 | 企业版 | +| ---- | ----------- | -------------- | ------ | ------ | +| cpu | Java | 推荐 Linux 4.14+ | | ✔ | 说明： - 类型： diff --git a/translate/translated/05-features/04-continuous-profiling/01-auto-profiling.md b/translate/translated/05-features/04-continuous-profiling/01-auto-profiling.md index 1df0e8c0..76ff9ddc 100644 --- a/translate/translated/05-features/04-continuous-profiling/01-auto-profiling.md +++ b/translate/translated/05-features/04-continuous-profiling/01-auto-profiling.md @@ -17,42 +17,43 @@ By using eBPF to capture snapshots of an application's function call stack, Deep Supported eBPF profiling data types: -| Type | Supported Languages/Libraries | Community Edition | Enterprise Edition | -| ---------- | ----------------------------- | ----------------- | ------------------ | -| on-cpu | Java | ✔ | ✔ | -| | C/C++ | ✔ | ✔ | -| | Rust | ✔ | ✔ | -| | Golang | ✔ | ✔ | -| | CUDA | ✔ | ✔ | -| | Node.js/V8 | | ✔ | -| | PHP | | ✔ | -| | Lua | | ✔ | -| | Python | | ✔ | -| off-cpu | Java | | ✔ | -| | C/C++ | | ✔ | -| | Rust | | ✔ | -| | Golang | | ✔ | -| | CUDA | | ✔ | -| | Node.js/V8 | | ✔ | -| | PHP | | ✔ | -| | Python | | ✔ | -| on-gpu | CUDA `*` | | ✔ | -| mem-alloc | Java `**` | | ✔ | -| | Rust | | ✔ | -| | Golang `*` | | ✔ | -| | Python | | ✔ | -| mem-inuse | Rust | | ✔ | -| | Python | | ✔ | -| hbm-alloc | CUDA `*` | | ✔ | -| | Python (using CUDA) | | ✔ | -| hbm-inuse | CUDA `*` | | ✔ | -| | Python (using CUDA) | | ✔ | -| rdma | C/C++ `*` | | ✔ | +| Type | Supported Languages/Libraries | Supported Kernel Versions | Community Edition | Enterprise Edition | +| ---------- | ----------------------------- | ------------------------- | ----------------- | ------------------ | +| on-cpu | Java | Linux 4.14+ | ✔ | ✔ | +| | C/C++ | Linux 4.14+ | ✔ | ✔ | +| | Rust | Linux 4.14+ | ✔ | ✔ | +| | Golang | Linux 4.14+ | ✔ | ✔ | +| | CUDA | Linux 4.14+ | ✔ | ✔ | +| | Node.js/V8 | Linux 5.2+/whitelisted kernels `***` | | ✔ | +| | PHP | Linux 5.2+/whitelisted kernels `***` | | ✔ | +| | Lua | Linux 5.2+/whitelisted kernels `***` | | ✔ | +| | Python | Linux 5.2+/whitelisted kernels `***` | | ✔ | +| off-cpu | Java | Linux 4.14+ | | ✔ | +| | C/C++ | Linux 4.14+ | | ✔ | +| | Rust | Linux 4.14+ | | ✔ | +| | Golang | Linux 4.14+ | | ✔ | +| | CUDA | Linux 4.14+ | | ✔ | +| | Node.js/V8 | Linux 5.2+/whitelisted kernels `***` | | ✔ | +| | PHP | Linux 5.2+/whitelisted kernels `***` | | ✔ | +| | Python | Linux 5.2+/whitelisted kernels `***` | | ✔ | +| on-gpu | CUDA `*` | Linux 4.14+ | | ✔ | +| mem-alloc | Java `**` | Linux 4.14+ | | ✔ | +| | Rust | Linux 4.14+ | | ✔ | +| | Golang `*` | Linux 4.14+ | | ✔ | +| | Python | Linux 5.2+/whitelisted kernels `***` | | ✔ | +| mem-inuse | Rust | Linux 4.14+ | | ✔ | +| | Python | Linux 5.2+/whitelisted kernels `***` | | ✔ | +| hbm-alloc | CUDA `*` | Linux 4.14+ | | ✔ | +| | Python (using CUDA) | Linux 5.2+/whitelisted kernels `***` | | ✔ | +| hbm-inuse | CUDA `*` | Linux 4.14+ | | ✔ | +| | Python (using CUDA) | Linux 5.2+/whitelisted kernels `***` | | ✔ | +| rdma | C/C++ `*` | Linux 4.14+ | | ✔ | Notes: - `*`: features in development - `**`: The JVM running the Java program must have a symbol table. See the [check method](#jvm-symbol-table-check). +- `***`: Adapted Kylin V2207 kernels whose versions start with `4.19.90-` and contain `.v2207.ky10.` - Types: - on-cpu: Time a function spends on the CPU - off-cpu: Time a function waits for the CPU @@ -111,9 +112,9 @@ The Off-CPU profiling feature **only** collects the following call stacks: Supported Java Profiling data types: -| Type | Supported Language/Library | Community Edition | Enterprise Edition | -| ---- | -------------------------- | ----------------- | ------------------ | -| cpu | Java | | ✔ | +| Type | Supported Language/Library | Supported Kernel Versions | Community Edition | Enterprise Edition | +| ---- | -------------------------- | ------------------------- | ----------------- | ------------------ | +| cpu | Java | Linux 4.14+ recommended | | ✔ | Notes: From d7031edd72e08831474cf57bfb1e6f2cb1df5ab6 Mon Sep 17 00:00:00 2001 From: Jiping Yin Date: Thu, 10 Sep 2026 07:25:36 +0800 Subject: [PATCH 5/7] docs: refine profiling kernel support guidance --- .../01-auto-profiling.md | 66 +++++++++---------- .../01-auto-profiling.md | 66 +++++++++---------- 2 files changed, 66 insertions(+), 66 deletions(-) diff --git a/docs/zh/05-features/04-continuous-profiling/01-auto-profiling.md b/docs/zh/05-features/04-continuous-profiling/01-auto-profiling.md index 8988f6dd..41cf16d6 100644 --- a/docs/zh/05-features/04-continuous-profiling/01-auto-profiling.md +++ b/docs/zh/05-features/04-continuous-profiling/01-auto-profiling.md @@ -15,42 +15,42 @@ permalink: /features/continuous-profiling/auto-profiling 支持的 eBPF Profiling 数据类型： -| 类型 | 支持语言/库 | 支持的内核版本 | 社区版 | 企业版 | -| ---------- | ----------- | -------------- | ------ | ------ | -| on-cpu | Java | Linux 4.14+ | ✔ | ✔ | -| | C/C++ | Linux 4.14+ | ✔ | ✔ | -| | Rust | Linux 4.14+ | ✔ | ✔ | -| | Golang | Linux 4.14+ | ✔ | ✔ | -| | CUDA | Linux 4.14+ | ✔ | ✔ | -| | Node.js/V8 | Linux 5.2+/白名单内核 `***` | | ✔ | -| | PHP | Linux 5.2+/白名单内核 `***` | | ✔ | -| | Lua | Linux 5.2+/白名单内核 `***` | | ✔ | -| | Python | Linux 5.2+/白名单内核 `***` | | ✔ | -| off-cpu | Java | Linux 4.14+ | | ✔ | -| | C/C++ | Linux 4.14+ | | ✔ | -| | Rust | Linux 4.14+ | | ✔ | -| | Golang | Linux 4.14+ | | ✔ | -| | CUDA | Linux 4.14+ | | ✔ | -| | Node.js/V8 | Linux 5.2+/白名单内核 `***` | | ✔ | -| | PHP | Linux 5.2+/白名单内核 `***` | | ✔ | -| | Python | Linux 5.2+/白名单内核 `***` | | ✔ | -| on-gpu | CUDA `*` | Linux 4.14+ | | ✔ | -| mem-alloc | Java `**` | Linux 4.14+ | | ✔ | -| | Rust | Linux 4.14+ | | ✔ | -| | Golang `*` | Linux 4.14+ | | ✔ | -| | Python | Linux 5.2+/白名单内核 `***` | | ✔ | -| mem-inuse | Rust | Linux 4.14+ | | ✔ | -| | Python | Linux 5.2+/白名单内核 `***` | | ✔ | -| hbm-alloc | CUDA `*` | Linux 4.14+ | | ✔ | -| | Python（调用 CUDA） | Linux 5.2+/白名单内核 `***` | | ✔ | -| hbm-inuse | CUDA `*` | Linux 4.14+ | | ✔ | -| | Python（调用 CUDA） | Linux 5.2+/白名单内核 `***` | | ✔ | -| rdma | C/C++ `*` | Linux 4.14+ | | ✔ | +| 类型 | 支持语言/库 | 社区版 | 企业版 | +| ---------- | ----------- | ------ | ------ | +| on-cpu | Java | ✔ | ✔ | +| | C/C++ | ✔ | ✔ | +| | Rust | ✔ | ✔ | +| | Golang | ✔ | ✔ | +| | CUDA | ✔ | ✔ | +| | Node.js/V8 | | ✔ | +| | PHP | | ✔ | +| | Lua | | ✔ | +| | Python | | ✔ | +| off-cpu | Java | | ✔ | +| | C/C++ | | ✔ | +| | Rust | | ✔ | +| | Golang | | ✔ | +| | CUDA | | ✔ | +| | Node.js/V8 | | ✔ | +| | PHP | | ✔ | +| | Python | | ✔ | +| on-gpu | CUDA `*` | | ✔ | +| mem-alloc | Java `**` | | ✔ | +| | Rust | | ✔ | +| | Golang `*` | | ✔ | +| | Python | | ✔ | +| mem-inuse | Rust | | ✔ | +| | Python | | ✔ | +| hbm-alloc | CUDA `*` | | ✔ | +| | Python（调用 CUDA） | | ✔ | +| hbm-inuse | CUDA `*` | | ✔ | +| | Python（调用 CUDA） | | ✔ | +| rdma | C/C++ `*` | | ✔ | 说明： - `*`: features in development - `**`: 运行 Java 程序的 JVM 须有符号表，参考[检查方法](#jvm-符号表检查) -- `***`: 已适配的麒麟 V2207 内核：版本以 `4.19.90-` 开头且包含 `.v2207.ky10.` +- 内核版本支持情况：请查看[运行权限及内核要求](../../ce-install/overview/#运行权限及内核要求)。 - 类型： - on-cpu：函数在 CPU 上消耗的时间 - off-cpu：函数等待 CPU 的时间 @@ -111,7 +111,7 @@ Off-CPU Profiling 功能**仅会**采集如下调用栈： | 类型 | 支持语言/库 | 支持的内核版本 | 社区版 | 企业版 | | ---- | ----------- | -------------- | ------ | ------ | -| cpu | Java | 推荐 Linux 4.14+ | | ✔ | +| cpu | Java | 推荐 Linux 4.14+ 或 CentOS/RedHat 3.10.0-940+ | | ✔ | 说明： - 类型： diff --git a/translate/translated/05-features/04-continuous-profiling/01-auto-profiling.md b/translate/translated/05-features/04-continuous-profiling/01-auto-profiling.md index 76ff9ddc..61f58569 100644 --- a/translate/translated/05-features/04-continuous-profiling/01-auto-profiling.md +++ b/translate/translated/05-features/04-continuous-profiling/01-auto-profiling.md @@ -17,43 +17,43 @@ By using eBPF to capture snapshots of an application's function call stack, Deep Supported eBPF profiling data types: -| Type | Supported Languages/Libraries | Supported Kernel Versions | Community Edition | Enterprise Edition | -| ---------- | ----------------------------- | ------------------------- | ----------------- | ------------------ | -| on-cpu | Java | Linux 4.14+ | ✔ | ✔ | -| | C/C++ | Linux 4.14+ | ✔ | ✔ | -| | Rust | Linux 4.14+ | ✔ | ✔ | -| | Golang | Linux 4.14+ | ✔ | ✔ | -| | CUDA | Linux 4.14+ | ✔ | ✔ | -| | Node.js/V8 | Linux 5.2+/whitelisted kernels `***` | | ✔ | -| | PHP | Linux 5.2+/whitelisted kernels `***` | | ✔ | -| | Lua | Linux 5.2+/whitelisted kernels `***` | | ✔ | -| | Python | Linux 5.2+/whitelisted kernels `***` | | ✔ | -| off-cpu | Java | Linux 4.14+ | | ✔ | -| | C/C++ | Linux 4.14+ | | ✔ | -| | Rust | Linux 4.14+ | | ✔ | -| | Golang | Linux 4.14+ | | ✔ | -| | CUDA | Linux 4.14+ | | ✔ | -| | Node.js/V8 | Linux 5.2+/whitelisted kernels `***` | | ✔ | -| | PHP | Linux 5.2+/whitelisted kernels `***` | | ✔ | -| | Python | Linux 5.2+/whitelisted kernels `***` | | ✔ | -| on-gpu | CUDA `*` | Linux 4.14+ | | ✔ | -| mem-alloc | Java `**` | Linux 4.14+ | | ✔ | -| | Rust | Linux 4.14+ | | ✔ | -| | Golang `*` | Linux 4.14+ | | ✔ | -| | Python | Linux 5.2+/whitelisted kernels `***` | | ✔ | -| mem-inuse | Rust | Linux 4.14+ | | ✔ | -| | Python | Linux 5.2+/whitelisted kernels `***` | | ✔ | -| hbm-alloc | CUDA `*` | Linux 4.14+ | | ✔ | -| | Python (using CUDA) | Linux 5.2+/whitelisted kernels `***` | | ✔ | -| hbm-inuse | CUDA `*` | Linux 4.14+ | | ✔ | -| | Python (using CUDA) | Linux 5.2+/whitelisted kernels `***` | | ✔ | -| rdma | C/C++ `*` | Linux 4.14+ | | ✔ | +| Type | Supported Languages/Libraries | Community Edition | Enterprise Edition | +| ---------- | ----------------------------- | ----------------- | ------------------ | +| on-cpu | Java | ✔ | ✔ | +| | C/C++ | ✔ | ✔ | +| | Rust | ✔ | ✔ | +| | Golang | ✔ | ✔ | +| | CUDA | ✔ | ✔ | +| | Node.js/V8 | | ✔ | +| | PHP | | ✔ | +| | Lua | | ✔ | +| | Python | | ✔ | +| off-cpu | Java | | ✔ | +| | C/C++ | | ✔ | +| | Rust | | ✔ | +| | Golang | | ✔ | +| | CUDA | | ✔ | +| | Node.js/V8 | | ✔ | +| | PHP | | ✔ | +| | Python | | ✔ | +| on-gpu | CUDA `*` | | ✔ | +| mem-alloc | Java `**` | | ✔ | +| | Rust | | ✔ | +| | Golang `*` | | ✔ | +| | Python | | ✔ | +| mem-inuse | Rust | | ✔ | +| | Python | | ✔ | +| hbm-alloc | CUDA `*` | | ✔ | +| | Python (using CUDA) | | ✔ | +| hbm-inuse | CUDA `*` | | ✔ | +| | Python (using CUDA) | | ✔ | +| rdma | C/C++ `*` | | ✔ | Notes: - `*`: features in development - `**`: The JVM running the Java program must have a symbol table. See the [check method](#jvm-symbol-table-check). -- `***`: Adapted Kylin V2207 kernels whose versions start with `4.19.90-` and contain `.v2207.ky10.` +- For supported kernel versions, see [Running Permissions and Kernel Requirements](../../ce-install/overview/#running-permissions-and-kernel-requirements). - Types: - on-cpu: Time a function spends on the CPU - off-cpu: Time a function waits for the CPU @@ -114,7 +114,7 @@ Supported Java Profiling data types: | Type | Supported Language/Library | Supported Kernel Versions | Community Edition | Enterprise Edition | | ---- | -------------------------- | ------------------------- | ----------------- | ------------------ | -| cpu | Java | Linux 4.14+ recommended | | ✔ | +| cpu | Java | Linux 4.14+ or CentOS/RedHat 3.10.0-940+ recommended | | ✔ | Notes: From 9f8d128141d834b70cc3c8313fd942768ab7c185 Mon Sep 17 00:00:00 2001 From: Jiping Yin Date: Thu, 10 Sep 2026 07:32:03 +0800 Subject: [PATCH 6/7] docs: update DWARF kernel requirement --- docs/zh/02-ce-install/01-overview.md | 2 +- translate/translated/02-ce-install/01-overview.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/zh/02-ce-install/01-overview.md b/docs/zh/02-ce-install/01-overview.md index f1020515..3ab8bbab 100644 --- a/docs/zh/02-ce-install/01-overview.md +++ b/docs/zh/02-ce-install/01-overview.md @@ -65,7 +65,7 @@ DeepFlow 中的 eBPF 能力（AutoTracing、AutoProfiling）对内核版本的 - [7]: 已验证 KylinOS V10 SP1 的部分 aarch64 内核（如 4.19.90-23.48.v2101.ky10.aarch64）可以正常运行 deepflow-agent，但不保证 KylinOS V10 SP1 的所有内核版本均能正常运行。 - [8]: KylinOS V10 SP2 某些内核如：4.19.90-24.4.v2101.ky10.aarch64 由于不支持 `bpf_probe_read_user()` 无法读取用户态的任何数据因而不支持 AutoTracing 功能，但可支持持续剖析和文件读写追踪功能。 - [9]: `perf` 表示通用 eBPF Profiling 能力。其中，以下增强能力有额外的内核要求： - - DWARF 栈回溯（DWARF Unwind）：支持 Linux 5.2+，以及 Kylin V10 SP3 v2207 的 `4.19.90-*.v2207.ky10.*` 白名单内核。 + - DWARF 栈回溯（DWARF Unwind）：支持 Linux 5.3+，以及 Kylin V10 SP3 v2207 的 `4.19.90-*.v2207.ky10.*` 白名单内核。 - 解释器脚本函数栈展开（Node.js/V8、PHP、Lua、Python Profiling）：支持 Linux 5.2+，以及 Kylin V10 SP3 v2207 的 `4.19.90-*.v2207.ky10.*` 白名单内核。 - [10]: TCP Option Trace 要求 Linux 5.10+，并启用 cgroup v2。 - [11]: CPU Balancer 要求 Linux 4.15+，且内核支持 XDP 和 CPUMAP。 diff --git a/translate/translated/02-ce-install/01-overview.md b/translate/translated/02-ce-install/01-overview.md index 9423c938..10646272 100644 --- a/translate/translated/02-ce-install/01-overview.md +++ b/translate/translated/02-ce-install/01-overview.md @@ -66,7 +66,7 @@ Additional notes on kernel versions: - [7]: Some aarch64 kernels of KylinOS V10 SP1 (e.g., 4.19.90-23.48.v2101.ky10.aarch64) have been verified to run deepflow-agent correctly. However, not all kernel versions of KylinOS V10 SP1 are guaranteed to be compatible. - [8]: Some kernels of KylinOS V10 SP2, such as 4.19.90-24.4.v2101.ky10.aarch64, do not support `bpf_probe_read_user()` and cannot read any user-space data, thus not supporting AutoTracing functionality, but can support continuous profiling and file read/write tracing functions. - [9]: `perf` indicates the generic eBPF Profiling capability. The following enhanced capabilities have additional kernel requirements: - - DWARF stack unwinding: Linux 5.2 or later, or a whitelisted Kylin V10 SP3 v2207 kernel matching `4.19.90-*.v2207.ky10.*`. + - DWARF stack unwinding: Linux 5.3 or later, or a whitelisted Kylin V10 SP3 v2207 kernel matching `4.19.90-*.v2207.ky10.*`. - Interpreter-level script stack unwinding (Node.js/V8, PHP, Lua, and Python Profiling): Linux 5.2 or later, or a whitelisted Kylin V10 SP3 v2207 kernel matching `4.19.90-*.v2207.ky10.*`. - [10]: TCP Option Trace requires Linux 5.10 or later with cgroup v2 enabled. - [11]: CPU Balancer requires Linux 4.15 or later and kernel support for XDP and CPUMAP. From a9984c890f99981c3a0a3f2fd4d2ef39d23f9db5 Mon Sep 17 00:00:00 2001 From: Jiping Yin Date: Thu, 10 Sep 2026 07:43:41 +0800 Subject: [PATCH 7/7] docs: clarify CPU Balancer XDP requirements --- docs/zh/02-ce-install/01-overview.md | 2 +- translate/translated/02-ce-install/01-overview.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/zh/02-ce-install/01-overview.md b/docs/zh/02-ce-install/01-overview.md index 3ab8bbab..3688c531 100644 --- a/docs/zh/02-ce-install/01-overview.md +++ b/docs/zh/02-ce-install/01-overview.md @@ -68,7 +68,7 @@ DeepFlow 中的 eBPF 能力（AutoTracing、AutoProfiling）对内核版本的 - DWARF 栈回溯（DWARF Unwind）：支持 Linux 5.3+，以及 Kylin V10 SP3 v2207 的 `4.19.90-*.v2207.ky10.*` 白名单内核。 - 解释器脚本函数栈展开（Node.js/V8、PHP、Lua、Python Profiling）：支持 Linux 5.2+，以及 Kylin V10 SP3 v2207 的 `4.19.90-*.v2207.ky10.*` 白名单内核。 - [10]: TCP Option Trace 要求 Linux 5.10+，并启用 cgroup v2。 -- [11]: CPU Balancer 要求 Linux 4.15+，且内核支持 XDP 和 CPUMAP。 +- [11]: CPU Balancer 要求 Linux 4.15+，且内核及网卡驱动支持 XDP，内核支持 CPUMAP。 deepflow-agent 运行权限的要求： diff --git a/translate/translated/02-ce-install/01-overview.md b/translate/translated/02-ce-install/01-overview.md index 10646272..1a664ad0 100644 --- a/translate/translated/02-ce-install/01-overview.md +++ b/translate/translated/02-ce-install/01-overview.md @@ -69,7 +69,7 @@ Additional notes on kernel versions: - DWARF stack unwinding: Linux 5.3 or later, or a whitelisted Kylin V10 SP3 v2207 kernel matching `4.19.90-*.v2207.ky10.*`. - Interpreter-level script stack unwinding (Node.js/V8, PHP, Lua, and Python Profiling): Linux 5.2 or later, or a whitelisted Kylin V10 SP3 v2207 kernel matching `4.19.90-*.v2207.ky10.*`. - [10]: TCP Option Trace requires Linux 5.10 or later with cgroup v2 enabled. -- [11]: CPU Balancer requires Linux 4.15 or later and kernel support for XDP and CPUMAP. +- [11]: CPU Balancer requires Linux 4.15 or later, XDP support from both the kernel and NIC driver, and kernel support for CPUMAP. Requirements for running permissions of deepflow-agent: