Share via


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

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

See Also

Tasks

How to: Lock ASP.NET Configuration Settings

Reference

healthMonitoring Element (ASP.NET Settings Schema)
bufferModes Element for healthMonitoring (ASP.NET Settings Schema)
clear Element for bufferModes for healthMonitoring (ASP.NET Settings Schema)
remove Element for bufferModes for healthMonitoring (ASP.NET Settings Schema)
System.Configuration
System.Web.Configuration

Concepts

ASP.NET Configuration Overview
ASP.NET Web Server Controls and Browser Capabilities
Securing ASP.NET Configuration
ASP.NET Configuration Scenarios

Other Resources

ASP.NET Configuration Files
ASP.NET Configuration Settings
General Configuration Settings (ASP.NET)
ASP.NET Configuration API