Knowledge Base

Showing results for 
Search instead for 
Did you mean: 

How to resolve an error when reaching the agent metric registration limit


When an agent tries to register more than 5000 metrics, it will fire the error below to the Controller. The default limit is 5,000 and once it has been met, the agent will not register new metrics. Mostly seen when users try to register Custom Metrics with incorrect configurations.





Follow the steps below to resolve this error message:


1. First control the metric registration limit from the agent side after deleting the unwanted businesss transactions, information points, service endpoints and backends. You can then try reseting the agent.


2. If all of the metrics are still required, you can increase the agent metric registration limit using the system property below and restarting the agent.




1. There is a reason why we have these limits.Be careful when increasing the metric registration limit. Before doing so, check your current CPU and memory utlization from the application side. A drastic increase of agent limit can affect the Controller.

2. Identify which metrics are registered, and focus only on relevant metrics. Increasing the limits everytime you encounter this error is not the solution. 

Version history
Revision #:
4 of 4
Last update:
3 weeks ago
Updated by:
Labels (1)
0 Kudos