This page applies to an earlier version of the AppDynamics App IQ Platform.
For documentation on the latest version, see the 4.4 Documentation.

On this page:

Your Rating:
16 rates

AppDynamics agents instrument the transactions flowing through your application and report metrics to the Controller. 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 per machine agents, as follows:

  • For an app agent, the default maximum number of registered metrics is 5000.
  • For a machine agent, the default maximum number of registered metrics is 200.

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. Use caution when increasing the metric registration limits. Increasing the limit can increase the resource overhead for agents and Controller.

On Java

On Java platforms, 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 300 as follows: 

nohup java -Dappdynamics.agent.maxMetrics=300 -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

The maximum number of registered metrics for a single Controller across all agents is 2 million by default.

This limit is controlled by the metric.registration.limit property. You can view or modify the property in the Controller Properties page in the Controller Administration Console.


  • No labels