CPULimitPause
CPULimitPause specifies the percentage of CPU time, in 1/1000ths of a percent, that all isolated processes on the Web server can occupy during a given process accounting interval (specified by CPUResetInterval). If the processes attempt to occupy more CPU time than specified in CpuLimitPause, IIS pauses the entire site, and any new client requests receives a custom error indicating that the server is out of resources. The site remains in a paused state until the current reset interval has ended. Any limit overrun is recorded in the Windows Event Log, and, if process accounting is enabled, in the IIS log as well.
If CpuLimitPause is set to 0, or a value greater than 100,000 (100 percent), IIS does not pause the site. However, one of the other process throttling properties, such as CPULimitLogEvent, CPULimitPriority, or CPULimitProcStop, could generate a response from IIS if a CPU limit is exceeded.
Note Because process accounting in IIS uses Windows Job Objects to monitor CPU times for an entire process, process accounting logs and throttles only those applications that are isolated in a separate process from IIS.
Process throttling and process accounting are independently controlled by several other metabase properties.
To properly activate process throttling, CPULimitsEnabled must be set to true, and at least one of the following properties must be set to true:CPULimitLogEvent, CPULimitPriority, CPULimitProcStop, or CpuLimitPause.
Important Applications that do not have process throttling enabled do not contribute to the total CPU time for the purposes of calculating CPU limit overruns.
Attribute Name | Attribute Value |
---|---|
XML Data Type | DWORD |
WMI Data Type |
SINT32
|
ADSI Data Type | DWORD |
ABO Data Type | DWORD |
ABO Metabase identifier |
MD_CPU_LIMIT_PAUSE
|
Attributes | INHERIT |
Default Value | 0 |
MetaFlagsEx | CACHE_PROPERTY_MODIFIED |
User Type | IIS_MD_UT_SERVER |
StartingNumber | Not applicable |
EndingNumber | 0 |
ID | 2152 |
Configurable Locations
You can configure this property at the following locations in the IIS metabase.
Code Example
For general code examples, please see Code Examples to Configure Metabase Properties