<html>
 <body>
  <div style="font-family: Verdana, Arial, Helvetica, Sans-Serif;">
   <table bgcolor="#f9f3c9" width="100%" cellpadding="8" style="border: 1px #c9c399 solid;">
    <tr>
     <td>
      This is an automatically generated e-mail. To reply, visit:
      <a href="https://reviewboard.asterisk.org/r/2629/">https://reviewboard.asterisk.org/r/2629/</a>
     </td>
    </tr>
   </table>
   <br />



<table bgcolor="#e0e0e0" width="100%" cellpadding="8" style="border: 1px gray solid;">
 <tr>
  <td>
   <h1 style="margin-right: 0.2em; padding: 0; font-size: 10pt;">This change has been marked as submitted.</h1>
  </td>
 </tr>
</table>
<br />


<table bgcolor="#fefadf" width="100%" cellspacing="0" cellpadding="8" style="background-image: url('https://reviewboard.asterisk.org/static/rb/images/review_request_box_top_bg.png'); background-position: left top; background-repeat: repeat-x; border: 1px black solid;">
 <tr>
  <td>

<div>Review request for Asterisk Developers.</div>
<div>By Mark Michelson.</div>


<p style="color: grey;"><i>Updated June 20, 2013, 11:29 a.m.</i></p>



<h1 style="color: #575012; font-size: 10pt; margin-top: 1.5em;">Changes</h1>
<table width="100%" bgcolor="#ffffff" cellspacing="0" cellpadding="10" style="border: 1px solid #b8b5a0">
 <tr>
  <td>
   <pre style="margin: 0; padding: 0; white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word;">Committed in revision 392318</pre>
  </td>
 </tr>
</table>







<div style="margin-top: 1.5em;">
 <b style="color: #575012; font-size: 10pt;">Repository: </b>
Asterisk
</div>


<h1 style="color: #575012; font-size: 10pt; margin-top: 1.5em;">Description </h1>
 <table width="100%" bgcolor="#ffffff" cellspacing="0" cellpadding="10" style="border: 1px solid #b8b5a0">
 <tr>
  <td>
   <pre style="margin: 0; padding: 0; white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word;">Joshua Colp noticed while doing some performance testing of chan_pjsip that sometimes the thread count in the threadpool would suddenly spike (e.g. going from 26 threads to 2600 threads) when processing a high number of calls per second. The reason for this is due to the threadpool&#39;s control queue, coupled with the fact that new threads in the threadpool start in the &#39;active&#39; state.

Consider a scenario where a threadpool&#39;s threads are all active, and 25 tasks all get queued into the threadpool in succession. When the first task gets evaluated, the threadpool sees that there are no idle threads, so it grows by its configured autoincrement value (we&#39;ll say 5 for this case). All 5 new threads start active. Now the next queued task is evaluated. The threadpool sees there are still no idle threads (since the 5 new threads are all active), so the threadpool again increments the number of threads by 5. This repeats until all 25 tasks have been evaluated. In this scenario, the threadpool&#39;s size has increased by 125 threads (5 * 25) very quickly. Obviously, the vast majority of these new threads will go idle immediately, so why doesn&#39;t this affect the count of idle threads when evaluating the incoming tasks? It&#39;s because when a thread becomes idle, the task to make the thread idle gets queued behind the other tasks already waiting. So once the 25 threadpool tasks are evaluated, it&#39;s likely that there will be ~100 &quot;thread has become idle&quot; tasks immediately following.

This patch aims to fix the above scenario. The modifications are as follows:

* New worker threads start idle instead of active.
* If there are no idle threads when a new task arrives, and the threadpool auto-increments the thread count, then the threadpool will activate a single idle thread.
* If the threadpool&#39;s thread count is increased manually (via ast_threadpool_set_size), then all idle threads will be activated once the new threads are added. The justification for this is that the most likely scenario when ast_threadpool_set_size() is called is when a threadpool listener has determined that the number of tasks has greatly outnumbered the number of threads to handle them. Thus the listener wishes to increase the threadpool size and have all the new threads immediately get to work to clear out the backlog of tasks.

With the first two modifications, let&#39;s re-examine the earlier problem scenario.

All threadpool threads are active, and 25 tasks all get queued into the threadpool in succession. When the first task gets evaluated, the threadpool sees that there are no idle threads, so it grows by 5 threads. The 5 threads start idle, but one is activated in order to address the task being added. Now the next queued task is evaluated. There are 4 idle threads, so the threadpool simply activates one and continues. This process will continue until all tasks in the queue have been evaluated. This time, the threadpool only grew by 25 threads, which is just enough to get the tasks completed.

This fix is not a perfect solution since some of the active threads possibly became idle during the time that the threadpool was evaluating the 25 queued tasks. Therefore it could be possible not to have to increase the threadpool size by as many threads. However, the fix for that would likely require API changes to taskprocessors. The effort to benefit ratio is not clear at this point since it is not as easy to predict how many threads might go idle during a long chain of queued tasks. If further testing shows that the thread increase in such a scenario is still too large, then we can look into further efforts to minimize threadpool growth.</pre>
  </td>
 </tr>
</table>


<h1 style="color: #575012; font-size: 10pt; margin-top: 1.5em;">Testing </h1>
<table width="100%" bgcolor="#ffffff" cellspacing="0" cellpadding="10" style="border: 1px solid #b8b5a0">
 <tr>
  <td>
   <pre style="margin: 0; padding: 0; white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word;">The threadpool unit tests still pass.</pre>
  </td>
 </tr>
</table>


<h1 style="color: #575012; font-size: 10pt; margin-top: 1.5em;">Diffs</b> </h1>
<ul style="margin-left: 3em; padding-left: 0;">

 <li>/trunk/main/threadpool.c <span style="color: grey">(391698)</span></li>

</ul>

<p><a href="https://reviewboard.asterisk.org/r/2629/diff/" style="margin-left: 3em;">View Diff</a></p>







  </td>
 </tr>
</table>




  </div>
 </body>
</html>