Share via


LogEventOnRecycle Metabase Property

Applies To: Windows Server 2003, Windows Server 2003 with SP1

The LogEventOnRecycle property specifies that IIS should log an event when an application pool is recycled. Application pools recycle for a variety of reasons. In order for IIS to log the event, the LogEventOnRecycle property must have a bit set corresponding to the reason for the recycle.

Attribute Name Attribute Value

XML Data Type

DWORD

WMI Data Type

SINT32

ADSI Data Type

DWORD

ABO Data Type

DWORD

ABO Metabase Identifier

MD_APP_POOL_LOG_EVENT_ON_RECYCLE

Attributes

INHERIT

Default Value

APPPOOLRECYCLEMEMORY

MetaFlagsEx

CACHE_PROPERTY_MODIFIED

User Type

IIS_MD_UT_SERVER

ID

9037

Configurable Locations

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

Metabase Path IIS Admin Object Type

/LM/W3SVC/AppPools/DefaultAppPool /LM/W3SVC/AppPools/DefaultAppPool/application_pool_name

IIsApplicationPool

/LM/W3SVC/AppPools

IIsApplicationPools

Flags

Flag Name AppPoolRecycleTime

Description

Important   This feature of IIS 6.0 is available only when IIS is running in worker process isolation mode. For more information, see Recycling Worker Processes with IIS 6.0.

Setting this flag to true causes IIS to log the event (the worker process is recycled after a specified elapsed time).

Metabase Bitmask Identifier

MD_APP_POOL_RECYCLE_TIME

Decimal Value

1

Hexadecimal Value

0x00000001

Flag Name AppPoolRecycleRequests

Description

Important   Important This feature of IIS 6.0 is available only when IIS is running in worker process isolation mode. For more information, see Recycling Worker Processes with IIS 6.0.

Setting this flag to true causes IIS to log the event (the worker process is recycled after a specified number of requests).

Metabase Bitmask Identifier

MD_APP_POOL_RECYCLE_REQUESTS

Decimal Value

2

Hexadecimal Value

0x00000002

Flag Name AppPoolRecycleSchedule

Description

Important   Important This feature of IIS 6.0 is available only when IIS is running in worker process isolation mode. For more information, see Recycling Worker Processes with IIS 6.0.

Setting this flag to true causes IIS to log the event (the worker process is recycled at specified times).

Metabase Bitmask Identifier

MD_APP_POOL_RECYCLE_SCHEDULE

Decimal Value

4

Hexadecimal Value

0x00000004

Flag Name AppPoolRecycleMemory

Description

Important   Important This feature of IIS 6.0 is available only when IIS is running in worker process isolation mode. For more information, see Recycling Worker Processes with IIS 6.0.

Setting this flag to true causes IIS to log the event (the worker process is recycled once a specified amount of used or virtual memory, expressed in megabytes, is in use).

Metabase Bitmask Identifier

MD_APP_POOL_RECYCLE_MEMORY

Decimal Value

8

Hexadecimal Value

0x00000008

Flag Name AppPoolRecycleIsapiUnhealthy

Description

Important   This feature of IIS 6.0 is available only when IIS is running in worker process isolation mode. For more information, see Recycling Worker Processes with IIS 6.0.

Setting this flag to true causes IIS to log the event (the worker process is recycled if IIS finds that an ISAPI is unhealthy).

Metabase Bitmask Identifier

MD_APP_POOL_RECYCLE_ISAPI_UNHEALTHY

Decimal Value

16

Hexadecimal Value

0x00000010

Flag Name AppPoolRecycleOnDemand

Description

Important   This feature of IIS 6.0 is available only when IIS is running in worker process isolation mode. For more information, see Recycling Worker Processes with IIS 6.0.

Setting this flag to true causes IIS to log the event (the worker process is recycled on demand by an administrator).

Metabase Bitmask Identifier

MD_APP_POOL_RECYCLE_ON_DEMAND

Decimal Value

32

Hexadecimal Value

0x00000020

Flag Name AppPoolRecycleConfigChange

Description

Important   Important This feature of IIS 6.0 is available only when IIS is running in worker process isolation mode. For more information, see Recycling Worker Processes with IIS 6.0.

Setting this flag to true causes IIS to log the event (the worker process is recycled after configuration changes are made).

Metabase Bitmask Identifier

MD_APP_POOL_RECYCLE_CONFIG_CHANGE

Decimal Value

64

Hexadecimal Value

0x00000040

Flag Name ppPoolRecyclePrivateMemory

Description

Important   This feature of IIS 6.0 is available only when IIS is running in worker process isolation mode. For more information, see Recycling Worker Processes with IIS 6.0.

Setting this flag to true causes IIS to log the event (the worker process is recycled when private memory reaches a specified amount).

Metabase Bitmask Identifier

MD_APP_POOL_RECYCLE_PRIVATE_MEMORY

Decimal Value

128

Hexadecimal Value

0x00000080

Code Example

For general code examples, see Code Examples to Configure Metabase Properties.