Synthetics 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 Synthetics 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

A New Relic Synthetics subscription level is based on the number of non-ping monitor checks used during a calendar month. Once per day, every Synthetics monitor location will generate an NrDailyUsage event for every monitor type. This event will summarize Synthetics usage for that location and monitor type over the last 24 hours.

All Synthetics usage events have a productLine attribute value of Synthetics. For more information, see the Synthetics query examples.

Usage calculations

A New Relic Synthetics subscription level is based on the number of non-ping monitor checks used during a calendar month. If your monitor checks are fairly steady over time, you can estimate the current month's eventual usage.

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 Synthetics usage page, set the time picker to Last 30 days.
Multiply the Avg daily paid checks by the number of days in the current month.

The Synthetics usage chart displays the daily count of monitor checks. The table value Avg daily paid checks displays the total number of monitor checks for the selected time period, divided by the number of days.

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

General attributes

The following are general (not Synthetics-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.

Synthetics attributes

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

Attribute	Description
`productLine`	The New Relic product the usage data is from. Synthetics data will have the value `Synthetics`. Use this value when querying Synthetics usage data.
`syntheticsFailedCheckCount`	Number of failed checks that ran on the given day for the given Synthetics monitor and location. Failed checks count toward subscription usage for Synthetics. Only checks with `syntheticsType` not equal to `SIMPLE` count toward billable subscription usage.
`syntheticsSuccessCheckCount`	Number of successful checks that ran on the given day for the given Synthetics monitor and location. Only checks with `syntheticsType` not equal to `SIMPLE` count toward billable subscription usage.
`syntheticsLocation`	Location the check ran in.
`syntheticsLocationLabel`	Human-readable label for the location of the check.
`syntheticsType`	The type of Synthetics monitor. Possible values: `SIMPLE`, `BROWSER`, `SCRIPT_BROWSER`, `SCRIPT_API`. For more information, see Monitor types.
`syntheticsTypeLabel`	Human-readable label for `syntheticsType`. Possible values: `Ping`, `Simple Browser`, `Scripted Browser`, `Scripted API`.
`syntheticsMonitorName`	Name of the monitor.
`syntheticsMonitorId`	Unique ID of the monitor.
`usageType`	The type of entity for which this event records usage data. This value is `Check` for Synthetics.

Query examples

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

This query produces a chart of the billable monitor checks over the last month. Remember that a syntheticsType of SIMPLE refers to a ping monitor, which doesn't count towards paid usage.

FROM NrDailyUsage 
SELECT sum(syntheticsFailedCheckCount) + sum(syntheticsSuccessCheckCount) 
AS 'Paid checks' where productLine='Synthetics' 
AND syntheticsType != 'SIMPLE' 
SINCE last month 
UNTIL this month

This is a non-product-specific query useful for seeing your 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 calculations

Tip

General attributes

Synthetics attributes

Query examples

Billable checks for the last month

Account hierarchy

For more help

Synthetics subscription usage

Important

Data generation

Usage calculations

Tip

General attributes

Synthetics attributes

Query examples

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