RoleInstanceDiagnosticManager.SetCurrentConfiguration Method (DiagnosticMonitorConfiguration)
Sets the configuration for the diagnostic monitor.
Namespace: Microsoft.WindowsAzure.Diagnostics.Management
Assembly: Microsoft.WindowsAzure.Diagnostics (in Microsoft.WindowsAzure.Diagnostics.dll)
Syntax
public void SetCurrentConfiguration(
DiagnosticMonitorConfiguration newConfiguration
)
public:
void SetCurrentConfiguration(
DiagnosticMonitorConfiguration^ newConfiguration
)
member SetCurrentConfiguration :
newConfiguration:DiagnosticMonitorConfiguration -> unit
Public Sub SetCurrentConfiguration (
newConfiguration As DiagnosticMonitorConfiguration
)
Parameters
newConfiguration
Type: Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorConfigurationType: Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorConfiguration
A DiagnosticMonitorConfiguration object representing the new configuration.
Remarks
The SetCurrentConfiguration method is used to set a new configuration for the diagnostic monitor of a role instance. See DiagnosticMonitorConfiguration for more information.
Setting the current configuration while on-demand transfers are pending results in an error.
Example
The following code snippet gets the current diagnostic monitor configuration for a role instance, modifies it, and sets it.
// Get the diagnostic monitor for the specified role instance.
RoleInstanceDiagnosticManager roleInstanceDiagnosticManager =
new RoleInstanceDiagnosticManager(myStorageAccount,
"28281fc7754b44faa9ccf4911983edf1",
"MyWebRole",
"deployment(1).MyAzureProject.WebRole1.0");
// Get the current diagnostic monitor for the role.
DiagnosticMonitorConfiguration currentConfiguration = roleInstanceDiagnosticManager.GetCurrentConfiguration();
// Use 30 seconds for the performance counter sample rate.
TimeSpan perfSampleRate = TimeSpan.FromSeconds(30.0);
// Add a performance counter for processor time to the current configuration.
currentConfiguration.PerformanceCounters.DataSources.Add(new PerformanceCounterConfiguration()
{
CounterSpecifier = @"\Processor(_Total)\% Processor Time",
SampleRate = perfSampleRate
});
// Apply the modified configuration to the diagnostic monitor for the role instance.
roleInstanceDiagnosticManager.SetCurrentConfiguration(currentConfiguration);
Warning
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.
See Also
See Also
RoleInstanceDiagnosticManager Class
Microsoft.WindowsAzure.Diagnostics.Management Namespace
Return to top