RoleInstanceDiagnosticManager.BeginOnDemandTransfer Method (DataBufferName)

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.

Example

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 Platforms

Target Platforms