次の方法で共有


CpuLoggingMask

This 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.

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.

Schema Attributes

Attribute Name

Value

ADSI/WMI Data Type

DWORD

ABO Data Type

DWORD_METADATA

Schema Default

null

Internal Default

null

Upper Bound

Not specified

Lower Bound

Not specified

Internal ID

4507

Friendly ID

MD_CPU_LOGGING_MASK

Property Attributes

INHERIT

User Type

IIS_MD_UT_SERVER

Configurable Locations

You can configure this property at the following locations in the IIS metabase.

Metabase Path

IIS Admin Object Type

/LM/W3SVC

IIsWebService

/LM/W3SVC/n

IIsWebServer

Flags

Flag Name

CpuEnableActiveProcs

Versions Applicable

[IIS 5.0]

Description

Setting this flag to true indicates that the total number of active processes is recorded when process accounting is performed.

Bitmask

64 (hex 0x00000040)

Friendly Bitmask ID

MD_CPU_ENABLE_ACTIVE_PROCS

Internal ID

Not specified.

Flag Name

CpuEnableEvent

Versions Applicable

[IIS 5.0]

Description

Setting this flag to true indicates that the event that triggered the creation of a log record is specified in the log record itself.

Bitmask

1 (hex 0x00000001)

Friendly Bitmask ID

MD_CPU_ENABLE_EVENT

Internal ID

Not specified.

Flag Name

CpuEnableKernelTime

Versions Applicable

[IIS 5.0]

Description

Setting this flag to true indicates that total kernel-mode CPU time is recorded when process accounting is performed.

Bitmask

8 (hex 0x00000008)

Friendly Bitmask ID

MD_CPU_ENABLE_KERNEL_TIME

Internal ID

Not specified.

Flag Name

CpuEnableLogging

Versions Applicable

[IIS 5.0]

Description

Setting this flag to true indicates that process accounting is enabled for the Web service or server. Process accounting can log the amount of CPU time that is taken by a Web server or service, as well as any process throttling events that might occur. 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.

Bitmask

2147483648 (hex 0x80000000)

Friendly Bitmask ID

MD_CPU_ENABLE_LOGGING

Internal ID

Not specified.

Flag Name

CpuEnablePageFaults

Versions Applicable

[IIS 5.0]

Description

Setting this flag to true indicates that the total number of page faults is recorded when process accounting is performed.

Bitmask

16 (hex 0x00000010)

Friendly Bitmask ID

MD_CPU_ENABLE_PAGE_FAULTS

Internal ID

Not specified.

Flag Name

CpuEnableProcType

Versions Applicable

[IIS 5.0]

Description

Setting this flag to true indicates that process type is recorded when process accounting is performed.

Bitmask

2 (hex 0x00000002)

Friendly Bitmask ID

MD_CPU_ENABLE_PROC_TYPE

Internal ID

Not specified.

Flag Name

CpuEnableTerminatedProcs

Versions Applicable

[IIS 5.0]

Description

Setting this flag to true indicates that the total number of terminated processes is recorded when process accounting is performed.

Bitmask

128 (hex 0x00000080)

Friendly Bitmask ID

MD_CPU_ENABLE_TERMINATED_PROCS

Internal ID

Not specified.

Flag Name

CpuEnableTotalProcs

Versions Applicable

[IIS 5.0]

Description

Setting this flag to true indicates that the total number of processes is recorded when process accounting is performed.

Bitmask

32 (hex 0x00000020)

Friendly Bitmask ID

MD_CPU_ENABLE_TOTAL_PROCS

Internal ID

Not specified.

Flag Name

CpuEnableUserTime

Versions Applicable

[IIS 5.0]

Description

Setting this flag to true indicates that total user-mode CPU time is recorded when process accounting is performed.

Bitmask

4 (hex 0x00000004)

Friendly Bitmask ID

MD_CPU_ENABLE_USER_TIME

Internal ID

Not specified.

Requirements

Client: Requires Windows 2000 Professional, or Windows NT Workstation 4.0.

Server: Requires Windows 2000 Server, or Windows NT Server 4.0.

Product: IIS

See Also