Datadog in the Azure Portal

Datadog in the Azure Portal

This guide is for Datadog customers using US3 with Azure.

This guide is for managing the integration between Azure and Datadog in the Azure portal using the Datadog resource. The Datadog resource in Azure represents the connection between a Datadog organization and an Azure subscription. Create a Datadog resource in Azure before proceeding with this guide.

With the Datadog resource, you can manage the following within the associated Azure subscription:

  • Configure the collection of Azure metrics and platform logs
  • Verify the Azure resources sending metrics and logs
  • View API keys and set the key default for your Datadog resource Agent deployments
  • Deploy the Datadog VM Agent to your Azure VMs and view details about running Agents
  • Deploy the Datadog .NET extension to your Azure Web Apps and view details about installed extensions
  • Reconfigure single sign-on
  • Change the billing plan for your Datadog organization (Azure Marketplace only)
  • Enable or disable the Azure integration
  • Delete the Datadog resource

This page describes the Azure Portal experience. If you prefer to use CLI, see the Azure CLI for Datadog.

Overview

Select “Overview” in the left sidebar to view information for your Datadog resource.

Essentials

The overview page displays essential information about your Datadog resource including: resource group name, location (region), subscription, tags, Datadog organization link, status, pricing plan, and billing term.

Note: The Datadog organization link is a SAML link if SSO is enabled. If the Datadog organization was created with the Azure marketplace, set a password the first time you use this link.

The overview page provides links to view Datadog dashboards, logs, and host maps.

Resource summary

The overview page provides a summary table of the resources sending logs and metrics to Datadog. This table includes the following columns:

ColumnDescription
Resource typeThe Azure resource type
Total resourcesThe count of all resources for the resource type
Logs to DatadogThe count of resources sending logs to Datadog through the integration
Metrics to DatadogThe count of resources sending metrics to Datadog through the integration

Disable

To stop sending logs and metrics from Azure to Datadog, select “Disable” on the overview page, then click “OK”.

Note: Disabling the Datadog resource stops the submission of metrics and platform logs to Datadog for the associated subscription. Any resources in the subscription submitting data directly to Datadog through the Agent or extension are unaffected.

Enable

To start sending logs and metrics from Azure to Datadog, select “Enable” on the overview page, then click “OK”. Any previous configuration for logs and metrics is retrieved and enabled.

Delete

To delete the Datadog resource, select “Delete” on the overview page. Confirm deletion by typing yes, then click “Delete”.

For Datadog organizations billed through the Azure Marketplace:

  • If the deleted Datadog resource is the only Datadog resource mapped to its associated Datadog organization, logs and metrics are no longer sent to Datadog and all billing stops for Datadog through Azure. Datadog support will reach out to confirm next steps with your account.
  • If there are additional Datadog resources mapped to the associated Datadog organization, deleting a Datadog resource only stops sending logs and metrics for its associated Azure subscription.

If your Datadog organization is NOT billed through the Azure Marketplace, deleting a Datadog resource just removes the integration for that Azure subscription.

Change plan

Select “Change Plan” on the overview page to change your Datadog billing plan.

The portal retrieves all the available Datadog plans for your tenant, this includes any private offers. Select the appropriate plan and click “Change Plan”.

Datadog org configurations

Metrics and logs

Select “Metrics and logs” in the left sidebar to change the configuration rules for metrics and logs. See the Azure documentation to Configure metrics and logs.

Monitored resources

Select “Monitored Resources” in the left sidebar to see a list of resources emitting logs and metrics to Datadog. Use the search to filter the list by resource name, type, group, location, logs to Datadog, or metrics to Datadog.

The “Logs to Datadog” column displays Sending if the resource is sending logs to Datadog. Otherwise, this field indicates why logs aren’t being sent. Possible reasons:

ReasonDescription
Resource doesn’t support sending logsOnly resource types with monitoring log categories can be configured to send logs to Datadog.
Limit of five diagnostic settings reachedEach Azure resource can have a maximum of five diagnostic settings. For more information, see diagnostic settings.
ErrorThe resource is configured to send logs to Datadog, but is blocked by an error.
Logs not configuredOnly Azure resources with appropriate resource tags are configured to send logs to Datadog.
Region not supportedThe Azure resource is in a region that doesn’t support sending logs to Datadog.
Datadog Agent not configuredVirtual machines without the Datadog Agent installed don’t emit logs to Datadog.

Virtual machine agent

To see a list of virtual machines (VMs) in the subscription, select “Virtual machine agent” in the left sidebar. On this page, you can install the Datadog Agent on a VM as an extension.

For each VM, the following information is displayed:

ColumnDescription
Resource nameThe VM’s name
Resource statusWhether the VM is stopped or running. The Datadog Agent can only be installed on a running VM. If the VM is stopped, installing the Datadog Agent is disabled.
Agent versionThe Datadog Agent version number
Agent statusWhether the Datadog Agent is running on the VM.
Integrations enabledThe key metrics being collected by enabled integrations in the Datadog Agent.
Install methodThe specific tool used to install the Datadog Agent, such as Chef, Azure VM extension, etc.
Sending logsWhether the Datadog Agent is sending logs to Datadog.

Install

To install the Datadog Agent, select the appropriate VM, then click “Install Agent”. The portal asks for confirmation 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. After the Datadog Agent is installed, the status changes to Installed.

Uninstall

If the Datadog Agent was installed with the Azure VM extension, you can uninstall the Agent by selecting the appropriate VM, then click “Uninstall Agent”.

If the Agent was installed using a different method, you can not use the Datadog resource to deploy or remove the Agent, but information about the Agent is still reflected on this page.

App Service extension

Select “App Service extension” in the left sidebar to see a list of app services in the subscription. On this page, you can install the Datadog extension on Azure App Service to enable APM tracing and custom metrics.

For each app service, the following information is displayed:

ColumnDescription
Resource nameThe app name
Resource statusWhether the app service is stopped or running. The app service must be running to initiate install. If the app service is stopped, installing the Datadog Agent is disabled.
App service planThe specific plan configured for the app service
Extension versionThe Datadog extension version number

Install

To install the Datadog extension, select the appropriate app, then click “Install Extension”. The portal asks for confirmation to install the extension. Select “OK” to begin installation. This restarts your app and adds the following settings:

  • DD_API_KEY:<DEFAULT_API_KEY>
  • DD_SITE:us3.datadoghq.com
  • DD_LOGS_INJECTION:true

Azure shows the status as Installing until the Agent is installed and provisioned. After the Datadog Agent is installed, the status changes to Installed.

Note: Ensure you are adding the extension to apps with supported runtimes. The Datadog resource does not limit or filter the list of apps.

Uninstall

To uninstall the Datadog extension, select the appropriate app, then click “Uninstall Extension”.

Settings

Single sign-on

Select “Single sign-on” in the left sidebar to reconfigure single sign-on.

To activate single sign-on through Azure Active Directory, select “Enable single sign-on”. The portal retrieves the appropriate Datadog application from Azure Active Directory. The app name is the enterprise app name you chose when setting up the integration. Select the Datadog application name as shown below:

API keys

Select “Keys” in the left sidebar to view a list of API keys for your Datadog resource.

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 Datadog, refresh the Azure portal view.

The Azure Datadog integration allows you to install the Datadog Agent on a VM or app service. If there is no default key selected, a Datadog Agent installation fails.

Further Reading