---
title: Metric grouping issues (APM, browser, mobile)
source: https://docs.newrelic.com/docs/new-relic-solutions/solve-common-issues/troubleshooting/metric-grouping-issues
---

## Problem

For our APM, browser monitoring, and mobile monitoring features, there can be cases when an account or application is sending many individual [metric timeslice data points](https://docs.newrelic.com/docs/data-analysis/metrics/analyze-your-metrics/data-collection-metric-timeslice-event-data#timeslice-data) that could be better managed by grouping them together. We use the term **metric grouping issue** or **MGI** to describe this situation. When this occurs, the agent is sending unnecessarily large amounts of data to New Relic, which reduces the effectiveness of New Relic charts, tables, and reports.

Metric grouping issues occur most commonly with web transactions, especially if the name is based on URLs. They can also happen with other metrics reported by your application. For example:

-   If your application is crawling the Internet and each external call goes to a different domain
-   If your software dynamically generates temporary database tables every time you receive a request
-   If you are using [custom instrumentation](https://docs.newrelic.com/docs/agents/manage-apm-agents/agent-metrics/custom-instrumentation) that includes UUIDs, article names, or similar unique components

Any situation where a potentially infinite list of metrics can be created, rather than metrics being grouped effectively (as with controllers, permanent database tables, or specific external services) can become a metric grouping issue.

## Solution

By understanding what metric grouping is and how issues can arise, you can better understand how New Relic works with your application to group metrics effectively and help prevent metric grouping issues from occurring.

![ Before and after](https://docs.newrelic.com/images/solutions_screenshot-crop_metric-grouping.webp " Before and after")

Here's a "before" and "after" example of how metric grouping can help organize transactions, to help you more easily identify patterns with performance problems.

To help prevent metric grouping issues from occurring in your app:

1.  Check the [New Relic release notes](https://docs.newrelic.com/docs/release-notes) to verify you're running the latest version of the New Relic agent.
2.  If needed, [update your APM/mobile/browser agent](https://docs.newrelic.com/docs/agents/manage-apm-agents/installation/update-new-relic-agent) to the latest version.
3.  Wait a few minutes, then look at new data in the New Relic UI.
4.  Check/Query [`NrIntegrationError`](https://docs.newrelic.com/docs/data-apis/manage-data/nrintegrationerror/) for events with name `MetricCardinalityNearLimit`. The creation of these events happens when your app is getting near the cardinality limit.

If the problem persists, follow the procedures for your agent:

| Agent      | Preventing MGIs                                                                                                                                                                                                                                                                                                                         |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| All agents | Review the information about [what causes metric grouping issues](#cause).                                                                                                                                                                                                                                                              |
| Browser    | [Add URL groupings](https://docs.newrelic.com/docs/browser/new-relic-browser/configuration/url-whitelists-grouping-browser-metrics#adding).                                                                                                                                                                                             |
| Go         | Rename your [Go transactions](https://docs.newrelic.com/docs/agents/go-agent/instrumentation/instrument-go-transactions).                                                                                                                                                                                                               |
| Java       | See [Java metric grouping issues](https://docs.newrelic.com/docs/agents/java-agent/troubleshooting/resolve-metric-grouping-issues-java).                                                                                                                                                                                                |
| .NET       | Rename metrics with [`SetTransactionName`](https://docs.newrelic.com/docs/agents/net-agent/net-agent-api/set-transaction-name). For more information about using XML to add details, see [Name transactions](https://docs.newrelic.com/docs/agents/net-agent/custom-instrumentation/add-detail-transactions-xml-net#name-transactions). |
| Node.js    | Rename transactions with [Request API calls](https://docs.newrelic.com/docs/agents/nodejs-agent/api-guides/nodejs-agent-api#request-api).                                                                                                                                                                                               |
| PHP        | [Rename your PHP transactions](https://docs.newrelic.com/docs/agents/php-agent/frameworks-libraries/php-frameworks-integrating-support-new-relic#dev).                                                                                                                                                                                  |
| Python     | Rename your Python transactions with [`set_transaction_name`](https://docs.newrelic.com/docs/agents/python-agent/python-agent-api/set_transaction_name).                                                                                                                                                                                |
| Ruby       | [Rename your Ruby transactions](https://docs.newrelic.com/docs/agents/ruby-agent/api-guides/ruby-custom-instrumentation#naming-transactions).                                                                                                                                                                                           |

You can also edit and create metric normalization rules in the UI. For more details, see [Metric normalization](https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/ui-data/metric-normalization-rules).

## Cause [#cause]

Metric grouping issues occur when the granularity of metric names (most often web transaction names) is too fine, resulting in hundreds or thousands of different web transaction names for just a small number of code paths. A few major code paths may generate many different full URL paths to unique documents, articles, or page, etc., and if the unique element of the URL path is included in the transaction name, each of these common paths will have its own unique name.

**MGI example**

In this example, you have an application that lets users write articles on any subject and post them for other users to see. Your application has three main functions: add an article, search for an article, and display an article.

In order to improve search engine optimization (SEO), the "view article" code generates a unique URL to refer to each article. For example, the following URLs each refer to different articles in the example website:

````
http://example.com/article/view/How_to_Install_New_Relic
http://example.com/article/view/How_New_Relic_Saved_the_Day
http://example.com/article/view/Where_do_I_get_New_Relic
```

All three articles are different; they contain different content and their URLs are different. However, the code path that generates each article is the same: they all use the "view article" function.

Many web frameworks use this technique. They have a controller or route (in this case named `article/view`) as part of the URL. New Relic works to automatically identify these patterns and group similar routes together, to prevent metric grouping issues from occurring.

Without mechanisms for detecting controllers, the example application would send metrics for each individual URL requested by visitors to your site. If you have a million articles and your site is popular, in each minute there could be several thousand unique URLs visited. This produces a significant amount of additional data to be sent to New Relic for each [harvest cycle](/docs/accounts-partnerships/education/getting-started-new-relic/glossary#harvest-cycle), and the [APM <DNT>**Transactions**</DNT> page](/docs/apm/applications-menu/monitoring/transactions-page) would attempt to list thousands of unique URLs, resulting in metric grouping issues.

````

To monitor and improve your application performance, it's much more useful to know the average performance for a function (for example, viewing articles on your site) than how quickly each individual article is displayed. To prevent metric grouping issues, New Relic will normally show a single entry for that function (for example, `/article/view/*`) on the [APM **Transactions** page](https://docs.newrelic.com/docs/apm/applications-menu/monitoring/transactions-page).

This grouping gives you a much better idea of how much time was spent viewing articles, and allows you to easily spot any performance problems related to viewing articles. If these statistics were spread across hundreds or thousands of transactions, detecting trends, regressions, or performance improvements would be extremely difficult.

Each APM agent has distinct ways of detecting controllers and frameworks. Most are automatic, but a few require you to enable or disable options in a [config file](https://docs.newrelic.com/docs/agents/manage-apm-agents/configuration/configure-agent). You can also follow our recommendations to help prevent metric grouping issues from occurring.