Skip to contentSkip to conversation

docs/scheduler: Introduce the docs of load average

PATCH New Jui-Tse Huang 1 participant 1 message Apr 7, 2022 Documentation

lore
Share & tools
lore
#0 lore raw

PATCH v5 1/1 docs/scheduler: Introduce the docs of load average

The load average is one of a common as well as easy observed statistic provied by Linux, but still not well documented, which makes the numbers that users observes from the output of top, htop or other system monitoring application are only numbers. This patch gives a discussion on how Linux calculates the load average as well as what metrics are concerned while calculating the load average.

Topics covered in this documentation:
1. The physical meaning of load average
2. How to peek at load average as well as what values could be fetched from /proc/loadavg interface.
3. Run through the implementation of the updating process of load average.

---

Notes:
Notes:
v5:
- Reorgnize the content (Peter Zijlstra)

v4:
- Fix typo and grammar error (Randy Dunlap)

v3:
- Fix typo (Randy Dunlap)
- Add further reading that links to Brendan Gregg's blog

v2:
- Fix typo (Chun-Hung Tseng)

 Documentation/scheduler/index.rst        |   1 +
 Documentation/scheduler/load-average.rst | 115 +++++++++++++++++++++++
 2 files changed, 116 insertions(+)
 create mode 100644 Documentation/scheduler/load-average.rst
Documentation/scheduler/index.rst +1 -0
index 88900aabdbf7..bdc779b4190f 100644
@@ -17,6 +17,7 @@ Linux Scheduler
     sched-nice-design
     sched-rt-group
     sched-stats
+    load-average
 
     text_files
 
Documentation/scheduler/load-average.rst new file +115 -0

115 lines not on this page · raw message

Signature · 1 line
2.25.1