CpuLoggingMask

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

Access Locations

This property is accessible at the following locations:

Metabase Path Key Type
/LM/W3SVC IIsWebService
/LM/W3SVC/N IIsWebServer

IIS Admin Base Object Information

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

Bitmask Values
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.