• /
  • Log in

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's 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.

Finally, 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.

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.

New Relic One - workload creation UI

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

You can use New Relic One 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:

Use the API

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

For more help

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

Create issueEdit page
Copyright © 2021 New Relic Inc.