LogEventOnRecycle

  • Article

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.

Schema Attributes

Attribute Name

Value

ADSI/WMI Data Type

DWORD

ABO Data Type

DWORD_METADATA

Schema Default

AppPoolRecycleMemory

Internal Default

AppPoolRecycleTime | AppPoolRecycleMemory | AppPoolRecyclePrivateMemory

Upper Bound

Not specified

Lower Bound

Not specified

Internal ID

9037

Friendly ID

MD_APP_POOL_LOG_EVENT_ON_RECYCLE

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/AppPools/application_pool_name

IIsApplicationPool

/LM/W3SVC/AppPools

IIsApplicationPools

Flags

Flag Name

AppPoolRecycleConfigChange

Versions Applicable

[IIS 6.0]

Description

Caution

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.

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

Bitmask

64 (hex 0x00000040)

Friendly Bitmask ID

MD_APP_POOL_RECYCLE_CONFIG_CHANGE

Internal ID

6306

Flag Name

AppPoolRecycleIsapiUnhealthy

Versions Applicable

[IIS 6.0]

Description

Caution

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.

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

Bitmask

16 (hex 0x00000010)

Friendly Bitmask ID

MD_APP_POOL_RECYCLE_ISAPI_UNHEALTHY

Internal ID

6304

Flag Name

AppPoolRecycleMemory

Versions Applicable

[IIS 6.0]

Description

Caution

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.

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

Bitmask

8 (hex 0x00000008)

Friendly Bitmask ID

MD_APP_POOL_RECYCLE_MEMORY

Internal ID

6303

Flag Name

AppPoolRecycleOnDemand

Versions Applicable

[IIS 6.0]

Description

Caution

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.

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

Bitmask

32 (hex 0x00000020)

Friendly Bitmask ID

MD_APP_POOL_RECYCLE_ON_DEMAND

Internal ID

6305

Flag Name

AppPoolRecyclePrivateMemory

Versions Applicable

[IIS 6.0]

Description

Caution

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.

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

Bitmask

128 (hex 0x00000080)

Friendly Bitmask ID

MD_APP_POOL_RECYCLE_PRIVATE_MEMORY

Internal ID

6307

Flag Name

AppPoolRecycleRequests

Versions Applicable

[IIS 6.0]

Description

Caution

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.

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

Bitmask

2 (hex 0x00000002)

Friendly Bitmask ID

MD_APP_POOL_RECYCLE_REQUESTS

Internal ID

6301

Flag Name

AppPoolRecycleSchedule

Versions Applicable

[IIS 6.0]

Description

Caution

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.

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

Bitmask

4 (hex 0x00000004)

Friendly Bitmask ID

MD_APP_POOL_RECYCLE_SCHEDULE

Internal ID

6302

Flag Name

AppPoolRecycleTime

Versions Applicable

[IIS 6.0]

Description

Caution

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.

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

Bitmask

1 (hex 0x00000001)

Friendly Bitmask ID

MD_APP_POOL_RECYCLE_TIME

Internal ID

6300

Requirements

Server: Requires or Windows Server 2003.

Product: IIS

See Also