delay-accounting.rst

  1.. include:: ../disclaimer-zh_CN.rst
  2
  3:Original: Documentation/accounting/delay-accounting.rst
  4
  5:Translator: Yang Yang <yang.yang29@zte.com.cn>
  6
  7========
  8延时计数
  9========
 10
 11任务在等待某些内核资源可用时，会造成延时。例如一个可运行的任务可能会等待
 12一个空闲CPU来运行。
 13
 14基于每任务的延时计数功能度量由以下情况造成的任务延时：
 15
 16a) 等待一个CPU（任务为可运行）
 17b) 完成由该任务发起的块I/O同步请求
 18c) 页面交换
 19d) 内存回收
 20e) 抖动
 21f) 直接规整
 22g) 写保护复制
 23
 24并将这些统计信息通过taskstats接口提供给用户空间。
 25
 26这些延时信息为适当的调整任务CPU优先级、io优先级、rss限制提供反馈。重要任务
 27长期延时，表示可能需要提高其相关优先级。
 28
 29通过使用taskstats接口，本功能还可提供一个线程组（对应传统Unix进程）所有任务
 30（或线程）的总延时统计信息。此类汇总往往是需要的，由内核来完成更加高效。
 31
 32用户空间的实体，特别是资源管理程序，可将延时统计信息汇总到任意组中。为实现
 33这一点，任务的延时统计信息在其生命周期内和退出时皆可获取，从而确保可进行
 34连续、完整的监控。
 35
 36接口
 37----
 38
 39延时计数使用taskstats接口，该接口由本目录另一个单独的文档详细描述。Taskstats
 40向用户态返回一个通用数据结构，对应每pid或每tgid的统计信息。延时计数功能填写
 41该数据结构的特定字段。见
 42
 43     include/uapi/linux/taskstats.h
 44
 45其描述了延时计数相关字段。系统通常以计数器形式返回 CPU、同步块 I/O、交换、内存
 46回收、页缓存抖动、直接规整、写保护复制等的累积延时。
 47
 48取任务某计数器两个连续读数的差值，将得到任务在该时间间隔内等待对应资源的总延时。
 49
 50当任务退出时，内核会将包含每任务的统计信息发送给用户空间，而无需额外的命令。
 51若其为线程组最后一个退出的任务，内核还会发送每tgid的统计信息。更多详细信息见
 52taskstats接口的描述。
 53
 54tools/accounting目录中的用户空间程序getdelays.c提供了一些简单的命令，用以显示
 55延时统计信息。其也是使用taskstats接口的示例。
 56
 57用法
 58----
 59
 60使用以下配置编译内核::
 61
 62	CONFIG_TASK_DELAY_ACCT=y
 63	CONFIG_TASKSTATS=y
 64
 65延时计数在启动时默认关闭。
 66若需开启，在启动参数中增加::
 67
 68   delayacct
 69
 70本文后续的说明基于延时计数已开启。也可在系统运行时，使用sysctl的
 71kernel.task_delayacct进行开关。注意，只有在启用延时计数后启动的
 72任务才会有相关信息。
 73
 74系统启动后，使用类似getdelays.c的工具获取任务或线程组（tgid）的延时信息。
 75
 76getdelays命令的一般格式::
 77
 78	getdelays [-dilv] [-t tgid] [-p pid]
 79
 80获取pid为10的任务从系统启动后的延时信息::
 81
 82	# ./getdelays -d -p 10
 83	（输出信息和下例相似）
 84
 85获取所有tgid为5的任务从系统启动后的总延时信息::
 86
 87	# ./getdelays -d -t 5
 88	print delayacct stats ON
 89	TGID	5
 90
 91
 92	CPU             count     real total  virtual total    delay total  delay average
 93	                    8        7000000        6872122        3382277          0.423ms
 94	IO              count    delay total  delay average
 95	                    0              0              0.000ms
 96	SWAP            count    delay total  delay average
 97	                    0              0              0.000ms
 98	RECLAIM         count    delay total  delay average
 99	                    0              0              0.000ms
100	THRASHING       count    delay total  delay average
101	                    0              0              0.000ms
102	COMPACT         count    delay total  delay average
103	                    0              0              0.000ms
104    WPCOPY          count    delay total  delay average
105                       0              0              0ms
106
107获取pid为1的IO计数，它只和-p一起使用::
108	# ./getdelays -i -p 1
109	printing IO accounting
110	linuxrc: read=65536, write=0, cancelled_write=0
111
112上面的命令与-v一起使用，可以获取更多调试信息。