Infrastructure subscription usage

Important

This doc is for accounts on our original Product-based pricing. If you're on the newer pricing plan, see New Relic One pricing plan. Not sure which you're on? See Overview of pricing plans.

For accounts on our original pricing plan, this document explains how we calculate billable usage for Infrastructure accounts. This document also provides available subscription usage attributes and example NRQL queries to use in the New Relic UI or with API calls.

Data generation

Once per day, a New Relic Infrastructure account will generate an NrDailyUsage event for every unique host on which an application instance existed over the last 24 hours. All Infrastructure events have a productLine attribute value of Infrastructure. For more information, see query examples.

Usage calculation

Monthly billable CUs for a host are calculated by the size of the host running Infrastructure (number of CPUs + GBs of RAM) multiplied by the number of hours the host is connected to New Relic during that month. For more on how this is calculated, see CU-based pricing.

If your usage is fairly steady over time, you can estimate usage for the current month.

Tip

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

To view usage information in the UI:

Go to the usage UI.
On the Infrastructure usage page, set the time picker to Last 30 days.
Multiply the Avg daily compute units by the number of days in the current month.

For more information about the usage UI, see Introduction to subscription usage data.

Table definitions

Here are definitions of the column headers displayed in the UI table and CSV files. The columns displayed 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 parent account or a customer partnership.
Account ID	New Relic account ID.
Agent hostname	The name of the host, as reported by the agent. For more about this value, see `agentHostname`.
Average daily compute units	The average daily compute units used.
% of total usage	The percentage of the total usage used.

General attributes

The following are general (not Infrastructure-specific) account-related attributes. These attributes can help you understand how your accounts are using New Relic products.

Attribute	Description
`consumingAccountId`	ID of the New Relic account that is directly responsible for the stored events, as determined from the license key used.
`consumingAccountName`	Name of the New Relic account that is directly responsible for the stored events, as determined from the license key used.
`masterAccountId`	The ID of the parent account that is either responsible for stored events or that is the parent of the consuming account. When a parent account is the consuming account, `masterAccountId` is the `consumingAccountId`. This attribute is present even for accounts that do not have a parent account. This is to ensure continued reporting if the account is later made a parent account.
`masterAccountName`	Name of the parent account that is either responsible for stored events, or that is the parent of the consuming account. When a parent account is the consuming account, `masterAccountName` is the `consumingAccountName`. This attribute is present even for accounts that do not have a parent account. This is to ensure continued reporting if the account is later made a parent account.
`partnershipId`	Partner ID of the New Relic customer partnership associated with the account responsible for the stored events. This attribute is only present if the consuming account is associated with a New Relic customer partnership.
`partnershipName`	Name of the New Relic customer partnership associated with the account responsible for the stored events. This attribute is only present if the consuming account is associated with a customer partnership.
`subAccountId`	ID of the child account that is responsible for the stored event. When this attribute is present, `subAccountId` is the `consumingAccountId`. This attribute is only present if the consuming account is a child account (not a parent account).
`subAccountName`	Name of the child account responsible for stored events. When present, this attribute is the same as the `consumingAccountName`. This attribute is only present if the consuming account is a child account (not a parent account).
`timestamp`	UNIX timestamp (seconds since epoch) of the day and time when event generation was initiated.

Infrastructure attributes

The following are usage-related attributes generated by Infrastructure. To query this data, use a productLine attribute value of Infrastructure.

Attribute	Description
`agentHostname`	ID used to uniquely identify the host for which this usage is reported. Any given hour of usage for this host will be counted only once when calculating `infrastructureHoursUsed`. There are several possible host identifiers reported by the New Relic agent. The usage reporting system will always use the agent-reported hostname to uniquely identify the host for the Infrastructure product, but will also record the `cloudInstanceId`, if present, for informational purposes.
`cloudInstanceId`	ID uniquely identifying the cloud host instance (example: an AWS EC2 instance) for which this usage is reported. (For example, for an AWS EC2 instance, the value would look like `i-1234abcd5678ef900`.) This will not be present if no cloud provider was detected by the agent.
`cloudInstanceSize`	Size of the cloud instance for this host for CU billing purposes, as calculated according to the formula for `infrastructureBillingInstanceSize`, using the CPU and memory sizes associated with the instance type defined by the cloud provider. Will not be present if no cloud provider was detected by the agent.
`cloudInstanceType`	Instance type of the host as defined by the cloud provider and detected by the agent. For example: `c4.2xlarge`. This will not be present if no cloud provider was detected by the agent.
`cloudProvider`	Name of the cloud provider for this host. Example values: `aws`, `azure`. This will not be present if no cloud provider was detected by the agent.
`cloudZone`	Name of the zone that a cloud provider host is located in. For example: `eu-central-1b`. This will not be present if no cloud provider was detected by the agent.
`infrastructureAgentVersion`	Version of the Infrastructure agent running on the host reporting this usage. If multiple agents are reporting from the same host, the version from the first agent seen in a given hour will be used.
`infrastructureAgentMemoryBytes`	Bytes of RAM available to the host, used to calculate `infrastructureBillingInstanceSize`.
`infrastructureAgentProcessorCount`	Number of logical CPU cores available to the host, used to calculate `infrastructureBillingInstanceSize`.
`infrastructureCloudDerivedMemoryBytes`	Bytes of RAM available to the host, as reported by the cloud provider, used to calculate `infrastructureBillingInstanceSize`.
`infrastructureCloudDerivedProcessorCount`	Number of logical CPU cores available to the host, as reported by the cloud provider, used to calculate `infrastructureBillingInstanceSize`.
`infrastructureBillingInstanceSize`	Size of the host, for CU billing purposes. Calculated as: number of processors multiplied by memory in GiB.
`infrastructureHoursUsed`	Number of hours for which usage was recorded for the given host. When a host is connected to New Relic for any amount of time within a given hour, that hour is counted toward usage.
`infrastructureComputeUnits`	Number of compute units (CUs) recorded for the given host. CUs are calculated as: `infrastructureHoursUsed` multiplied by `infrastructureBillingInstanceSize`. For more about compute unit calculation, see CU pricing.
`infrastructureComputeUnitRule`	Describes the algorithm used to calculate the host size for CU usage. Values include: `agent_collected_calculated_data`: Use the host size data collected by the agent from the OS environment. `cloud_provider_data`: Use the host size data from the cloud provider. `missing_data`: Some host size data was missing. This could be due to an agent and operating system combination for which CPU and memory sizes are not supported. This will result in the default host size (16) being applied.
`instanceSizeCapped`	This is `True` if the calculated host size was greater than 16 and therefore capped.
`missingCpuData`	`True` if the Infrastructure agent reports no CPU count.
`missingRamData`	`True` if the Infrastructure agent reports no memory count.
`productLine`	The New Relic product the usage data is from. Always use the value `Infrastructure` when querying for Infrastructure usage data.
`usageType`	The type of entity this event records values for. This value is `Host` for Infrastructure.

Query examples

Here are some examples of NRQL queries you can use with your Infrastructure subscription usage data. You can run NRQL queries, and use the resulting charts in dashboards.

For general information about how to use NRQL queries to get focused usage data, see Intro to usage data.

This query produces a count of the CUs used over the last month:

SELECT sum(infrastructureComputeUnits) 
FROM NrDailyUsage 
WHERE productLine='Infrastructure' 
AND usageType='Host' 
SINCE last month 
UNTIL this month

This query reproduces as closely as possible the report you would have gotten by downloading the CSV from the previously available Infrastructure subscription usage UI:

FROM NrDailyUsage 
SELECT consumingAccountId 
AS 'Account ID',agentHostname,cloudProvider 
AS 'Host provider', cloudInstanceType 
AS 'Instance type',infrastructureBillingInstanceSize 
AS 'Instance size',infrastructureHoursUsed 
AS 'Hours used',infrastructureComputeUnits 
AS 'Usage (CU)', infrastructureCloudDerivedMemoryBytes/(1024*1024*1024) 
AS 'Total RAM',infrastructureCloudDerivedProcessorCount 
AS 'Logical processors',infrastructureAgentMemoryBytes/(1024*1024*1024) 
AS 'Total RAM',infrastructureAgentProcessorCount 
AS 'Logical processors',infrastructureComputeUnitRule 
AS 'Business rule',missingCpuData, missingRamData, instanceSizeCapped,cloudZone,cloudInstanceId 
WHERE productLine='Infrastructure' 
AND usageType='Host' 
SINCE 1 day ago 
LIMIT 1000

This NRQL query is different than the legacy usage report:

Detailed host query	Comments
Time period	This query includes only the last day of usage. To see the usage aggregated over a longer time period, change the SINCE clause.
Results limited to 1000	NRQL limits the results to 1000. If you have more than 1000 hosts and want to get the complete set of hosts, you can narrow your query with more `WHERE` clauses to return subsets of the data (for example, `WHERE agentHostname LIKE ...` to divide the data into groups).
Business rule	`Business rule` has been replaced with two attributes: `infrastructureComputeUnitRule` defines how the size of the host was calculated, depending on what data was available from the agent. It no longer describes whether the agent needs to be updated to provide more accurate host naming in a container environment (`update_agent_for_container_environment`). `missingCpuData`, `missingRamData`, and `instanceSizeCapped` are now boolean flags describing what the value `missing_data` means when it is present in the `infrastructureComputeUnitRule` attribute.

Detailed host query

Comments

Time period

This query includes only the last day of usage. To see the usage aggregated over a longer time period, change the SINCE clause.

Results limited to 1000

NRQL limits the results to 1000. If you have more than 1000 hosts and want to get the complete set of hosts, you can narrow your query with more WHERE clauses to return subsets of the data (for example, WHERE agentHostname LIKE ... to divide the data into groups).

Business rule

Business rule has been replaced with two attributes:

infrastructureComputeUnitRule defines how the size of the host was calculated, depending on what data was available from the agent. It no longer describes whether the agent needs to be updated to provide more accurate host naming in a container environment (update_agent_for_container_environment).
missingCpuData, missingRamData, and instanceSizeCapped are now boolean flags describing what the value missing_data means when it is present in the infrastructureComputeUnitRule attribute.

This query is useful for seeing the account hierarchy (partnership, parent accounts, child accounts).

SELECT count(*) 
FROM NrDailyUsage 
FACET partnershipName,masterAccountName,masterAccountId,consumingAccountName,consumingAccountId 
LIMIT 1000 
SINCE 1 day ago

For more help

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

Browse the Explorers Hub to get help from the community and join in discussions.
Find answers on our sites and learn how to use our support portal.
Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
Review New Relic's and and documentation.

Important

Data generation

Usage calculation

Tip

Table definitions

General attributes

Infrastructure attributes

Query examples

Compute units for last month

Detailed host report (reproducing old usage report)

Account hierarchy

For more help

Infrastructure subscription usage

Important

Data generation

Usage calculation

Tip

Table definitions

General attributes

Infrastructure attributes

Query examples

Detailed host report (reproducing old usage report)

Account hierarchy

.css-3u3y73{fill:none;stroke:currentColor;stroke-width:2;stroke-linecap:round;stroke-linejoin:round;}.css-1bvd50p{width:1rem;height:1rem;fill:none;stroke:currentColor;stroke-width:2;stroke-linecap:round;stroke-linejoin:round;}For more help

For more help