162306a36Sopenharmony_ci.. include:: ../disclaimer-zh_CN.rst
262306a36Sopenharmony_ci
362306a36Sopenharmony_ci:Original: Documentation/accounting/delay-accounting.rst
462306a36Sopenharmony_ci
562306a36Sopenharmony_ci:Translator: Yang Yang <yang.yang29@zte.com.cn>
662306a36Sopenharmony_ci
762306a36Sopenharmony_ci========
862306a36Sopenharmony_ci延时计数
962306a36Sopenharmony_ci========
1062306a36Sopenharmony_ci
1162306a36Sopenharmony_ci任务在等待某些内核资源可用时,会造成延时。例如一个可运行的任务可能会等待
1262306a36Sopenharmony_ci一个空闲CPU来运行。
1362306a36Sopenharmony_ci
1462306a36Sopenharmony_ci基于每任务的延时计数功能度量由以下情况造成的任务延时:
1562306a36Sopenharmony_ci
1662306a36Sopenharmony_cia) 等待一个CPU(任务为可运行)
1762306a36Sopenharmony_cib) 完成由该任务发起的块I/O同步请求
1862306a36Sopenharmony_cic) 页面交换
1962306a36Sopenharmony_cid) 内存回收
2062306a36Sopenharmony_cie) 抖动
2162306a36Sopenharmony_cif) 直接规整
2262306a36Sopenharmony_cig) 写保护复制
2362306a36Sopenharmony_ci
2462306a36Sopenharmony_ci并将这些统计信息通过taskstats接口提供给用户空间。
2562306a36Sopenharmony_ci
2662306a36Sopenharmony_ci这些延时信息为适当的调整任务CPU优先级、io优先级、rss限制提供反馈。重要任务
2762306a36Sopenharmony_ci长期延时,表示可能需要提高其相关优先级。
2862306a36Sopenharmony_ci
2962306a36Sopenharmony_ci通过使用taskstats接口,本功能还可提供一个线程组(对应传统Unix进程)所有任务
3062306a36Sopenharmony_ci(或线程)的总延时统计信息。此类汇总往往是需要的,由内核来完成更加高效。
3162306a36Sopenharmony_ci
3262306a36Sopenharmony_ci用户空间的实体,特别是资源管理程序,可将延时统计信息汇总到任意组中。为实现
3362306a36Sopenharmony_ci这一点,任务的延时统计信息在其生命周期内和退出时皆可获取,从而确保可进行
3462306a36Sopenharmony_ci连续、完整的监控。
3562306a36Sopenharmony_ci
3662306a36Sopenharmony_ci接口
3762306a36Sopenharmony_ci----
3862306a36Sopenharmony_ci
3962306a36Sopenharmony_ci延时计数使用taskstats接口,该接口由本目录另一个单独的文档详细描述。Taskstats
4062306a36Sopenharmony_ci向用户态返回一个通用数据结构,对应每pid或每tgid的统计信息。延时计数功能填写
4162306a36Sopenharmony_ci该数据结构的特定字段。见
4262306a36Sopenharmony_ci
4362306a36Sopenharmony_ci     include/uapi/linux/taskstats.h
4462306a36Sopenharmony_ci
4562306a36Sopenharmony_ci其描述了延时计数相关字段。系统通常以计数器形式返回 CPU、同步块 I/O、交换、内存
4662306a36Sopenharmony_ci回收、页缓存抖动、直接规整、写保护复制等的累积延时。
4762306a36Sopenharmony_ci
4862306a36Sopenharmony_ci取任务某计数器两个连续读数的差值,将得到任务在该时间间隔内等待对应资源的总延时。
4962306a36Sopenharmony_ci
5062306a36Sopenharmony_ci当任务退出时,内核会将包含每任务的统计信息发送给用户空间,而无需额外的命令。
5162306a36Sopenharmony_ci若其为线程组最后一个退出的任务,内核还会发送每tgid的统计信息。更多详细信息见
5262306a36Sopenharmony_citaskstats接口的描述。
5362306a36Sopenharmony_ci
5462306a36Sopenharmony_citools/accounting目录中的用户空间程序getdelays.c提供了一些简单的命令,用以显示
5562306a36Sopenharmony_ci延时统计信息。其也是使用taskstats接口的示例。
5662306a36Sopenharmony_ci
5762306a36Sopenharmony_ci用法
5862306a36Sopenharmony_ci----
5962306a36Sopenharmony_ci
6062306a36Sopenharmony_ci使用以下配置编译内核::
6162306a36Sopenharmony_ci
6262306a36Sopenharmony_ci	CONFIG_TASK_DELAY_ACCT=y
6362306a36Sopenharmony_ci	CONFIG_TASKSTATS=y
6462306a36Sopenharmony_ci
6562306a36Sopenharmony_ci延时计数在启动时默认关闭。
6662306a36Sopenharmony_ci若需开启,在启动参数中增加::
6762306a36Sopenharmony_ci
6862306a36Sopenharmony_ci   delayacct
6962306a36Sopenharmony_ci
7062306a36Sopenharmony_ci本文后续的说明基于延时计数已开启。也可在系统运行时,使用sysctl的
7162306a36Sopenharmony_cikernel.task_delayacct进行开关。注意,只有在启用延时计数后启动的
7262306a36Sopenharmony_ci任务才会有相关信息。
7362306a36Sopenharmony_ci
7462306a36Sopenharmony_ci系统启动后,使用类似getdelays.c的工具获取任务或线程组(tgid)的延时信息。
7562306a36Sopenharmony_ci
7662306a36Sopenharmony_cigetdelays命令的一般格式::
7762306a36Sopenharmony_ci
7862306a36Sopenharmony_ci	getdelays [-dilv] [-t tgid] [-p pid]
7962306a36Sopenharmony_ci
8062306a36Sopenharmony_ci获取pid为10的任务从系统启动后的延时信息::
8162306a36Sopenharmony_ci
8262306a36Sopenharmony_ci	# ./getdelays -d -p 10
8362306a36Sopenharmony_ci	(输出信息和下例相似)
8462306a36Sopenharmony_ci
8562306a36Sopenharmony_ci获取所有tgid为5的任务从系统启动后的总延时信息::
8662306a36Sopenharmony_ci
8762306a36Sopenharmony_ci	# ./getdelays -d -t 5
8862306a36Sopenharmony_ci	print delayacct stats ON
8962306a36Sopenharmony_ci	TGID	5
9062306a36Sopenharmony_ci
9162306a36Sopenharmony_ci
9262306a36Sopenharmony_ci	CPU             count     real total  virtual total    delay total  delay average
9362306a36Sopenharmony_ci	                    8        7000000        6872122        3382277          0.423ms
9462306a36Sopenharmony_ci	IO              count    delay total  delay average
9562306a36Sopenharmony_ci	                    0              0              0.000ms
9662306a36Sopenharmony_ci	SWAP            count    delay total  delay average
9762306a36Sopenharmony_ci	                    0              0              0.000ms
9862306a36Sopenharmony_ci	RECLAIM         count    delay total  delay average
9962306a36Sopenharmony_ci	                    0              0              0.000ms
10062306a36Sopenharmony_ci	THRASHING       count    delay total  delay average
10162306a36Sopenharmony_ci	                    0              0              0.000ms
10262306a36Sopenharmony_ci	COMPACT         count    delay total  delay average
10362306a36Sopenharmony_ci	                    0              0              0.000ms
10462306a36Sopenharmony_ci    WPCOPY          count    delay total  delay average
10562306a36Sopenharmony_ci                       0              0              0ms
10662306a36Sopenharmony_ci
10762306a36Sopenharmony_ci获取pid为1的IO计数,它只和-p一起使用::
10862306a36Sopenharmony_ci	# ./getdelays -i -p 1
10962306a36Sopenharmony_ci	printing IO accounting
11062306a36Sopenharmony_ci	linuxrc: read=65536, write=0, cancelled_write=0
11162306a36Sopenharmony_ci
11262306a36Sopenharmony_ci上面的命令与-v一起使用,可以获取更多调试信息。
113