📚 课程目录第3章 perf c2c安装与环境准备

3. perf c2c 安装与环境准备：内核配置要求、perf工具安装、硬件PMU支持检查

在开始使用 perf c2c 进行缓存一致性分析之前，必须确保系统环境满足硬件、内核及工具链三方面的要求。本章将详细讲解从内核编译选项到硬件 PMU 验证的完整准备流程，帮助您搭建一个可用的 perf c2c 分析环境。

3.1 硬件 PMU 支持检查

perf c2c 依赖处理器性能监视单元（PMU）中的特定事件来捕获缓存一致性流量。目前，该工具主要支持 Intel 和 AMD 的 x86 架构处理器，对 ARM 架构的支持仍在完善中。

3.1.1 支持的处理器微架构

厂商	微架构	PMU 版本	c2c 支持状态
Intel	Sandy Bridge / Ivy Bridge	PEBS v2	✅ 完全支持
Intel	Haswell / Broadwell	PEBS v3	✅ 完全支持
Intel	Skylake / Kaby Lake / Coffee Lake	PEBS v4	✅ 完全支持
Intel	Ice Lake / Tiger Lake / Alder Lake	PEBS v4+	✅ 完全支持
AMD	Zen 2 / Zen 3 / Zen 4	IBS v2+	✅ 完全支持
ARM	Cortex-A76 / Neoverse N1	SPE v1	⚠️ 实验性支持

3.1.2 验证 PMU 可用性

在终端中执行以下命令，检查系统是否具备 perf c2c 所需的基本 PMU 能力：

# 检查 PMU 版本和可用事件
perf list | grep -i "c2c\|cache\|snoop\|hitm"

# 检查 PEBS 或 IBS 是否启用
dmesg | grep -i "pebs\|ibs\|precise"

# 查看 CPU 型号和微架构
cat /proc/cpuinfo | grep "model name" | head -1
lscpu | grep "Architecture\|Model name"

💡 提示： 如果 perf list 输出中包含 mem-loads、mem-stores、l1d.replacement 等事件，说明 PMU 基础功能正常。若缺少 c2c 相关事件，请检查内核版本和配置。

3.2 内核配置要求

perf c2c 依赖内核中的多个子系统协同工作。以下配置项必须在内核编译时启用，否则工具将无法正确采集数据。

3.2.1 必需的内核配置项

配置项	说明	推荐值
`CONFIG_PERF_EVENTS`	性能事件核心框架	y
`CONFIG_HW_PERF_EVENTS`	硬件 PMU 事件支持	y
`CONFIG_HAVE_PERF_EVENTS`	架构级性能事件支持	y
`CONFIG_HAVE_HW_BREAKPOINT`	硬件断点支持（用于精确采样）	y
`CONFIG_HAVE_PERF_REGS`	性能事件寄存器转储	y
`CONFIG_HAVE_PERF_USER_STACK_DUMP`	用户态栈回溯支持	y
`CONFIG_X86_PMEM_LEGACY`	Intel 平台 PMEM 支持（可选）	m

3.2.2 验证当前内核配置

使用以下命令检查当前运行内核是否包含所需配置：

# 方法一：通过 /proc/config.gz（如果内核编译时启用了 CONFIG_IKCONFIG_PROC）
zcat /proc/config.gz | grep -E "CONFIG_PERF_EVENTS|CONFIG_HW_PERF_EVENTS|CONFIG_HAVE_PERF"

# 方法二：通过 /boot/config-$(uname -r)
cat /boot/config-$(uname -r) | grep -E "CONFIG_PERF_EVENTS|CONFIG_HW_PERF_EVENTS|CONFIG_HAVE_PERF"

⚠️ 警告： 如果上述配置项显示为 is not set 或 # CONFIG_xxx is not set，则需要重新编译内核。建议使用发行版提供的 kernel-devel 或 linux-image-extra 包来避免手动编译。

3.3 perf 工具安装

perf 工具是 Linux 内核源码树的一部分，通常位于 tools/perf/ 目录下。安装方式取决于您的发行版。

3.3.1 发行版包管理器安装（推荐）

发行版	安装命令	备注
Ubuntu / Debian	`sudo apt install linux-tools-common linux-tools-$(uname -r)`	自动匹配当前内核版本
RHEL / CentOS / Rocky	`sudo yum install perf` 或 `sudo dnf install perf`	EPEL 仓库可能需额外启用
Fedora	`sudo dnf install perf`	默认仓库包含
openSUSE	`sudo zypper install perf`	—
Arch Linux	`sudo pacman -S perf`	—

3.3.2 从内核源码编译安装

如果需要最新特性或自定义编译选项，可以从内核源码编译 perf：

# 1. 下载内核源码
git clone --depth 1 https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
cd linux

# 2. 安装编译依赖（Ubuntu/Debian 示例）
sudo apt install build-essential flex bison libelf-dev libdw-dev libunwind-dev \
                 libslang2-dev libnuma-dev libperl-dev python3-dev libssl-dev \
                 libcap-dev libzstd-dev

# 3. 编译 perf（仅编译 tools/perf，不编译整个内核）
make -C tools/perf

# 4. 安装到系统路径
sudo make -C tools/perf install

# 5. 验证安装
perf --version

  📌 关键点： 编译 perf 时，libnuma-dev 和 libunwind-dev 是 perf c2c 正常工作的重要依赖。缺少 libnuma 会导致 NUMA 拓扑信息无法获取，影响缓存一致性分析结果的准确性。

3.4 环境验证与故障排查

完成上述步骤后，执行以下命令进行完整的环境验证：

# 1. 检查 perf 版本（建议 ≥ 5.0）
perf --version

# 2. 检查 c2c 子命令是否可用
perf c2c --help

# 3. 运行一次快速测试（采集 1 秒数据）
perf c2c record -a -g -- sleep 1

# 4. 如果上一步成功，查看报告
perf c2c report

# 5. 检查是否有错误信息
dmesg | tail -20 | grep -i "perf\|pmu\|pebs\|ibs"

3.4.1 常见问题及解决方案

错误信息	可能原因	解决方案
`perf: 'c2c' is not a perf-command`	perf 版本过低或未编译 c2c 支持	升级到内核 5.0+ 或重新编译 perf
`No PMU or event for c2c`	硬件不支持或内核配置缺失	检查 CPU 微架构和内核配置项
`Operation not permitted`	权限不足	使用 `sudo` 或设置 `kernel.perf_event_paranoid=1`
`Cannot allocate memory`	perf 缓冲区不足	增大 `/proc/sys/kernel/perf_event_mlock_kb`

3.5 环境准备流程总览

以下 SVG 图展示了从硬件检查到工具验证的完整环境准备流程：

3.6 内核参数调优建议

为了获得更准确的 perf c2c 采样结果，建议调整以下内核参数：

# 降低 perf 事件采样限制（需要 root）
echo 1 > /proc/sys/kernel/perf_event_paranoid

# 增大 mlock 限制，允许更大的采样缓冲区
echo 65536 > /proc/sys/kernel/perf_event_mlock_kb

# 禁用看门狗以减少干扰（可选）
echo 0 > /proc/sys/kernel/nmi_watchdog

💡 生产环境建议： 在性能敏感的生产环境中，建议在分析完成后恢复 perf_event_paranoid 和 nmi_watchdog 的原始值，以避免潜在的性能影响。

3.7 本章小结

完成本章的环境准备后，您应该能够：

确认处理器微架构是否支持 perf c2c
验证内核配置是否满足所有依赖项
通过包管理器或源码编译成功安装 perf 工具
运行 perf c2c record 和 perf c2c report 进行基本验证