Updated: October 24, 2011
Specifies options for an on-demand transfer.
Assembly: Microsoft.WindowsAzure.Diagnostics (in Microsoft.WindowsAzure.Diagnostics.dll)
Gets or sets the start of the time window for which event data is to be transferred.
Gets or sets the filter level for event data that has been logged with level information.
Gets or sets the name of the queue where transfer completion notification can optionally be sent.
Gets or sets the end of the time window for which event data is to be transferred.
Theclass is used to specify options for transferring diagnostic data from a role instance. For example, you can specify a time period for which to return results, as well as specify logging levels and a name for the notification queue in persistent storage.
The following code snippet creates a completeobject and starts an on-demand transfer.
// Specify the on-demand transfer options for the diagnostic data. OnDemandTransferOptions transferOptions = new OnDemandTransferOptions(); // Get data starting from an hour ago until now. transferOptions.From = DateTime.UtcNow.AddHours(1.0); transferOptions.To = DateTime.UtcNow; // Specify only error-level logs. transferOptions.LogLevelFilter = LogLevel.Error; // Provide a name for the queue where completion messages will be stored. transferOptions.NotificationQueueName = "wad-on-demand-transfers"; // Start a transfer of Windows event logs. roleInstanceDiagnosticManager.BeginOnDemandTransfer(DataBufferName.PerformanceCounters, transferOptions);
This API is not supported in Azure SDK versions 2.5 and higher. Instead, use the diagnostics.wadcfg XML configuration file. For more information, see Collect Logging Data by Using Azure Diagnostics.
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.