It has been a year and a half since we rolled out the throttling-aware container CPU sizing feature for IBM Turbonomic, and it has captured quite some attention, for good reason. As illustrated in our first blog post, setting the wrong CPU limit is silently killing your application performance and literally working as designed.
Turbonomic visualizes throttling metrics and, more importantly, takes throttling into consideration when recommending CPU limit sizing. Not only can we expose this silent performance killer, Turbonomic will prescribe the CPU limit value to minimize its impact on your containerized application performance.
In this new post, we are going to talk about a significant improvement in the way that we measure the level of throttling. Prior to this improvement, our throttling indicator was calculated based on the percentage of throttled periods. With such a measurement, throttling was underestimated for applications with a low CPU limit and overestimated for those with a high CPU limit. That resulted in sizing up high-limit applications too aggressively as we tuned our decision-making toward low-limit applications to minimize throttling and guarantee their performance.
In this recent improvement, we measure throttling based on the percentage of time throttled. In this post, we will show you how this new measurement works and why it will correct both the underestimation and the overestimation mentioned above:
- Brief revisit of CPU throttling
- The old/biased way: Period-based throttling measurement
- The new/unbiased Way: Time-based throttling measurement
- Benchmarking results
- Release
Brief revisit of CPU throttling
If you watch this demo video, you can see a similar illustration of throttling. There it is a single-threaded container app with a CPU limit of 0.4 core (or 400m). The 400m limit in Linux is translated to a cgroup CPU quota of 40ms per 100ms, which is the default quota enforcement period in Linux that Kubernetes adopts. That means that the app can only use 40ms of CPU time in each 100ms period before it is throttled for 60ms. This repeats four times for a 200ms task (like the one shown below) and finally gets completed in the fifth period without being throttled. Overall, the 200ms task takes 100 * 4 + 40 = 440ms to complete, more than twice the actual needed CPU time:
Linux provides the following metrics related to throttling, which cAdvisor monitors and feeds to Kubernetes:
| Linux Metric | cAdvisor Metric | Value (in the above example) | Explanation |
| nr_periods | container_cpu_cfs_throttled_periods_total | 5 | This is the number of runnable periods. In the example, there are five. |
| nr_throttled | container_cpu_cfs_throttled_periods_total | 4 | It is throttled for only four out of the five runnable periods. In the fifth period, the request is completed, so it is no longer throttled. |
| throttled_time | container_cpu_cfs_throttled_seconds_total | 720ms | For the first four periods, it runs for 40ms and is throttled for 60ms. Therefore, the total throttled time is 60ms * 4 = 240ms. |
Scroll to view full table
The old/biased way: Period-based throttling measurement
As mentioned at the beginning, we used to measure the throttling level as the percentage of runnable periods that are throttled. In the above example, that would be 4 / 5 = 80%.
There is a significant bias with this measurement. Consider a second container application that has a CPU limit of 800m, as shown below. A task with 400ms processing time will run 80ms and then be throttled for 20ms in each of the first four enforcement periods of 100ms. It will then be completed in the fifth period. With the current way of measuring the throttling level, it will arrive at the same percentage: 80%. But clearly, this second app suffers far less than the first app. It is throttled for only 20ms * 4 = 80ms total—just a fraction of the 400ms CPU run time. The currently measured 80% throttling level is way too high to reflect the true situation of this app.
We needed a better way to measure throttling, and we created it:
The new/unbiased way: Time-based throttling measurement
With the new way, we measure the level of throttling as the percentage of time throttled versus the total time between using the CPU and being throttled. Here are the new measurements of the above two apps:
| Application | Throttled Time | Total Runnable Time | Percentage Time Throttled |
| First | 240ms | 200ms + 240ms = 440ms | 240ms / 440ms = 55% |
| Second | 80ms | 400ms + 80ms = 480ms | 80ms / 480ms = 17% |
Scroll to view full table
These two numbers—55% and 17%—make more sense than the original 80%. Not only they are two different numbers differentiating the two application scenarios, but their respective values also more appropriately reflect the true impact of throttling, as you could perhaps visualize from the two graphs. Intuitively, the new measurement can be interpreted as how much the overall task time can be improved/reduced by getting rid of throttling. For the first app, we can reduce the overall task time by 240ms (55% of the total). For the second app, it’s merely 17% if we get rid of throttling—not as significant as the first app.
Benchmarking results
Below, you’ll see some data to compare the throttling measurements computed using the throttling periods versus the timed-based version.
For a container with low CPU limits, the time-based measurement shows much higher throttling percentages compared to the older version that uses only throttling periods, as expected.
As the CPU limits go up, the time-based measurements again accurately reflect lower throttling percentages. Conversely, the older version shows a much higher throttling percentage, which can result in an aggressive resize-up in spite of the CPU limit being high enough.
| Number of Cores | CPU Limit | Throttled Periods | Total Periods | Old Average | Throttled Time (ms) | Total Usage (ms) | New Average | |
| throttling-auto/low-cpu-high-throttling-77b6b5f84c-p97v8/kube-rbac-proxy-main | 10 | 20 | 21 | 75 | 28 | 2,884.59 | 76.23 | 97.42537968 |
| throttling-auto/low-cpu-high-throttling-77b6b5f84c-p97v8/low-cpu-high-throttling-spec | 10 | 20 | 64 | 148 | 43.24324324 | 9,690.95 | 170.8 | 98.26808196 |
| monitoring/kube-state-metrics-6c6f446b4-hrq7v/kube-rbac-proxy-main | 12 | 20 | 339 | 567 | 59.78835979 | 43,943.63 | 827.91 | 98.15081538 |
| throttling-auto/low-cpu-high-throttling-77b6b5f84c-njptn/kube-state-metrics | 12 | 100 | 360 | 8154 | 4.415011038 | 17,296.02 | 21,838.65 | 44.19615579 |
| dummy-ns/beekman-change-reconciler-5dbdcdb49b-sg2f9/beekman-2 | 10 | 200 | 8202 | 8563 | 95.78418778 | 488,921.77 | 168,961.80 | 74.31737012 |
| dummy-ns/beekman-change-reconciler-5dbdcdb49b-5mktb/beekman-2 | 12 | 200 | 8576 | 8586 | 99.88353133 | 554,103.75 | 171,659.58 | 76.34771956 |
| quota-test/cpu-quota-1-7f84f77bc5-ztdbm/cpu-quota-1-spec | 12 | 500 | 3531 | 8566 | 41.2211067 | 59,267.71 | 357,274.10 | 14.22851472 |
| turbo/kubeturbo-arsen-170-203-599fbdcff6-vbl55/kubeturbo-arsen-170-203-spec | 10 | 1000 | 101 | 1739 | 5.807935595 | 6,300.33 | 32,319.39 | 16.31375702 |
| default/nri-bundle-newrelic-logging-v8fqb/newrelic-logging | 12 | 1300 | 1 | 8250 | 0.012121212 | 11.86 | 177,353.93 | 0.00668406 |
Scroll to view full table
Release
This new measurement of throttling has been available since IBM Turbonomic release 8.7.5. Furthermore, in release 8.8.2, we also allow users to customize the max throttling tolerance for each individual application or group of applications, as we fully recognize different applications have different needs in terms of tolerating throttling. For example, response-time-sensitive applications like web-services applications may have lower tolerance while batch applications like big machine learning jobs may have much higher tolerance. Now, users can configure the desired level as they want.
Learn more about IBM Turbonomic.
