> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vantage.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# New Relic

> Learn how to integrate Vantage with New Relic.

Vantage integrates with your New Relic account using [NerdGraph](https://docs.newrelic.com/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph/), New Relic's GraphQL API. It accesses the API using an API token.

## Connect Your New Relic Account

### Prerequisites

* You must have a Vantage **Organization Owner** or **Integration Owner** role to add or remove this integration. See the [Role-Based Access Control](/rbac) documentation for details.
* [Create a free Vantage account](https://console.vantage.sh/signup), then follow the steps below to generate a New Relic API token and obtain your Account ID.

<Steps>
  <Step>
    Log in to your New Relic account. Then, follow the instructions in the [New Relic documentation](https://docs.newrelic.com/docs/apis/intro-apis/new-relic-api-keys/#overview-keys) to create a **User key**.
  </Step>

  <Step>
    Once you've created a new **User key**, you will see the key in your **API keys** list. Click the ellipses next to the key in the list and select **Copy key**. You will need this value for completing the integration with Vantage.
  </Step>

  <Step>
    To obtain your Account ID, follow the instructions provided in the [New Relic documentation](https://docs.newrelic.com/docs/accounts/accounts-billing/account-structure/account-id/). Copy the value for your Account ID.
  </Step>
</Steps>

### Create the Connection

<Steps>
  <Step>
    Navigate to the [New Relic Settings](https://console.vantage.sh/settings/new_relic) page in the Vantage console.
  </Step>

  <Step>
    Click **Add Connection**.
  </Step>

  <Step>
    Paste your **New Relic Account ID** and **New Relic API Key** you previously obtained into the provided fields.
  </Step>

  <Step>
    Complete the additional fields based on the specific pricing for your account. This can include the per-gigabyte ingestion rate, amount of free ingestion per month, core and full platform user pricing, and any free user seats. For more information on New Relic pricing, see the [New Relic documentation](https://docs.newrelic.com/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing/).
  </Step>

  <Step>
    Click **Connect Account**.
  </Step>
</Steps>

After clicking **Connect Account**, you will see the status of your integration change to **Importing** within the Vantage console. This status indicates that Vantage is actively importing your New Relic cost data. Vantage will automatically begin ingesting and visualizing your costs. See the [Integration Status](/vantage_account#integration-status) documentation for details on integration statuses.

### Next Steps - Manage Workspace Access

Once the import is complete and the integration status changes to **Stable**, you can select which workspaces this integration is associated with. See the [Workspaces](/workspaces#manage-workspace-provider-integrations) documentation for information.

## Data Refresh

See the [provider data refresh documentation](/provider_data_refresh) for information on when data for each provider refreshes in Vantage.

## New Relic Reporting Dimensions

On New Relic [Cost Reports](/cost_reports), you can filter across several dimensions:

* Account (account name)
* Category (e.g., New Relic Users - CoreUsers)
* Tags: Includes [Virtual Tags](/tagging) created in Vantage for this provider. The following provider tag is automatically created by Vantage from New Relic data and is available for filtering and grouping:
  * `newrelic.source`: The source of the cost data when present in the source data, allowing you to filter and group costs by source.
* Charge Type (e.g., Usage)
* Service (e.g., New Relic Ingestion)