- name: Linux

url: serverless/azure_app_services/azure_app_services_linux

parent: serverless_app_services

weight: 201

- name: Windows

url: serverless/azure_app_services/azure_app_services_windows

parent: serverless_app_services

weight: 202

title: Monitoring Azure App Service

kind: documentation

aliases:

- /infrastructure/serverless/azure_app_services/

further_reading:

- link: "/integrations/azure_app_services/"

tag: "Documentation"

text: "Azure App Service"

- link: "/integrations/azure_app_service_environment/"

tag: "Documentation"

text: "Azure App Service Environment"

- link: "https://www.datadoghq.com/blog/azure-app-service-extension/"

tag: "Blog"

text: "Monitor .NET web apps with the Datadog extension for Azure App Service"

- link: "https://www.datadoghq.com/pricing/?product=apm--continuous-profiler#apm--continuous-profiler-what-is-considered-as-a-host-for-azure-app-services"

tag: "Pricing"

text: "Azure App Service APM Pricing"

- link: "https://www.datadoghq.com/blog/deploy-dotnet-core-azure-app-service/"

tag: "Blog"

text: "Deploy ASP.NET Core applications to Azure App Service"

Microsoft [Azure App Service][1] is a group of serverless resources that enable you to build and host web apps, mobile backends, event-driven functions, and RESTful APIs without managing infrastructure. It can host workloads of all sizes and offers auto-scaling and high availability options.

Datadog provides monitoring capabilities for all Azure App Service resource types:

- Azure Monitor metrics for [Apps][2] and [Functions][3] using the [Azure Integration][2].

- Use the [Azure App Service View][4] to quickly spot issues, map relationships between your Azure App Service resources, and gain insights into cost and performance.

- Submit custom metrics through the API.

- Submit [resource logs][5] through [Event Hub][6].

Datadog provides additional monitoring capabilities for the following Azure App Service workload runtimes on Basic, Standard, and Premium plans:

| OS | Runtime |Status|Documentation|

|----|---------|----|----|

|Windows|.NET|GA|[Windows .NET setup][7]|

|Windows|Java|Beta|[Windows Java setup][8]|

|Linux|.NET|Beta|[Linux docs][9]|

|Linux|Node|Beta|[Linux docs][9]|

Capabilities:

- Fully distributed APM tracing using automatic instrumentation

- Customized APM service and trace views showing relevant Azure App Service metrics and metadata

- Manual APM instrumentation to customize spans

- `Trace_ID` injection into application logs

- Custom metrics with [DogStatsD][7]

[1]: /integrations/azure/#log-collection

[2]: /tracing/trace_collection/dd_libraries/

[3]: https://registry.hub.docker.com/r/datadog/serverless-init

[4]: /metrics/custom_metrics/dogstatsd_metrics_submission/

[5]: /getting_started/site/

[6]: /getting_started/tagging/unified_service_tagging/

[7]: /serverless/azure_app_services/azure_app_services_windows?tab=net#setup

[8]: /serverless/azure_app_services/azure_app_services_windows?tab=java#setup

[9]: /serverless/azure_app_services/azure_app_services_linux

title: Azure App Service - Linux

kind: documentation

This instrumentation method provides the following additional monitoring capabilities for Linux Azure App Service workloads:

- Fully distributed APM tracing using automatic instrumentation.

- Customized APM service and trace views showing relevant Azure App Service metrics and metadata.

- Support for manual APM instrumentation to customize spans.

- `Trace_ID` injection into application logs.

- Support for submitting custom metrics using [DogStatsD][1].

This solution uses the startup command setting and Application Settings for Linux Azure App Service to instrument the application and manage its configuration. Java, Node, .NET, PHP, and Python are supported.

To instrument your application, begin by adding the following key-value pairs under **Application Settings** in your Azure configuration settings.

{{< img src="serverless/azure_app_service/application-settings.jpg" alt="Azure App Service Configuration: the Application Settings, under the Configuration section of Settings in the Azure UI. Three settings are listed: DD_API_KEY, DD_SERVICE, and DD_START_APP." style="width:80%;" >}}

- `DD_API_KEY` is your Datadog API key.

- `DD_CUSTOM_METRICS_ENABLED` (optional) enables [custom metrics](#custom-metrics).

- `DD_SITE` is the Datadog site [parameter][2]. Your site is {{< region-param key="dd_site" code="true" >}}. This value defaults to `datadoghq.com`.

- `DD_SERVICE` is the service name used for this program. Defaults to the name field value in `package.json`.

- `DD_START_APP` is the command used to start your application. For example, `node ./bin/www`.

Linux Azure App Service Web Apps built using the code deployment option on built-in runtimes depend on a startup command that varies by language. The default values are outlined in [Azure's documentation][7]. Examples are included below.

Set these values in the `DD_START_APP` environment variable. Examples below are for an application named `datadog-demo`, where relevant.

| Runtime | `DD_START_APP` Example Value | Description

| ---- | --- | --- |

| Node.js | `node ./bin/www` | Runs the [Node PM2 configuration file][12], or your script file |

| .NET Core | `dotnet datadog-demo.dll` | Runs a .dll file that uses your Web App name by default |

| PHP | `cp /home/site/wwwroot/default /etc/nginx/sites-available/default && service nginx reload` | Copies script to correct location and starts application |

| Python | `gunicorn --bind=0.0.0.0 --timeout 600 quickstartproject.wsgi` | Custom [startup script][13]. This example shows a Gunicorn command for starting a Django app. |

| Java | `java -jar /home/site/wwwroot/datadog-demo.jar` | The command to start your app |

[7]: https://learn.microsoft.com/en-us/troubleshoot/azure/app-service/faqs-app-service-linux#what-are-the-expected-values-for-the-startup-file-section-when-i-configure-the-runtime-stack-

[12]: https://learn.microsoft.com/en-us/azure/app-service/configure-language-nodejs?pivots=platform-linux#configure-nodejs-server

[13]: https://learn.microsoft.com/en-us/azure/app-service/configure-language-php?pivots=platform-linux#customize-start-up

**Note**: The application restarts when new settings are saved.

{{< tabs >}}

{{% tab "Node, .NET, PHP, Python" %}}

Go to **General settings** and add the following to the **Startup Command** field:

{{< img src="serverless/azure_app_service/startup-command-1.jpeg" alt="Azure App Service Configuration: the Stack settings, under the Configuration section of Settings in the Azure UI. Underneath the stack, major version, and minor version fields is a 'Startup Command' field that is populated by the above curl command." style="width:100%;" >}}

{{% /tab %}}

{{% tab "Java" %}}

Download the [`datadog_wrapper`][8] file from the releases and upload it to your application with the Azure CLI command:

Alternatively, you can upload this script as part of your application and set the startup command in general settings as its location (for example, `/home/site/wwwroot/datadog_wrapper`.)

If you are already using a startup script, add the following curl command to the end of your script:

[8]: https://github.com/DataDog/datadog-aas-linux/releases

{{% /tab %}}

{{< /tabs >}}

When new Application Settings are saved, Azure restarts the application. However, if a startup command is added and saved, a restart may be required.

After the application restarts, you can view traces by searching for the service name (`DD_SERVICE`) in the [APM Service page][4] of Datadog.

To enable custom metrics for your application with DogStatsD, add `DD_CUSTOM_METRICS_ENABLED` and set it as `true` in your Application Settings.

To configure your application to submit metrics, follow the appropriate steps for your runtime.

- [Java][9]

- [Node][5]

- [.NET][6]

- [PHP][10]

- [Python][11]

If you are not receiving traces or custom metric data as expected, enable **App Service logs** to receive debugging logs.

{{< img src="serverless/azure_app_service/app-service-logs.png" alt="Azure App Service Configuration: App Service logs, under the Monitoring section of Settings in the Azure UI. The 'Application logging' option is set to 'File System'." style="width:100%;" >}}

Share the content of the **Log stream** with [Datadog Support][14].

[1]: /developers/dogstatsd

[2]: /getting_started/site/#access-the-datadog-site

[3]: https://www.datadoghq.com/blog/azure-app-service-datadog-serverless-view/

[4]: /tracing/services/service_page/

[5]: https://github.com/brightcove/hot-shots

[6]: /developers/dogstatsd/?tab=hostagent&code-lang=dotnet#code

[9]: https://docs.datadoghq.com/developers/dogstatsd/?tab=hostagent&code-lang=java

[10]: https://docs.datadoghq.com/developers/dogstatsd/?tab=hostagent&code-lang=php

[11]: https://docs.datadoghq.com/developers/dogstatsd/?tab=hostagent&code-lang=python

[14]: /help

title: Azure App Service - Windows

- Support for submitting custom metrics using [DogStatsD][1].