WebApplicationLifetimeEvent Class
Assembly: System.Web (in system.web.dll)
ASP.NET health monitoring allows production and operations staff to manage deployed Web applications. The System.Web.Management namespace contains the health-event types responsible for packaging application health-status data and the provider types responsible for processing this data. It also contains supporting types that help during the management of health events.
Application lifetime events include events such as application startup and shutdown events. If an application is terminated, you can determine why by viewing the related event message field.
When a WebApplicationLifetimeEvent instance occurs, ASP.NET health monitoring updates the Application Lifetime Events performance counter. You can log these events by adding the WebApplicationLifetimeEvent object to the rules subsection of the healthMonitoring section of the configuration file, as shown in the following example.
<rules>
<add name="Application Events"
eventName="Application Lifetime Events"
provider="EventLogProvider"
profile="Default"
minInterval="00:01:00" />
</rules>
The Application Lifetime Events performance counter contains the sum total of all ASP.NET lifetime events. To view this performance counter in System Monitor (PerfMon), in the Add Counters window select ASP.NET from the Performance object drop-down list. Select the Application Lifetime Events performance counter, and click the Add button. For more information, see "Using the System Monitor (PerfMon) with ASP.NET Applications" on MSDN. If you allow events to be logged by the standard EventLogWebEventProvider, you can view them in Event Viewer by selecting the Application log. For more information, see Event Viewer in the Windows Server 2003 documentation on TechNet.
Caution: |
|---|
| Because the WebApplicationLifetimeEvent object is a high-volume event, logging it is resource-intensive and might slow down your system. It can also cause other events to be overwritten in the case of the EventLogWebEventProvider class due to the high volume of events and the way the event logging works. |
Note: |
|---|
| In most cases you will be able to use the ASP.NET health-monitoring types as implemented, and you will control the health-monitoring system by specifying values in the healthMonitoring configuration section. You can also derive from the health-monitoring types to create your own custom events and providers. For an example of deriving from the WebApplicationLifetimeEvent class, see the example provided in this topic. |
The following code example shows how to derive from the WebApplicationLifetimeEvent class to create a custom event.
The following configuration-file excerpt shows how to configure the healthMonitoring section of a configuration file to add the SampleWebApplicationLifetimeEvent code defined above to the ASP.NET health-monitoring system. To add the event to the system, you must define the event by adding a new entry to the eventMappings section and map the event to a provider by adding a new entry to the rules section.
<healthMonitoring
enabled="true"
heartBeatInterval="0">
<eventMappings>
<clear />
<!-- Configure the application lifetime event -->
<!-- object to handle the Web application events. -->
<add name="SampleApplicationLifetimeEvents"
type="System.Web.Management.SampleWebApplicationLifetimeEvent,
System.Web,Version=2.0.3600.0,
Culture=neutral,PublicKeyToken=b03f5f7f11d50a3a" />
</eventMappings>
<rules>
<clear/>
// Configure the connection between the
// application lifetime event object
// and the provider that must process it.
<add name="Custom Application Events"
eventName="SampleApplicationLifetimeEvents"
provider="EventLogProvider"
profile="Default"
minInterval="00:01:00" />
</rules>
</healthMonitoring>
- AspNetHostingPermission for operating in a hosted environment. Demand value: LinkDemand; Permission value: Minimal.
- AspNetHostingPermission for operating in a hosted environment. Demand value: InheritanceDemand; Permission value: Minimal.
System.Web.Management.WebBaseEvent
System.Web.Management.WebManagementEvent
System.Web.Management.WebApplicationLifetimeEvent
Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.
Caution:
Note: