Activate Azure integrations

New Relic Infrastructure integrations allow you to report data from specific systems and supplement Infrastructure's default, out-of-the-box monitoring. The Microsoft Azure integrations report data from various Azure platform services to your New Relic account. This document explains how to activate Azure integrations.

The New Relic Azure integrations require a paid Infrastructure account.

Requirements

The Azure integration activation process requires you to:

  • Create a New Relic application and key in Azure.
  • Grant this application access to the Azure services you want to monitor.
  • Place required information in the New Relic Infrastructure Integrations UI.

To use these integration activation instructions directly from the Infrastructure UI, go to infrastructure.newrelic.com > Integrations > Microsoft Azure > Add an Azure account.

Step 1: Get Azure subscription and tenant IDs

To get your Azure account's subscription id and tenantId, use your local terminal if you have Azure's tools installed, or use Azure's Cloud Shell terminal in the Azure portal.

  1. Open a terminal with access to your Azure account.
  2. Type the following:

    az account show
  3. Copy and save the subscription id and tenantID from the output response for later use.

The response should look similar to the response below. The subscription id and tenantID are highlighted.

@Azure:~$ az account show
{
  "environmentName": "AzureCloud",
  "id": "9ffe9512-f4a2-42dd-1230-518aec34be21",
  "isDefault": true,
  "name": "Beyond Team Sandbox",
  "registeredProviders": [],
  "state": "Enabled",
  "tenantId": "ac6692da-1231-422f-22a8-9eed6dbe83f1",
  "user": {
    "name": "youremail@domain",
    "type": "user"
}

Step 2: Register your app and get ID

You must have Azure permissions to register your application and copy its Application ID.

To register your app in Azure:

  1. Log in to the Azure portal and go to the Active Directory.
  2. From Manage, select App registrations > New application registration.
  3. Enter a name for the application. Recommendation: Name your app NewRelic-Integrations.
  4. Select the application type Web app / API.
  5. Required although not used: Enter the sign-on URL as https://www.newrelic.com.
  6. Select Create.

To copy and save the ID:

  1. In Azure, select the App registrations page.
  2. In the search bar, enter the app name you created; for example, NewRelic-Integrations.
  3. Select the app to access its properties.
  4. Select the Application ID's copy [copy icon] icon, and save the application ID for later use.

Step 3: Create client key in Azure

To create a client key associated with this application:

  1. In Azure, under the application you just created, select Settings > Keys.
  2. Create a key named Client Key.
  3. Save the Client Key.
  4. Save the key value for later use. Important: Save the key value that has Azure-applied encryption.

Step 4: Provide permissions to services

Your app must provide Reader permissions for each Azure service you want New Relic to monitor:

  1. In the Azure Subscriptions section, select the subscriptions that you want New Relic to monitor.
  2. Select Access control (IAM) > Add.
  3. From the Role dropdown, select Reader.
  4. From the Select dropdown, select the app's name; for example, NewRelic-Integrations.
  5. From Selected members, verify your app name appears, then select Save.

Some Azure services, including Azure CosmosDB and Azure VMs, require additional steps. See the Azure integration documentation for the services you want to enable.

Step 5: Add app to New Relic

Now you can activate the Azure integration in the Infrastructure UI. The UI will require the information you have saved in the previous steps, including:

To add your Azure app to New Relic Infrastructure:

  1. Go to infrastructure.newrelic.com > Integrations > Microsoft Azure and select the Azure Service you wish to add.
  2. Follow the steps in the UI to activate the integration in New Relic Infrastructure.
  3. If you have already completed the Azure account steps, skip to the end of the steps to fill out the form. (For Azure account name, enter the name you want to use to identify the account in your Integrations dashboard.)

Explore app data in New Relic Infrastructure

After you activate an Azure integration, New Relic will start monitoring your Azure data at regular polling intervals. To find and use your data, including links to your New Relic Insights dashboards and alert settings, go to infrastructure.newrelic.com > Integrations > Microsoft Azure.

For more help

Recommendations for learning more: