You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: Get started with Datadog on Azure by creating a new resource, configuring metrics and logs, and setting up single sign-on through Microsoft Entra ID.
4
-
5
4
ms.topic: quickstart
6
-
ms.date: 12/11/2024
5
+
ms.date: 03/10/2025
7
6
ms.custom:
8
7
- references_regions
9
8
- ai-gen-docs-bap
@@ -13,35 +12,20 @@ ms.custom:
13
12
14
13
# QuickStart: Get started with Datadog
15
14
16
-
In this quickstart, you create a new instance of Datadog. You can either create a new Datadog organization or [link to an existing Datadog organization](link-to-existing-organization.md).
15
+
In this quickstart, you create a new instance of Datadog.
17
16
18
17
## Prerequisites
19
18
20
-
Before creating your first instance of Datadog in Azure, [configure your environment](prerequisites.md).
21
-
22
-
## Setup
23
-
24
-
Begin by signing into the [Azure portal](https://portal.azure.com).
25
-
26
-
## Create a Datadog resource
27
-
28
-
To create your resource, start at the Azure portal home page.
29
-
30
-
1. Search for the resource provider by typing it into the header search bar.
31
-
32
-
1. Choose the service you want from the *Services* search results.
33
-
34
-
1. Select the **+ Create** option.
35
-
36
-
The portal displays a selection asking whether you would like to create a Datadog organization or link Azure subscription to an existing Datadog organization.
- You must [configure your environment](prerequisites.md).
21
+
- You must [subscribe to Datadog](overview.md#subscribe-to-datadog).
37
22
38
-
:::image type="content" source="media/create-datadog-resource.png" alt-text="A screenshot of Azure portal with the Create a Datadog resource in Azure options displayed.":::
23
+
## Create a New Relic resource
39
24
40
-
If you're creating a new Datadog organization, select **Create** under the **Create a new Datadog organization**
The Create a Datadog resource pane opens to the *Basics* tab by default.
43
-
44
-
:::image type="content" source="media/create-new-datadog-resource.png" alt-text="A screenshot of the Azure portal with the Create a new Datadog resource options displayed.":::
27
+
> [!NOTE]
28
+
> The steps in this article are for creating a new Datadog organization. See [link to an existing Datadog organization](link-to-existing-organization.md) if you have an existing Datadog organization you'd prefer to link your Azure subscription to.
45
29
46
30
### Basics tab
47
31
@@ -50,86 +34,91 @@ The *Basics* tab has three sections:
50
34
- Project details
51
35
- Azure resource details
52
36
- Datadog organization details
37
+
38
+
:::image type="content" source="media/create/basics-tab.png" alt-text="A screenshot of the Create a Datadog resource in Azure options inside of the Azure portal's working pane with the Basics tab displayed.":::
53
39
54
-
There are required fields in each section that you need to fill out.
40
+
There are required fields (identified with a red asterisk) in each section that you need to fill out.
55
41
56
42
1. Enter the values for each required setting under *Project details*.
|Resource name |Specify a unique name for the resource.|
68
-
|Location |Select the [region](https://azure.microsoft.com/explore/global-infrastructure/geographies/) where you want to enable this service and its child resources to be located. |
| Datadog org name | Choose to create a new organization, or associate your resource with an existing organization. |
73
61
74
-
Use Azure resource tags to configure which metrics and logs are sent to Datadog. You can include or exclude metrics and logs for specific resources.
62
+
Select the **Change plan** link to change your billing plan.
75
63
76
-
Enter the names and values for each *Action* listed under Metrics and Logs.
64
+
The remaining fields update to reflect the details of the plan you selected for this new organization.
77
65
78
-
<!--Metrics-->
79
-
<!--Silence monitoring for expected Azure VM Shutdowns-->
80
-
<!--Collect custom metrics from App Insights-->
66
+
1. Choose your preferred billing term.
81
67
82
-
<!--Logs-->
83
-
<!--Send subscription activity logs-->
84
-
<!--Send Azure resource logs for all defined sources.-->
68
+
1. Select the **Next** button at the bottom of the page.
85
69
86
-
Once you complete the configuration for metrics and logs, select **Next: Security**.
70
+
### Metrics and logs tab (optional)
87
71
88
-
## Security tab
72
+
If you wish, you can configure resources to send metrics/logs to Datadog.
89
73
90
-
To enable Datadog Cloud Security Posture management, select the checkbox.
74
+
Enter the names and values for each *Action* listed under Metrics and Logs.
91
75
92
-
Select **Single sign-on**.
76
+
- Select **Silence monitoring for expected Azure VM Shutdowns**.
77
+
- Select **Collect custom metrics from App Insights**.
78
+
- Select **Send subscription activity logs**.
79
+
- Select **Send Azure resource logs for all defined sources**.
93
80
94
-
##Single sign-on tab (optional)
81
+
#### Inclusion and exclusion rules for metrics and logs
95
82
96
-
If your organization uses Microsoft Entra ID as its identity provider, you can establish single sign-on from the Azure portal to Datadog.
83
+
To filter the set of Azure resources that send logs to Datadog, use inclusion and exclusion rules and set Azure resource tags.
97
84
98
-
To establish single sign-on through Microsoft Entra ID, select the checkbox.
85
+
- All Azure resources with tags defined in include rules send logs to Datadog.
86
+
- All Azure resources with tags defined in exclude rules don't send logs to Datadog.
99
87
100
-
The Azure portal retrieves the appropriate Datadog application from Microsoft Entra ID, which matches the Enterprise app you provided previously.
88
+
> [!NOTE]
89
+
> If there's a conflict between inclusion and exclusion rules, exclusion takes priority.
101
90
102
-
Select the Datadog app name.
91
+
Select the **Next** button at the bottom of the page.
103
92
104
-
Select **Next: Tags**.
93
+
### Security tab (optional)
105
94
106
-
## Tags tab (optional)
95
+
If you wish to enable Datadog Cloud Security Posture management, select the checkbox.
107
96
108
-
If you wish, you can optionally create tags resource, then select the **Next: Review + create** button at the bottom of the page.
97
+
Select the **Next** button at the bottom of the page.
109
98
110
-
Select **Next: Review + create**.
99
+
### Single sign-on tab (optional)
111
100
112
-
## Review + create tab
101
+
If your organization uses Microsoft Entra ID as its identity provider, you can establish single sign-on from the Azure portal to Datadog.
113
102
114
-
If the review identifies errors, a red dot appears next each section where errors exist. Fields with errors are highlighted in red.
103
+
To establish single sign-on through Microsoft Entra ID:
115
104
116
-
1.Open each section with errors and fix the errors.
105
+
1.Select the checkbox.
117
106
118
-
1. Select the **Review + create** button again.
107
+
The Azure portal retrieves the appropriate Datadog application from Microsoft Entra ID, which matches the Enterprise app you provided previously.
119
108
120
-
1. Select the **Create** button.
109
+
1. Select the Datadog app name.
121
110
122
-
Once the resource is created, select **Go to Resource** to navigate to the Datadog resource.
111
+
Select the **Next** button at the bottom of the page.
123
112
124
-
:::image type="content" source="media/go-to-resource.png" alt-text="A screenshot of the Overview for a newly created Datadog resource with the Go to Resource button emphasized.":::
Copy file name to clipboardExpand all lines: articles/partner-solutions/datadog/link-to-existing-organization.md
+61-77Lines changed: 61 additions & 77 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,39 +10,28 @@ ms.custom: references_regions
10
10
11
11
# QuickStart: Link to existing Datadog organization
12
12
13
-
In this quickstart, you link to an existing organization of Datadog. You can either [create a new Datadog organization](create.md) or link to an existing Datadog organization.
13
+
In this quickstart, you link to an existing organization of Datadog.
14
14
15
-
## Prerequisites
16
-
17
-
Before creating your first instance of Datadog, [configure your environment](prerequisites.md). These steps must be completed before continuing with the next steps in this quickstart.
18
-
19
-
## Find offer
20
-
21
-
Use the Azure portal to find Datadog.
22
-
23
-
1. Go to the [Azure portal](https://portal.azure.com/) and sign in.
15
+
> [!NOTE]
16
+
> You can either [create a new Datadog organization](create.md) or link to an existing Datadog organization.
24
17
25
-
1. If you've visited the **Marketplace** in a recent session, select the icon from the available options. Otherwise, search for _Marketplace_.
26
-
27
-
1. In the Marketplace, search for **Datadog - An Azure Native ISV Service**.
28
-
29
-
1. In the plan overview screen, select **Set up + subscribe**.
30
-
31
-
## Link to existing Datadog organization
18
+
## Prerequisites
32
19
33
-
The portal displays a selection asking whether you would like to create a Datadog organization or link Azure subscription to an existing Datadog organization.
- You must [configure your environment](prerequisites.md).
22
+
- You must [subscribe to Datadog](overview.md#subscribe-to-datadog).
34
23
35
-
If you're linking to an existing Datadog organization, select **Create** under the **Link Azure subscription to an existing Datadog organization**
24
+
## Create a New Relic resource
36
25
37
-
You can link your new Datadog resource in Azure to an existing Datadog organization in **US3**.
26
+
Begin by signing in to the [Azure portal](https://portal.azure.com/).
38
27
39
-
The portal displays the Create a Datadog resource pane.
28
+
1. Type the name of the service in the header search bar.
40
29
41
-
## Create a Datadog resource
30
+
1. Choose the service from the *Services* search results.
42
31
43
-
The Create a Datadog resource pane opens to the *Basics* tab by default.
32
+
1. Select the **+ Create** option under **Link Azure subscription to an existing Datadog org**.
44
33
45
-
:::image type="content" source="media/create-new-datadog-resource.png" alt-text="A screenshot of the Azure portal with the Create a new Datadog resource options displayed.":::
34
+
The **Create**resource pane displays in the working pane with the *Basics* tab open by default.
46
35
47
36
### Basics tab
48
37
@@ -52,94 +41,89 @@ The *Basics* tab has three sections:
52
41
- Azure resource details
53
42
- Datadog organization details
54
43
55
-
There are required fields in each section that you need to fill out.
44
+
:::image type="content" source="media/create/link-existing-basics-tab.png" alt-text="A screenshot of the Link Azure subscription to an existing Datadog organization options inside of the Azure portal's working pane with the Basics tab displayed.":::
45
+
46
+
There are required fields (identified with a red asterisk) in the first two sections that you need to fill out.
56
47
57
48
1. Enter the values for each required setting under *Project details*.
|Resource name |Specify a unique name for the resource.|
69
-
|Location |Select the [region](https://azure.microsoft.com/explore/global-infrastructure/geographies/) where you want to enable this service and its child resources to be located. |
|Resource name |Specify a unique name for the resource. |
60
+
|Location |Select a regionto deploy your resource.|
70
61
71
-
1.Enter the values for each required setting under *Datadog organization details*.
62
+
1.Select **Link to Datadog organization** under *Datadog organization details*.
72
63
73
-
Select **Link to Datadog organization**. The link opens a Datadog authentication window. Sign in to Datadog.
64
+
A new window appears for **Log in to Datadog**.
74
65
75
-
By default, Azure links your current Datadog organization to your Datadog resource. If you would like to link to a different organization, select the appropriate organization in the authentication window.
66
+
> [!IMPORTANT]
67
+
>
68
+
> - By default, Azure links your current Datadog organization to your Datadog resource. If you would like to link to a different organization, select the appropriate organization in the authentication window.
69
+
> - You can't link the subscription to the same organization through a different Datadog resource if the subscription is already linked to an organization to avoid duplicate logs and metrics being shipped to the same organization for the same subscription.
76
70
77
-
Select **Next: Metrics and logs** to configure metrics and logs.
71
+
Once you finish authenticating, return to the Azure portal.
78
72
79
-
> [!NOTE]
80
-
> If the subscription is already linked to an organization through a Datadog resource, an attempt to link the subscription to the same organization through a different Datadog resource would be blocked. It's blocked to avoid scenarios where duplicate logs and metrics get shipped to the same organization for the same subscription.
73
+
1. Select the **Next** button at the bottom of the page.
81
74
82
-
### Metrics and logs tab
75
+
### Metrics and logs tab (optional)
83
76
84
-
Use Azure resource tags to configure which metrics and logs are sent to Datadog. You can include or exclude metrics and logs for specific resources.
77
+
If you wish, you can configure resources to send metrics/logs to Datadog.
85
78
86
79
Enter the names and values for each *Action* listed under Metrics and Logs.
87
80
88
-
<!--Metrics-->
89
-
<!--Silence monitoring for expected Azure VM Shutdowns-->
90
-
<!--Collect custom metrics from App Insights-->
91
-
92
-
<!--Logs-->
93
-
<!--Send subscription activity logs-->
94
-
<!--Send Azure resource logs for all defined sources.-->
95
-
96
-
Once you complete the configuration for metrics and logs, select **Next: Security**.
81
+
- Select **Silence monitoring for expected Azure VM Shutdowns**.
82
+
- Select **Collect custom metrics from App Insights**.
83
+
- Select **Send subscription activity logs**.
84
+
- Select **Send Azure resource logs for all defined sources**.
97
85
98
-
##Security tab
86
+
#### Inclusion and exclusion rules for metrics and logs
99
87
100
-
To enable Datadog Cloud Security Posture management, select the checkbox.
88
+
To filter the set of Azure resources that send logs to Datadog, use inclusion and exclusion rules and set Azure resource tags.
101
89
102
-
Select **Single sign-on**.
90
+
- All Azure resources with tags defined in include rules send logs to Datadog.
91
+
- All Azure resources with tags defined in exclude rules don't send logs to Datadog.
103
92
104
-
## Single sign-on tab (optional)
93
+
> [!NOTE]
94
+
> If there's a conflict between inclusion and exclusion rules, exclusion takes priority.
105
95
106
-
If your organization uses Microsoft Entra ID as its identity provider, you can establish single sign-on from the Azure portal to Datadog.
96
+
Select the **Next** button at the bottom of the page.
107
97
108
-
To establish single sign-on through Microsoft Entra ID, select the checkbox.
98
+
### Security tab (optional)
109
99
110
-
The Azure portal retrieves the appropriate Datadog application from Microsoft Entra ID, which matches the Enterprise app you provided previously.
100
+
If you wish to enable Datadog Cloud Security Posture management, select the checkbox.
111
101
112
-
Select the Datadog app name.
102
+
Select the **Next** button at the bottom of the page.
113
103
114
-
Select **Next: Tags**.
104
+
### Single sign-on tab (optional)
115
105
116
-
## Tags tab (optional)
106
+
If your organization uses Microsoft Entra ID as its identity provider, you can establish single sign-on from the Azure portal to Datadog.
117
107
118
-
If you wish, you can optionally create tags resource, then select the **Next: Review + create** button at the bottom of the page.
108
+
To establish single sign-on through Microsoft Entra ID:
119
109
120
-
Select Next: Review + create.
110
+
1.Select the checkbox.
121
111
122
-
## Review + create tab
112
+
The Azure portal retrieves the appropriate Datadog application from Microsoft Entra ID, which matches the Enterprise app you provided previously.
123
113
124
-
If the review identifies errors, a red dot appears next each section where errors exist. Fields with errors are highlighted in red.
114
+
1. Select the Datadog app name.
125
115
126
-
1. Open each section with errors and fix the errors.
116
+
Select the **Next** button at the bottom of the page.
127
117
128
-
1. Select the **Review + create** button again.
118
+
### Tags tab (optional)
129
119
130
-
1. Select the **Create** button.
120
+
[!INCLUDE [tags](../includes/tags.md)]
131
121
132
-
Once the resource is created, select **Go to Resource** to navigate to the Datadog resource.
122
+
### Review + create tab
133
123
134
-
:::image type="content" source="media/go-to-resource.png" alt-text="A screenshot of the Overview for a newly created Datadog resource with the Go to Resource button emphasized.":::
0 commit comments