Refresh for Azure App Service (#31300)

* initial commit

* swap screenshot

Author: cswatt

config/_default/menus/main.en.yaml

@@ -3299,23 +3299,23 @@ menu:
       parent: serverless
       weight: 3
     - name: Azure App Service
-      url: serverless/azure_app_services
+      url: serverless/azure_app_service
       parent: serverless
       identifier: serverless_app_services
       weight: 4
     - name: Linux - Code
       identifier: serverless_azure_app_services_linux_code
-      url: serverless/azure_app_services/azure_app_services_linux
+      url: serverless/azure_app_service/linux_code
       parent: serverless_app_services
       weight: 401
     - name: Linux - Container
       identifier: serverless_azure_app_services_linux_container
-      url: serverless/azure_app_services/azure_app_services_container
+      url: serverless/azure_app_service/linux_container
       parent: serverless_app_services
       weight: 402
     - name: Windows - Code
       identifier: serverless_azure_app_services_windows_code
-      url: serverless/azure_app_services/azure_app_services_windows
+      url: serverless/azure_app_service/windows_code
       parent: serverless_app_services
       weight: 403
     - name: Azure Container Apps

content/en/serverless/_index.md

@@ -102,7 +102,7 @@ Datadog also provides a solution for [instrumenting your Cloud Run applications]
 [4]: /serverless/custom_metrics
 [5]: /serverless/distributed_tracing
 [6]: /serverless/deployment_tracking
-[7]: /infrastructure/serverless/azure_app_services/#overview
+[7]: /serverless/azure_app_service/#overview
 [8]: https://app.datadoghq.com/functions?cloud=azure&config_serverless-azure-app=true&group=service
 [9]: /integrations/azure/#log-collection
 [10]: /serverless/azure_container_apps

content/en/serverless/azure_app_service/_index.md

@@ -0,0 +1,69 @@
+---
+title: Serverless Monitoring for Azure App Service
+aliases:
+  - /infrastructure/serverless/azure_app_services/
+  - /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/blog/deploy-dotnet-core-azure-app-service/"
+  tag: "Blog"
+  text: "Deploy ASP.NET Core applications to Azure App Service"
+- link: "https://www.datadoghq.com/pricing/?product=application-performance-monitoring#application-performance-monitoring-apm_faq-what-is-considered-as-a-host-for-azure-app-services"
+  tag: "Pricing"
+  text: "Azure App Service APM Pricing"
+---
+
+## Overview
+
+[Azure App Service][1] is a platform that hosts web applications, REST APIs, and mobile backends. Datadog Serverless Monitoring provides metrics, logs, and traces for your Azure App Service applications.
+
+{{< img src="serverless/azure_app_service/azure_app_service_top_2.png" alt="Datadog UI, Serverless Monitoring page with Azure App Service selected." style="width:100%;" >}}
+
+In Datadog, use the [Serverless > Azure][4] page to troubleshoot all your Azure resources.
+
+### Azure metrics and logs
+
+Install the [Azure integration][2] for [enriched metrics][3] and resource metadata for Azure App Service. 
+
+Set up [Azure log forwarding][6] to automatically collect and send Azure App Service resource and application logs to Datadog.
+
+### APM and custom metrics
+
+To monitor Azure App Service workloads with APM and custom metrics, you can instrument your Azure App Service workloads.
+
+| OS      | Runtime   | Documentation               |
+|---------|-----------|-----------------------------|
+| Linux   | Java, Node.js, .NET, PHP, Python | [Linux - Code instrumentation][7] |
+| Linux   | Container | [Linux - Container instrumentation][8] |
+| Windows | Java, Node.js, .NET | [Windows - Code instrumentation][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][10]
+
+## Further reading
+
+{{< partial name="whats-next/whats-next.html" >}}
+
+[1]: https://learn.microsoft.com/en-us/azure/app-service/overview
+[2]: /integrations/azure/
+[3]: /integrations/azure_app_services/#metrics
+[4]: https://app.datadoghq.com/serverless/azure/app-service-plan
+[5]: /integrations/azure/#setup
+[6]: /logs/guide/azure-logging-guide/
+[7]: /serverless/azure_app_service/linux_code
+[8]: /serverless/azure_app_service/linux_container
+[9]: /serverless/azure_app_service/windows_code
+[10]: /developers/dogstatsd/
+

content/en/serverless/azure_app_services/azure_app_services_linux.md renamed to content/en/serverless/azure_app_service/linux_code.md

@@ -1,20 +1,26 @@
 ---
 title: Azure App Service - Linux Code
+aliases:
+  - /serverless/azure_app_services/azure_app_services_linux
 further_reading:
 - link: "https://www.datadoghq.com/blog/monitor-azure-app-service-linux/"
   tag: "Blog"
   text: "Monitor your Linux web apps on Azure App Service with Datadog"
 ---
 ## Overview
 
-This solution uses a sidecar container and Application Settings for Linux Azure App Service to instrument the application and manage its configuration.
+This page describes how to instrument your Linux Azure App Service application with the Datadog Agent. The procedure on this page makes use of a sidecar container and Application Settings for Linux Azure App Service to instrument the application and manage its configuration.
 
 If you would prefer to not use the sidecar approach (Not Recommended), you can instead follow the instructions to [Instrument Azure App Service - Linux Code Deployment with the Datadog wrapper][1].
 
 **Supported runtimes**: Java, Node.js, .NET, PHP, Python
 
 ## Setup
 
+### Azure integration
+
+If you haven't already, install the [Datadog-Azure integration][10] to collect metrics and logs.
+
 ### Application
 
 Install the tracing library for your language:
@@ -272,3 +278,4 @@ Share the content of the **Log stream** with [Datadog Support][9].
 [7]: /developers/dogstatsd/?tab=python#dogstatsd-client
 [8]: /profiler/
 [9]: /help
+[10]: https://app.datadoghq.com/integrations/azure

content/en/serverless/azure_app_services/azure_app_services_container.md renamed to content/en/serverless/azure_app_service/linux_container.md

@@ -2,6 +2,7 @@
 title: Instrument Azure App Service - Linux Containers
 aliases:
   - /serverless/guide/azure_app_service_linux_sidecar
+  - /serverless/azure_app_services/azure_app_services_container
 further_reading:
 - link: "/integrations/azure_app_services/"
   tag: "Documentation"
@@ -12,14 +13,20 @@ further_reading:
 ---
 
 
-### Prerequisites
+## Overview
+
+This page describes how to instrument your containerized Linux Azure App Service application with the Datadog Agent.
 
 This document assumes that your application is set up for sidecars according to Azure's [Configure a sidecar container for custom container in Azure App Service][1] tutorial.
 
 If you would prefer to not use the sidecar approach (Not Recommended), you can instead follow the instructions to [Instrument Azure App Service - Linux Container with `serverless-init`][2].
 
 ## Setup
 
+### Azure integration
+
+If you haven't already, install the [Datadog-Azure integration][3] to collect metrics and logs.
+
 ### Application
 
 {{< tabs >}}
@@ -502,3 +509,4 @@ $statsd->increment('page.views', 1, array('environment'=>'dev'));
 
 [1]: https://learn.microsoft.com/en-us/azure/app-service/tutorial-custom-container-sidecar
 [2]: /serverless/guide/azure_app_service_linux_containers_serverless_init
+[3]: https://app.datadoghq.com/integrations/azure

content/en/serverless/azure_app_services/azure_app_services_windows.md renamed to content/en/serverless/azure_app_service/windows_code.md

@@ -2,6 +2,7 @@
 title: Azure App Service - Windows Code
 aliases:
   - /infrastructure/serverless/azure_app_services/
+  - /serverless/azure_app_services/azure_app_services_windows
 further_reading:
 - link: "/integrations/guide/azure-portal/"
   tag: "Documentation"
@@ -20,7 +21,7 @@ further_reading:
 
 ## Overview
 
-The Datadog extension for Azure App Service provides additional monitoring capabilities.
+The Datadog extension for Azure App Service provides monitoring capabilities in addition to the [Datadog-Azure integration][11], which provides metrics and logs.
 
 - Full distributed APM tracing using automatic instrumentation.
 - Customized APM service and trace views showing relevant Azure App Service metrics and metadata.
@@ -492,3 +493,4 @@ Still need help? Contact [Datadog support][10].
 [8]: /metrics/
 [9]: /integrations/azure/
 [10]: /help
+[11]: https://app.datadoghq.com/integrations/azure