Requisitos

1. Si todavía no lo hiciste, configura primero la integración de Microsoft Azure.

2. La extensión admite los siguientes tipos de recursos:

   • Aplicaciones web de Azure App Service
   • Aplicaciones de funciones alojadas en los planes Basic, Standard y Premium.
   Las aplicaciones de funciones en planes de consumo no son compatibles. ¿Te interesa la compatibilidad con otros tipos de recursos o tiempos de ejecución de App Service? Regístrate para recibir una notificación cuando haya una versión beta disponible.

3. La extensión de Datadog APM para .NET admite los siguientes tiempos de ejecución de .NET tanto en arquitecturas x64 como x86 cuando se ejecuta en el sistema operativo Windows (AAS todavía no admite extensiones en Linux). Para obtener más detalles sobre la instrumentación automática de bibliotecas, consulta la documentación del rastreador.

   • .NET Framework 4.6.1 y versiones posteriores
   • .NET Core 2.1
   • .NET Core 2.2 (el soporte de Microsoft finalizó el 23-12-2019)
   • .NET Core 3.0 (el soporte de Microsoft finalizó el 03-03-2020)
   • .NET Core 3.1
   • .NET 5
   • .NET 6
   • .NET 7
   • .NET 8

4. Datadog recomienda actualizar de forma periódica a la última versión de la extensión para garantizar un rendimiento, estabilidad y disponibilidad óptimos de las funciones. Ten en cuenta que tanto la instalación inicial como las actualizaciones posteriores requieren que tu aplicación web esté completamente detenida para que la instalación o actualización se ejecute correctamente.

Nota: La instrumentación automática de Datadog se basa en la API de .NET CLR Profiling. Esta API solo permite un suscriptor (por ejemplo, el rastreador de .NET de Datadog con el generador de perfiles habilitado). Para garantizar la máxima visibilidad, ejecuta solo una solución de APM dentro del entorno de tu aplicación.

A partir de la versión 2.3.0, la extensión de .NET ya no se basa en el control de versiones semántico. La extensión utiliza el siguiente esquema: x.y.zAA, donde x.y.z es la versión del rastreador de .Net y AA está dedicada únicamente a la extensión. NuGet recorta cualquier cero a la izquierda en zAA para que la versión se convierta en x.y.A.

Por ejemplo:

• La extensión 2.3.0 utiliza la versión 2.3.0 del rastreador.
• La extensión 2.3.1 utiliza la versión 2.3.0 del rastreador.
• La extensión 2.3.2 utiliza la versión 2.3.0 del rastreador.
• La extensión 2.3.100 utiliza la versión 2.3.1 del rastreador.
• La extensión 2.3.101 utiliza la versión 2.3.1 del rastreador.
• La extensión 2.3.200 utiliza la versión 2.3.2 del rastreador.

Instalación

1. Configura la integración de Azure para monitorear tu aplicación web o función. Puedes comprobar que está configurada correctamente si ves la métrica azure.app_services.count o azure.functions.count correspondiente en Datadog. Nota: Este paso es fundamental para la correlación de métricas y trazas y las vistas funcionales del panel de trazas, y mejora la experiencia general de uso de Datadog con Azure App Service.

2. Abre Azure Portal y navega hasta el dashboard de la aplicación de Azure que quieres instrumentar con Datadog.

Nota: Los clientes que utilicen la integración nativa de Azure pueden usar el recurso de Datadog en Azure para añadir la extensión a sus aplicaciones de .NET. Para obtener las instrucciones, consulta la sección sobre la extensión de App Service de la guía de Azure Portal de Datadog.

3. Ve a la pestaña “Application settings” (Parámetros de la aplicación) de la página “Configuration” (Configuración).

4. Añade tu clave de la API de Datadog como un parámetro de la aplicación llamado DD_API_KEY y un valor para la clave de la API de Datadog.

5. Configura los parámetros opcionales de la aplicación:

   • Define DD_SITE como (por defecto, es datadoghq.com).
   • Configura DD_ENV para agrupar tus trazas y estadísticas personalizadas.
   • Configura DD_SERVICE para especificar el nombre de un servicio (por defecto, es el nombre de tu aplicación).
   • Configura DD_LOGS_INJECTION:true para la correlación con los logs de aplicación de tu aplicación.
   • Configura DD_PROFILING_ENABLED:true para habilitar .NET Continuous Profiler.
   • Configura DD_APPSEC_ENABLED:true para habilitar Application Security.
   • Consulta la lista completa de variables de configuración opcionales.

6. Haz clic en Save (Guardar) (se reiniciará la aplicación).

7. [OBLIGATORIO] Haz clic en Stop (Detener) para detener la aplicación.

8. Ve a la página de extensiones de Azure y selecciona la extensión de Datadog APM.

9. Acepta los términos legales, haz clic en OK (Aceptar) y espera a que se complete la instalación. Nota: La aplicación debe estar detenida para que este paso se complete correctamente.

10. Para iniciar la aplicación principal, haz clic en Start (Iniciar):

Generación de logs de aplicaciones

Puedes enviar logs desde tu aplicación en Azure App Service a Datadog de una de las siguientes maneras:

1. Generación de logs sin agente con la instrumentación automática
2. Generación de logs sin agente con el colector de Serilog

Ambos métodos permiten la inyección del ID de rastreo, lo que hace posible conectar logs y trazas en Datadog. Para habilitar la inyección del ID de rastreo con la extensión, añade el parámetro de la aplicación DD_LOGS_INJECTION:true.

Nota: Dado que esto ocurre dentro de tu aplicación, los logs de la plataforma de Azure que envíes con los parámetros de diagnóstico no incluirán el ID de rastreo.

Métricas personalizadas con DogStatsD

La extensión de Azure App Service incluye una instancia de DogStatsD (el servicio de agregación de métricas de Datadog). Esto te permite enviar métricas personalizadas, checks de servicios y eventos directamente a Datadog desde las aplicaciones web y funciones de Azure con la extensión.

Escribir métricas personalizadas y checks en Azure App Service es similar al proceso para hacerlo con una aplicación en un host que ejecuta el Datadog Agent. Para enviar métricas personalizadas a Datadog desde Azure App Service mediante la extensión, haz lo siguiente:

1. Añade el paquete NuGet de DogStatsD a tu proyecto de Visual Studio.
2. Inicializa DogStatsD y escribe métricas personalizadas en tu aplicación.
3. Despliega tu código en Azure App Service.
4. Si todavía no lo hiciste, instala la extensión de App Service de Datadog.

Nota: A diferencia del proceso de configuración estándar de DogStatsD, no es necesario establecer puertos o un nombre de servidor al inicializar la configuración de DogStatsD. Existen variables de entorno en Azure App Service que determinan cómo se envían las métricas (esto requiere la versión 6.0.0 o versiones superiores del cliente de DogStatsD).

Para enviar métricas, usa este código:

// Configura tu cliente de DogStatsD y añade cualquier etiqueta (tag)
if (!DogStatsd.Configure(new StatsdConfig() { ConstantTags = new[] { "app:sample.mvc.aspnetcore" } }))
{
    // `Configure` devuelve false si las variables de entorno obligatorias no están presentes.
    // Estas variables de entorno están presentes en Azure App Service, pero
    // debes configurarlas para poder testear tus métricas personalizadas: DD_API_KEY:{api_key}, DD_AGENT_HOST:localhost
    // Ignora o genera un log del error según corresponda
    Console.WriteLine("Cannot initialize DogstatsD.");
}

// Envía una métrica
DogStatsd.Increment("sample.startup");

Nota: Para enviar solo métricas personalizadas (con el rastreo deshabilitado), define las siguientes variables en la configuración de tu aplicación:

• Define DD_TRACE_ENABLED como false.
• Define DD_AAS_ENABLE_CUSTOM_METRICS como true. Obtén más información sobre las métricas personalizadas.

Requisitos

1. Si todavía no lo hiciste, configura primero la integración de Microsoft Azure.

2. La extensión es compatible con las aplicaciones web de Azure App Service. Las aplicaciones de funciones no son compatibles.

   Support for Java Web Apps is in beta for extension v2.4+. There are no billing implications for tracing Java Web Apps during this period.
   
   Interested in support for other App Service resource types or runtimes? Sign up to be notified when a beta becomes available.

3. La extensión de Datadog APM para Java admite todos los tiempos de ejecución Java en el sistema operativo Windows. Azure App Service no admite extensiones en Linux. Para obtener más información sobre la instrumentación automática de bibliotecas, consulta la documentación del rastreador.

4. Datadog recomienda actualizar de forma periódica a la última versión de la extensión para garantizar un rendimiento, estabilidad y disponibilidad óptimos de las funciones. Ten en cuenta que tanto la instalación inicial como las actualizaciones posteriores requieren que tu aplicación web esté completamente detenida para que la instalación o actualización se ejecute correctamente.

Instalación

1. Configura la integración de Azure para monitorear tu aplicación web o función. Puedes comprobar que está configurada correctamente si ves la métrica azure.app_service.count o azure.functions.count correspondiente en Datadog. Nota: Este paso es fundamental para la correlación de métricas y trazas y las vistas funcionales del panel de trazas, y evita las experiencias de usuario defectuosas en el sitio de Datadog.

2. Abre Azure Portal y navega hasta el dashboard de la aplicación web de Azure que quieres instrumentar con Datadog.

3. Ve a la pestaña “Application settings” (Parámetros de la aplicación) de la página “Configuration” (Configuración).

4. Añade tu clave de la API de Datadog como un parámetro de la aplicación llamado DD_API_KEY y un valor para la clave de la API de Datadog.

5. Configura los parámetros opcionales de la aplicación:

   • Define DD_SITE como (por defecto, es datadoghq.com).
   • Configura DD_ENV para agrupar tus trazas y estadísticas personalizadas.
   • Configura DD_SERVICE para especificar el nombre de un servicio (por defecto, es el nombre de tu aplicación web).
   • Consulta la lista completa de variables de configuración opcionales.

6. Haz clic en Save (Guardar) (se reiniciará la aplicación).

7. [OBLIGATORIO] Haz clic en Stop (Detener) para detener la aplicación.

8. Ve a la página de extensiones de Azure y selecciona la extensión de Datadog APM.

9. Acepta los términos legales, haz clic en OK (Aceptar) y espera a que se complete la instalación. Nota: La aplicación web debe estar detenida para que este paso se complete correctamente.

10. Para iniciar la aplicación principal, haz clic en Start (Iniciar):

Generación de logs de aplicaciones desde las aplicaciones web de Azure

El envío de logs desde una aplicación en Azure App Service a Datadog requiere la transmisión de logs a Datadog directamente desde la aplicación. El envío de logs con este método permite la inyección del ID de rastreo, lo que hace posible conectar logs y trazas en Datadog.

Nota: La inyección del ID de rastreo ocurre dentro de tu aplicación. Azure genera los logs de los recursos de Azure en el plano de gestión y, por lo tanto, no incluyen el ID de rastreo.

Consulta las instrucciones de Generación de logs sin agente con Java para configurar la generación de logs de aplicaciones para Java en Azure App Service.

Métricas personalizadas con DogStatsD

La extensión de Azure App Service incluye una instancia de DogStatsD (el servicio de agregación de métricas de Datadog). Esto te permite enviar métricas personalizadas, checks de servicios y eventos directamente a Datadog desde las aplicaciones web de Azure con la extensión.

Escribir métricas personalizadas y checks en este entorno es similar al proceso para hacerlo con una aplicación en un host estándar que ejecuta el Datadog Agent. Para enviar métricas personalizadas a Datadog desde Azure App Service mediante la extensión, haz lo siguiente:

1. Añade el cliente de DogStatsD a tu proyecto.
2. Inicializa DogStatsD y escribe métricas personalizadas en tu aplicación.
3. Despliega tu código en una aplicación web de Azure compatible.
4. Si todavía no lo hiciste, instala la extensión de App Service de Datadog.

Nota: A diferencia del proceso de configuración estándar de DogStatsD, no es necesario establecer puertos o un nombre de servidor al inicializar la configuración de DogStatsD. Existen variables de entorno en Azure App Service que determinan cómo se envían las métricas (esto requiere la versión 6.0.0 o versiones superiores del cliente de DogStatsD).

Para enviar métricas, usa este código:

// Configura tu cliente de DogStatsD y añade cualquier etiqueta
StatsDClient client = new NonBlockingStatsDClientBuilder()
                            .constantTags("app:sample.service")
                            .build();
// Envía una métrica
client.Increment("sample.startup");

Obtén más información sobre las métricas personalizadas.

Requisitos

Si todavía no lo hiciste, configura primero la integración Datadog-Azure.

La extensión de Azure App Service para Node.js de Datadog es compatible con las aplicaciones web de Azure App Service. Las aplicaciones de funciones no son compatibles.

Instalación

1. Configura la integración Datadog-Azure para monitorizar tu aplicación web de Azure. Para verificarla, comprueba que tu aplicación web se cuente en la métrica azure.app_service.count en Datadog.

2. Abre Azure Portal y navega hasta el dashboard de la aplicación web de Azure que quieres instrumentar con Datadog.

3. En la página Configuration (Configuración), ve a la pestaña Application settings (Parámetros de la aplicación). Selecciona + New application setting (+ Nuevo parámetro de la aplicación).

4. Añade tu clave de la API de Datadog como valor de un parámetro de la aplicación con el nombre DD_API_KEY.

   Opcionalmente, puedes configurar otras variables de entorno como parámetros de la aplicación. Entre estas variables se incluyen las siguientes:

   • DD_SITE: (por defecto, datadoghq.com)
   • DD_ENV: el nombre de tu entorno
   • DD_SERVICE: el nombre de tu servicio (por defecto, es el nombre de tu aplicación web)
   • DD_RUNTIME_METRICS_ENABLED: true para habilitar las métricas del tiempo de ejecución
   • DD_APPSEC_ENABLED: true para habilitar Application Security Management

   Consulta la lista completa de parámetros de configuración opcionales.

5. Selecciona Save (Guardar). Esto reiniciará la aplicación.

6. Haz clic en Stop (Detener) para detener la aplicación.

   Para evitar la caída del sistema, utiliza slots de despliegue. Puedes crear un flujo de trabajo que utilice la Acción de GitHub para la Azure CLI. Consulta el flujo de trabajo de GitHub de ejemplo.

7. En la página Extensions (Extensiones), selecciona la extensión Nodo Datadog APM.

8. Acepta los términos legales, selecciona OK (Aceptar) y espera a que se complete la instalación.

9. Haz clic en Start (Iniciar) para iniciar la aplicación.

Generación de logs de aplicaciones desde las aplicaciones web de Azure

El envío de logs desde una aplicación en Azure App Service a Datadog requiere la transmisión de logs a Datadog directamente desde la aplicación. El envío de logs con este método permite la inyección del ID de rastreo, lo que hace posible conectar logs y trazas en Datadog.

Para configurar la generación de logs de aplicaciones para Node.js en Azure App Service, consulta Generación de logs sin agente con Node.js.

Métricas personalizadas con DogStatsD

La extensión de Azure App Service para Node.js de Datadog incluye una instancia de DogStatsD, el servicio de agregación de métricas de Datadog. Esto te permite enviar métricas personalizadas, checks de servicios y eventos directamente a Datadog desde las aplicaciones web de Azure.

Escribir métricas personalizadas y checks en este entorno es similar al proceso para hacerlo con una aplicación en un host estándar que ejecuta el Datadog Agent. Para enviar métricas personalizadas a Datadog desde Azure App Service mediante la extensión, haz lo siguiente:

1. Inicializa DogStatsD y escribe métricas personalizadas en tu aplicación.
2. Despliega tu código en una aplicación web de Azure compatible.
3. Si todavía no lo hiciste, instala la extensión de Azure App Service para Node.js de Datadog.

Para enviar métricas, usa este código:

const tracer = require('dd-trace');
tracer.init();

tracer.dogstatsd.increment('example_metric.increment', 1, { environment: 'dev' });
tracer.dogstatsd.decrement('example_metric.decrement', 1, { environment: 'dev' });

Obtén más información sobre las métricas personalizadas.

Datadog proporciona scripts para actualizar o instalar la extensión de Azure App Service mediante Powershell. La gestión de extensiones mediante scripts te permite actualizar extensiones de forma masiva por grupo de recursos y designar la instalación de versiones específicas de la extensión del sitio. También puedes utilizar scripts para añadir la extensión mediante programación en los pipelines de CI/CD, así como buscar y actualizar extensiones que ya estén instaladas.

Requisitos previos

• La Azure CLI o Azure Cloud Shell.
• Las credenciales de contexto de usuario. Si todavía no tienes estas credenciales, ve a Azure Portal y accede a tu aplicación web o de funciones. Luego, navega hasta Deployment (Despliegue) > Deployment Center (Centro de despliegue) para crear o recuperar tus credenciales de contexto de usuario.

Instalación de la extensión por primera vez

El script de instalación añade la última versión de la extensión a una aplicación web o de funciones de Azure. Esto ocurre por aplicación, en lugar de en el nivel de grupo de recursos.

1. Abre la Azure CLI o Azure Cloud Shell.

2. Descarga el script de instalación con el siguiente comando:

   Invoke-WebRequest -Uri "https://raw.githubusercontent.com/DataDog/datadog-aas-extension/master/management-scripts/extension/install-latest-extension.ps1" -OutFile "install-latest-extension.ps1"
   

3. Ejecuta el siguiente comando e introduce los argumentos obligatorios y opcionales según sea necesario.

   .\install-latest-extension.ps1 -Username <USERNAME> -Password <PASSWORD> -SubscriptionId <SUBSCRIPTION_ID> -ResourceGroup <RESOURCE_GROUP_NAME> -SiteName <SITE_NAME> -DDApiKey <DATADOG_API_KEY> -DDSite <DATADOG_SITE> -DDEnv <DATADOG_ENV> -DDService <DATADOG_SERVICE> -DDVersion <DATADOG_VERSION>
   

Nota: Los siguientes argumentos son obligatorios para el comando anterior:

• <USERNAME>: el nombre de usuario de tu contexto de usuario de Azure.
• <PASSWORD>: la contraseña del contexto de usuario de Azure.
• <SUBSCRIPTION_ID>: tu ID de suscripción de Azure.
• <RESOURCE_GROUP_NAME>: el nombre de tu grupo de recursos de Azure.
• <SITE_NAME>: el nombre de tu aplicación.
• <DATADOG_API_KEY>: tu clave de la API de Datadog.

Además, define DATADOG_SITE como tu sitio de Datadog. Por defecto, DATADOG_SITE es datadoghq.com. Tu sitio es: .

Actualización de la extensión para un grupo de recursos

El script de actualización se aplica a todo un grupo de recursos. Este script actualiza cada aplicación web o de funciones que tenga la extensión instalada. Las aplicaciones de App Service que no tengan instalada la extensión de Datadog no se verán afectadas.

1. Abre la Azure CLI o Azure Cloud Shell.

2. Descarga el script de actualización con el siguiente comando:

   $baseUri="https://raw.githubusercontent.com/DataDog/datadog-aas-extension/master/management-scripts/extension"; Invoke-WebRequest -Uri "$baseUri/update-all-site-extensions.ps1" -OutFile "update-all-site-extensions.ps1"; Invoke-WebRequest -Uri "$baseUri/install-latest-extension.ps1" -OutFile "install-latest-extension.ps1"
   

3. Ejecuta el siguiente comando. Todos los argumentos son obligatorios.

   .\update-all-site-extensions.ps1 -SubscriptionId <SUBSCRIPTION_ID> -ResourceGroup <RESOURCE_GROUP_NAME> -Username <USERNAME> -Password <PASSWORD>
   

Instalar una versión específica de la extensión

La interfaz de usuario de Azure App Service no permite instalar una versión específica de una extensión, pero puedes hacerlo con el script de instalación o actualización.

Instalar una versión específica en un solo recurso

Para instalar una versión específica en una sola instancia, sigue las instrucciones de instalación de la extensión por primera vez y añade el parámetro -ExtensionVersion al comando de instalación.

.\install-latest-extension.ps1 -Username <USERNAME> -Password <PASSWORD> -SubscriptionId <SUBSCRIPTION_ID> -ResourceGroup <RESOURCE_GROUP_NAME> -SiteName <SITE_NAME> -DDApiKey <DATADOG_API_KEY> -ExtensionVersion <EXTENSION_VERSION>

Reemplaza <EXTENSION_VERSION> por la versión de la extensión que quieres instalar. Por ejemplo, 1.4.0.

Instalar una versión específica en todo un grupo de recursos

Para instalar una versión específica para un grupo de recursos, sigue las instrucciones de actualización de la extensión para un grupo de recursos y añade el parámetro -ExtensionVersion al comando de instalación.

.\update-all-site-extensions.ps1 -SubscriptionId <SUBSCRIPTION_ID> -ResourceGroup <RESOURCE_GROUP_NAME> -Username <USERNAME> -Password <PASSWORD> -ExtensionVersion <EXTENSION_VERSION>

Reemplaza <EXTENSION_VERSION> por la versión de la extensión que quieres instalar. Por ejemplo, 1.4.0.

Plantilla de ARM

Muchas organizaciones utilizan plantillas de Azure Resource Management (ARM) para implementar la práctica de infraestructura como código. Para integrar la extensión de App Service en estas plantillas, incorpora la plantilla de ARM de la extensión de App Service de Datadog en tus despliegues para añadir la extensión y configurarla junto con los recursos de App Service.