Requisitos
Si todavía no lo hiciste, configura primero la integración de Microsoft Azure.
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.
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
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
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.
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.
Ve a la pestaña “Application settings” (Parámetros de la aplicación) de la página “Configuration” (Configuración).
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.
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.
Haz clic en Save (Guardar) (se reiniciará la aplicación).
[OBLIGATORIO] Haz clic en Stop (Detener) para detener la aplicación.
Ve a la página de extensiones de Azure y selecciona la extensión de Datadog APM.
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.
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:
- Generación de logs sin agente con la instrumentación automática
- 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:
- Añade el paquete NuGet de DogStatsD a tu proyecto de Visual Studio.
- Inicializa DogStatsD y escribe métricas personalizadas en tu aplicación.
- Despliega tu código en Azure App Service.
- 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
Si todavía no lo hiciste, configura primero la integración de Microsoft Azure.
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.
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.
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
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.
Abre Azure Portal y navega hasta el dashboard de la aplicación web de Azure que quieres instrumentar con Datadog.
Ve a la pestaña “Application settings” (Parámetros de la aplicación) de la página “Configuration” (Configuración).
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.
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.
Haz clic en Save (Guardar) (se reiniciará la aplicación).
[OBLIGATORIO] Haz clic en Stop (Detener) para detener la aplicación.
Ve a la página de extensiones de Azure y selecciona la extensión de Datadog APM.
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.
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:
- Añade el cliente de DogStatsD a tu proyecto.
- Inicializa DogStatsD y escribe métricas personalizadas en tu aplicación.
- Despliega tu código en una aplicación web de Azure compatible.
- 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
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.
Abre Azure Portal y navega hasta el dashboard de la aplicación web de Azure que quieres instrumentar con Datadog.
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).
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 entornoDD_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ónDD_APPSEC_ENABLED
: true
para habilitar Application Security Management
Consulta la lista completa de parámetros de configuración opcionales.
Selecciona Save (Guardar). Esto reiniciará la aplicación.
Haz clic en Stop (Detener) para detener la aplicación.
En la página Extensions (Extensiones), selecciona la extensión Nodo Datadog APM.
Acepta los términos legales, selecciona OK (Aceptar) y espera a que se complete la instalación.
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.
Los logs de los recursos de Azure no incluyen el ID de rastreo.
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.
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:
- Inicializa DogStatsD y escribe métricas personalizadas en tu aplicación.
- Despliega tu código en una aplicación web de Azure compatible.
- Si todavía no lo hiciste, instala la extensión de Azure App Service para Node.js de Datadog.
No es necesario instalar un cliente de DogStatsD para Node.js, ya que se incluye en el rastreador de Node.js (dd-trace
) empaquetado en la extensión de Azure App Service.
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' });
El rastreador de Node.js de Datadog,
dd-trace
, está empaquetado en la extensión de Azure App Service. Se añade automáticamente a
NODE_PATH
.
No es necesario añadir dd-trace
como dependencia en package.json
. Añadir
dd-trace
de forma explícita como dependencia puede anular la versión que proporciona la extensión. Para el testeo local, consulta las
notas de la versión para encontrar la versión del rastreador de Node.js acorde a tu versión de la extensión de Azure App Service.
Obtén más información sobre las métricas personalizadas.