Skip to content

Commit c68aba8

Browse files
updates
1 parent b55440c commit c68aba8

File tree

3 files changed

+98
-113
lines changed

3 files changed

+98
-113
lines changed

articles/partner-solutions/datadog/manage.md

Lines changed: 70 additions & 113 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,9 @@ This article shows how to manage the settings for Datadog.
1717

1818
## Resource overview
1919

20-
To see details of your Datadog resource, select **Overview** in the left pane.
20+
[!INCLUDE [manage](../includes/manage.md)]
21+
22+
:::image type="content" source="media/manage/resource-overview.png" alt-text="A screenshot of a Datadog resource in the Azure portal with the overview displayed in the working pane." lightbox="media/manage/resource-overview.png":::
2123

2224
The details include:
2325

@@ -29,7 +31,7 @@ The details include:
2931
- Datadog organization
3032
- Status
3133
- Pricing Plan
32-
- Billing Plan
34+
- Billing Term
3335

3436
To manage your resource, select the links next to corresponding details.
3537

@@ -50,181 +52,136 @@ A summary of resources is also displayed in the working pane.
5052

5153
## Reconfigure rules for metrics and logs
5254

53-
To change the configuration rules for metrics and logs, select **Datadog organization configurations > Metrics and Logs** in the Resource menu.
55+
To change the configuration rules for metrics and logs:
5456

55-
## View monitored resources
57+
[!INCLUDE [manage](../includes/manage.md)]
5658

57-
To see the list of resources emitting logs to Datadog, select **Datadog organization configurations > Monitored Resources** in the Resource menu.
59+
1. Select **Datadog organization configurations > Metrics and Logs** from the Resource menu.
5860

59-
You can filter the list of resources by resource type, subscription, resource group name, location, and whether the resource is sending logs and metrics.
61+
## View monitored resources
6062

61-
The column **Logs to Datadog** indicates whether the resource is sending logs to Datadog.
63+
To see the list of resources emitting logs to Datadog:
6264

63-
## Monitor multiple subscriptions
65+
[!INCLUDE [manage](../includes/manage.md)]
6466

65-
You can monitor multiple subscriptions by linking them to a single Datadog resource tied to a Datadog organization, which provides a single pane of glass view for all resources across multiple subscriptions.
67+
1. Select **Datadog organization configurations > Monitored Resources** in the Resource menu.
6668

67-
To manage multiple subscriptions that you want to monitor, select **Monitored Subscriptions** in the **Datadog organization configurations** section of the Resource menu.
69+
You can filter the list of resources by resource type, subscription, resource group name, location, and whether the resource is sending logs and metrics.
6870

69-
From **Monitored Subscriptions** in the Resource menu, select the **Add Subscriptions**. The **Add Subscriptions** experience that opens and shows the subscriptions you have _Owner_ role assigned to and any Datadog resource created in those subscriptions that is already linked to the same Datadog organization as the current resource.
71+
The column **Logs to Datadog** indicates whether the resource is sending logs to Datadog.
7072

71-
If the subscription you want to monitor has a resource already linked to the same Datadog org, delete the Datadog resources to avoid shipping duplicate data, and incurring double the charges.
73+
## Monitor multiple subscriptions
7274

73-
Select the subscriptions you want to monitor through the Datadog resource and select **Add**.
75+
To monitor multiple subscriptions:
7476

75-
If the list doesn’t get updated automatically, select **Refresh** to view the subscriptions and their monitoring status. You might see an intermediate status of _In Progress_ while a subscription gets added. When the subscription is successfully added, you see the status is updated to **Active**. If a subscription fails to get added, **Monitoring Status** shows as **Failed**.
77+
[!INCLUDE [manage](../includes/manage.md)]
7678

77-
The set of tag rules for metrics and logs defined for the Datadog resource apply to all subscriptions that are added for monitoring. Setting separate tag rules for different subscriptions isn't supported. Diagnostics settings are automatically added to resources in the added subscriptions that match the tag rules defined for the Datadog resource.
79+
1. Select **Datadog organization configurations > Monitored Subscriptions**.
7880

79-
### Remove/unlink subscriptions from a Datadog resource
81+
1. Select **Add subscriptions** from the Command bar.
8082

81-
You can unlink subscriptions you don't want monitored through the Datadog resource by selecting **Monitored Subscriptions** from the Resource menu. Then, select any subscription you want to remove, and select **Remove subscriptions**. Select **Refresh** to view the updated list of subscriptions being monitored.
83+
The **Add Subscriptions** experience that opens and displays subscriptions you have _Owner_ role assigned to and any Datadog resource created in those subscriptions that is already linked to the same Datadog organization as the current resource.
84+
85+
If the subscription you want to monitor has a resource already linked to the same Datadog org, delete the Datadog resources to avoid shipping duplicate data, and incurring double the charges.
8286

83-
## API keys
87+
1. Select the subscriptions you want to monitor through the Datadog resource and select **Add**.
8488

85-
To view the list of API keys for your Datadog resource, select the **Keys** in the left pane. You see information about the keys.
89+
Diagnostics settings are automatically added to the subscription's resources that match the defined tag rules.
8690

87-
The Azure portal provides a read-only view of the API keys. To manage the keys, select the Datadog portal link. After making changes in the Datadog portal, refresh the Azure portal view.
91+
> [!TIP]
92+
> - If the list doesn’t get updated automatically, select **Refresh** to view the subscriptions and their monitoring status.
8893
89-
The Azure Datadog integration provides you with the ability to install Datadog agent on a virtual machine or app service. If a default key isn't selected, the Datadog agent installation fails.
94+
When the subscription is successfully added, One the subscription is added, the status changes to *Active*.
9095

91-
## Monitor virtual machines using the Datadog agent
96+
> [!NOTE]
97+
>
98+
> Setting separate tag rules for different subscriptions isn't supported.
9299
93-
You can install Datadog agents on virtual machines as an extension. Go to **Virtual machine agent** under the **Datadog organization configurations** in the Resource menu. This screen shows all the virtual machines across all subscriptions you have the *Owner* role assigned to. All subscriptions are selected by default. You can select a subset of subscriptions to narrow down the list of virtual machines shown in the subscription.
100+
### Remove subscriptions from a Datadog resource
94101

95-
For each virtual machine, the following data is displayed:
102+
To unlink subscriptions from a Datadog resource:
96103

97-
- Resource Name – Virtual machine name
98-
- Resource Status – Whether the virtual machine is stopped or running. The Datadog agent can only be installed on virtual machines that are running. If the virtual machine is stopped, installing the Datadog agent is disabled.
99-
- Agent version – The Datadog agent version number.
100-
- Agent status – Whether the Datadog agent is running on the virtual machine.
101-
- Integrations enabled – The key metrics collected by the Datadog agent.
102-
- Install Method – The specific tool used to install the Datadog agent. For example, Chef or Script.
103-
- Sending logs – Whether the Datadog agent is sending logs to Datadog.
104+
1. Select **Datadog organization configurations > Monitored Subscriptions** from the Resource menu.
104105

105-
Select the virtual machine to install the Datadog agent on. Select **Install Agent**.
106+
1. Select the subscription you want to remove.
106107

107-
The portal asks for confirmation that you want to install the agent with the default key. Select **OK** to begin installation. Azure shows the status as **Installing** until the agent is installed and provisioned.
108+
1. Choose **Remove subscriptions**.
108109

109-
After the Datadog agent is installed, the status changes to Installed.
110+
To view the updated list of monitored subscriptions, select **Refresh** from the Command bar.
110111

111-
To see that the Datadog agent is installed, select the virtual machine and navigate to the Extensions window.
112+
## API keys
112113

113-
You can uninstall Datadog agents on a virtual machine by going to **Virtual machine agent**. Select the virtual machine and **Uninstall agent**.
114+
To view the list of API keys for your Datadog resource:
114115

115-
## Monitor App Services using the Datadog agent as an extension
116+
1. Select **Settings > Keys** from the Resource menu.
116117

117-
You can install Datadog agents on app services as an extension. Go to **App Service extension** in left pane. This screen shows the list of all app services across all subscriptions you have *Owner* role assigned to. All subscriptions are selected by default. You can select a subset of subscriptions to narrow down the list of app services shown.
118+
The Azure portal provides a read-only view of the API keys.
118119

119-
For each app service, the following data elements are displayed:
120+
1. To manage the keys, select the **Datadog portal** link.
120121

121-
- Resource Name – Virtual machine name.
122-
- Resource Status – Whether the app service is stopped or running. The Datadog agent can only be installed on app services that are running. If the app service is stopped, installing the Datadog agent is disabled.
123-
- App service plan – The specific plan configured for the app service.
124-
- Agent version – The Datadog agent version number.
122+
The Datadog portal opens in a new tab.
125123

126-
To install the Datadog agent, select the app service and **Install Extension**. The latest Datadog agent is installed on the app service as an extension.
124+
After making changes in the Datadog portal, refresh the Azure portal view.
127125

128-
The portal confirms that you want to install the Datadog agent. Also, the application settings for the specific app service are updated with the default key. The app service is restarted after the install of the Datadog agent completes.
126+
## Monitor resources with Datadog agents
129127

130-
Select **OK** to begin the installation process for the Datadog agent. The portal shows the status as **Installing** until the agent is installed. After the Datadog agent is installed, the status changes to Installed.
128+
You can install Datadog agents on virtual machines, App Service extensions, Azure Kubernetes Services, and Azure Arc Machines.
131129

132-
To uninstall Datadog agents on the app service, go to **App Service Extension**. Select the app service and **Uninstall Extension**
130+
> [!IMPORTANT]
131+
> If a default key isn't selected, your Datadog agent installation will fail. See [API keys](#api-keys).
133132
134-
## Monitor AKS clusters using the Datadog extension
135-
You can collect monitoring data from your containerized applications deployed on Azure Kubernetes Service (AKS) by installing the Datadog Agent on your AKS clusters.
136-
- Select **Datadog organization configurations** > **Azure Kubernetes Services** from the *Service menu*.
133+
### Virtual machines
137134

138-
A list of all AKS Clusters in the subscription displays in the working pane. If you have added multiple subscriptions via the **Monitored Subscriptions** blade, AKS clusters across all of those subscriptions are listed. Filters include *Resource Group*, *Subscription*, *Resource Status* and *Agent Status*.
135+
To monitor resources for virtual machines, select **Datadog organization configurations > Virtual machine agent** from the Resource pane.
139136

140-
For each AKS resource, the following info appears:
137+
[!INCLUDE [install-datadog-agent](../includes/=datadog-agent.md)]
141138

142-
| Property | Description |
143-
|--------------------------|--------------------------------------------------------------------------|
144-
| **Resource Name** | Name of the AKS Cluster. |
145-
| **Resource Group** | Name of the resource group containing the AKS resource. |
146-
| **Subscription** | Name of the subscription containing the AKS resource. |
147-
| **Kubernetes Version** | The version of Kubernetes running in the cluster. |
148-
| **Resource Status** | Indicates whether the AKS resource is stopped or running. |
149-
| **Agent Status** | Indicates whether the Datadog agent is running on the AKS Cluster. |
150-
| **Agent Version** | Version of the Datadog agent. |
139+
### App Service
151140

152-
- To install the agent, choose the AKS clusters you would like to monitor and click on **Install Extension**. Select **OK** to begin the installation process for the Datadog agent. After the Datadog agent is installed, the agent status changes to *Installed*.
141+
To monitor resources for App Service, select **Datadog organization configurations > App Service extension** from the Resource pane.
153142

154-
You can uninstall the Datadog agent on a cluster by selecting the AKS resource and clicking on **Uninstall Extension**.
143+
[!INCLUDE [install-datadog-agent](../includes/=datadog-agent.md)]
155144

156-
## Monitor Arc enabled servers using the Datadog agent
157-
You can monitor your Azure Arc-enabled servers by installing the Datadog agent as an extension.
158-
- Select **Datadog organization configurations** > **Azure Arc Machines** from the *Service menu*.
145+
### Azure Kubernetes Services
159146

160-
A list of all Arc-enabled servers in the subscription displays in the working pane. If you have added multiple subscriptions via the **Monitored Subscriptions** blade, resources across all of those subscriptions are listed. Filters include *Resource Group*, *Subscription*, *Resource Status* and *Agent Status*.
147+
To monitor resources Azure Kubernetes Services, select **Datadog organization configurations > Azure Kubernetes Services** from the Resource pane.
161148

162-
For each Arc-enabled server, the following info appears:
149+
[!INCLUDE [install-datadog-agent](../includes/=datadog-agent.md)]
163150

164-
| Property | Description |
165-
|--------------------------|--------------------------------------------------------------------------|
166-
| **Resource Name** | Name of the Azure Arc-enabled server. |
167-
| **Resource Group** | Name of the resource group containing the Arc-enabled server. |
168-
| **Subscription** | Name of the subscription containing the Arc-enabled server. |
169-
| **Resource Status** | Indicates whether the Arc-enabled server is stopped or running. |
170-
| **Agent Status** | Indicates whether the Datadog agent is running on the Arc-enabled server.|
171-
| **Agent Version** | Version of the Datadog agent. |
151+
### Azure Arc Machines
172152

173-
- To install the agent, choose the Arc-enabled servers you would like to monitor and click on **Install Extension**. Select **OK** to begin the installation process for the Datadog agent. After the Datadog agent is installed, the agent status changes to *Installed*.
153+
To monitor resources for Azure Arc Machines, select **Datadog organization configurations > Azure Arc Machines** from the Resource pane.
174154

175-
You can uninstall the Datadog agent on an Arc server by selecting the resource and clicking on **Uninstall Extension**.
155+
[!INCLUDE [install-datadog-agent](../includes/=datadog-agent.md)]
176156

177157
## Reconfigure single sign-on
178158

179-
If you would like to reconfigure single sign-on, select **Single sign-on** in the left pane.
159+
To enable single sign-on through Microsoft Entra ID:
180160

181-
To establish single sign-on through Microsoft Entra ID, select **Enable single sign-on through Microsoft Entra ID**.
161+
1. Select **Settings > Single sign-on** from the Resource pane.
182162

183-
The portal retrieves the appropriate Datadog application from Microsoft Entra ID. The app comes from the enterprise app name you selected when setting up integration. Select the Datadog app name:
163+
1. Select the check box.
184164

185165
## Change your billing plan
186166

187-
To change the Datadog billing plan, go to **Overview** and select **Change Plan**.
188-
189-
The portal retrieves all the available Datadog plans for your tenant.
190-
191-
Choose the appropriate plan and select **Change Plan**.
167+
[!INCLUDE [change-plan](../includes/change-plan.md)]
192168

193-
## Disable or enable integration
169+
## Manage logs and metrics
194170

195-
You can stop sending logs and metrics from Azure to Datadog. You continue to be billed for other Datadog services that aren't related to monitoring metrics and logs.
171+
To stop sending logs and metrics from Azure to Datadog:
196172

197-
To disable the Azure integration with Datadog, go to **Overview**. Select **Disable** and **OK**.
173+
[!INCLUDE [manage](../includes/manage.md)]
198174

199-
To enable the Azure integration with Datadog, go to **Overview**. Select **Enable** and **OK**.
175+
1. Select **Disable** from the Command bar.
200176

201-
Selecting **Enable** retrieves any previous configuration for metrics and logs. The configuration determines which Azure resources emit metrics and logs to Datadog. After you complete this step, metrics and logs are sent to Datadog.
177+
> [!IMPORTANT]
178+
> Billing continues for other Datadog services that aren't related to monitoring metrics and logs.
202179
203180
## Delete a Datadog resource
204181

205-
If only one Datadog resource is mapped to a Datadog organization, logs and metrics are no longer sent to Datadog. All billing stops for Datadog through Azure Marketplace.
206-
207-
If more than one Datadog resource is mapped to the Datadog organization, deleting the Datadog resource only stops sending logs and metrics for that Datadog resource. Because the Datadog organization is linked to other Azure resources, billing continues through Azure Marketplace.
208-
209-
If you're done using your resource and would like to delete it, follow these steps:
210-
211-
1. From the **Resource** menu, select the resource you would like to delete.
182+
[!INCLUDE [delete-resource](../includes/delete-resource.md)]
212183

213-
1. On the working pane of the **Overview** menu, select **Delete**.
214-
215-
1. Confirm deletion.
216-
217-
1. Select a reason for deleting the resource.
218-
219-
1. Select **Delete**.
220-
221-
## Next steps
184+
## Related content
222185

223186
- [Troubleshooting Datadog solutions](troubleshoot.md)
224-
- Get started with Datadog on
225-
226-
> [!div class="nextstepaction"]
227-
> [Azure portal](https://portal.azure.com/#view/HubsExtension/BrowseResource/resourceType/Microsoft.Datadog%2Fmonitors)
228187

229-
> [!div class="nextstepaction"]
230-
> [Azure Marketplace](https://azuremarketplace.microsoft.com/marketplace/apps/datadog1591740804488.dd_liftr_v2?tab=Overview)
38.3 KB
Loading
Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
---
2+
author: ProfessorKendrick
3+
ms.topic: include
4+
ms.date: 03/10/2025
5+
ms.author: kkendrick
6+
---
7+
#### Install a Datadog agent
8+
9+
To install a Datadog agent:
10+
11+
1. Choose the resource you would like to monitor.
12+
13+
1. Select **Install Extension**.
14+
15+
1. Select **OK**.
16+
17+
> [!NOTE]
18+
>
19+
> - After the Datadog agent is installed, the status changes to *Installed*.
20+
> - The service restarts once installation is complete.
21+
22+
#### Uninstall a Datadog agent
23+
24+
To uninstall a Datadog agent:
25+
26+
1. Choose a resource.
27+
28+
1. Select **Uninstall Extension**.

0 commit comments

Comments
 (0)