Get started with organizing your applications

To get started with New Relic APM, we're going to take you through the basics to manage your application. The first thing you need to do is see what's happening in your application. To do this, you'll need to install our agent in your environment. Then, you can put that data to work and improve your application's performance.

Viewing individual application performance is useful, but it's even more helpful to see data quickly for the ones you care about the most. You can add multiple applications and services to your New Relic account, and monitor their performance from the user interface. Let's organize your applications so that you can easily find them and quickly view performance trends for them.

Organize your applications

By creating labels with meaningful categories, and then rolling up your applications into the categories, you can identify useful groups. For example, you can create a label for Environment with different values for each environment (Environment:Test, Environment:Staging, Environment:Production, etc.). Then, after you assign labels to your applications, you can easily find, view, and compare only the ones that are meaningful to you.

Before we start, watch this video (5:44 minutes).

Try this! Create a label

Let's get started. To create a label:

  1. Go to
  2. At the top of the APM index page, click Show/Hide labels to turn it On.
  3. To add a new label, select the plus icon by the application's name. Type the category name, a colon :, and the value (for example, Environment:Production), then press Enter or Return.
  4. Select the plus icon by another application's name. Type the same category name, a colon :, and the value (for example, Environment:Production), then press Enter or Return.
Try this! View your applications by category

Now that you have two applications organized into your Production category, you can search and filter just those applications. For example:

  1. Go to
  2. At the top of the APM index page, click the search box, then select Roll up by > Environment:Production.

When you have many applications reporting to New Relic, the ability to search and filter by meaningful labels will become increasingly important. In addition, after you create alert policies, you will also be able to see the comparative health status for categories (and the applications within the categories) at a glance.

Learn more about labels

Want to learn more about planning, creating, and managing all your categories of labels? For more information, see the labels documentation, including agent configuration file options.

In addition, for multiple labels, you may want to use the REST API. Watch the New Relic University tutorial, Manage categories and labels with the REST API, for a step-by-step guide about using the REST API Explorer to manage multiple categories and labels.

What's next

Now that you have successfully organized your applications with labels, let's get started with creating alert policies and conditions. This will ensure you get notified if something goes wrong.

For more help

If you need more help, check out these support and learning resources: