docs/scheduler: Introduce the doc of load average
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
@@ -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