Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: CORE-52298


To create custom metrics, you create a monitoring extension. In your extension, you define the name and path of your metric (where it appears in the metric browser tree), what type of metric it is (sum, average, and so on), and how the data for the metric should be rolled up as it ages. One agent can run many extensions, although you may need to increase the amount of memory for the agent JVM if you do. See the section "JVM Memory Requirements in Standalone Machine Agent Requirements and Supported Environments for details. You can even have multiple copies of the same extension, if they are in different directories.

A custom metric can be common across nodes or associated with a specific tier. When you create a metric, you specify the path in which it will appear in the metric tree. To make a common custom metric, use the root tree path Custom Metrics in your metric declaration. To make a tier-specific metric, specify the metric path associated with that component. For details, see the topics on creating Java or script-based custom metrics listed below.   

If your application uses a large number of AppDynamics extensions with the 

Appd machine agent name
, you may need to increase the size of the memory allocation as follows:

Code Block
titleFor Linux and Unix-like systems
% <machine_agent_home>/bin/machine-agent -Xms64m
Code Block
titleFor Windows
> <machine_agent_home>\bin\machine-agent.cmd -Xms64m Note

Once you establish a metric, you can not delete the metric without access to the Controller database (on-prem) and cannot delete it at all (on SAAS). Therefore, when you want to add new custom metrics to your applications, try it first in one application in a test environment to confirm that everything is appearing satisfactorily. Then, when you are ready you can move to a production environment.

Types of Monitoring Extensions

You can implement custom metrics using the following mechanisms.