|
1 | 1 | ---
|
2 |
| -title: Create Datadog |
3 |
| -description: This article describes how to use the Azure portal to create an instance of Datadog. |
4 |
| - |
| 2 | +title: Create a Datadog resource |
| 3 | +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. |
5 | 4 |
|
6 | 5 | ms.topic: quickstart
|
7 |
| -ms.date: 01/06/2023 |
8 |
| - |
9 |
| -ms.custom: references_regions |
10 |
| - |
| 6 | +ms.date: 12/11/2024 |
| 7 | +ms.custom: |
| 8 | + - references_regions |
| 9 | + - ai-gen-docs-bap |
| 10 | + - ai-gen-desc |
| 11 | + - ai-seo-date:12/03/2024 |
11 | 12 | ---
|
12 | 13 |
|
13 |
| -# QuickStart: Get started with Datadog - An Azure Native ISV Service by creating new instance |
| 14 | +# QuickStart: Get started with Datadog |
14 | 15 |
|
15 |
| -In this quickstart, you'll create a new instance of Datadog - An Azure Native ISV Service. You can either create a new Datadog organization or [link to an existing Datadog organization](link-to-existing-organization.md). |
| 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). |
16 | 17 |
|
17 | 18 | ## Prerequisites
|
18 | 19 |
|
19 |
| -Before creating your first instance of Datadog in Azure, [configure your environment](prerequisites.md). These steps must be completed before continuing with the next steps in this quickstart. |
20 |
| - |
21 |
| -## Find offer |
| 20 | +Before creating your first instance of Datadog in Azure, [configure your environment](prerequisites.md). |
22 | 21 |
|
23 |
| -Use the Azure portal to find Datadog. |
| 22 | +## Setup |
24 | 23 |
|
25 |
| -1. Go to the [Azure portal](https://portal.azure.com/) and sign in. |
| 24 | +Begin by signing into the [Azure portal](https://portal.azure.com). |
26 | 25 |
|
27 |
| -1. If you've visited the **Marketplace** in a recent session, select the icon from the available options. Otherwise, search for _Marketplace_. |
| 26 | +## Create a Datadog resource |
28 | 27 |
|
29 |
| - :::image type="content" source="media/create/marketplace.png" alt-text="Screenshot of the Azure Marketplace icon."::: |
| 28 | +To create your resource, start at the Azure portal home page. |
30 | 29 |
|
31 |
| -1. In the Marketplace, search for **Datadog**. |
| 30 | +1. Search for the resource provider by typing it into the header search bar. |
32 | 31 |
|
33 |
| -1. In the plan overview screen, select **Subscribe**. |
| 32 | +1. Choose the service you want from the *Services* search results. |
34 | 33 |
|
35 |
| - :::image type="content" source="media/create/datadog-app-2.png" alt-text="Screenshot of the Datadog application in Azure Marketplace."::: |
36 |
| - |
37 |
| -## Create a Datadog resource in Azure |
| 34 | +1. Select the **+ Create** option. |
38 | 35 |
|
39 | 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.
|
40 | 37 |
|
41 |
| -If you're creating a new Datadog organization, select **Create** under the **Create a new Datadog organization** |
42 |
| - |
43 |
| -:::image type="content" source="media/create/datadog-create-link-selection.png" alt-text="Screenshot of the create or link a Datadog organization."::: |
| 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."::: |
44 | 39 |
|
45 |
| -The portal displays a form for creating the Datadog resource. |
46 |
| - |
47 |
| -:::image type="content" source="media/create/datadog-create-resource.png" alt-text="Screenshot of the create Datadog resource."::: |
48 |
| - |
49 |
| -Provide the following values. |
| 40 | +If you're creating a new Datadog organization, select **Create** under the **Create a new Datadog organization** |
50 | 41 |
|
51 |
| -|Property | Description |
52 |
| -|:-----------|:-------- | |
53 |
| -| Subscription | Select the Azure subscription you want to use for creating the Datadog resource. You must have owner access. | |
54 |
| -| Resource group | Specify whether you want to create a new resource group or use an existing one. A [resource group](../../azure-resource-manager/management/overview.md#resource-groups) is a container that holds related resources for an Azure solution. | |
55 |
| -| Resource name | Specify a name for the Datadog resource. This name will be the name of the new Datadog organization, when creating a new Datadog organization. | |
56 |
| -| Location | Select West US 2. Currently, West US 2 is the only supported region. | |
57 |
| -| Pricing plan | When creating a new organization, select from the list of available Datadog plans. | |
58 |
| -| Billing Term | Monthly. | |
| 42 | +The Create a Datadog resource pane opens to the *Basics* tab by default. |
59 | 43 |
|
60 |
| -## Configure metrics and logs |
| 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."::: |
61 | 45 |
|
62 |
| -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. |
| 46 | +### Basics tab |
63 | 47 |
|
64 |
| -Tag rules for sending **metrics** are: |
| 48 | +The *Basics* tab has three sections: |
65 | 49 |
|
66 |
| -- By default, metrics are collected for all resources, except virtual machines, Virtual Machine Scale Sets, and App Service plans. |
67 |
| -- Virtual machines, Virtual Machine Scale Sets, and App Service plan with _Include_ tags send metrics to Datadog. |
68 |
| -- Virtual machines, Virtual Machine Scale Sets, and App Service plan with _Exclude_ tags don't send metrics to Datadog. |
69 |
| -- If there's a conflict between inclusion and exclusion rules, exclusion takes priority. |
| 50 | +- Project details |
| 51 | +- Azure resource details |
| 52 | +- Datadog organization details |
70 | 53 |
|
71 |
| -Tag rules for sending **logs** are: |
| 54 | +There are required fields in each section that you need to fill out. |
72 | 55 |
|
73 |
| -- By default, logs are collected for all resources. |
74 |
| -- Azure resources with _Include_ tags send logs to Datadog. |
75 |
| -- Azure resources with _Exclude_ tags don't send logs to Datadog. |
76 |
| -- If there's a conflict between inclusion and exclusion rules, exclusion takes priority. |
| 56 | +1. Enter the values for each required setting under *Project details*. |
77 | 57 |
|
78 |
| -For example, the following screenshot shows a tag rule where only those virtual machines, Virtual Machine Scale Sets, and App Service plan tagged as _Datadog = True_ send metrics to Datadog. |
| 58 | + |Setting |Action | |
| 59 | + |-------------------|-------------------------------------------------------------| |
| 60 | + |Subscription |Select a subscription from your existing subscriptions. | |
| 61 | + |Resource group |Use an existing resource group or create a new one. | |
79 | 62 |
|
80 |
| -:::image type="content" source="media/create/config-metrics-logs.png" alt-text="Screenshot of how to configure metrics and logs in Azure for Datadog."::: |
| 63 | +1. Enter the values for each required setting under *Resource details*. |
81 | 64 |
|
82 |
| -There are three types of logs that can be sent from Azure to Datadog. |
| 65 | + |Setting |Action | |
| 66 | + |-------------------|-------------------------------------------------------------| |
| 67 | + |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. | |
83 | 69 |
|
84 |
| -1. **Subscription level logs** - Provide insight into the operations on your resources at the [control plane](../../azure-resource-manager/management/control-plane-and-data-plane.md). Updates on service health events are also included. Use the activity log to determine the what, who, and when for any write operations (PUT, POST, DELETE). There's a single activity log for each Azure subscription. |
| 70 | +1. Enter the values for each required setting under *Datadog organization details*. |
85 | 71 |
|
86 |
| -1. **Azure resource logs** - Provide insight into operations that were taken on an Azure resource at the [data plane](../../azure-resource-manager/management/control-plane-and-data-plane.md). For example, getting a secret from a Key Vault is a data plane operation. Or, making a request to a database is also a data plane operation. The content of resource logs varies by the Azure service and resource type. |
| 72 | +### Metrics and logs tab |
87 | 73 |
|
88 |
| -1. **Microsoft Entra logs** - As an IT administrator, you want to monitor your IT environment. The information about your system's health enables you to assess potential issues and decide how to respond. |
| 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. |
89 | 75 |
|
90 |
| -The Microsoft Entra admin center gives you access to three activity logs: |
| 76 | +Enter the names and values for each *Action* listed under Metrics and Logs. |
91 | 77 |
|
92 |
| -- [Sign-in](../../active-directory/reports-monitoring/concept-sign-ins.md) – Information about sign-ins and how your resources are used by your users. |
93 |
| -- [Audit](../../active-directory/reports-monitoring/concept-audit-logs.md) – Information about changes applied to your tenant such as users and group management or updates applied to your tenant's resources. |
94 |
| -- [Provisioning](../../active-directory/reports-monitoring/concept-provisioning-logs.md) – Activities performed by the provisioning service, such as the creation of a group in ServiceNow or a user imported from Workday. |
| 78 | +<!--Metrics--> |
| 79 | +<!--Silence monitoring for expected Azure VM Shutdowns--> |
| 80 | +<!--Collect custom metrics from App Insights--> |
95 | 81 |
|
96 |
| -To send subscription level logs to Datadog, select **Send subscription activity logs**. If this option is left unchecked, none of the subscription level logs are sent to Datadog. |
| 82 | +<!--Logs--> |
| 83 | +<!--Send subscription activity logs--> |
| 84 | +<!--Send Azure resource logs for all defined sources.--> |
97 | 85 |
|
98 |
| -To send Azure resource logs to Datadog, select **Send Azure resource logs for all defined resources**. The types of Azure resource logs are listed in [Azure Monitor Resource Log categories](/azure/azure-monitor/essentials/resource-logs-categories). To filter the set of Azure resources sending logs to Datadog, use Azure resource tags. |
| 86 | +Once you complete the configuration for metrics and logs, select **Next: Security**. |
99 | 87 |
|
100 |
| -You can request your IT Administrator to route Microsoft Entra logs to Datadog. For more information, see [Microsoft Entra activity logs in Azure Monitor](../../active-directory/reports-monitoring/concept-activity-logs-azure-monitor.md). |
| 88 | +## Security tab |
101 | 89 |
|
102 |
| -The logs sent to Datadog will be charged by Azure. For more information, see the [pricing of platform logs](https://azure.microsoft.com/pricing/details/monitor/) sent to Azure Marketplace partners. |
| 90 | +To enable Datadog Cloud Security Posture management, select the checkbox. |
103 | 91 |
|
104 |
| -Once you have completed configuring metrics and logs, select **Next: Single sign-on**. |
| 92 | +Select **Single sign-on**. |
105 | 93 |
|
106 |
| -## Configure single sign-on |
| 94 | +## Single sign-on tab (optional) |
107 | 95 |
|
108 |
| -If your organization uses Microsoft Entra ID as its identity provider, you can establish single sign-on from the Azure portal to Datadog. If your organization uses a different identity provider or you don't want to establish single sign-on at this time, you can skip this section. |
| 96 | +If your organization uses Microsoft Entra ID as its identity provider, you can establish single sign-on from the Azure portal to Datadog. |
109 | 97 |
|
110 |
| -To establish single sign-on through Microsoft Entra ID, select the checkbox for **Enable single sign-on through Microsoft Entra ID**. |
| 98 | +To establish single sign-on through Microsoft Entra ID, select the checkbox. |
111 | 99 |
|
112 |
| -The Azure portal retrieves the appropriate Datadog application from Microsoft Entra ID. The app matches the Enterprise app you provided in an earlier step. |
| 100 | +The Azure portal retrieves the appropriate Datadog application from Microsoft Entra ID, which matches the Enterprise app you provided previously. |
113 | 101 |
|
114 | 102 | Select the Datadog app name.
|
115 | 103 |
|
116 |
| -:::image type="content" source="media/create/sso.png" alt-text="Screenshot of the enable Single sign-on to Datadog."::: |
117 |
| - |
118 | 104 | Select **Next: Tags**.
|
119 | 105 |
|
120 |
| -## Add custom tags |
| 106 | +## Tags tab (optional) |
121 | 107 |
|
122 |
| -You can specify custom tags for the new Datadog resource. Provide name and value pairs for the tags to apply to the Datadog resource. |
| 108 | +If you wish, you can optionally create tags resource, then select the **Next: Review + create** button at the bottom of the page. |
123 | 109 |
|
124 |
| -:::image type="content" source="media/create/tags.png" alt-text="Screenshot of the add custom tags for the Datadog resource."::: |
| 110 | +Select **Next: Review + create**. |
125 | 111 |
|
126 |
| -When you've finished adding tags, select **Next: Review+Create**. |
| 112 | +## Review + create tab |
127 | 113 |
|
128 |
| -## Review + Create Datadog resource |
| 114 | +If the review identifies errors, a red dot appears next each section where errors exist. Fields with errors are highlighted in red. |
129 | 115 |
|
130 |
| -Review your selections and the terms of use. After validation completes, select **Create**. |
| 116 | +1. Open each section with errors and fix the errors. |
131 | 117 |
|
132 |
| -:::image type="content" source="media/create/review-create.png" alt-text="Screenshot of Review and Create a Datadog resource."::: |
| 118 | +1. Select the **Review + create** button again. |
133 | 119 |
|
134 |
| -Azure deploys the Datadog resource. |
| 120 | +1. Select the **Create** button. |
135 | 121 |
|
136 |
| -When the process completes, select **Go to Resource** to see the Datadog resource. |
| 122 | +Once the resource is created, select **Go to Resource** to navigate to the Datadog resource. |
137 | 123 |
|
138 |
| -:::image type="content" source="media/create/go-to-resource.png" alt-text="Screenshot of the Datadog resource deployment."::: |
| 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."::: |
139 | 125 |
|
140 | 126 | ## Next steps
|
141 | 127 |
|
142 | 128 | - [Manage the Datadog resource](manage.md)
|
143 |
| -- Get started with Datadog – An Azure Native ISV Service on |
| 129 | +- Get started with Datadog on |
144 | 130 |
|
145 | 131 | > [!div class="nextstepaction"]
|
146 | 132 | > [Azure portal](https://portal.azure.com/#view/HubsExtension/BrowseResource/resourceType/Microsoft.Datadog%2Fmonitors)
|
|
0 commit comments