• English日本語한국어
  • Log inStart now

Use workloads

To view workloads, go to one.newrelic.com and find them on the Explorer. There are three main tabs (Health, Activity, and Owner) plus the header.


The Health tab in a workload provides relevant status data that helps you operate the workload: It shows the global status of the workload, as well as the individual status of all the entities that make up the workload at each point in time. It looks like this:

It comprises the following:

  1. The navigator view shows the entities that make up the workload, and provides controls to group and sort them. If you’ve used queries to dynamically select entities, the workload entities will change over time.
  2. The workload status informs about how your workload is performing, based on the individual alerting status of the entities in your workload. With health over time you’ll see whether and how the workload status has changed in the past three hours.
  3. If one or more entities are alerting, you’ll get a count of criticals and warnings and a summary of the open conditions, which will make it easier to identify and troubleshoot the most important issues.


The Activity tab shows performance data related to the entities in the workload, along with the events that could explain any changes in those time series. It looks like this:

Here are the most important sections:

  1. Linked dashboards. You can add links to dashboards from your workload, and create pre-filtered, workload-relevant links to dashboards.
  2. Golden metrics. These are charts with the most relevant 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). The golden metrics that you see for each entity type on a workload can be customized either at the account or the workload level through the NerdGraph API.
  3. Events timeline. This includes the start and end time of incidents and anomalies that refer to the workload entities. It also shows other event types that can explain a change in the status or performance of the workload, such as deployments and configuration changes.


The Owner tab gives you information about the team responsible for the workload. It looks like this:

It contains:

  1. The team responsible for the workload. You can include more than one team.
  2. The workload description. Share the mission of the workload, and the business logic it represents: Is it a web application? An API? A backend process? Fill in any details that are relevant to your team, or to other teams in your organization.
  3. Contact information. From the drop-down menu, choose how your team prefers to be contacted.
  4. Links to the most relevant resources to operate the workload. Here you can add links to runbooks, code repositories, productivity tools, or anything else related to the workload that you need at hand.

The header contains the filter bar and the edition controls:

  1. Filter bar. Use the advanced filtering options when you need to focus only on certain entities within the workload.
  2. Edit workload. Define the entities that are part of the workload, and the accounts they’ll be fetched from.
  3. Setup status. Configure how the global workload status will be determined, based on the workload entities health.
  4. Summary page. See all the tags that have been added to the workload, as well as metadata such as the workload's identifier (GUID) and account.

You can create workloads that update dynamically by leveraging tags. To learn how, watch this short video (approx. 3 minutes).

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.

one.newrelic.com > Explorer > Workloads > Create a workload: When you create a workload, you choose the associated accounts and monitored entities.

You can use the UI or the NerdGraph API to create a workload. Follow these steps to create a workload using the UI:

  1. Go to one.newrelic.com and click on the Explorer, and then click + Create a workload.

  2. Give the workload a name that will be meaningful for you and your team later.

  3. From the Select an account dropdown, select the workload account you'd like to use.

  4. Click Choose the scope accounts to check all of the accounts related to this workload.

  5. Find and choose the entities that make up the workload. When you have the results you're looking for, you can add specific entities or add the query to dynamically update the entities in the workload.

    • You can search by entity type, tags, or attributes (like entity name, account ID, and AWS region).
    • Click + Add this query to create a list of dynamically updated entities for your workload. We recommend this if you want your workload to update its entities as your system changes.
    • Click + Add next to an entity to add it to your workload. This is a good choice if you know that the entities will stay useful even as your system changes.
  6. You can add a combination of queries and specific entities to the workload, which combine according to the query logic.

  7. Click Create a workload to save the workload. Once you've created the workload, you can edit it at any time

If your workload contains one or more dashboards, you can set filters on those dashboard links.

Below are more details about some aspects of how to define workloads:

View workloads maps

You can view a topological map that displays how your workloads relate to and affect one another.

To access workloads maps:

  1. Go to one.newrelic.com, then select All capabilities.
  2. Click the Workloads tile.
  3. In the top pane, click Maps.

To learn more about our omnimap-powered maps capabilities, see Maps in context.

Use the API

You can query, create, and update workloads with our NerdGraph API.

Copyright © 2023 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.