Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
In this quickstart, you create a new Datadog organization and resource in Azure.
What to expect
After you complete this quickstart, you have:
- A Datadog resource (
Microsoft.Datadog/monitors) in your chosen resource group - A new Datadog organization with API keys provisioned
- Azure platform metrics flowing from your subscription to Datadog
- (Optional) Azure resource logs forwarded to Datadog
- (Optional) Single sign-on configured via Microsoft Entra ID
The entire process takes about 5-10 minutes.
Prerequisites
An Azure account with an active subscription is required. If you don't already have one, you can create an account for free.
Your Azure role must be set to Owner for the subscription. Confirm that you have the appropriate access before you begin.
- You must configure your environment.
Important
Azure free credits can't be used to purchase Azure Marketplace third-party offers, including Datadog. For details, see Understand your Azure Marketplace charges.
Create the resource
Note
If you already have a Datadog organization on the US3 site that you'd like to link to your Azure subscription, see Link to an existing Datadog organization instead.
Set up the Azure CLI
Start by preparing your environment for the Azure CLI:
Use the Bash environment in Azure Cloud Shell. For more information, see Get started with Azure Cloud Shell.
If you prefer to run CLI reference commands locally, install the Azure CLI. If you're running on Windows or macOS, consider running Azure CLI in a Docker container. For more information, see How to run the Azure CLI in a Docker container.
If you're using a local installation, sign in to the Azure CLI by using the az login command. To finish the authentication process, follow the steps displayed in your terminal. For other sign-in options, see Authenticate to Azure using Azure CLI.
When you're prompted, install the Azure CLI extension on first use. For more information about extensions, see Use and manage extensions with the Azure CLI.
Run az version to find the version and dependent libraries that are installed. To upgrade to the latest version, run az upgrade.
Register the resource provider
The Azure portal registers the Microsoft.Datadog resource provider automatically when you create through the portal UI. For CLI or SDK deployments, you must register it yourself first:
az provider register --namespace Microsoft.Datadog --wait
Verify that registration succeeded:
az provider show --namespace Microsoft.Datadog --query registrationState -o tsv
# Expected output: Registered
Create the resource
Important
Make sure the Microsoft.Datadog resource provider is registered on your subscription before you run the create command. Resource creation fails with a generic ResourceCreationValidateFailed error if the provider isn't registered. See Register the resource provider above.
After you sign in, use the az datadog monitor create command (from the datadog Azure CLI extension, version 3.0.0 or higher — the extension installs automatically the first time you run an az datadog monitor command; run az extension update --name datadog if you installed it previously) to create the new monitor resource.
Create a new Datadog organization. Replace the placeholder values with your own:
az datadog monitor create \
--name "myDatadog" \
--resource-group "myResourceGroup" \
--location "West US 2" \
--sku name="payg_v3_Monthly" \
--org-properties name="my-datadog-org" \
--user-info name="Jane Doe" email-address="jane@contoso.com" phone-number="123-456-7890" \
--identity type="SystemAssigned" \
--monitoring-status "Enabled" \
--tags Environment="Dev" Team="Platform"
Link to an existing Datadog organization instead by using the Linked SKU and supplying the org's API key and application key:
az datadog monitor create \
--name "myDatadog-link" \
--resource-group "myResourceGroup" \
--location "West US 2" \
--sku name="Linked" \
--org-properties api-key="<datadog-api-key>" application-key="<datadog-application-key>" \
--user-info name="Jane Doe" email-address="jane@contoso.com" phone-number="123-456-7890" \
--identity type="SystemAssigned"
| Parameter | Description |
|---|---|
--name |
A unique name for your Datadog resource. |
--resource-group |
The resource group to contain the Datadog resource. |
--location |
The Azure region. Use West US 2 — see region availability. |
--sku name= |
Marketplace plan SKU. Use payg_v3_Monthly for the public pay-as-you-go plan when creating a new Datadog org, or Linked when linking to an existing org. For private offers, supply the SKU name your Datadog account team shared with you. |
--org-properties |
For a new org: name=<org-name>. For linking: api-key= and application-key= from your existing Datadog org. |
--user-info |
Contact name, email, and phone for the Datadog organization admin. |
--identity |
Managed identity for the Datadog resource. SystemAssigned is recommended. |
--monitoring-status |
Enabled (default) or Disabled. |
--tags |
Optional Azure resource tags for organization and cost tracking. |
Tip
Add --no-wait if you want the command to return immediately. The operation continues in the background until the Datadog monitor is created. Use az datadog monitor wait to check for completion.
Verify the resource
After creation completes, verify your Datadog resource:
az datadog monitor show --name "myDatadog" --resource-group "myResourceGroup"
List existing monitors
View all Datadog monitors in your subscription:
az datadog monitor list
Filter by resource group:
az datadog monitor list --resource-group "myResourceGroup"
Wait for completion (optional)
To pause CLI execution until a monitor's specific event or condition occurs, use the az datadog monitor wait command:
az datadog monitor wait --name "myDatadog" --resource-group "myResourceGroup" --created
Start the creation workflow
You can start the Datadog creation workflow from either entry point:
- Azure portal: open the Datadog resource browse page and select Create.
- Azure Marketplace: open the Datadog – an Azure Native ISV Service offering and select Get It Now.
Alternatively, from the Azure portal global search bar, search for Datadog and select the Datadog – An Azure Native ISV Service result.
Basics tab
The Basics tab has three sections:
- Project details
- Azure resource details
- Datadog organization details
There are required fields (identified with a red asterisk) in each section that you need to fill out.
Enter the values for each required setting under Project details.
Field Action Subscription Select a subscription from your existing subscriptions. Resource group Use an existing resource group or create a new one. Enter the values for each required setting under Azure Resource details.
Field Action Resource name Specify a unique name for the resource. Location Select a region to deploy your resource. Enter the values for each required setting under Datadog organization details.
Field Action Datadog org name Enter a name for your new Datadog organization. Select the Change plan link to change your billing plan.
The remaining fields update to reflect the details of the plan you selected for this new organization.
Choose your preferred billing term.
Select the Next button at the bottom of the page.
Metrics and logs tab (optional)
Configure which Azure resources send metrics and logs to Datadog. You can change these settings at any time after creation.
For details on what gets forwarded and include/exclude examples, see tag rules for sending metrics and tag rules for sending logs in Monitor & Observe Azure resources with Azure Native Integrations.
| Setting | What it does |
|---|---|
| Silence monitoring for expected Azure VM Shutdowns | Suppresses alerts when VMs are stopped intentionally |
| Collect custom metrics from App Insights | Forwards Application Insights custom metrics to Datadog |
| Send subscription activity logs | Sends Azure subscription activity logs (management plane operations) to Datadog |
| Send Azure resource logs for all defined sources | Forwards resource diagnostic logs from all supported Azure resources to Datadog |
After you finish configuring metrics and logs, select Next.
Security tab (optional)
The Security tab controls two features:
| Setting | Default | What it does |
|---|---|---|
| Enable resource collection | On | Allows Datadog to collect metadata about your Azure resources — types, tags, and configurations — so they appear in the Datadog Resource Catalog for search, inventory, and infrastructure context. There's no additional Datadog charge for this. |
| Enable Datadog Cloud Security Posture Management | Off | Continuously assesses your Azure configuration against CIS, PCI DSS, SOC 2, HIPAA, and other benchmarks. Learn more about Cloud Security Posture Management. |
Important
Resource collection is enabled by default and we recommend keeping it on — it's what populates the Datadog Resource Catalog and gives every other Datadog product accurate Azure context. Cloud Security Posture Management (CSPM) is optional and can be enabled only when resource collection is on. If you turn resource collection off, the CSPM checkbox is disabled.
Select the Next button at the bottom of the page.
Single sign-on tab (optional)
If your organization uses Microsoft Entra ID as its identity provider, you can establish single sign-on from the Azure portal:
Select the checkbox.
The Azure portal retrieves the appropriate application from Microsoft Entra ID.
Select the app name.
Select Next.
Tags tab (optional)
Optionally, you can create tags for your resource. Then select Review + create.
Review + create tab
If the review finds no errors, the Create button becomes active. Select Create.
If the review identifies errors, a red dot appears next to each section where errors exist. To fix errors:
Open each section that has errors and fix the errors.
Fields with errors are highlighted in red.
Select Review + create again.
Select Create.
The message "Deployment is in progress" appears. When the deployment is complete, the message "Your deployment is complete" appears on the upper-right corner of the Azure portal.
After the resource is created, select Go to resource to view your resource.
Verify your deployment
After the resource is created, verify that data is flowing:
- Navigate to your Datadog resource in the Azure portal.
- In the Overview pane, confirm the Status shows as Active.
- Select the Datadog portal link to open your Datadog organization.
- In the Datadog portal, check Infrastructure > Host Map to confirm Azure hosts appear.
- Check Logs > Search to verify log data is arriving (allow a few minutes for initial data).
Tip
If metrics or logs aren't appearing after 10 minutes, see Troubleshooting for common causes and solutions.