Skip to content

Commit 89b9c36

Browse files
updates
1 parent b1ee3f7 commit 89b9c36

File tree

2 files changed

+62
-79
lines changed

2 files changed

+62
-79
lines changed

articles/partner-solutions/datadog/create.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,9 +13,7 @@ ms.custom:
1313

1414
# QuickStart: Get started with Datadog
1515

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).
17-
18-
In this quickstart, you create an instance of Azure Native New Relic Service.
16+
In this quickstart, you create a new instance of Datadog.
1917

2018
## Prerequisites
2119

@@ -27,6 +25,9 @@ In this quickstart, you create an instance of Azure Native New Relic Service.
2725

2826
[!INCLUDE [create-resource](../includes/create-resource.md)]
2927

28+
> [!NOTE]
29+
> 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.
30+
3031
### Basics tab
3132

3233
The *Basics* tab has three sections:

articles/partner-solutions/datadog/link-to-existing-organization.md

Lines changed: 58 additions & 76 deletions
Original file line numberDiff line numberDiff line change
@@ -10,39 +10,28 @@ ms.custom: references_regions
1010

1111
# QuickStart: Link to existing Datadog organization
1212

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.
1414

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.
24-
25-
1. If you've visited the **Marketplace** in a recent session, select the icon from the available options. Otherwise, search for _Marketplace_.
15+
> [!NOTE]
16+
> You can either [create a new Datadog organization](create.md) or link to an existing Datadog organization.
2617
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
3219

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.
20+
[!INCLUDE [create-prerequisites](../includes/create-prerequisites.md)]
21+
- You must [configure your environment](prerequisites.md).
22+
- You must [subscribe to Datadog](overview.md#subscribe-to-datadog).
3423

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
3625

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/).
3827

39-
The portal displays the Create a Datadog resource pane.
28+
1. Type the name of the service in the header search bar.
4029

41-
## Create a Datadog resource
30+
1. Choose the service from the *Services* search results.
4231

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**.
4433

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.
4635

4736
### Basics tab
4837

@@ -51,55 +40,66 @@ The *Basics* tab has three sections:
5140
- Project details
5241
- Azure resource details
5342
- Datadog organization details
43+
-
44+
- :::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.":::
5445

55-
There are required fields in each section that you need to fill out.
46+
There are required fields (identified with a red asterisk) in each section that you need to fill out.
5647

5748
1. Enter the values for each required setting under *Project details*.
5849

59-
|Setting |Action |
60-
|-------------------|-------------------------------------------------------------|
61-
|Subscription |Select a subscription from your existing subscriptions. |
62-
|Resource group |Use an existing resource group or create a new one. |
50+
| Field | Action |
51+
|---------------------|-----------------------------------------------------------|
52+
| Subscription | Select a subscription from your existing subscriptions. |
53+
| Resource group | Use an existing resource group or create a new one. |
6354

64-
1. Enter the values for each required setting under *Resource details*.
55+
1. Enter the values for each required setting under *Azure Resource details*.
6556

66-
|Setting |Action |
67-
|-------------------|-------------------------------------------------------------|
68-
|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. |
57+
| Field | Action |
58+
|--------------------|-------------------------------------------|
59+
| Resource name | Specify a unique name for the resource. |
60+
| Region | Select a region to deploy your resource. |
7061

71-
1. Enter the values for each required setting under *Datadog organization details*.
62+
1. Select **Link to Datadog organization** under *Datadog organization details*.
7263

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**.
7465

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+
> - If the subscription is already linked to an organization through a Datadog resource, you cannot link the subscription to the same organization through a different Datadog resource. This avoids duplicate logs and metrics being shipped to the same organization for the same subscription.
7670
77-
Select **Next: Metrics and logs** to configure metrics and logs.
71+
Once you've finished authenticating, return to the Azure portal.
7872

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.
8174

82-
### Metrics and logs tab
75+
### Metrics and logs tab (optional)
8376

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.
8578

8679
Enter the names and values for each *Action* listed under Metrics and Logs.
8780

88-
<!--Metrics-->
89-
<!--Silence monitoring for expected Azure VM Shutdowns-->
90-
<!--Collect custom metrics from App Insights-->
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**.
9185

92-
<!--Logs-->
93-
<!--Send subscription activity logs-->
94-
<!--Send Azure resource logs for all defined sources.-->
86+
#### Inclusion and exclusion rules for metrics and logs
9587

96-
Once you complete the configuration for metrics and logs, select **Next: Security**.
88+
To filter the set of Azure resources that send logs to Datadog, use inclusion and exclusion rules and set Azure resource tags.
9789

98-
## Security tab
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.
9992

100-
To enable Datadog Cloud Security Posture management, select the checkbox.
93+
> [!NOTE]
94+
> If there's a conflict between inclusion and exclusion rules, exclusion takes priority.
10195
102-
Select **Single sign-on**.
96+
Select the **Next** button at the bottom of the page.
97+
98+
## Security tab (optional)
99+
100+
If you wish to enable Datadog Cloud Security Posture management, select the checkbox.
101+
102+
Select the **Next** button at the bottom of the page.
103103

104104
## Single sign-on tab (optional)
105105

@@ -111,35 +111,17 @@ The Azure portal retrieves the appropriate Datadog application from Microsoft En
111111

112112
Select the Datadog app name.
113113

114-
Select **Next: Tags**.
115-
116-
## Tags tab (optional)
117-
118-
If you wish, you can optionally create tags resource, then select the **Next: Review + create** button at the bottom of the page.
114+
Select the **Next** button at the bottom of the page.
119115

120-
Select Next: Review + create.
116+
### Tags tab (optional)
121117

122-
## Review + create tab
118+
[!INCLUDE [tags](../includes/tags.md)]
123119

124-
If the review identifies errors, a red dot appears next each section where errors exist. Fields with errors are highlighted in red.
120+
### Review + create tab
125121

126-
1. Open each section with errors and fix the errors.
127-
128-
1. Select the **Review + create** button again.
129-
130-
1. Select the **Create** button.
131-
132-
Once the resource is created, select **Go to Resource** to navigate to the Datadog resource.
133-
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.":::
122+
[!INCLUDE [review-create](../includes/review-create.md)]
135123

136124
## Next steps
137125

138-
- [Manage the Datadog resource](manage.md)
139-
- Get started with Datadog – An Azure Native ISV Service on
140-
141-
> [!div class="nextstepaction"]
142-
> [Azure portal](https://portal.azure.com/#view/HubsExtension/BrowseResource/resourceType/Microsoft.Datadog%2Fmonitors)
126+
- [Manage settings for your Datadog resource via Azure portal](manage.md)
143127

144-
> [!div class="nextstepaction"]
145-
> [Azure Marketplace](https://azuremarketplace.microsoft.com/marketplace/apps/datadog1591740804488.dd_liftr_v2?tab=Overview)

0 commit comments

Comments
 (0)