Storprototrace高级配置：如何自定义统计项和过滤规则

2026/6/29 22:12:42

Storprototrace高级配置：如何自定义统计项和过滤规则

【免费下载链接】storprototraceStorprototrace (storage protocol trace) is a tracing function for IO events entering the iscsi protocol driver layer based on libbpf.项目地址: https://gitcode.com/openeuler/storprototrace

前往项目官网免费下载：https://ar.openeuler.org/ar/

Storprototrace是基于libbpf的存储协议跟踪工具，专门用于捕获进入iSCSI协议驱动层的IO事件。本文将详细介绍如何通过命令行参数自定义统计项和过滤规则，帮助用户精准定位和分析存储性能问题。

一、基础过滤规则配置 🚀

Storprototrace提供了多种命令行参数用于过滤特定IO事件，核心过滤参数定义在cli_parser/cli_parser.h中，支持以下维度的精确过滤：

1.1 按会话/连接ID过滤

通过会话ID（SID）和连接ID（CID）过滤特定iSCSI会话的事件：

# 跟踪指定SID的会话 ./storprototrace -sid 1 # 跟踪指定SID和CID的连接 ./storprototrace -sid 1 -cid 0

⚠️ 注意：使用CID过滤时必须同时指定SID，系统会自动验证会话和连接的有效性，如cli_parser/cli_parser.cpp中的验证逻辑所示。

1.2 按目标/发起者名称过滤

针对特定iSCSI目标或发起者进行跟踪：

# 跟踪指定目标名称的事件 ./storprototrace -target "iqn.2024-06.com.example:storage.target0" # 跟踪指定发起者名称的事件 ./storprototrace -initiatorname "iqn.2024-06.com.example:initiator0"

系统会通过检查/etc/iscsi/nodes/目录验证目标名称的有效性，具体实现见cli_parser/cli_parser.cpp。

1.3 LUN过滤

精确跟踪特定逻辑单元号（LUN）的IO事件：

./storprototrace -lun "360014058a7b3d2a8a7b3d2a800000001"

二、统计项自定义方法 📊

Storprototrace默认输出丰富的性能统计项，主要包括：

连接信息（sid/cid）
IO读写类型（RW）
时间间隔统计（总间隔/最大间隔，单位ns）
发起者/目标名称
LUN信息

这些统计项的输出格式定义在iscsi_usr.cpp中，用户可以通过以下方式自定义统计行为：

2.1 单次事件模式

使用-once参数仅显示一次事件后退出，适合快速验证配置：

./storprototrace -target "iqn.2024-06.com.example:storage.target0" -once

2.2 详细调试信息

启用-verbose参数获取更详细的调试输出，帮助诊断过滤规则是否生效：

./storprototrace -sid 1 -verbose

三、高级过滤组合策略 🔍

通过组合多个过滤参数，可以实现更精确的事件跟踪。以下是几个实用示例：

3.1 多条件组合过滤

跟踪特定会话中来自指定发起者的LUN事件：

./storprototrace -sid 1 -initiatorname "iqn.2024-06.com.example:initiator0" -lun "360014058a7b3d2a8a7b3d2a800000001"

3.2 性能问题定位场景

当需要定位特定目标的性能问题时，可结合时间间隔统计项进行分析：

./storprototrace -target "iqn.2024-06.com.example:storage.target0"

输出结果将包含"Toal Interval(ns)"和"Max Interval(ns)"等关键性能指标，帮助识别IO延迟异常。

四、配置验证与常见问题 ❓

4.1 配置验证方法

所有过滤参数在生效前会经过严格验证，例如：

SID/CID验证会检查/sys/class/iscsi_session/和/sys/class/iscsi_connection/目录
目标名称验证会检查/etc/iscsi/nodes/目录
发起者名称验证会读取会话目录下的initiatorname文件

4.2 常见错误解决

"need sid!"错误：使用CID过滤时未指定SID，需同时提供-sid参数
"can not find this session"错误：指定的SID不存在，可通过ls /sys/class/iscsi_session/查看有效会话
目标名称验证失败：确保目标名称与/etc/iscsi/nodes/目录下的文件夹名称完全一致

五、使用流程总结 📝

克隆项目仓库：

git clone https://gitcode.com/openeuler/storprototrace

根据需求组合过滤参数：

# 示例：跟踪SID为1、目标名称为target0的事件 ./storprototrace -sid 1 -target "iqn.2024-06.com.example:storage.target0"

分析输出的统计结果，定位存储性能问题

通过灵活配置Storprototrace的过滤规则和统计项，用户可以精准聚焦于关注的IO事件，有效提升存储系统的问题诊断效率。更多高级功能可参考项目源代码中的iscsi_stats_ebpf.h和cli_parser目录下的实现。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Storprototrace高级配置：如何自定义统计项和过滤规则