cachepc-linux

Fork of AMDESE/linux with modifications for CachePC side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-linux
Log | Files | Refs | README | LICENSE | sfeed.txt

delay-accounting.rst (4048B)


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