RoleInstanceDiagnosticManager.BeginOnDemandTransfer Method (DataBufferName)
Updated: November 15, 2013
Assembly: Microsoft.WindowsAzure.Diagnostics (in Microsoft.WindowsAzure.Diagnostics.dll)
'Declaration Public Function BeginOnDemandTransfer ( _ sourceBufferName As DataBufferName _ ) As Guid
The name of the source buffer.
Return ValueType: System.GuidA 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, "28281fc7754b44faa9ccf4911983edf1", "MyWebRole", "deployment(1).MyAzureProject.WebRole1.0"); // Start a transfer of performance counter logs. roleInstanceDiagnosticManager.BeginOnDemandTransfer(DataBufferName.PerformanceCounters);
Development PlatformsWindows Vista, Windows 7 and Windows Server 2008