Microsoft Azure

Overview

Datadog’s Azure integration enables the collection of metrics and logs from your Azure environment. The configuration options are different depending on which Datadog site your organization is using:

All Sites: All Datadog sites can use the App Registration credential process for implementing metric collection, and the Event Hub setup for sending Azure Platform Logs. To the extent that the Azure Integration is used to monitor Azure China, all use of Datadog Services in (or in connection with environments within) mainland China is subject to the disclaimer published in the Restricted Service Locations section on our website.

US3: If your organization is on the Datadog US3 site, use the Azure Native integration to streamline management and data collection for your Azure environment. Datadog recommends using this method when possible. Setup entails creating a Datadog resource in Azure to link your Azure subscriptions to your Datadog organization. This replaces the App Registration credential process for metric collection and Event Hub setup for log forwarding.

Connect to Microsoft Azure to:

  • Get metrics from Azure VMs with or without installing the Datadog Agent.
  • Collect standard Azure Monitor metrics for all Azure services: Application Gateway, App Service (Web & Mobile), Batch Service, Event Hub, IoT Hub, Logic App, Redis Cache, Server Farm (App Service Plan), SQL Database, SQL Elastic Pool, Virtual Machine Scale Set, and many more.
  • Tag your Azure metrics with Azure-specific information about the associated resource, such as region, resource group, and tags defined in your Azure environment.
  • Get Datadog generated metrics to provide unique insights into your Azure environment.
  • Correlate data from your Azure applications across logs, metrics, APM tracing, user activity, and more within your Datadog organization.
Datadog's Azure integration is built to collect all metrics from Azure Monitor. Datadog strives to continually update the docs to show every sub-integration, but cloud services rapidly release new metrics and services so the list of integrations can sometimes lag.
The azure.*.status and azure.*.count metrics are generated by Datadog from Azure Resource Health. For more information, see Azure Status and Count Metrics.
IntegrationDescription
Analysis ServicesA service that provides data models in the cloud.
API ManagementA service to publish, secure, transform, maintain, and monitor APIs.
App ServiceA service for deploying and scaling web, mobile, API and business logic application.
App Service EnvironmentA service that provides an environment for securely running App Service apps at high scale.
App Service PlanA set of compute resources for a web app to run.
Application GatewayA web traffic load balancer that enables you to manage traffic to your web applications.
AutomationA service that provides automation and configuration management across your environments.
Batch ServiceManaged task scheduler and processor.
Cognitive ServicesAPIs, SDKs, and services available to help build applications without AI or data science knowledge.
Container InstancesA service to deploy containers without the need to provision or manage the underlying infrastructure.
Container ServiceA production-ready Kubernetes, DC/OS, or Docker Swarm cluster.
Cosmos DBA database service that supports document, key-value, wide-column, and graph databases.
Customer InsightsEnables organizations to bring together data sets to build a 360° view of their customers.
Data ExplorerFast and highly scalable data exploration service.
Data FactoryA service to compose data storage, movement, and processing services into automated data pipelines.
Data Lake AnalyticsAn analytics job service that simplifies big data.
Data Lake StoreA no limits data lake that powers big data analytics.
Database for MariaDBA service that provides fully managed, enterprise-ready community MariaDB database.
Event GridAn event routing service that allows for uniform event consumption using a publish-subscribe model.
Event HubLarge scale data stream managed service.
ExpressRouteA service to extend your on-premises networks into the cloud.
FirewallCloud-native network security to protect your Azure Virtual Network resources.
FunctionsA service for running serverless code in response to event triggers.
HDInsightsA cloud service that processes massive amounts of data.
IOT HubConnect, monitor, and manage billions of IOT assets.
Key VaultA service to safeguard and manage cryptographic keys and secrets used by cloud applications and services.
Load BalancerScale your applications and create high availability for your services.
Logic AppBuild powerful integration solutions.
Machine LearningEnterprise-grade machine learning service to build and deploy models faster.
Network InterfacesEnables VM communication with internet, Azure, and on-premises resources.
Notification HubsA push engine that allows you to send notifications to any platform from any backend.
Public IP AddressA resource that enables inbound communication and outbound connectivity from the Internet.
Recovery Service VaultAn entity that stores the backups and recovery points created over time.
Redis CacheManaged data cache.
RelaySecurely expose services that run in your corporate network to the public cloud.
StorageStorage for blobs, files, queues, and tables.
Stream AnalyticsAn event-processing engine to examine high volumes of data streaming from devices.
SQL DatabaseHighly scalable relational database in the cloud.
SQL Database Elastic PoolManage the performance of multiple database.
Synapse AnalyticsAn analytics service that brings together data integration, enterprise data warehousing and big data analytics.
Usage and QuotasFollow your Azure usage.
Virtual MachineVirtual machine management service.
Virtual Machine Scale SetDeploy, manage, and autoscale a set of identical VMs.
Virtual NetworkAllow Azure resources to securely communicate with each other, the internet, and on-premises networks.

Setup

Automatic

All sites:
See the Standard Azure Integration Programmatic Management Guide for instructions on automatically setting up the standard Datadog integration with Azure. You can set up the integration through Terraform or the Azure CLI, deploy the Datadog Agent natively in Azure through the Datadog Azure VM Extension, and run automated scripts to enable log collection.

US3:
See the Azure Native Integration Programmatic Management Guide for instructions on using Terraform to set up Datadog’s Azure Native integration with the Datadog resource in Azure.

Manual

All sites:
See the Standard Azure Integration Manual Setup Guide for instructions on manually setting up the Datadog integration with Azure through the Azure portal or CLI, as well as deploying the Datadog Agent directly in Azure with the VM extension or AKS Cluster extension.

US3:
See the Azure Native Integration Manual Setup Guide for instructions on manually setting up the Azure Native integration with Datadog. This includes creation of the Datadog resource in Azure, deploying the Datadog Agent directly in Azure with the VM extension or AKS Cluster extension, and optional configuration of single sign-on (SSO).

Log collection

All sites:
See the Send Azure Logs to Datadog guide for instructions on sending your Azure logs to Datadog. You can choose between an automatic or manual process to enable log collection through the Datadog-Azure function and an Azure Event Hub. You can also use an Azure Blob Storage Function to collect logs from all of your Azure App Services.

US3:
See the Send Azure Logs with the Datadog Resource guide for instructions on sending your subscription level, Azure resource, and Azure Active Directory logs to Datadog.

Data Collected

Metrics

All standard Azure Monitor metrics plus unique Datadog generated metrics.

For a detailed list of metrics, select the appropriate Azure service in the overview section. To exclude certain VMs from metric collection, see Azure VM Exclusion.

Events

The Azure integration automatically collects Azure Service Health events. To view these in Datadog, navigate to the Event explorer and filter for the Azure Service Health namespace.

Service Checks

The Azure integration does not include any service checks.

Tags

Azure integration metrics, events, and service checks receive the following tags in addition to tags defined in your Azure environments:

IntegrationNamespaceDatadog Tag Keys
All Azure integrationsAllcloud_provider, region, kind, type, name, resource_group, tenant_name, subscription_name, subscription_id, status (if applicable)
Azure VM integrationsazure.vm.*host, size, operating_system, availability_zone
Azure App Service Plansazure.web_serverfarms.*per_site_scaling, plan_size, plan_tier, operating_system
Azure App Services Web Apps & Functionsazure.app_services.*, azure.functions.*operating_system, server_farm_id, reserved, usage_state, fx_version (linux web apps only), php_version, dot_net_framework_version, java_version, node_version, python_version
Azure SQL DBazure.sql_servers_databases.*license_type, max_size_mb, server_name, role, zone_redundant.
For replication Links only: state primary_server_name primary_server_region secondary_server_name secondary_server_region
Azure Load Balancerazure.network_loadbalancers.*sku_name
Azure Usage and Quotaazure.usage.*usage_category, usage_name

Troubleshooting

See the Azure Troubleshooting guide.

Still need help? Contact Datadog support.

Further Reading

PREVIEWING: may/unit-testing