Knowledge Base

cancel
Showing results for 
Search instead for 
Did you mean: 

Advanced Metric Prefix Configuration Scenarios for AppDynamics Monitoring Extensions

The purpose of this document is to list out the possible configuration scenarios for the Machine Agent and SIM and App Agents, and their impact on an extension and its configurations. 

 

Table of Contents

APM Machine Agent Installation

Independent Machine Agent Installation

SIM with No App agents

SIM with one or more app agents

 

APM Machine Agent Installation

This case is when a Standalone Machine Agent (MA) is configured on the same host as one or more App Agents. For more details, please check APM Machine Agent Installation Scenario.

 

In this case, if app, tier and node names are NOT specified in the MA configuration, the MA will be resolved to all the APM app, tier and node associated on that host. So, if in the extension's configuration metricPrefix is configured as metricPrefix="Custom Metrics|Sample Monitor" all the Custom Metrics from the extension will be replicated under all the APM metric browsers associated to that host. 

 

If the requirement is to see the Custom Metrics under a particular application only, this can be done by specifying metricPrefix = "Server|Component:<ID or Name>|Custom Metrics|Sample Monitor" 

 

To find the Component ID, please refer to Configuring an Extension. In this case, the Custom Metrics from the extension will show up only in the Metric Browser of the application to which the Component ID (tier) belongs. 

 

IMPORTANT: The Component ID specified in the metric prefix of the extension should match to one of the resolved tiers of the MA. The extension cannot report to any tier other than any of the resolved tiers of its MA.  

 

Independent Machine Agent Installation

An independent Standalone Machine Agent without any APM Agents is not supported by AppDynamics. There have to be App Agents running on the same host for the MA to run in Standalone mode. If the requirement is to use extensions without any APM Agents, a Server Visibility license needs to be purchased. Please check the SIM with No App agents scenario.

 

SIM with no App Agents 

In this case, metricPrefix should be configured as metricPrefix = "Custom Metrics|Sample Monitor"

 

However, as mentioned in the APM Machine Agent Installation Scenario, if the requirement is to see the Custom Metrics from the extension under a particular application only, this can be done by following the steps mentioned below:

       1. The app, tier and node name need to be specified in the controllerInfo.xml. 

       2. In the extension's configuration, the metricPrefix should be configured as

           metricPrefix = "Server|Component:<ID or Name>|Custom Metrics|Sample Monitor" 

 

IMPORTANT: The component ID specified in the metric prefix of the extension should match to the tier specified in the controller-info.xml. The extension cannot report to any tier other than the tier pointed by the SIM agent.

 

SIM with one or more App Agents

In this case, metricPrefix should be configured as metricPrefix = "Custom Metrics|Sample Monitor"

 

All the Custom Metrics from the extension will be replicated under all the APM metric browsers associated to that host. If the requirement is to see the Custom Metrics under a particular APM application only, this can be done by specifying:

metricPrefix = "Server|Component:<ID or Name>|Custom Metrics|Sample Monitor" 

 

To find the Component ID, please refer to Configuring an Extension. In this case, the Custom Metrics from the extension will show up only in the Metric Browser of the application to which Component ID (tier) belongs. 

  

IMPORTANT: The host ID field helps the Controller to stitch the metrics from the Machine Agent or SIM Agents and App Agents together. This host ID field, by default, has the system hostname value. However, this can be overridden by using the uniqueHostId field on the agents.

Version history
Revision #:
8 of 8
Last update:
‎01-15-2019 04:59 PM
Updated by:
 
Labels (1)