Apply APM Agent configuration

Microsoft.SystemCenter.Apm.ApmAgentApplyConfiguration (WriteActionModuleType)

Element properties:

Show References:
- Rules (1)

Type	WriteActionModuleType
Isolation	Any
Accessibility	Internal
RunAs	System.PrivilegedMonitoringAccount
InputType	System.BaseData

Overrideable Parameters:

Source Code:

<WriteActionModuleType ID="Microsoft.SystemCenter.Apm.ApmAgentApplyConfiguration" Accessibility="Internal" RunAs="System!System.PrivilegedMonitoringAccount">

  <Configuration>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="Id" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="EnableAllWebMonitoring" type="xsd:boolean"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="PerformanceThreshold" type="xsd:nonNegativeInteger"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="SensitivityThreshold" type="xsd:nonNegativeInteger"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="EnableAllExceptions" type="xsd:boolean"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="EnableEventThrottling" type="xsd:boolean"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="SensitiveRules" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="AliasingRules" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ThrottlingPerformancePerDomainPerMinute" type="xsd:nonNegativeInteger"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ThrottlingPerformancePerDomainPerHour" type="xsd:nonNegativeInteger"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ThrottlingPerformancePerDomainPerDay" type="xsd:nonNegativeInteger"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ThrottlingPerformanceEventGroupsPerMinute" type="xsd:nonNegativeInteger"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ThrottlingPerformanceEventGroupsPerHour" type="xsd:nonNegativeInteger"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ThrottlingPerformanceEventGroupsPerDay" type="xsd:nonNegativeInteger"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ThrottlingExceptionsTotalChainsPerMinute" type="xsd:nonNegativeInteger"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ThrottlingExceptionsTotalChainsPerHour" type="xsd:nonNegativeInteger"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ThrottlingExceptionsTotalChainsPerDay" type="xsd:nonNegativeInteger"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ThrottlingExceptionsPerDomainPerMinute" type="xsd:nonNegativeInteger"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ThrottlingExceptionsPerDomainPerHour" type="xsd:nonNegativeInteger"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ThrottlingExceptionsPerDomainPerDay" type="xsd:nonNegativeInteger"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ThrottlingExceptionsEventGroupsPerMinute" type="xsd:nonNegativeInteger"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ThrottlingExceptionsEventGroupsPerHour" type="xsd:nonNegativeInteger"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ThrottlingExceptionsEventGroupsPerDay" type="xsd:nonNegativeInteger"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="StatisticCountersActionConfigPath" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="StatisticCountersInstrumentConfigPath" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="PMonitorConfigPath" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="PMonitorDefaultConfigPath" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="MonitorXsdPath" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="PerfCounterMonitorConfigPath" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="PerfCounterMonitorXsdPath" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="StarterConfigPath" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="StarterXsdPath" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ServerAgentConfigPath" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ServerAgentXsdPath" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="StatisticCountersActionXsdPath" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="AgentHandlersConfigPath" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ApmServerModulesConfigPath" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ManagementGroupName" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="ManagementGroupId" type="xsd:string"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="DisableAssemblySharing" type="xsd:boolean"/>

    <xsd:element xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="EnableRTIA" type="xsd:boolean"/>

  </Configuration>

  <OverrideableParameters>

    <OverrideableParameter ID="SensitiveRules" Selector="$Config/SensitiveRules$" ParameterType="string"/>

    <OverrideableParameter ID="AliasingRules" Selector="$Config/AliasingRules$" ParameterType="string"/>

    <OverrideableParameter ID="ThrottlingPerformancePerDomainPerMinute" Selector="$Config/ThrottlingPerformancePerDomainPerMinute$" ParameterType="int"/>

    <OverrideableParameter ID="ThrottlingPerformancePerDomainPerHour" Selector="$Config/ThrottlingPerformancePerDomainPerHour$" ParameterType="int"/>

    <OverrideableParameter ID="ThrottlingPerformancePerDomainPerDay" Selector="$Config/ThrottlingPerformancePerDomainPerDay$" ParameterType="int"/>

    <OverrideableParameter ID="ThrottlingPerformanceEventGroupsPerMinute" Selector="$Config/ThrottlingPerformanceEventGroupsPerMinute$" ParameterType="int"/>

    <OverrideableParameter ID="ThrottlingPerformanceEventGroupsPerHour" Selector="$Config/ThrottlingPerformanceEventGroupsPerHour$" ParameterType="int"/>

    <OverrideableParameter ID="ThrottlingPerformanceEventGroupsPerDay" Selector="$Config/ThrottlingPerformanceEventGroupsPerDay$" ParameterType="int"/>

    <OverrideableParameter ID="ThrottlingExceptionsTotalChainsPerMinute" Selector="$Config/ThrottlingExceptionsTotalChainsPerMinute$" ParameterType="int"/>

    <OverrideableParameter ID="ThrottlingExceptionsTotalChainsPerHour" Selector="$Config/ThrottlingExceptionsTotalChainsPerHour$" ParameterType="int"/>

    <OverrideableParameter ID="ThrottlingExceptionsTotalChainsPerDay" Selector="$Config/ThrottlingExceptionsTotalChainsPerDay$" ParameterType="int"/>

    <OverrideableParameter ID="ThrottlingExceptionsPerDomainPerMinute" Selector="$Config/ThrottlingExceptionsPerDomainPerMinute$" ParameterType="int"/>

    <OverrideableParameter ID="ThrottlingExceptionsPerDomainPerHour" Selector="$Config/ThrottlingExceptionsPerDomainPerHour$" ParameterType="int"/>

    <OverrideableParameter ID="ThrottlingExceptionsPerDomainPerDay" Selector="$Config/ThrottlingExceptionsPerDomainPerDay$" ParameterType="int"/>

    <OverrideableParameter ID="ThrottlingExceptionsEventGroupsPerMinute" Selector="$Config/ThrottlingExceptionsEventGroupsPerMinute$" ParameterType="int"/>

    <OverrideableParameter ID="ThrottlingExceptionsEventGroupsPerHour" Selector="$Config/ThrottlingExceptionsEventGroupsPerHour$" ParameterType="int"/>

    <OverrideableParameter ID="ThrottlingExceptionsEventGroupsPerDay" Selector="$Config/ThrottlingExceptionsEventGroupsPerDay$" ParameterType="int"/>

    <OverrideableParameter ID="StatisticCountersActionConfigPath" Selector="$Config/StatisticCountersActionConfigPath$" ParameterType="string"/>

    <OverrideableParameter ID="StatisticCountersInstrumentConfigPath" Selector="$Config/StatisticCountersInstrumentConfigPath$" ParameterType="string"/>

    <OverrideableParameter ID="PMonitorConfigPath" Selector="$Config/PMonitorConfigPath$" ParameterType="string"/>

    <OverrideableParameter ID="PMonitorDefaultConfigPath" Selector="$Config/PMonitorDefaultConfigPath$" ParameterType="string"/>

    <OverrideableParameter ID="PerfCounterMonitorConfigPath" Selector="$Config/PerfCounterMonitorConfigPath$" ParameterType="string"/>

    <OverrideableParameter ID="StarterConfigPath" Selector="$Config/StarterConfigPath$" ParameterType="string"/>

    <OverrideableParameter ID="ServerAgentConfigPath" Selector="$Config/ServerAgentConfigPath$" ParameterType="string"/>

    <OverrideableParameter ID="AgentHandlersConfigPath" Selector="$Config/AgentHandlersConfigPath$" ParameterType="string"/>

    <OverrideableParameter ID="ApmServerModulesConfigPath" Selector="$Config/ApmServerModulesConfigPath$" ParameterType="string"/>

    <OverrideableParameter ID="DisableAssemblySharing" Selector="$Config/DisableAssemblySharing$" ParameterType="bool"/>

    <OverrideableParameter ID="EnableRTIA" Selector="$Config/EnableRTIA$" ParameterType="bool"/>

  </OverrideableParameters>

  <ModuleImplementation>

    <Managed>

      <Assembly>Res.Microsoft.SystemCenter.Apm.LibraryConfigManager</Assembly>

      <Type>

              Microsoft.EnterpriseManagement.Modules.Apm.LibraryConfigManager.WriteActions.ApmAgentConfigurationWriteAction

            </Type>

    </Managed>

  </ModuleImplementation>

  <InputType>System!System.BaseData</InputType>

</WriteActionModuleType>

ID	ParameterType	Selector	Display Name	Description
SensitiveRules	string	$Config/SensitiveRules$	Sensitive data rules	Sensitive data rules are used to mask collected data where personal information such as user names/passwords may be captured by the monitoring. See the operators guide for more details on using the rules.
AliasingRules	string	$Config/AliasingRules$	Aliasing rules	Aliasing rules are used to alter the name of an application so that you can join different applications under a single application name in Application Diagnostics and Application Advisor. See the Monitoring .NET Applications section of the Operations Guide for additional details.
ThrottlingPerformancePerDomainPerMinute	int	$Config/ThrottlingPerformancePerDomainPerMinute$	Performance events per domain per minute	Override to set a limit to the number of performance events collected for an application per minute
ThrottlingPerformancePerDomainPerHour	int	$Config/ThrottlingPerformancePerDomainPerHour$	Performance events per domain per hour	Override to set a limit to the number of performance events collected for an application per hour
ThrottlingPerformancePerDomainPerDay	int	$Config/ThrottlingPerformancePerDomainPerDay$	Performance events per domain per day	Override to set a limit to the number of performance events collected for an application per day
ThrottlingPerformanceEventGroupsPerMinute	int	$Config/ThrottlingPerformanceEventGroupsPerMinute$	Performance event groups per minute	Override to limit the number of times a performance event with the same call stack will be collected and reported per minute
ThrottlingPerformanceEventGroupsPerHour	int	$Config/ThrottlingPerformanceEventGroupsPerHour$	Performance event groups per hour	Override to limit the number of times a performance event with the same call stack will be collected and reported per hour
ThrottlingPerformanceEventGroupsPerDay	int	$Config/ThrottlingPerformanceEventGroupsPerDay$	Performance event groups per day	Override to limit the number of times a performance event with the same call stack will be collected and reported per day
ThrottlingExceptionsTotalChainsPerMinute	int	$Config/ThrottlingExceptionsTotalChainsPerMinute$	Total number of exceptions collected per minute	Override to set a limit to the total number of exception collected per minute
ThrottlingExceptionsTotalChainsPerHour	int	$Config/ThrottlingExceptionsTotalChainsPerHour$	Total number of exceptions collected per hour	Override to set a limit to the total number of exception collected per hour
ThrottlingExceptionsTotalChainsPerDay	int	$Config/ThrottlingExceptionsTotalChainsPerDay$	Total number of exceptions collected per day	Override to set a limit to the total number of exceptions collected per day.
ThrottlingExceptionsPerDomainPerMinute	int	$Config/ThrottlingExceptionsPerDomainPerMinute$	Exception per domain per minute	Override to set a limit to the number of exceptions collected and reported for an application per minute
ThrottlingExceptionsPerDomainPerHour	int	$Config/ThrottlingExceptionsPerDomainPerHour$	Exception per domain per hour	Override to set a limit to the number of exceptions collected and reported for an application per hour
ThrottlingExceptionsPerDomainPerDay	int	$Config/ThrottlingExceptionsPerDomainPerDay$	Exception per domain per day	Override to set a limit to the number of exceptions collected and reported for an application per day
ThrottlingExceptionsEventGroupsPerMinute	int	$Config/ThrottlingExceptionsEventGroupsPerMinute$	Exception event groups per minute	Override to limit the number of times an exception with the same call stack will be collected and reported per minute
ThrottlingExceptionsEventGroupsPerHour	int	$Config/ThrottlingExceptionsEventGroupsPerHour$	Exception event groups per hour	Override to limit the number of times an exception with the same call stack will be collected and reported per hour
ThrottlingExceptionsEventGroupsPerDay	int	$Config/ThrottlingExceptionsEventGroupsPerDay$	Exception event groups per day	Override to limit the number of times an exception with the same call stack will be collected and reported per day
StatisticCountersActionConfigPath	string	$Config/StatisticCountersActionConfigPath$	Path to StatisticCounters.action.config file	Used as a gold master for the StatisticCounters.action.config file, the value should be the full path to the customized configuration file. Overriding this value will cause the APM Services on the affected servers to pull the new configuration file from the specified location (can be a network share) and merge the wizard generated configuration into it. Any settings that are controlled through the UI will overwrite changes made in the custom configuration file.
StatisticCountersInstrumentConfigPath	string	$Config/StatisticCountersInstrumentConfigPath$	Path to StatisticCounters.instrument.config file	Used as a gold master for the StatisticCounters.instrument.config file, the value should be the full path to the customized configuration file. Overriding this value will cause the APM Services on the affected servers to pull the new configuration file from the specified location (can be a network share) and merge the wizard generated configuration into it. Any settings that are controlled through the UI will overwrite changes made in the custom configuration file.
PMonitorConfigPath	string	$Config/PMonitorConfigPath$	Path to PMonitor.config file	Used as a gold master for the PMonitor.config file, the value should be the full path to the customized configuration file. Overriding this value will cause the APM Services on the affected servers to pull the new configuration file from the specified location (can be a network share) and merge the wizard generated configuration into it. Any settings that are controlled through the UI will overwrite changes made in the custom configuration file.
PMonitorDefaultConfigPath	string	$Config/PMonitorDefaultConfigPath$	Path to PMonitor.default.config file	Used as a gold master for the PMonitor.default.config file, the value should be the full path to the customized configuration file. Overriding this value will cause the APM Services on the affected servers to pull the new configuration file from the specified location (can be a network share) and merge the wizard generated configuration into it. Any settings that are controlled through the UI will overwrite changes made in the custom configuration file.
PerfCounterMonitorConfigPath	string	$Config/PerfCounterMonitorConfigPath$	Path to PerfCounterMonitor.config file	Used as a gold master for the PerfCounterMonitor.config file, the value should be the full path to the customized configuration file. Overriding this value will cause the APM Services on the affected servers to pull the new configuration file from the specified location (can be a network share) and merge the wizard generated configuration into it. Any settings that are controlled through the UI will overwrite changes made in the custom configuration file.
StarterConfigPath	string	$Config/StarterConfigPath$	Path to Starter.config file	Used as a gold master for the Starter.config file, the value should be the full path to the customized configuration file. Overriding this value will cause the APM Services on the affected servers to pull the new configuration file from the specified location (can be a network share) and merge the wizard generated configuration into it. Any settings that are controlled through the UI will overwrite changes made in the custom configuration file.
ServerAgentConfigPath	string	$Config/ServerAgentConfigPath$	Path to ServerAgent.config file	Used as a gold master for the ServerAgent.config file, the value should be the full path to the customized configuration file. Overriding this value will cause the APM Services on the affected servers to pull the new configuration file from the specified location (can be a network share) and merge the wizard generated configuration into it. Any settings that are controlled through the UI will overwrite changes made in the custom configuration file.
AgentHandlersConfigPath	string	$Config/AgentHandlersConfigPath$	Path to AgentHandlers.config file	Used as a gold master for the AgentHandlers.config file, the value should be the full path to the customized configuration file. Overriding this value will cause the APM Services on the affected servers to pull the new configuration file from the specified location (can be a network share) and merge the wizard generated configuration into it. Any settings that are controlled through the UI will overwrite changes made in the custom configuration file.
ApmServerModulesConfigPath	string	$Config/ApmServerModulesConfigPath$	Path to ApmServerModules.config file	Used as a gold master for the ApmServerModules.config file, the value should be the full path to the customized configuration file. Overriding this value will cause the APM Services on the affected servers to pull the new configuration file from the specified location (can be a network share) and merge the wizard generated configuration into it. Any settings that are controlled through the UI will overwrite changes made in the custom configuration file.
DisableAssemblySharing	bool	$Config/DisableAssemblySharing$	Disable assembly sharing	.NET Framework implements a mechanism of sharing assemblies between multiple running application domains. This reduces amount of memory consumed by the applications but in some cases might make applications incompatible with Application Performance Monitoring (APM). Using this override allows controlling assembly sharing in .NET Framework.
EnableRTIA	bool	$Config/EnableRTIA$	Enable RTIA profiler	Override to enable RTIA profiler.