Collecting metrics from an Azure service

Prerequisites

• You must have access to the Global Admin role for performing these tasks. Request your admin for access. 
• You must already have an application, or you can create an application key. 

To create an application key

If you do not have an application, complete the following procedure to the create an application key.

1. Navigate to https://manage.windowsazure.com.

2. Select Active Directory from the navigation pane and then click Default Directory from the list.
3. Select the Applications tab and click Add
   1. Select Add an application my organization is developing
   2. Type a Name for the application, and select Web Application And/Or Web API
   3. Type https://truesight.bmc.com for the Sign-on URL, APP ID URI, and Reply URL.

To create credentials to access Azure

To create the credentials, you must get the client ID, client secret, and tenant ID. For more information, see the Azure documentation.

1. Navigate to https://manage.windowsazure.com.

2. Select Active Directory from the navigation pane.
3. Click Default directory from the list.
4. Click the Applications link, and select your application.
5. From the Configure section, select Access Web APIs in other applications.

6. Copy the ID from the Update your code with your client ID field to the clipboard.

   Tip

   Paste the client ID to a notepad file.

7. From Create a key, click Configure key to generate a key used to access the Microsoft Azure Active Directory web APIs.
   1. Select the duration from the drop-down list
   2. The permissions to other applications section should have Windows Azure Active Directory.
      • From the Application Permissions menu, select:

1. 1. 1. • Read and write devices
         • Read and write directory data
         • Read and write domains
         • Read directory data.
      • From the Delegated Permissions menu, select:

1. 1. 1. • Read all users' basic profiles
         • Read all users' full profiles
         • Read all groups
         • Read and write all groups
         • Read and write directory data
         • Read directory data.
   2. Click Add application, and select Windows Azure Service Management API.
      • Ensure that no value is selected from the Application Permissions menu.
      • From the Delegated Permissions drop-down list, select Access Azure Service Management as organiza...

   3. Click Save to generate and display the value for the client secret.

      Warning

      Copy and paste the client secret to a notepad file. You will not be able to access the client secret after you leave the page.

2. Click View endpoints to get a list of the App Endpoints.

3. Copy the value from any of the fields to the clipboard. This is the endpoint used to obtain the tenant ID.

   Tip

   Paste the tenant ID in a notepad file. For example, if https://login.microsoftonline.com

   /random-setofcharacters-denoting-a-tenantID

   /oauth2/authorize is the value, you must copy and paste the highlighted section of the URL.

To add owners to the application

1. Click https://manage.windowsazure.com.

2. Navigate to Active Directory > Default Directory > Applications > Select the Application
3. Click the Owners link from the top of the page.
4. Click Add owners
5. From the list, select the owners you want to add to the application

To associate the required roles for the application

1. Navigate to https://portal.azure.com.
   Ensure that you enable diagnostics for virtual machines to collect metrics.  For more information, see https://blogs.technet.microsoft.com/canitpro/2016/05/31/step-by-step-enable-diagnostics-on-an-azure-virtual-machine.

2. From the navigation pane, click Subscriptions

3. From the Subscriptions page, double-click the Subscription ID or click Subscription Name.

   To monitor multiple subscriptions, repeat the following steps for each subscription.

4. From the Settings pane, click Access control (IAM)
5. Click Add, and select one role at a time:
   • Owner
   • Reader
   • Classic Storage Account Contributor
   • Storage Account Contributor
6. Search the name of the application that you created for integrating with TrueSight Intelligence, and associate it to the selected role.
7. Repeat Step 5 and 6 for each of the roles listed in Step 5.

To configure the integration

1. Click  > Data Collection > Azure and click Add to integrate and collect data from your Azure cloud instance.
   
2. Use the Azure Configuration section to provide the details required to configure data collection from Azure:
   
   1. Type a Name for the Azure instance.
   2. Type a Description for your reference.
   3. Set the Polling Frequency (mins) used for polling the Azure instance.
   4. Type the Tenant Id for your Azure instance.
   5. Type the Client Id for your Azure user.
   6. Type the Client Secret for the Azure user.
      For more information on getting the values for the Tenant Id, Client Id and Client Secret, see To create credentials to access Azure, earlier in this topic.
   7. Select the TrueSight Intelligence App Name to which the Azure data will be associated or type the name for a new App.

3. Click Validate and Continue to validate the details and open the Azure Services section to select the Azure services.

   Elastic Pool

   SQL

   Virtual Machine

4. Click Continue to open the Azure Metrics section.

   The [confluence_table-filter] macro is a standalone macro and it cannot be used inline. Click on this message for details.
   This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.
   Alternately, click Start Over if you want to start over with the configuration.

5. Select one or more metrics, or select all metrics to collect data. Use the search box to filter and display metrics that contain specific keywords.
6. Click Save to save the integration.
   Alternately, click Start Over if you want to start over with the configuration.