Skip to content

Commit 97e70c2

Browse files
Fix docs for transport_worker hot threads (elastic#96346)
Backports the docs changes from elastic#96315, reflecting the change introduced in elastic#90482, but adjusting them slightly to reflect the different behaviour in earlier versions. Co-authored-by: Elastic Machine <[email protected]>
1 parent 8b86071 commit 97e70c2

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

docs/reference/modules/network/threading.asciidoc

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ reported like this:
6363

6464
[source,text]
6565
----
66-
100.0% [cpu=0.0%, other=100.0%] (500ms out of 500ms) cpu usage by thread 'elasticsearch[instance-0000000004][transport_worker][T#1]'
66+
0.0% [cpu=0.0%, idle=100.0%] (500ms out of 500ms) cpu usage by thread 'elasticsearch[instance-0000000004][transport_worker][T#1]'
6767
10/10 snapshots sharing following 9 elements
6868
[email protected]/sun.nio.ch.EPoll.wait(Native Method)
6969
[email protected]/sun.nio.ch.EPollSelectorImpl.doSelect(EPollSelectorImpl.java:118)
@@ -78,10 +78,10 @@ reported like this:
7878

7979
Note that `transport_worker` threads should always be in state `RUNNABLE`, even
8080
when waiting for input, because they block in the native `EPoll#wait` method.
81-
This means the hot threads API will report these threads at 100% overall
82-
utilisation. This is normal, and the breakdown of time into `cpu=` and `other=`
83-
fractions shows how much time the thread spent running and waiting for input
84-
respectively.
81+
The `idle=` time reports the proportion of time the thread spent waiting for
82+
input, whereas the `cpu=` time reports the proportion of time the thread spent
83+
processing input it has received. If the thread was seen using absolutely no
84+
CPU then it will report `0.0% [cpu=0.0%, idle=0.0%]`.
8585

8686
If a `transport_worker` thread is not frequently idle, it may build up a
8787
backlog of work. This can cause delays in processing messages on the channels

0 commit comments

Comments
 (0)