Knowledge Base

cancel
Showing results for 
Search instead for 
Did you mean: 

How do I resolve an error when reaching the agent metric registration limit?

What should I consider when resolving agent metric registration limits?

 

Table of Contents

 

Issue

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 per session and once it has been met, the agent will not register new metrics. 

 

NOTE: A new session begins at the last restart 

 

This error is most often seen when users try to register Custom Metrics with incorrect configurations that consume the metric limit.

 

AGENT_METRIC_BLACKLIST_REG_LIMIT_REACHED

 

Solution

To resolve the AGENT_METRIC_BLACKLIST_REG_LIMIT_REACHED error message:

  1. First, delete unwanted business transactions, information points, service endpoints, and backends.

  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.

    -Dappdynamics.agent.maxMetrics=<IntegerNumber>

    Use caution when changing a metric registration limit. A drastic increase in the agent limit can affect the Controller.

    It is highly recommended that you check your current CPU and memory utilization from the application side before increasing the metric registration limit.
  1. Restart the agent.

Note: Identify which metrics are registered, and focus only on relevant metrics. Increasing the limits every time you encounter this error can cause serious performance issues.

 

FAQs

How can we find the custom metric with an incorrect configuration?

There is no single place to look for an incorrect configuration of the custom metric. If you find you’re hitting the backend limit, check the backend configuration. Similarly, if you’re exceeding limits in SEP, BT, etc, look in those places for how you might adjust or reconfigure them to bring your numbers down.

 

When increasing the maximum metric size, how can we anticipate how large the increase to higher CPU utilization will be?

Increasing the maximum metric size can cause high CPU utilization, but only at a very high value. The Controller also has a metric limit of 1M per Controller application, including all its tiers and nodes. 

 

As a rule of thumb, things should work fine if you keep below 1M per Controller.

 

Can utilization of the main Controller also be affected by configuration?

If the Controller application metric limit is exceeding limits even after you've increased those limits, then the Controller level can also experience issues as a result.

Version history
Revision #:
9 of 9
Last update:
‎01-17-2020 05:15 PM
Updated by:
 
Labels (1)


Found this article helpful? Click the Thumbs Up button.
Have an additional comment? Post it below.
Comments

Regarding this matter, we have an extra large Appdynamics setup and we are finding many metric reg limit exceeded.

The question, reading your manuals is:

Which most common errors can be seen as incorrect, that produces exceeded limits?

Thanks for your kind answer.

@Fernando.Villava The limit you are seeing here is the agent side limit so the agent will send or register up to 5000 metrics to the controller and after that, if you are trying to register any BT, Backend, SEP agent will not register those metric to the controller UI.

and you will see the agent limit reached message on agent logs as well on controller UI.

 

Now there are so many reasons for reaching the limit

1) You are monitoring so many BT's and due to that agent is reaching the limit.

2) You are creating so many backends due to that you are reaching the limit.

3) You are registering too many mbean from the same node due to that you are reaching the limit.

 

 

How to resolve 

1) If you have sufficient heap space and your CPU utilization is normal you can increase the agent metric registration limit using below mentioned property

 

-Dappdynamics.agent.maxMetrics=<IntegerNumber>

 

2) You can group you BT/backend in one backend/BT so you can control the metric limit

 

https://docs.appdynamics.com/display/PRO45/Backend+Detection+Rules#BackendDetectionRules-all_other_t...

 

 

https://docs.appdynamics.com/display/PRO45/Business+Transactions#BusinessTransactions-RefineBusiness...

 

Regards,

Rajendra

 

 

 

 

 



Found this article helpful? Click the Thumbs Up button.
Have an additional comment? Post it below.