CPU Overload Protection

Communications Server enables you to regulate incoming HTTP and SIP requests based on the CPU load.

To enable CPU overload protection, set the cpu-overload-protection attribute to true. By default, this value this set to false. Use the following command to set this attribute:

asadmin set config.overload-protection-service.cpu-overload-protection=true

To view the Overload Protection settings, use the following command:

asadmin get config.overload-protection-service.*

config1.overload-protection-service.cpu-http-threshold = 70
config1.overload-protection-service.cpu-ir-threshold = 70
config1.overload-protection-service.cpu-mm-threshold = 99
config1.overload-protection-service.cpu-overload-activation-algorithm = MEDIAN
config1.overload-protection-service.cpu-overload-deactivation-algorithm = CONSECUTIVE
config1.overload-protection-service.cpu-overload-protection = true
config1.overload-protection-service.cpu-sr-threshold = 90
config1.overload-protection-service.number-of-samples = 5
config1.overload-protection-service.retry-after-interval = 10
config1.overload-protection-service.sample-rate = 2

The CPU Overload Protection attributes provide the following uses:

• cpu-http-threshold - All incoming HTTP requests are rejected and 503 responses are sent out, when this threshold is exceeded.

• cpu-ir-threshold - Initial incoming SIP requests are rejected and 503 responses are sent out when this threshold is exceeded.

• cpu-sr-threshold - All incoming subsequent SIP requests are rejected and 503 responses are sent out, when this threshold is exceeded.

• cpu-mm-threshold - All incoming HTTP and SIP requests are rejected when this threshold is exceeded.

• cpu-overload-protection - Specifies if CPU overload protection is enabled.

• cpu-overload-activation-algorithm - Specifies the algorithm used for detecting a CPU overload situation. Valid values are CONSECUTIVE and MEDIAN.

• cpu-overload-deactivation-algorithm - Specifies the algorithm used for detecting the end a CPU overload situation. Valid values are CONSECUTIVE and MEDIAN.

• mm-threshold-http-wait-time - Denotes the interval for which the thread is held before being released back to the pool. This attribute is used in the context of maximum overload for HTTP requests. Under overload, the threads are not immediately available to process requests, thereby contributing to the reduction of congestion in the system. Default is 2 seconds.

• sample-rate - Interval or periodicity of the measurement of CPU usage.

• number-of-samples -Number of samples that the CPU usage has to be above the threshold level to trigger an action of either dropping the request or sending 503 responses.

• retry-after-interval -Interval or periodicity after which the CPU usage is measured. This is the value that is set in the retry-after header in the 503 response.

To view and set these values, you can use the Configuration —> Overload Protection node in the Admin Console or the asadmin get and set commands.

For example, you can use the following command to set the value of the cpu-mm-threshold property:

asadmin set config.overload-protection-service.cpu-mm-threshold =80