This page applies to an earlier version of the AppDynamics App IQ Platform.
See the latest version of the documentation.

Skip to end of metadata
Go to start of metadata

On this page:

To ensure that you see the metric information that is most relevant to your application, agents operate under a few limits. Different limits apply to app agents and machine agents, as follows:

  • For an app agent, the default maximum number of registered metrics is 5000.
  • For the Standalone Machine Agent, the default maximum number of registered metrics is 450 (this default was reduced from 1800 in version 4.2.4). This includes both basic hardware metrics and the expanded metrics available with Server Monitoring.

If the limit is reached, an error event is generated of type AGENT_METRIC_REG_LIMIT_REACHED with a summary of "Metric registration limit of n reached."  No new metrics are created until the agent restarts. You can increase the default limit if necessary, as described next. 

Modifying Metric Limits Per Agent

You can increase or decrease the default metric registration limits for machine agents or app agents. 

Changing these limits can affect the resource consumption of your deployment. Before you change this setting verify your application environment and Controller can handle the increased resource requirements.

For the Java agent, modify the limit using the agent.maxMetrics system property. For example, to increase the machine agent metric limit specify the maximum number of metrics as an argument when starting the machine agent in the following format:


For example, when starting the machine agent, increase the maximum number of metrics that can be registered to 2000 as follows: 

nohup java -Dappdynamics.agent.maxMetrics=2000 -jar machineagent.jar &

For the .NET Agent, set the maxMetrics property as an environment variable. This setting only affects the app agent. For example:


For the .NET Machine Agent, specify the maximum number of metrics using the Metrics element in the config.xml. See "Machine Agent Element" on .NET Agent Configuration Properties . See also Administer the .NET Agent.

<metrics max-metrics="300"/>

Modifying Global Metric Limits

For an on-premise Controller, you can view and modify the property that controls the metric registration limit (metric.registration.limit) in the Controller settings page in the Controller Administration Console. The default maximum for an on-premise Controller across all agents is 2 million. 


  • No labels