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.