Connecting to New Relic
Connections are how CloudZero manages the various Cost Sources that bring Billing, Resource, and other types of data into the platform.
How the New Relic Connection Works
The CloudZero New Relic connection leverages the New Relic Query Language to pull your New Relic consumption data and combine it with New Relic rate information provided by you to calculate your New Relic spend. The connection will pull as many accounts as the New Relic API key has access to query. To pull all New Relic consumption data you will need to provide an API key associated with your New Relic parent account.
Create a New Relic connection
Open the Connections page
This can be found by selecting the gear icon from the sidebar and selecting Connections, or alternatively going to https://app.cloudzero.com/organization/connections
Navigate to the New Relic Connection Creation page
Select the Add New Connection button. Then select the New Relic tile.
Note: How to find information about your New Relic account
Some of the following metadata can be found in the Administration > Plan & Usage > Plan summary page of the New Relic app
Connection Metadata
- Connection Name: A connection name that will appear in the CloudZero UI
- Billing Account ID: Your New Relic parent account ID
- New Relic Account Region: the region your New Relic account uses (US or EU)
- API Key: a New Relic User API Key
To create this key navigate to the Administration > API Keys page
Hit the Create a key button and proceed to create a User API key
Note: API Key Account Access
The connection will pull data for all accounts available to the API key. If you would like to include data from all accounts please use an API key associated with your New Relic parent account.
Rate Information
Note: How to find New Relic rate information
Your rate information can be found in the Administration > Plan & Usage > Plan summary page of the New Relic app
- Subscription Term Start Date: The date you signed your contract with New Relic
- Data: The price you pay per GB of data ingested into New Relic
- Basic Users: The price you pay per Basic User (likely $0)
- Core Users: The price you pay per Core User
- Full Platform Users: The price you pay per Full Platform User
- Additional Synthetic Checks: The price you pay per Synthetic Check
Note: Tiered Pricing
Some New Relic pricing agreements can include rates that change depending on usage. If the amount you pay for Data, Basic Users, Core Users, Full Platform Users, or Additional Synthetic Checks changes based on your usage, please click the Add Tier button for the relevant fields and provide that information. Do not account for free usage with tiers. (e.g. first 100 GB per month is free)
Note: Recent Contract Changes
If your agreement with New Relic recently changed and you'd like to properly calculate old consumption data with your old agreement, please contact your CloudZero support representative.
Save the Connection
Select the Save button. You will be redirected back to the Connection Details page in the CloudZero platform, where you should see your newly created New Relic connection.
New Relic Connection Notes
Billing Period Ingest Windows
- Newly Created Connection: CloudZero will ingest the most recent 12 months worth of billing periods if available.
- Re-enabled Connection: CloudZero will attempt to ingest up to 24 months of billing periods starting from the current billing period and going back to the most recent billing period ingested.
- Steady State: CloudZero will ingest the current billing period and sometimes the previous billing period.
Event Data Ingest Usage Calculation (Beta)
New Relic provides data ingest usage accurately for usage metric groups, but can only provide estimated data ingestion figures for individual events. Data ingest usage with event granularity is calculated by assigning a portion of the total data ingest to each event where the ratio of the portion to the total data ingest is equal to the ratio of that event's estimated data ingest to the total estimated data ingest.
Tags
The New Relic connection includes 4 tags. The first tag, nr_cz:account_name, is the human readable name of the account associated with the usage. The second tag is nr_cz:entity_name, which is the name of the New Relic entity associated with the usage. The other two tags, nr_cz:service.name and nr_cz:service.namespace, coalesce various facets of New Relic event types. The following table maps each event type and facet field to the corresponding tag:
| Event Type | Facet Field | Tag |
|---|---|---|
Metric | newrelic.source | nr_cz:service.name |
Log | plugin.type | nr_cz:service.name |
PageView | appName | nr_cz:service.name |
PageViewTiming | appName | nr_cz:service.name |
AjaxRequest | appName | nr_cz:service.name |
BrowserTiming | appName | nr_cz:service.name |
JavaScriptError | appName | nr_cz:service.name |
PageAction | actionName OR appName | nr_cz:service.name |
Span | browserApp.name OR mobileApp.name OR service.name | nr_cz:service.name |
NetworkSample | hostname | nr_cz:service.name |
StorageSample | hostname | nr_cz:service.name |
SyntheticRequest | monitorName | nr_cz:service.name |
SyntheticPrivateLocationStatus | name | nr_cz:service.name |
MobileSession | newRelicAgent | nr_cz:service.name |
Mobile | name | nr_cz:service.name |
MobileSession | osName | nr_cz:service.name |
MobileHandledException | osName | nr_cz:service.name |
MobileCrash | osName | nr_cz:service.name |
MobileRequestError | osName | nr_cz:service.name |
MobileRequest | osName | nr_cz:service.name |
InfrastructureEvent | provider | nr_cz:service.name |
SyntheticsPrivateMinion | minionIpv4 | nr_cz:service.name |
Metric | metricName | nr_cz:service.namespace |
Log | syslog.app.name | nr_cz:service.namespace |
Span | appName | nr_cz:service.namespace |
SyntheticRequest | domain | nr_cz:service.namespace |
MobileSession | appName | nr_cz:service.namespace |
MobileHandledException | appName | nr_cz:service.namespace |
MobileCrash | appName | nr_cz:service.namespace |
MobileRequestError | appName | nr_cz:service.namespace |
MobileRequest | appName | nr_cz:service.namespace |
Mobile | device OR deviceType | nr_cz:service.namespace |
InfrastructureEvent | source | nr_cz:service.namespace |
Usage Family
The New Relic connection merges a selection of facets for certain event types with the New Relic Usage Metric Group. Cost data from New Relic will always include the Usage Metric Group associated with the type of usage and, for certain event types, the value from the facet field in the following table:
| Event Type | Facet Field |
|---|---|
Metric | dataType |
Log | newrelic.source |
NetworkSample | dataType |
StorageSample | agentName |
MobileSession | platform |
MobileHandledException | platform |
MobileCrash | platform |
MobileRequestError | platform |
MobileRequest | platform |
Updated 4 months ago