Skip to main content

Authorization

Follow this guide to create a new New Relic credential that will allow Nexla to authenticate to and exchange data with your New Relic account.
newrelic_api_auth.png

New Relic

Prerequisites​

Before creating a New Relic credential, you need to obtain your API key and identify your root URL from your New Relic account. New Relic uses API key authentication for all API requests, with the API key sent in the x-api-key header.

To obtain your New Relic API credentials, follow these steps:

  1. Sign in to your New Relic account using your administrator credentials.

  2. Navigate to your account settings or profile settings in the New Relic interface.

  3. Look for the API Keys or API section in your account settings. This is typically located under Account settings or User preferences.

  4. If you don't have an API key yet, click Create API Key or Generate API Key to create a new API key.

  5. Configure your API key settings:

    • Enter a name or description for the API key (e.g., "Nexla Integration")
    • Select the key type (User API key or License key)
    • Review and select the permissions or scopes for the key

  6. Click Create or Generate to create the API key.

  7. Copy the API key immediately after it's generated, as it may not be accessible again after you navigate away from the page.

  8. Identify your root URL based on your New Relic instance:

    • US Instance: https://api.newrelic.com/v2
    • EU Instance: https://api.eu.newrelic.com/v2

  9. Store both the API key and root URL securely, as you will need them to configure your Nexla credential. The API key is sensitive information and should be kept confidential.

The API key is sent in the x-api-key header for all API requests to the New Relic API. The root URL determines which New Relic instance (US or EU) your API requests will be sent to. The API key authenticates your requests and grants access to New Relic resources based on your account permissions and the key's scopes. If your API key is compromised, you should immediately revoke it in your New Relic account settings and generate a new one. For detailed information about obtaining API keys, API authentication, and available endpoints, refer to the New Relic REST API documentation.

Create a New Relic Credential​

  • To create a new New Relic credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – New Relic

NewrelicCred.png

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

API Key Authentication​

New Relic uses API key authentication for all API requests. The API key is sent in the x-api-key header to authenticate API requests to the New Relic API.

  1. Enter your New Relic API key in the API Key Value field. This is the API key you obtained from your New Relic account settings (API Keys section). The API key is sent in the x-api-key header for all API requests to the New Relic API. The API key is sensitive information and must be kept confidential.

  2. Enter your New Relic root URL in the Root URL field. This should be the root URL for your New Relic API instance. Select US Instance (API v2) (https://api.newrelic.com/v2) for US accounts, or EU Instance (API v2) (https://api.eu.newrelic.com/v2) for EU accounts. The root URL determines which New Relic instance your API requests will be sent to.

    Your New Relic API key can be found in your New Relic account settings under the API Keys section. The API key is sent in the x-api-key header for all API requests to the New Relic API. The root URL should match your New Relic instance (US or EU).

    If your API key is compromised, you should immediately revoke it in your New Relic account settings and generate a new one. The API key provides access to your New Relic account data and should be treated as sensitive information. Keep your API key secure and do not share it publicly.

    For detailed information about obtaining API keys, API authentication, and available endpoints, see the New Relic REST API documentation.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.