文章目录
- SCSI日志调试功能
- scsi_logging_level
- 调整SCSI日志等级
- SCSI trace events
- 使能SCSI trace events
- 方式一:通过set_event接口
- 方式二:通过enable
- 跟踪trace信息
- 相关参考
SCSI日志调试功能
SCSI子系统支持内核选项CONFIG_SCSI_LOGGING
配置日志调试功能:
scsi_logging_level
scsi_logging_level定义为一个4字节的值,表示了SCSI的各种日志类型及对应的日志等级:
unsigned int scsi_logging_level;
scsi_logging_level被分成10个3位的字段,每个字段定义为一种日志类型,字段取值范围为0~7,表示了对应日志类型的打印等级。SCSI支持的日志类型如下:
- SCSI_LOG_ERROR
- SCSI_LOG_TIMEOUT_BITS
- SCSI_LOG_SCAN_BITS
- SCSI_LOG_MLQUEUE_BITS
- SCSI_LOG_MLCOMPLETE_BITS
- SCSI_LOG_LLQUEUE_BITS
- SCSI_LOG_LLCOMPLETE_BITS
- SCSI_LOG_HLQUEUE_BITS
- SCSI_LOG_HLCOMPLETE_BITS
- SCSI_LOG_IOCTL
调整SCSI日志等级
SCSI日志调试可以通过修改/proc/sys/devscsi/logging_level进行控制:
echo <bitmask> > /proc/sys/dev/scsi/logging_level # 0表示关闭,-1表示全开
通过proc文件系统的方式需要手动计算bitmask,相对比较繁琐,lsscsi软件包提供了scsi_logging_level命令行工具来控制SCSI子系统的打印等级:
-s, --set:设置SCSI日志类型打印等级
-g, --get: 获取当前SCSI日志类型等级设置
-a, --all:设置所有SCSI日志类型的打印等级
-E, --error :设置SCSI_LOG_ERROR的打印等级
-T, --timeout:设置SCSI_LOG_TIMEOUT的打印等级
-S, --scan:设置SCSI_LOG_SCAN的打印等级
-M, --midlevel:设置SCSI_LOG_MLQUEUE和SCSI_LOG_MLCOMPLETE的打印等级
--mlqueue:设置SCSI_LOG_MLQUEUE的打印等级
--mlcomplete:设置SCSI_LOG_MLCOMPLETE的打印等级
-L, --lowlevel:设置SCSI_LOG_LLQUEUE和SCSI_LOG_LLCOMPLETE的打印等级
--llqueue:设置SCSI_LOG_LLQUEUE的打印等级
--llcomplete:设置SCSI_LOG_LLCOMPLETE的打印等级
-H, --highlevel:设置SCSI_LOG_HLQUEUE和SCSI_LOG_HLCOMPLETE的打印等级
--hlqueue:设置SCSI_LOG_HLQUEUE的打印等级
--hlcomplete:设置SCSI_LOG_HLCOMPLETE的打印等级
-I, --ioctl:设置SCSI_LOG_IOCTL的打印等级
scsi_logging_level命令使用示例:
SCSI trace events
SCSI子系统注册了一些trace events,这些trace events可以用来跟踪特定路径上的行为,已支持的trace events有:
这些trace events也可以在/sys/kernel/debug/tracing/events/scsi
目录下找到:
使能SCSI trace events
方式一:通过set_event接口
* 使能特定的event:echo 'scsi_dispatch_cmd_done' > /sys/kernel/debug/tracing/set_event
* 使能SCSI系统的所有event:echo 'scsi:*' > /sys/kernel/debug/tracing/
* 禁用特定的event:echo '!scsi_dispatch_cmd_done' > /sys/kernel/debug/tracing/set_event
方式二:通过enable
* 使能特定的event:echo 1 > /sys/kerne/debug/tracing/events/scsi/scsi_dispatch_cmd_done/enable
* 使能SCSI系统的所有event:echo 1 > /sys/kernel/debug/tracing/event/scsi/enable
* 禁用特定的event:echo '!scsi_dispatch_cmd_done' > /sys/kernel/debug/tracing/set_event
跟踪trace信息
SCSI子系统注册的trace events有限,只能查看位于IO请求下发、返回的一些信息,对于日常问题定位可能帮助不大,但可以辅助用来分析SCSI的运行流程。
相关参考
- 《存储技术原理分析:基于Linux 2.6内核源代码分析》
- 深入浅出SCSI子系统
- Tracing event