Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

RoleInstanceDiagnosticManager.BeginOnDemandTransfer Method (DataBufferName)

Updated: November 15, 2013

Begins an on-demand transfer of the specified data buffer.

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

Public Function BeginOnDemandTransfer ( _
	sourceBufferName As DataBufferName _
) As Guid



Type: Microsoft.WindowsAzure.Diagnostics.DataBufferName

The name of the source buffer.

Return Value

Type: System.Guid

A request ID identifying the transfer.

The BeginOnDemandTransfer(DataBufferName) method is used to start an on-demand transfer of buffered diagnostic data from the local storage of a role instance to your desired final destination. The input parameter, sourceBufferName, indicates the value of the DataBufferName enumeration that you want to transfer.

Only one transfer of each data buffer can occur at a time. For example, if you call this method using PerformanceCounters to start transferring all performance counter data for a role instance, you cannot call it again until the transfer has completed.


The following code snippet starts an on-demand transfer of performance counter data for the role instance:

// Get the diagnostic monitor for the specified role instance.
RoleInstanceDiagnosticManager roleInstanceDiagnosticManager = 
       new RoleInstanceDiagnosticManager(myStorageAccount, 

// Start a transfer of performance counter logs.

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

Development Platforms

Windows Vista, Windows 7, Windows Server 2008, Windows 8.1, Windows Server 2012 R2, Windows 8 and Windows Server 2012

Target Platforms

Community Additions

© 2015 Microsoft