Workloads in New Relic One: Isolate and resolve incidents faster


In New Relic, a workload is represents a group of entities that work together to provide a digital service. New Relic One gives you the ability to group and monitor entities based on a team or a set of responsibilities, from front-end to back-end services, across your entire stack.

Workloads help you get understanding of a complex system, detect issues, understand the cause and impact of an incident, and resolve things quickly.

This feature is currently in beta.

What is a workload in New Relic?

New Relic monitors a wide range of entities and data, from client-side applications and back-end APIs, to the underlying infrastructure. To make sense of this large data set, New Relic One gives you the ability to create and monitor workloads. A workload represents a group of entities that work together to provide a digital service.

Here are some examples of workloads:

  • A serverless application that includes: an API gateway, a few serverless functions, and a managed database and storage.
  • A browser application and the back-end APIs that support it.
  • A collection of Java microservices and the infrastructure they run on.

Here's an example of a workload including a group of entities that provide a digital service:

New Relic workloads UI > Workloads > (selected workload): The workloads UI provides a curated view of how the entities in your workload are performing. The charts you see will depend on the types of entities you've included to the workload.

Workloads give you visibility into the end-to-end availability and consumption of resources across an entire service, and give you a way to define what’s relevant to you. You can use workloads to group together entities that are important to a specific team or project, so you can better browse and isolate the most relevant data for that service.

Because New Relic One gives you cross-account access, you can add entities to your workload from any account you have access to.

A workload can include:

  • Any New Relic-monitored entity, including services, browser apps, mobile apps, databases, and hosts.
  • New Relic One dashboards.
  • Other workloads, useful for complex teams who need to divide and overlap workloads.


Requirements for creating and managing workloads include:

  • All users for an account can view that account's workloads.
  • To create, edit, and delete workloads, you must be an Owner, Admin, or Workloads manager.

The workload UI

To view workloads: Go to and select the Workloads launcher. Select a specific workload to visualize it.

New Relic One workloads - numbered screenshot
Important components in the New Relic One workload UI.

These are some important components of the workload UI (corresponding to screenshot above):

  1. The overview. The Overview tab shows the most relevant entity performance and alert data that you need to operate the workload.
    1. View of workload components. This is useful for understanding the workload’s architecture, especially if the workload’s entities change over time because they are dynamically defined.
    2. Important charts. These are charts with key metrics for each entity type, such as number of requests, response time and error rate for an application. Explore the charts to detect correlations among different entities (for example, two applications) and different stack layers (for example, applications and hosts).
    3. Open violations. You can filter the workload to only the alerting entities to make it easier to troubleshoot the most important issues.
    4. Linked dashboards. You can add links to dashboards from your workload, and create pre-filtered, workload-relevant links to dashboards.
  1. List of entities. Select the Entities tab to see the entities that make up the workload. If you’ve used queries to dynamically select entities, the entity list will change over time.
  2. Edit workload. Edit the workload to define which entities are part of the workload, and to link dashboards to the workload.

Create a workload

A workload should contain the entities you and your team want to see. Your choice of entities depends on your organization structure and goals.

To create a workload:

  1. Go to and select the Workloads launcher.
  2. Select Create workload.
  3. From the Select the account dropdown, select the account the workload data will be attached to. For more about this, see Workload account.
  4. Choose the entities that make up the workload. For the best experience, we recommend using 500 or fewer entities. You can add entities in two ways:
    • Use a dynamic query. You can construct a query by choosing entity types (including dashboards), tags, and attributes (like app name, account ID, and AWS region). The workload dynamically updates its entities as your system changes. To save your query, construct it in the workload search bar, and then click Save this query. For more information, see Query logic.
    • Select specific entities. Adding specific entities is a good choice if you know those specific entities will remain useful to you. To add entities, use the search bar to return the entities you want and then click Add.
  5. Save the workload.

Once you finish creating a workload that contains one or more dashboards, you can set filters on those dashboard links.

Use tags to define the workload content

You can query and select workload entities using both tags and attributes. Therefore, to optimize your use of workloads, it helps to have a good entity-tagging strategy. We recommend reading the tagging documentation.

Query logic for dynamically selecting entities

In the workload search bar, you can add a multi-part query to define a workload. Query rules include:

  • Clauses in a single query are combined with an AND operator.
  • Separate queries are combined with an OR operator.

Add dashboards to workloads

If you have custom dashboards and you already know which data is relevant to your team for observing and operating their workloads, you can link those dashboards from your workload. You can also set filters on dashboards to scope them to a workload-specific context. When a user selects that dashboard from the workload, it opens with the filter already applied.

New Relic One workloads - add dashboards > Workloads: You can add dashboards to a workload.

To add dashboards to a workload:

  1. When creating or editing a workload, type Dashboard in the workload search bar to filter to dashboard entities.
  2. Add other search terms to filter to specific dashboards.
  3. Click Add.

To filter a workload’s dashboard:

  1. From a workload’s Overview page, select a dashboard.
  2. Add search terms to filter the dashboard to a view that’s relevant for that workload.
  3. Select Save filter for this workload.

The workload account

When creating a workload, you must choose a workload account. The workload account is the account where the workload lives. Even though workloads can query and display data from multiple accounts, there must be a primary account associated with the workload.

Impacts of choosing the workload account include:

  • The workload account dictates the permissions for which users can see that workload.
  • If you want to add a workload to another existing workload, you can find that workload by searching by its associated account.
  • The workload account is where any workload-specific data is stored. For example, a workload might generate NrAuditEvent data, and you can find that data by querying the workload account.

For how to find a New Relic account's ID, see Account ID.

For more help

Recommendations for learning more: