Compartilhar via


CpuLoggingOptions

This property contains flags that specify how IIS should log CPU times for services, servers, or applications. You can use this property to configure IIS to sum the CPU times of CGI applications only, of ISAPI extensions and ASP applications only, or of all applications.

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 directly manipulate the bit flags within CpuLoggingOptions by using the hexadecimal values in the following Bitmask Values table.

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

1

Internal Default

null

Upper Bound

Not specified

Lower Bound

Not specified

Internal ID

2146

Friendly ID

MD_CPU_LOGGING_OPTIONS

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

CpuEnableAllProcLogging

Versions Applicable

[IIS 5.0]

Description

Setting this flag to true indicates that IIS should log total CPU times for all out-of-process ISAPI extensions and ASP and CGI applications.

Bitmask

1 (hex 0x00000001)

Friendly Bitmask ID

MD_CPU_ENABLE_ALL_PROC_LOGGING

Internal ID

Not specified.

Flag Name

CpuEnableAppLogging

Versions Applicable

[IIS 5.0]

Description

Setting this flag to true indicates that IIS should log out-of-process ISAPI extensions and ASP applications.

Bitmask

4 (hex 0x00000004)

Friendly Bitmask ID

MD_CPU_ENABLE_APP_LOGGING

Internal ID

Not specified.

Flag Name

CpuEnableCgiLogging

Versions Applicable

[IIS 5.0]

Description

Setting this flag to true indicates that IIS should log total CPU times for CGI applications.

Bitmask

2 (hex 0x00000002)

Friendly Bitmask ID

MD_CPU_ENABLE_CGI_LOGGING

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