Cloud Control: Azure Target Setup [Turbonomic 5.9 or later] [Complete Guide]

Document created by fadi.josef Expert on Jun 10, 2016Last modified by fadi.josef Expert on Jan 11, 2018
Version 34Show Document
  • View in full screen mode
This document is a part of the Cloud Control Setup Overview [Start Here]. Targeting Public Cloud providers requires a license key that includes those features. If you are not able to add AWS, Azure or Softlayer with your current license please reach out for more information.

In this guide, we are going to go over how we can setup Turbonomic to manage Microsoft Azure. This guide will cover the following:

  • Obtaining Subscription ID
  • Creating Web Application and Obtaining Application ID
  • Creating Client Secret Key and Setting Permission
  • Obtaining Tenant Name



  • Administrator or Co-Administrator on Azure - Only required for initial configuration of Azure and not needed by Turbonomic
  • Access to Azure Portal (
  • Firewall configured to allow Turbonomic to access Azure resources 
  • Basic Metrics enabled for the VMs - More Details

If you are deploying Turbonomic using Azure Marketplace then you will need to use the username "azureuser" when deploying the VM to get root access.

Obtaining Subscription ID 

  • Login to your Azure Portal (

  • Click on Subscriptions. This is located on the left-hand side navigation.


  • Now choose the subscription you would like Turbonomic to manage.

Make sure you make a note of the Subscription ID. The subscription id will be used as your username in Turbonomic.

Creating Web Application & Obtaining Client ID

  • Under Manage click on App registrations

  • Now click on the Add button

  • Now enter the required details in the fields and then click Create
    • Name: Web Application name. This can be any name you like. In this example I used Turbonomic.
    • Application/Type: Keep that as Web app/API
    • Sign-on URL: Enter your Turbonomic URL.

Now we have created the App registration. Make a note of the Application ID.

Make sure you make a note of the Application ID. The application id will be used in Turbonomic later on under client id

Creating Client Secret Key & Permissions

Now click on the Settings button.

  • Click on Keys

Now you will see a new Window.

  • Fill in the required fields to generate a key and then click Save
    • Description: Turbonomic
    • Expires: Never expires

Make sure you make a note of the Key. The key will be used used in Turbonomic later on under client shared key.

  • Now click on Required Permissions


  • Click Add

  • Add the required API access and then click on Select and then Done

  • Then delegate permission.

  • At the end, you should see yours will look like the screenshot below.


Obtaining Tenant ID

  • Navigate to Azure Active Directory

  • Click on Properties

  • Make a note of the Directory ID which is the TenantID 

Make sure you make a note of the Directory ID because you will need to enter this ID under the Tenant Name field in Turbonomic.

The Web Application is now created and configured on Azure. Now we need to add the Web application as a user in Azure Portal.

  • Click on the subscription.
  • Click on 'Settings'.
  • Click on 'Control Access(IAM)'.


  • Click on 'Add' on the top

  • Select role as either 'Owner' OR 'Contributor' OR 'Reader + Storage Account Contributor'
  • Where it says "Select" type in the name of the Web Application you created and then click it from the list below.

  • Click Save

After you assigned the role to the application you should see it as a User in your Users list as shown in the screenshot below.


At the end, you should have the following information to enter in Turbonomic.

  • Tenant Name
  • Username
  • Client ID
  • Client Secret Key

For the address field, you can use any name. In the screenshot below I used the name of my subscription.



TurbonomicMicrosoft Azure
Tenant NameDirectory ID
UsernameSubscription ID
Client IDApplication ID
Client Secret KeyKeys


Enabling Basic Metrics

Now that you've added Azure as a target, if you'd like Turbonomic to collect Memory utilisation values for each VM, please enable Basic Metrics.More Details.


Firewall Requirements

5 people found this helpful