From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-15.7 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 3314DC433EF for ; Wed, 15 Sep 2021 13:20:58 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 1922E61263 for ; Wed, 15 Sep 2021 13:20:58 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S237544AbhIONWQ (ORCPT ); Wed, 15 Sep 2021 09:22:16 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43864 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S234801AbhIONWP (ORCPT ); Wed, 15 Sep 2021 09:22:15 -0400 Received: from mail-pf1-x434.google.com (mail-pf1-x434.google.com [IPv6:2607:f8b0:4864:20::434]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 07448C061574; Wed, 15 Sep 2021 06:20:57 -0700 (PDT) Received: by mail-pf1-x434.google.com with SMTP id q22so2760956pfu.0; Wed, 15 Sep 2021 06:20:57 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=6TlVjbFwM5s9cIrpaYR8atHU4al4NYLpsVPRqKrSjDs=; b=FljGuWBUtihlbUrqgBFHLVYygXQXJUHTjKLeGK7kZC0PEtFeP2OofVYtTragXBLGGg p+d4P85MvccsjGcHAL2LVAi/v8jWzZiVeMrg+aGVWxBScgAIpX1V/spZJCj32qU765Z0 xdtYwhrduDHmXFCr/A3bKEqJnkN4hHWWkHWZn0kUdmBERbRXTaOb5qJirLjttt+Hwmmg JyhurMgRX5A7Qm+ubL3UApa8ww+KgkT180QRh+ipyFLpeFQwBQUxfBNL5zxY53WGVwXG 5+h5VOoqZA2hwPP23TS76HLovG/BmiJgFXrBo25VB2ypupaEsW+14qRyauLSbIHZv+a9 kf6g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=6TlVjbFwM5s9cIrpaYR8atHU4al4NYLpsVPRqKrSjDs=; b=Khw5iKXQI06g1mREM0YQ0RGzz9m0LYmMrAP6TlT8bada+04qqELhm+94LMha4ANHdx hTdqtkmluoIUYuL3dNCtPqowojxC/Y7+sQs11lvDELo/z2XTaHONla9MBTQA9wMYKi5T 8fyySGDahr1H29Md4HaFJGbRAKr7zLp6ctBkj0R0x8Kw+jlMtf44e8Q8OiXHJ+NOKYrn NDiGZw7ppQ5LCoJHbVBtIrakgfXw6Dg4NVmGbn57O8esrGddlewIZ3mA5WbxIyYF+Le4 I7dCfIHL3ncjrlcs0dnV5+SpCh3jSGgI01LOtRgRwv2ak1wikF6frKjW4WFKTXgitxuI BIVg== X-Gm-Message-State: AOAM531Zn8YdYZVRfVEP0hVFlccC9Ksf2arZIMGRJS0FaUcHHtaVu7US MS2aQrSC6YD3nxzfzPPYmLQZ0F27iLk= X-Google-Smtp-Source: ABdhPJwcx3z36UfZRhxXH5OP9FS4+Q9VDye6BgDJQylLF3ytD+rENcPQ5CgX/7wG71/CAPkIt+WiQg== X-Received: by 2002:a63:ec45:: with SMTP id r5mr20669794pgj.440.1631712056441; Wed, 15 Sep 2021 06:20:56 -0700 (PDT) Received: from localhost.localdomain ([193.203.214.57]) by smtp.gmail.com with ESMTPSA id y13sm11026pfb.115.2021.09.15.06.20.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 15 Sep 2021 06:20:55 -0700 (PDT) From: cgel.zte@gmail.com X-Google-Original-From: yang.yang29@zte.com.cn To: alexs@kernel.org, siyanteng@loongson.cn Cc: corbet@lwn.net, yang.yang29@zte.com.cn, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH] docs/zh_CN: Add zh_CN/accounting/delay-accounting.rst Date: Wed, 15 Sep 2021 13:20:38 +0000 Message-Id: <20210915132037.169162-1-yang.yang29@zte.com.cn> X-Mailer: git-send-email 2.25.1 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org From: Yang Yang 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 --- .../zh_CN/accounting/delay-accounting.rst | 114 ++++++++++++++++++ .../translations/zh_CN/accounting/index.rst | 2 +- 2 files changed, 115 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/zh_CN/accounting/delay-accounting.rst diff --git a/Documentation/translations/zh_CN/accounting/delay-accounting.rst b/Documentation/translations/zh_CN/accounting/delay-accounting.rst new file mode 100644 index 000000000000..1df7d2354e07 --- /dev/null +++ b/Documentation/translations/zh_CN/accounting/delay-accounting.rst @@ -0,0 +1,114 @@ +.. include:: ../disclaimer-zh_CN.rst + +:Original: Documentation/accounting/delay-accounting.rst +:Translator: Yang Yang + +.. _cn_delay-accounting.rst: + + +======== +延迟计数 +======== + +任务在等待某些内核资源可用时，会造成延迟。例如一个可运行的任务可能会等待 +一个空闲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 + diff --git a/Documentation/translations/zh_CN/accounting/index.rst b/Documentation/translations/zh_CN/accounting/index.rst index 362e907b41f9..090f93776faa 100644 --- a/Documentation/translations/zh_CN/accounting/index.rst +++ b/Documentation/translations/zh_CN/accounting/index.rst @@ -16,10 +16,10 @@ :maxdepth: 1 psi + delay-accounting Todolist: cgroupstats - delay-accounting taskstats taskstats-struct -- 2.25.1