add Element for bufferMode for healthMonitoring (ASP.NET Settings Schema)

Article
11/03/2006

Configures a buffer mode and adds it to the HealthBufferModeSettings collection.

This element is new in the .NET Framework version 2.0.

<add 
  name="buffer mode name"
  maxBufferSize="buffer size"
  maxFlushSize="maximum events per flush"
  urgentFlushThreshold="minimum threshold per flush"
  regularFlushInterval="time interval per flush"
  urgentFlushInterval="minimum time between flushes"
  maxBufferThreads="maximum number of flushing threads"
/>

Attributes and Elements

The following sections describe attributes, child elements, and parent elements for this section.

Attributes

Attribute	Description
name	Required String attribute. Specifies the name for this buffer mode.
maxBufferSize	Required Int32 attribute. Specifies the maximum number of events that can be buffered. The value cannot be 0.
maxFlushSize	Required Int32 attribute. Specifies the maximum number of events per flush. The value must be between 1 and maxBufferSize.
urgentFlushThreshold	Required Int32 attribute. Specifies the minimum threshold per flush. The value must be less then or equal to maxBufferSize.
regularFlushInterval	Required TimeSpan attribute. Specifies the time interval per flush. The value cannot be 0.
urgentFlushInterval	Required TimeSpan attribute. Specifies the minimum time between flushes. The value must be between 0 and regularFlushInterval.
maxBufferThreads	Required Int32 attribute. Specifies the maximum number of flushing threads.

Child Elements

None.

Parent Elements

Element	Description
configuration	Specifies the root element in every configuration file that is used by the common language runtime and the .NET Framework applications.
system.web	Specifies the root element for the ASP.NET configuration section.
healthMonitoring	Configures an application for health monitoring.
bufferModes	Defines the buffering capabilities for a provider.

Remarks

Default Configuration

The following default add element is configured in the root Web.config file in the .NET Framework version 2.0.

<add name="Critical Notification" maxBufferSize="100" maxFlushSize="20"
     urgentFlushThreshold="1" regularFlushInterval="Infinite" urgentFlushInterval="00:01:00" 
     maxBufferThreads="1" />
<add name="Notification" maxBufferSize="300" maxFlushSize="20"
     urgentFlushThreshold="1" regularFlushInterval="Infinite" urgentFlushInterval="00:01:00" 
     maxBufferThreads="1" />
<add name="Analysis" maxBufferSize="1000" maxFlushSize="100" urgentFlushThreshold="100" 
     regularFlushInterval="00:05:00" urgentFlushInterval="00:01:00" 
     maxBufferThreads="1" />
<add name="Logging" maxBufferSize="1000" maxFlushSize="200" 
     urgentFlushThreshold="800" regularFlushInterval="00:30:00" urgentFlushInterval="00:05:00" 
     maxBufferThreads="1" />

Example

The following code example shows how to add a buffer mode.

<bufferModes>
  <add name="Critical Notification"
    maxBufferSize="100"
    maxFlushSize="20"
    urgentFlushThreshold="1"
    regularFlushInterval="Infinite"
    urgentFlushInterval="00:01:00"
    maxBufferThreads="1"
  />
</bufferModes>

Element Information

Configuration section handler	System.Web.Configuration.HealthMonitoringSection
Configuration member	System.Web.Configuration.BufferModesCollection
Configurable locations	Machine.config Root-level Web.config Application-level Web.config
Requirements	Microsoft Internet Information Services (IIS) version 5.0, 5.1, or 6.0 The .NET Framework version 2.0 Microsoft Visual Studio 2005

Share via

add Element for bufferMode for healthMonitoring (ASP.NET Settings Schema)

Attributes and Elements

Attributes

Child Elements

Parent Elements

Remarks

Default Configuration

Example

Element Information

See Also

Tasks

Reference

Concepts

Other Resources

Additional resources