APM Client-Side Monitoring Configuration

Microsoft.SystemCenter.Apm.Infrastructure.Monitoring.ApmAgent.CSMConfigurationConflict.Monitor (UnitMonitor)

This monitor verifies that an APM Agent has been correctly processing APM Client-Side Monitoring configuration. The monitor turns to Warning state when an invalid configuration or a configuration conflict is detected.

Knowledge Base article:

Summary

The instance state becomes unhealthy when the APM .NET Client Side monitoring Configuration is invalid or conflicting.

Causes

APM configuration infrastructure generates configuration for the APM .NET Client-Side Monitoring agent based on the settings specified in the .NET Application Performance Monitoring template, management packs, and a number of files containing default configuration directives that are pre-installed with the agent. During this process, there could be errors depending on agent problems or conflicting settings, which will prevent configuration from being successfully loaded and used. Reasons for this include: wrong settings specified during the configuration process, conflicting settings for the same application specified in different templates, or even the agent installation being damaged and needing to be repaired.

The most common cause for this type of error is a configuration conflict, for example: multiple templates specifying conflicting settings for the same application.

APM client-side monitoring is applied per website and only one configuration can be applied to any specific website. If you are configuring monitoring for different applications hosted in the same website, some configuration settings must be the same for all monitored applications in the process, as they will be sharing a single Client-Side Monitoring (CSM) Collector.

In some cases, an error of this type can also be caused by a broken encryption key.

Unless the configuration conflict is corrected, client-side application performance monitoring will not work as expected for this website.

Resolutions

Check the Alert Context and the Operations Manager Event Log on this agent to get additional details about the cause of the conflict. The event log might contain multiple messages for a single conflict or error, and it will help you isolate the application groups that are causing the configuration conflicts on the agent.

Using the information provided in the error(s), ensure that the thresholds and other settings have been configured the same across each specified application group. To update the application group configuration:

Open the Operations Console.
Go to the Authoring space.
Expand Management Pack Templates.
Select .NET Application Performance Monitoring.
Select the first conflicting template instance and click properties in the Task pane.

Using the properties wizard you can adjust the conflicting settings in the application groups.

In the case of a broken RunAs account, it is sufficient to just open the .NET Application Performance Monitoring template and save it again so that all the settings, together with the RunAs Account, are written again in the correct format.

Element properties:

Target

Microsoft.SystemCenter.Apm.ApmAgent

Parent Monitor

System.Health.ConfigurationState

Category

ConfigurationHealth

Enabled

True

Alert Generate

True

Alert Severity

MatchMonitorHealth

Alert Priority

Normal

Alert Auto Resolve

True

Monitor Type

Microsoft.Windows.2SingleEventLog2StateMonitorType

Remotable

False

Accessibility

Public

Alert Message

APM Client-Side Monitoring Configuration Error or Conflict

The APM Agent has encountered an error while processing APM Client-Side Monitoring configuration. This could be caused by an agent problem or by incorrect or conflicting configuration specified in multiple templates.

RunAs

Default

Source Code:

<UnitMonitor ID="Microsoft.SystemCenter.Apm.Infrastructure.Monitoring.ApmAgent.CSMConfigurationConflict.Monitor" Accessibility="Public" Enabled="true" ParentMonitorID="Health!System.Health.ConfigurationState" Target="AI!Microsoft.SystemCenter.Apm.ApmAgent" TypeID="Windows!Microsoft.Windows.2SingleEventLog2StateMonitorType" Remotable="false" Priority="Normal" ConfirmDelivery="false">

  <Category>ConfigurationHealth</Category>

  <AlertSettings AlertMessage="Microsoft.SystemCenter.Apm.Infrastructure.Monitoring.ApmAgent.CSMConfigurationConflict.Monitor.AlertMessageResourceID">

    <AlertOnState>Warning</AlertOnState>

    <AutoResolve>true</AutoResolve>

    <AlertPriority>Normal</AlertPriority>

    <AlertSeverity>MatchMonitorHealth</AlertSeverity>

    <AlertParameters>

      <AlertParameter1>$Data/Context/EventDescription$</AlertParameter1>

    </AlertParameters>

  </AlertSettings>

  <OperationalStates>

    <OperationalState ID="NOConflict" MonitorTypeStateID="SecondEventRaised" HealthState="Success"/>

    <OperationalState ID="Conflict" MonitorTypeStateID="FirstEventRaised" HealthState="Warning"/>

  </OperationalStates>

  <Configuration>

    <FirstComputerName>$Target/Host/Property[Type="Windows!Microsoft.Windows.Computer"]/NetworkName$</FirstComputerName>

    <FirstLogName>Operations Manager</FirstLogName>

    <FirstExpression>

      <And>

        <Expression>

          <SimpleExpression>

            <ValueExpression>

              <XPathQuery Type="String">PublisherName</XPathQuery>

            </ValueExpression>

            <Operator>Equal</Operator>

            <ValueExpression>

              <Value Type="String">.NET app monitoring</Value>

            </ValueExpression>

          </SimpleExpression>

        </Expression>

        <Expression>

          <Or>

            <Expression>

              <SimpleExpression>

                <ValueExpression>

                  <XPathQuery Type="UnsignedInteger">EventDisplayNumber</XPathQuery>

                </ValueExpression>

                <Operator>Equal</Operator>

                <ValueExpression>

                  <Value Type="UnsignedInteger">34240</Value>

                </ValueExpression>

              </SimpleExpression>

            </Expression>

            <Expression>

              <SimpleExpression>

                <ValueExpression>

                  <XPathQuery Type="UnsignedInteger">EventDisplayNumber</XPathQuery>

                </ValueExpression>

                <Operator>Equal</Operator>

                <ValueExpression>

                  <Value Type="UnsignedInteger">34246</Value>

                </ValueExpression>

              </SimpleExpression>

            </Expression>

            <Expression>

              <SimpleExpression>

                <ValueExpression>

                  <XPathQuery Type="UnsignedInteger">EventDisplayNumber</XPathQuery>

                </ValueExpression>

                <Operator>Equal</Operator>

                <ValueExpression>

                  <Value Type="UnsignedInteger">34247</Value>

                </ValueExpression>

              </SimpleExpression>

            </Expression>

            <Expression>

              <SimpleExpression>

                <ValueExpression>

                  <XPathQuery Type="UnsignedInteger">EventDisplayNumber</XPathQuery>

                </ValueExpression>

                <Operator>Equal</Operator>

                <ValueExpression>

                  <Value Type="UnsignedInteger">34248</Value>

                </ValueExpression>

              </SimpleExpression>

            </Expression>

            <Expression>

              <SimpleExpression>

                <ValueExpression>

                  <XPathQuery Type="UnsignedInteger">EventDisplayNumber</XPathQuery>

                </ValueExpression>

                <Operator>Equal</Operator>

                <ValueExpression>

                  <Value Type="UnsignedInteger">34249</Value>

                </ValueExpression>

              </SimpleExpression>

            </Expression>

            <Expression>

              <SimpleExpression>

                <ValueExpression>

                  <XPathQuery Type="UnsignedInteger">EventDisplayNumber</XPathQuery>

                </ValueExpression>

                <Operator>Equal</Operator>

                <ValueExpression>

                  <Value Type="UnsignedInteger">34250</Value>

                </ValueExpression>

              </SimpleExpression>

            </Expression>

          </Or>

        </Expression>

      </And>

    </FirstExpression>

    <SecondComputerName>$Target/Host/Property[Type="Windows!Microsoft.Windows.Computer"]/NetworkName$</SecondComputerName>

    <SecondLogName>Operations Manager</SecondLogName>

    <SecondExpression>

      <And>

        <Expression>

          <SimpleExpression>

            <ValueExpression>

              <XPathQuery Type="String">PublisherName</XPathQuery>

            </ValueExpression>

            <Operator>Equal</Operator>

            <ValueExpression>

              <Value Type="String">.NET app monitoring</Value>

            </ValueExpression>

          </SimpleExpression>

        </Expression>

        <Expression>

          <SimpleExpression>

            <ValueExpression>

              <XPathQuery Type="UnsignedInteger">EventDisplayNumber</XPathQuery>

            </ValueExpression>

            <Operator>Equal</Operator>

            <ValueExpression>

              <Value Type="UnsignedInteger">34243</Value>

            </ValueExpression>

          </SimpleExpression>

        </Expression>

      </And>

    </SecondExpression>

  </Configuration>

</UnitMonitor>