Skip to contentSkip to conversation

docs/scheduler: Introduce the doc of load average

PATCH Superseded Jui-Tse Huang 1 participant 1 message Mar 16, 2022 Documentation

v4 of 5 Superseded Latest is v5 →

lore
Share & tools
lore
#0 lore raw

PATCH v4 1/1 docs/scheduler: Introduce the doc 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.

The discussion flow is divided into several parts:
1. The expression used to get the load average.
2. Why Linux choose such average method from the other.
2. The meaning of each term in the expression.
3. The metrics, that is, the type of tasks that will be covered in the calculation.
4. A brief explanation over the fixed-point nubmer since the weights defined in the Linux kernel are based on it.

---

Notes:
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 | 82 ++++++++++++++++++++++++
 2 files changed, 83 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 +82 -0

82 lines not on this page · raw message

Signature · 1 line
2.25.1