mirror of
https://github.com/torvalds/linux.git
synced 2024-11-25 21:51:40 +00:00
docs/zh_CN: Add zh_CN/accounting/delay-accounting.rst
Add translation zh_CN/accounting/delay-accounting.rst and links it to zh_CN/accounting/index.rst while clean its todo entry. Signed-off-by: Yang Yang <yang.yang29@zte.com.cn> Reviewed-by: Alex Shi <alexs@kernel.org> Reviewed-by: Yanteng Si <siyanteng@loongson.cn> Link: https://lore.kernel.org/r/20211217110949.453361-1-yang.yang29@zte.com.cn Signed-off-by: Jonathan Corbet <corbet@lwn.net>
This commit is contained in:
parent
32211146e1
commit
422d98c187
111
Documentation/translations/zh_CN/accounting/delay-accounting.rst
Normal file
111
Documentation/translations/zh_CN/accounting/delay-accounting.rst
Normal file
@ -0,0 +1,111 @@
|
|||||||
|
.. include:: ../disclaimer-zh_CN.rst
|
||||||
|
|
||||||
|
:Original: Documentation/accounting/delay-accounting.rst
|
||||||
|
|
||||||
|
:Translator: Yang Yang <yang.yang29@zte.com.cn>
|
||||||
|
|
||||||
|
========
|
||||||
|
延时计数
|
||||||
|
========
|
||||||
|
|
||||||
|
任务在等待某些内核资源可用时,会造成延时。例如一个可运行的任务可能会等待
|
||||||
|
一个空闲CPU来运行。
|
||||||
|
|
||||||
|
基于每任务的延时计数功能度量由以下情况造成的任务延时:
|
||||||
|
|
||||||
|
a) 等待一个CPU(任务为可运行)
|
||||||
|
b) 完成由该任务发起的块I/O同步请求
|
||||||
|
c) 页面交换
|
||||||
|
d) 内存回收
|
||||||
|
|
||||||
|
并将这些统计信息通过taskstats接口提供给用户空间。
|
||||||
|
|
||||||
|
这些延时信息为适当的调整任务CPU优先级、io优先级、rss限制提供反馈。重要任务
|
||||||
|
长期延时,表示可能需要提高其相关优先级。
|
||||||
|
|
||||||
|
通过使用taskstats接口,本功能还可提供一个线程组(对应传统Unix进程)所有任务
|
||||||
|
(或线程)的总延时统计信息。此类汇总往往是需要的,由内核来完成更加高效。
|
||||||
|
|
||||||
|
用户空间的实体,特别是资源管理程序,可将延时统计信息汇总到任意组中。为实现
|
||||||
|
这一点,任务的延时统计信息在其生命周期内和退出时皆可获取,从而确保可进行
|
||||||
|
连续、完整的监控。
|
||||||
|
|
||||||
|
接口
|
||||||
|
----
|
||||||
|
|
||||||
|
延时计数使用taskstats接口,该接口由本目录另一个单独的文档详细描述。Taskstats
|
||||||
|
向用户态返回一个通用数据结构,对应每pid或每tgid的统计信息。延时计数功能填写
|
||||||
|
该数据结构的特定字段。见
|
||||||
|
|
||||||
|
include/linux/taskstats.h
|
||||||
|
|
||||||
|
其描述了延时计数相关字段。系统通常以计数器形式返回 CPU、同步块 I/O、交换、内存
|
||||||
|
回收等的累积延时。
|
||||||
|
|
||||||
|
取任务某计数器两个连续读数的差值,将得到任务在该时间间隔内等待对应资源的总延时。
|
||||||
|
|
||||||
|
当任务退出时,内核会将包含每任务的统计信息发送给用户空间,而无需额外的命令。
|
||||||
|
若其为线程组最后一个退出的任务,内核还会发送每tgid的统计信息。更多详细信息见
|
||||||
|
taskstats接口的描述。
|
||||||
|
|
||||||
|
tools/accounting目录中的用户空间程序getdelays.c提供了一些简单的命令,用以显示
|
||||||
|
延时统计信息。其也是使用taskstats接口的示例。
|
||||||
|
|
||||||
|
用法
|
||||||
|
----
|
||||||
|
|
||||||
|
使用以下配置编译内核::
|
||||||
|
|
||||||
|
CONFIG_TASK_DELAY_ACCT=y
|
||||||
|
CONFIG_TASKSTATS=y
|
||||||
|
|
||||||
|
延时计数在启动时默认关闭。
|
||||||
|
若需开启,在启动参数中增加::
|
||||||
|
|
||||||
|
delayacct
|
||||||
|
|
||||||
|
本文后续的说明基于延时计数已开启。也可在系统运行时,使用sysctl的
|
||||||
|
kernel.task_delayacct进行开关。注意,只有在启用延时计数后启动的
|
||||||
|
任务才会有相关信息。
|
||||||
|
|
||||||
|
系统启动后,使用类似getdelays.c的工具获取任务或线程组(tgid)的延时信息。
|
||||||
|
|
||||||
|
getdelays命令的一般格式::
|
||||||
|
|
||||||
|
getdelays [-t tgid] [-p pid] [-c cmd...]
|
||||||
|
|
||||||
|
获取pid为10的任务从系统启动后的延时信息::
|
||||||
|
|
||||||
|
# ./getdelays -p 10
|
||||||
|
(输出信息和下例相似)
|
||||||
|
|
||||||
|
获取所有tgid为5的任务从系统启动后的总延时信息::
|
||||||
|
|
||||||
|
# ./getdelays -t 5
|
||||||
|
|
||||||
|
|
||||||
|
CPU count real total virtual total delay total
|
||||||
|
7876 92005750 100000000 24001500
|
||||||
|
IO count delay total
|
||||||
|
0 0
|
||||||
|
SWAP count delay total
|
||||||
|
0 0
|
||||||
|
RECLAIM count delay total
|
||||||
|
0 0
|
||||||
|
|
||||||
|
获取指定简单命令运行时的延时信息::
|
||||||
|
|
||||||
|
# ./getdelays -c ls /
|
||||||
|
|
||||||
|
bin data1 data3 data5 dev home media opt root srv sys usr
|
||||||
|
boot data2 data4 data6 etc lib mnt proc sbin subdomain tmp var
|
||||||
|
|
||||||
|
|
||||||
|
CPU count real total virtual total delay total
|
||||||
|
6 4000250 4000000 0
|
||||||
|
IO count delay total
|
||||||
|
0 0
|
||||||
|
SWAP count delay total
|
||||||
|
0 0
|
||||||
|
RECLAIM count delay total
|
||||||
|
0 0
|
@ -15,11 +15,11 @@
|
|||||||
.. toctree::
|
.. toctree::
|
||||||
:maxdepth: 1
|
:maxdepth: 1
|
||||||
|
|
||||||
|
delay-accounting
|
||||||
psi
|
psi
|
||||||
taskstats
|
taskstats
|
||||||
|
|
||||||
Todolist:
|
Todolist:
|
||||||
|
|
||||||
cgroupstats
|
cgroupstats
|
||||||
delay-accounting
|
|
||||||
taskstats-struct
|
taskstats-struct
|
||||||
|
Loading…
Reference in New Issue
Block a user