cpu Element for applicationPoolDefaults for applicationPools [IIS Settings Schema]
Note
For more information about the cpu element, see the following topic on the Microsoft IIS.net Web site: CPU Settings for an Application Pool <cpu>.
Configures default values for CPU usage parameters and CPU actions that will be used by all application pools on a server.
Syntax
Attributes and Elements
The following sections describe attributes, child elements, and parent elements for this section.
Attributes
Attribute |
Description |
||||||
|---|---|---|---|---|---|---|---|
action |
Optional enum attribute. Configures the action(s) that IIS takes when an worker process exceeds its configured CPU limit. The action attribute is configured on a per-application pool basis. The action attribute can be one of the following possible values. The default value is NoAction.
|
||||||
limit |
Optional uint attribute. Configures the maximum percentage of CPU time (in 1/1000ths of one percent) that the worker processes in an application pool are allowed to consume over a period of time as indicated by the resetInterval attribute. If the limit set by the limit attribute is exceeded, an event is written to the event log and an optional set of events can be triggered. These optional events are determined by the action attribute. The default value is 0, which disables CPU limiting. |
||||||
resetInterval |
Optional timeSpan attribute. Specifies the reset period (in minutes) for CPU monitoring and throttling limits on an application pool. When the number of minutes elapsed since the last process accounting reset equals the number specified by this property, IIS resets the CPU timers for both the logging and limit intervals. Important The value in resetInterval must be greater than the time between logging operations, otherwise IIS will reset counters before logging has occurred, and process accounting will not occur. Note Because process accounting in IIS uses Windows job objects to monitor CPU times for the whole process, process accounting will only log and throttle applications that are isolated in a separate process from IIS. The default value is 0, which disables CPU monitoring. |
||||||
smpAffinitized |
Optional Boolean attribute. Specifies whether a particular worker process assigned to an application pool should also be assigned to a given CPU. This property is used together with the smpProcessorAffinityMask attribute. The default value is false. |
||||||
smpProcessorAffinityMask |
Configures the hexadecimal processor mask for multi-processor computers, which indicates to which CPU the worker processes in an application pool should be bound. Before this property takes effect, the smpAffinitized attribute must be set to true for the application pool. Note Do not set this property to 0. Doing so disables symmetric multiprocessing (SMP) affinity and creates an error condition. This means that processes running on one CPU will not remain affiliated with that CPU throughout their lifetime. The default value is 4294967295. If you set the value to 1 (which corresponds to 00000000000000001 in binary), the worker processes in an application pool run on only the first processor. If you set the value to 2 (which corresponds to 0000000000000010 in binary), the worker processes run on only the second processor. If you set the value to 3 (which corresponds to 0000000000000011 in binary) the worker processes run on both the first and second processors. |
Child Elements
None.
Parent Elements
Element |
Description |
|---|---|
configuration |
Specifies the root element in every configuration file that is used by IIS 7. |
system.applicationHost |
Specifies the root element for configuring Web process settings. |
applicationPools |
Specifies application pool definitions on a server. |
applicationPool |
Specifies the configuration settings for an application pool. |
Remarks
For more information about the cpu element, see the following topic on the Microsoft IIS.net Web site: CPU Settings for an Application Pool <cpu>.
Default Configuration
None.
Element Information
Configuration locations |
ApplicationHost.config |
Requirements |
Microsoft Internet Information Services (IIS) version 7.0 |