This topic has not yet been rated - Rate this topic

BasicLogsBufferConfiguration.ScheduledTransferLogLevelFilter Property

Gets or sets the logging level by which to filter records when performing a scheduled transfer.

Namespace: Microsoft.WindowsAzure.Diagnostics
Assembly: Microsoft.WindowsAzure.Diagnostics (in Microsoft.WindowsAzure.Diagnostics.dll)

Usage

Copy

'Usage
Dim instance As BasicLogsBufferConfiguration
Dim value As LogLevel

value = instance.ScheduledTransferLogLevelFilter

instance.ScheduledTransferLogLevelFilter = value

Syntax

C++

Copy

public LogLevel ScheduledTransferLogLevelFilter { get; set; }

Copy

/** @property */
/** @attribute CompilerGeneratedAttribute() */ 
public LogLevel get_ScheduledTransferLogLevelFilter ()

/** @property */
/** @attribute CompilerGeneratedAttribute() */ 
public void set_ScheduledTransferLogLevelFilter (LogLevel value)

JScript

Copy

CompilerGeneratedAttribute 
public function get ScheduledTransferLogLevelFilter () : LogLevel

CompilerGeneratedAttribute 
public function set ScheduledTransferLogLevelFilter (value : LogLevel)

Property Value

Type: Microsoft.WindowsAzure.Diagnostics.LogLevel

Returns LogLevel.

Remarks

The ScheduledTransferLogLevelFilter property is used to specify a LogLevel for diagnostics logs. When you specify a LogLevel, all events greater than or equal to the specified severity are transferred to persistent storage. For example, if you specify LogLevel = Warning, Error and Critical logs will also be transferred to persistent storage.

The default value of this property is Undefined. Undefined specifies that logging events at all levels will be transferred.

Example

The following code snippet will transfer only error-level Diagnostic Infrastructure logs from local storage to persistent storage every 30 minutes.

Copy

public override bool OnStart()
{
    // Get the default initial configuration for DiagnosticMonitor.
    DiagnosticMonitorConfiguration diagnosticConfiguration = DiagnosticMonitor.GetDefaultInitialConfiguration();

    // Filter the logs so that only error-level logs are transferred to persistent storage.
    diagnosticConfiguration.DiagnosticInfrastructureLogs.ScheduledTransferLogLevelFilter = LogLevel.Error;

    // Schedule a transfer period of 30 minutes.
    diagnosticConfiguration.DiagnosticInfrastructureLogs.ScheduledTransferPeriod = TimeSpan.FromMinutes(30.0);

    // Specify a buffer quota.
    diagnosticConfiguration.DiagnosticInfrastructureLogs.BufferQuotaInMB = 1024;

    // Start the DiagnosticMonitor using the diagnosticConfig and our connection string.
    DiagnosticMonitor.Start("Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString", diagnosticConfiguration);

    return base.OnStart();
}

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows Vista, Windows 7 and Windows Server 2008

Target Platforms

Change History

Reference

BasicLogsBufferConfiguration Class
BasicLogsBufferConfiguration Members
Microsoft.WindowsAzure.Diagnostics Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ