Metrics Limits

To ensure that metric information that is most relevant to your application displays, agents have limits for the number of metrics they can store. Different limits apply to app agents and machine agents:

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

  • For the Machine Agent, the default maximum number of registered metrics is 1450. This includes both basic hardware metrics and the expanded metrics available with Server Visibility

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. If necessary, you can increase the default limit.

When an agent attempts to register metrics, some metrics might be deemed invalid by the Controller. During this scenario:
  • Invalid metrics are temporarily counted in the unregistered metrics queue before registration.
  • After the Controller rejects them (due to limit hit), the agent blocklists and purges these invalid metrics.
  • Purged invalid metrics are removed from the agent metric collections and thus do not consume space in the AGENT_METRIC_REG_LIMIT.
  • This ensures that invalid metrics do not unfairly consume metric registration capacity.