<commit_before>---
title: Datadog - Microsoft Azure Integration
integration_title: Microsoft Azure
kind: integration
sidebar:
  nav:
    - header: Azure integration
    - text: Installation
      href: "#installation"
    - text: Creating the Web Application
      href: "#installation1"
    - text: Giving Read Permissions to the Application
      href: "#installation2"
    - text: Deploy agents
      href: "#agents"
    - text: Troubleshooting
      href: "#troubleshooting"
    - header: Integrations
    - text: Back to Overview
      href: "/integrations/"
---

### Overview

Datadog's Azure integration currently monitors Virtual Machines, SQL Databases, and App Services. For any other service, please reach out to [<EMAIL>][3].
Datadog's agent can also be deployed on your Azure virtual machines.


### Installation
{: #installation}

Integrating Datadog with Microsoft Azure is a two step process. The first step is creating a web application in your Active Directory and passing the correct credentials to Datadog, and the second step is giving this application read-access to any subscriptions you would like to monitor.

#### Getting your tenant ID
1. Go to [manage.windowsazure.com][5]
2. Once the URL redirects, copy the tenant name from the URL. It is the text in between the @ and # symbol <img src="/static/images/azure/azure_tenant_url.png" style="width: 75%;display:block;"/>
3. Paste the Tenant Name in the form on the Datadog setup page <img src="/static/images/azure/tenant_name_form.png" style="width: 50%;display:block;display:block;"/>

#### Creating the Web Application
{: #installation1}

1. Navigate to the “Active Directory” tab on the left-hand menu <img src="/static/images/azure/active_directory_icon.png" style="width: 25%;display:block;"/>
2. Click on the Active Directory you want to monitor <img src="/static/images/azure/active_directory_name_click.png" style="width: 50%;display:block;"/>
3. Click on "Applications" <img src="/static/images/azure/application_click.png" style="width: 50%;display:block;"/>
4. Click "Add" <img src="/static/images/azure/add_application_icon.png" style="width: 50%;display:block;"/>
5. Click "Add an application my organization is developing"
6. Give it a name, i.e. Datadog Auth App
7. Select “Web application and/or web api”
8. Provide a sign-on URL and App ID URI
	- These can be any value, they are not needed for authentication 
	- i.e. https://app.datadoghq.com	
9. Click the check mark. You should be on a page that says "Your app has been added!"
10. Click on "Configure" (Make sure this is configure for the app, not the active directory) <img src="/static/images/azure/configure_click.png" style="width: 50%;display:block;"/>
11. Scroll down to Client ID. Copy and paste the value in the form on the Datadog setup page <img src="/static/images/azure/client_id_form.png" style="width: 50%;display:block;display:block;"/>
12. Scroll down to Keys and create a new key (1 or 2 years are both acceptable)
	- Note: the client secret key will be shown after you save
13. Scroll down to "Permissions To Other Applications"
14. Click Add Application
15. Select Windows Azure Service Management API and press the check mark on the bottom right of the screen
16. Under Delegated Permissions, check off “Access Azure Service Management as organization users (preview)” <img src="/static/images/azure/app_permissions_dropdown.png" style="width: 50%;display:block;"/>
17. Click "Save" at the bottom of the screen 
18. Scroll back up to Keys, and copy and paste the generated Client Secret key in the form on the Datadog setup page <img src="/static/images/azure/client_secret_form.png" style="width: 50%;display:block;display:block;"/>
19. Click "Update Configuration" to complete application creation process

#### Giving Read Permissions to the Application
{: #installation2}

1. Navigate to [portal.azure.com][2]
2. Navigate to “Subscriptions” on the left hand menu <img src="/static/images/azure/subscriptions_icon.png" style="width: 25%;display:block;"/>
3. Click on the subscription you would like to monitor
4. Click on the user icon <img src="/static/images/azure/user_button.png" style="width: 50%;display:block;"/>
5. Click "Add" User <img src="/static/images/azure/add_user_button.png" style="width: 25%;display:block;"/>
6. Select “Reader” as a role <img src="/static/images/azure/reader_icon.png" style="width: 25%;display:block;"/>
7. Search/select for the name of the Application you just created (i.e. Datadog Auth App)
8. Click Select
9. Press OK
10. Repeat this process for any other subscriptions you would like to monitor

**In a few minutes, metrics from applications under that subscription will begin to appear!**

![Azure VM Default Dashboard](/static/images/azure/azure_vm_screenboard.png)

Learn more about how to monitor Azure VM performance metrics with [our series of posts](https://www.datadoghq.com/blog/how-to-monitor-microsoft-azure-vms/). We detail the key performance metrics, how to collect them, and how to use Datadog to monitor Azure VMs.

### Deploy agents
{: #agents}

1. Follow the steps in the [Azure integrations][1] tile
2. Manually deploy agents by following the instructions <a href="/guides/azure/">here</a> 

### Troubleshooting
{: #troubleshooting}
Here are some common issues you might be seeing.

#### I don't know my tenent name
To locate your tenent name first log into the classic [Azure portal][5].
After logging in, locate the settings page on the left side of the screen.
![](/static/images/azure_tenent.png)

The text in the red box shown in sceenshot above is your tenent name. Please only include text between parentheses.

Your tenant name is also available from the URL after navigating to the classic portal. It is the text in between the @ and # symbol <img src="/static/images/azure/azure_tenant_url.png" style="width: 75%;display:block;"/>

#### Unable to login
If you have experienced error logging in while trying to install the integration, please reach out to [<EMAIL>][3]. When possible, please attach a screen shot.

#### No Metrics Are Showing Up
Please ensure you completed <a href="#installation2">step two</a> of the installation process, which entails giving read permissions to the Azure application (created in <a href="#installation1">step one</a>) for the subscriptions you want to monitor. 

For ARM deployed VMs, diagnostics must be enabled to collect metrics. See Enable Diagnostics below for instructions.

#### Missing Metrics?
Classicly deployed VMs must have diagnostics enabled to collect advanced metrics. Diagnostics allows VMs to collect logging information which includes metrics for CPU, Network, etc...

##### Enable diagnostics
To collect advanced metrics for virtual machines, you must enable diagnostics. Right now this is only support by Windows based machines. To do this, first go to [Azure Portal][2] then follow the instructions below.
![](/static/images/azure_diag_manual.png)

After locating your VM:

1. Click on the CPU percentage today panel to show metrics panel
2. Click on Diagnostics
3. Shift the status to on
4. Datadog only requires "Basic metrics", "Network and web metrics", and ".Net metrics" to function correctly. Un-checking logs collection could save you some storage space.
5. Click OK to save your changes



   [1]: https://app.datadoghq.com/account/settings#integrations/azure
   [2]: https://portal.azure.com
   [3]: mailto:<EMAIL>
   [4]: https://management.azure.com
   [5]: https://manage.windowsazure.com
<commit_msg>small misnumbering of list fix<commit_after>---
title: Datadog - Microsoft Azure Integration
integration_title: Microsoft Azure
kind: integration
sidebar:
  nav:
    - header: Azure integration
    - text: Installation
      href: "#installation"
    - text: Creating the Web Application
      href: "#installation1"
    - text: Giving Read Permissions to the Application
      href: "#installation2"
    - text: Deploy agents
      href: "#agents"
    - text: Troubleshooting
      href: "#troubleshooting"
    - header: Integrations
    - text: Back to Overview
      href: "/integrations/"
---

### Overview

Datadog's Azure integration currently monitors Virtual Machines, SQL Databases, and App Services. For any other service, please reach out to [<EMAIL>][3].
Datadog's agent can also be deployed on your Azure virtual machines.


### Installation
{: #installation}

Integrating Datadog with Microsoft Azure is a two step process. The first step is creating a web application in your Active Directory and passing the correct credentials to Datadog, and the second step is giving this application read-access to any subscriptions you would like to monitor.

#### Getting your tenant ID
1. Go to [manage.windowsazure.com][5]
2. Once the URL redirects, copy the tenant name from the URL. It is the text in between the @ and # symbol <img src="/static/images/azure/azure_tenant_url.png" style="width: 75%;display:block;"/>
3. Paste the Tenant Name in the form on the Datadog setup page <img src="/static/images/azure/tenant_name_form.png" style="width: 50%;display:block;display:block;"/>

#### Creating the Web Application
{: #installation1}

1. Navigate to the “Active Directory” tab on the left-hand menu <img src="/static/images/azure/active_directory_icon.png" style="width: 25%;display:block;"/>
2. Click on the Active Directory you want to monitor <img src="/static/images/azure/active_directory_name_click.png" style="width: 50%;display:block;"/>
3. Click on "Applications" <img src="/static/images/azure/application_click.png" style="width: 50%;display:block;"/>
4. Click "Add" <img src="/static/images/azure/add_application_icon.png" style="width: 50%;display:block;"/>
5. Click "Add an application my organization is developing"
6. Give it a name, i.e. Datadog Auth App
7. Select “Web application and/or web api”
8. Provide a sign-on URL and App ID URI
	- These can be any value, they are not needed for authentication 
	- i.e. https://app.datadoghq.com	
9. Click the check mark. You should be on a page that says "Your app has been added!"
10. Click on "Configure" (Make sure this is configure for the app, not the active directory) <img src="/static/images/azure/configure_click.png" style="width: 50%;display:block;"/>
11. Scroll down to Client ID. Copy and paste the value in the form on the Datadog setup page <img src="/static/images/azure/client_id_form.png" style="width: 50%;display:block;display:block;"/>
12. Scroll down to Keys and create a new key (1 or 2 years are both acceptable)
	- Note: the client secret key will be shown after you save
13. Scroll down to "Permissions To Other Applications"
14. Click Add Application
15. Select Windows Azure Service Management API and press the check mark on the bottom right of the screen
16. Under Delegated Permissions, check off “Access Azure Service Management as organization users (preview)” <img src="/static/images/azure/app_permissions_dropdown.png" style="width: 50%;display:block;"/>
17. Click "Save" at the bottom of the screen 
18. Scroll back up to Keys, and copy and paste the generated Client Secret key in the form on the Datadog setup page <img src="/static/images/azure/client_secret_form.png" style="width: 50%;display:block;display:block;"/>
19. Click "Update Configuration" to complete application creation process

#### Giving Read Permissions to the Application
{: #installation2}

1. Navigate to [portal.azure.com][2]
2. Navigate to “Subscriptions” on the left hand menu <img src="/static/images/azure/subscriptions_icon.png" style="width: 25%;display:block;"/>
3. Click on the subscription you would like to monitor
4. Click on the user icon <img src="/static/images/azure/user_button.png" style="width: 50%;display:block;"/>
5. Click "Add" User <img src="/static/images/azure/add_user_button.png" style="width: 25%;display:block;"/>
6. Select “Reader” as a role <img src="/static/images/azure/reader_icon.png" style="width: 25%;display:block;"/>
7. Search/select for the name of the Application you just created (i.e. Datadog Auth App)
8. Click Select
9. Press OK
10. Repeat this process for any other subscriptions you would like to monitor

**In a few minutes, metrics from applications under that subscription will begin to appear!**

![Azure VM Default Dashboard](/static/images/azure/azure_vm_screenboard.png)

Learn more about how to monitor Azure VM performance metrics with [our series of posts](https://www.datadoghq.com/blog/how-to-monitor-microsoft-azure-vms/). We detail the key performance metrics, how to collect them, and how to use Datadog to monitor Azure VMs.

### Deploy agents
{: #agents}

1. Follow the steps in the [Azure integrations][1] tile
2. Manually deploy agents by following the instructions <a href="/guides/azure/">here</a> 

### Troubleshooting
{: #troubleshooting}
Here are some common issues you might be seeing.

#### I don't know my tenent name
To locate your tenent name first log into the classic [Azure portal][5].
After logging in, locate the settings page on the left side of the screen.
![](/static/images/azure_tenent.png)

The text in the red box shown in sceenshot above is your tenent name. Please only include text between parentheses.

Your tenant name is also available from the URL after navigating to the classic portal. It is the text in between the @ and # symbol <img src="/static/images/azure/azure_tenant_url.png" style="width: 75%;display:block;"/>

#### Unable to login
If you have experienced error logging in while trying to install the integration, please reach out to [<EMAIL>.com][3]. When possible, please attach a screen shot.

#### No Metrics Are Showing Up
Please ensure you completed <a href="#installation2">step two</a> of the installation process, which entails giving read permissions to the Azure application (created in <a href="#installation1">step one</a>) for the subscriptions you want to monitor. 

For ARM deployed VMs, diagnostics must be enabled to collect metrics. See Enable Diagnostics below for instructions.

#### Missing Metrics?
Classicly deployed VMs must have diagnostics enabled to collect advanced metrics. Diagnostics allows VMs to collect logging information which includes metrics for CPU, Network, etc...

##### Enable diagnostics
To collect advanced metrics for virtual machines, you must enable diagnostics. Right now this is only support by Windows based machines. To do this, first go to [Azure Portal][2] then follow the instructions below.
![](/static/images/azure_diag_manual.png)

After locating your VM:

1. Click on the CPU percentage today panel to show metrics panel
2. Click on Diagnostics
3. Shift the status to on (note: Datadog only requires "Basic metrics", "Network and web metrics", and ".Net metrics" to function correctly. Un-checking logs collection could save you some storage space)
4. Click OK to save your changes



   [1]: https://app.datadoghq.com/account/settings#integrations/azure
   [2]: https://portal.azure.com
   [3]: mailto:<EMAIL>
   [4]: https://management.azure.com
   [5]: https://manage.windowsazure.com

{'fraction_non_alphanumeric': 0.09817336433078712, 'fraction_numerical': 0.013218199933576884, 'mean_word_length': 4.588715664439495, 'pattern_counts': {'":': 0, '<': 51, '<?xml version=': 0, '>': 51, 'https://': 12, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '639974', 'n_tokens_mistral': 4272, 'n_tokens_neox': 4073, 'n_words': 1882}