APM (host-based) subscription usage UI

For account owners and admins, New Relic provides a UI for understanding the subscription-related usage of New Relic products. This document explains how to view and understand the usage UI for New Relic APM with host-based pricing (not CU-based pricing).

For an introduction to New Relic usage data and how to use it, see Introduction to usage data.

View APM usage

Only the account Owner and Admins can view the usage UI. However, anyone in your account can query usage data using the NrDailyUsage Insights event.

To view your APM subscription usage data:

  1. From rpm.newrelic.com, select the account dropdown, and then select Account settings.
  2. Select Usage.
  3. Select APM usage.

Usage calculations

For host-based pricing APM, monthly billable usage is determined by the number of equivalent hosts used during that month. An equivalent host is defined as: 750 hours (standardized number of monthly hours) of connection to New Relic by a host or multiple hosts. For more on this calculation, see host-based pricing.

To get an estimate of the current month's billable usage:

  1. On the APM usage page, set the time picker to Current month.
  2. See the Avg daily equivalent hosts for an account or grouping of accounts.

The UI is meant to estimate your host usage but, especially for cloud environments, your usage may go up or down over time.

For a description of general usage UI features, see UI features.

Table definitions

Here are definitions of the column headers in the UI table and CSV files. The columns you see depend on the Group by option selected at the top of the page.

Header Definition
Account name The name of the account. This can be a standalone account, a master account or a customer partnership.
Account ID New Relic account ID.
Host ID The unique identifier for that host. If the host is in AWS, we use the AWS-provided instance ID. For other hosts, New Relic assigns a host ID. For more about how this value is created, see hostID.
Agent hostname The name of the host, as reported by the agent. For more about this value, see agentHostname.
Average daily equivalent hosts Average equivalent hosts for that day. Calculated as the total number of hours reported for all unique hosts in a day, divided by 24. For more on how this is calculated, see Host-based pricing.
% of total usage The percentage of the total usage used.

Query and retrieve data

For how to query and retrieve usage data, see Intro to usage data.

For a description of the usage data you can query in Insights for APM with host-based pricing, and example NRQL queries, see APM attributes and queries.

Use of Docker and other containers

Some previous New Relic APM agents may miscount containers as hosts, which may lead to over-reporting of host-based usage.

To fix this calculation for Linux-based containers (including Docker), upgrade your APM agent to these versions:

  • Go: 1.11 or higher
  • Java: 3.42.0 or higher
  • .NET: 6.19.330.0 or higher
  • Node.js: 2.1.0 or higher
  • PHP: or higher
  • Python: or higher
  • Ruby: or higher

For more help

Recommendations for learning more: