DAdatadog
Azure Integration

Create an Azure integration

Create a Datadog-Azure integration.

Using the POST method updates your integration configuration by adding your new configuration to the existing one in your Datadog organization.

Using the PUT method updates your integration configuration by replacing your current configuration with the new one sent to your Datadog organization.

post/api/v1/integration/azure

Request

  • Base URL
    https://api.datadoghq.com
  • URL
    https://api.datadoghq.com/api/v1/integration/azure
  • Auth
    API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY

Request body

app_service_plan_filtersstring

Limit the Azure app service plans that are pulled into Datadog using tags. Only app service plans that match one of the defined tags are imported into Datadog.

automuteboolean

Silence monitors for expected Azure VM shutdowns.

client_idstring

Your Azure web application ID.

client_secretstring

Your Azure web application secret key.

container_app_filtersstring

Limit the Azure container apps that are pulled into Datadog using tags. Only container apps that match one of the defined tags are imported into Datadog.

cspm_enabledboolean

When enabled, Datadog’s Cloud Security Management product scans resource configurations monitored by this app registration. Note: This requires resource_collection_enabled to be set to true.

custom_metrics_enabledboolean

Enable custom metrics for your organization.

errorsstring[]

Errors in your configuration.

host_filtersstring

Limit the Azure instances that are pulled into Datadog by using tags. Only hosts that match one of the defined tags are imported into Datadog.

metrics_enabledboolean

Enable Azure metrics for your organization.

metrics_enabled_defaultboolean

Enable Azure metrics for your organization for resource providers where no resource provider config is specified.

new_client_idstring

Your New Azure web application ID.

new_tenant_namestring

Your New Azure Active Directory ID.

resource_collection_enabledboolean

When enabled, Datadog collects metadata and configuration info from cloud resources (compute instances, databases, load balancers, etc.) monitored by this app registration.

secretless_auth_enabledboolean

(Preview) When enabled, Datadog authenticates with this app registration using federated workload identity credentials instead of a client secret.

tenant_namestring

Your Azure Active Directory ID.

usage_metrics_enabledboolean

Enable azure.usage metrics for your organization.

Example request

{
  "app_service_plan_filters": "key:value,filter:example",
  "automute": true,
  "client_id": "testc7f6-1234-5678-9101-3fcbf464test",
  "client_secret": "TestingRh2nx664kUy5dIApvM54T4AtO",
  "container_app_filters": "key:value,filter:example",
  "cspm_enabled": true,
  "custom_metrics_enabled": true,
  "errors": [
    "*"
  ],
  "host_filters": "key:value,filter:example",
  "metrics_enabled": true,
  "metrics_enabled_default": true,
  "new_client_id": "new1c7f6-1234-5678-9101-3fcbf464test",
  "new_tenant_name": "new1c44-1234-5678-9101-cc00736ftest",
  "resource_collection_enabled": true,
  "resource_provider_configs": [
    {
      "metrics_enabled": true,
      "namespace": "Microsoft.Compute"
    }
  ],
  "secretless_auth_enabled": true,
  "tenant_name": "testc44-1234-5678-9101-cc00736ftest",
  "usage_metrics_enabled": true
}

Response

OK

object required

Example response

{}

Changes

No recorded changes to this operation across all 1 revision of this API.