This metabase property specifies which process accounting and throttling fields should be written to the IIS log file. All enabled fields will be written on every process accounting log. All values logged are for the reset interval in which the logging occurs.
Note Because process accounting in IIS uses Windows Job Objects to monitor CPU times for an entire process, process accounting will log and throttle only applications that are isolated in a separate process from IIS.
This property contains the following flags:
CpuEnableLogging | CpuEnableProcType |
CpuEnableActiveProcs | CpuEnableTerminatedProcs |
CpuEnableEvent | CpuEnableTotalProcs |
CpuEnableKernelTime | CpuEnableUserTime |
CpuEnablePageFaults |
You can also change the logging mask flags by directly manipulating the flags contained in CpuLoggingMask by using the hexadecimal values described in the following tables.
Process throttling and process accounting are independently controlled by several other metabase properties. In order to enable process accounting you must set CpuEnableLogging (which is a member of CpuLoggingMask) to TRUE, and set at least one other CpuLoggingMask property to TRUE. It is also necessary to set at least one member flag of the CpuLoggingOptions, set CpuLoggingInterval to a nonzero value, and set either CpuAppEnabled or CpuCgiEnabled, as appropriate, to TRUE.
To properly activate process throttling, CpuLimitsEnabled must be set to TRUE, and at least one of the following properties should be set to TRUE: CpuLimitLogEvent, CpuLimitPriority, CpuLimitProcStop, or CpuLimitPause.
Data type | Long |
Default value | All Member Flags = TRUE |
Inheritance | Inheritable |
This property is accessible at the following locations:
Metabase Path | Key Type |
/LM/W3SVC | IIsWebService |
/LM/W3SVC/N | IIsWebServer |
The following tables list additional information required only for code that uses the IIS Admin Base Object.
Metabase identifier | MD_CPU_LOGGING_MASK |
User type | IIS_MD_UT_SERVER |
Default bitmask setting
Note Multiple bits are set by default. |
MD_CPU_ENABLE_LOGGING
MD_CPU_ENABLE_EVENT MD_CPU_ENABLE_PROC_TYPE MD_CPU_ENABLE_USER_TIME MD_CPU_ENABLE_KERNEL_TIME MD_CPU_ENABLE_PAGE_FAULTS MD_CPU_ENABLE_TOTAL_PROCS MD_CPU_ENABLE_ACTIVE_PROCS MD_CPU_ENABLE_TERMINATED_PROCS |
Default bitmask value | 0x800000FF |
Constant | Value | Description |
MD_CPU_ENABLE_LOGGING | 0x80000000 | Specifies whether process accounting is enabled. |
MD_CPU_ENABLE_EVENT | 0x00000001 | Log site events, such as start, stop, and site process throttling. |
MD_CPU_ENABLE_PROC_TYPE | 0x00000002 | Log the process type. |
MD_CPU_ENABLE_USER_TIME | 0x00000004 | Log the total user CPU time, as a percentage of total CPU time, in 1/1000ths of a percent. |
MD_CPU_ENABLE_KERNEL_TIME | 0x00000008 | Log the total kernel CPU time, as a percentage of total CPU time, in 1/1000ths of a percent. |
MD_CPU_ENABLE_PAGE_FAULTS | 0x00000010 | Log the total number of page faults. |
MD_CPU_ENABLE_TOTAL_PROCS | 0x00000020 | Log the total number of processes. |
MD_CPU_ENABLE_ACTIVE_PROCS | 0x00000040 | Log the total number of active processes. |
MD_CPU_ENABLE_TERMINATED_PROCS | 0x00000080 | Log the total number of terminated processes. |