Requisitos de compatibilidad

Tiempos de ejecución .NET Core compatibles

El rastreador de .NET es compatible con la instrumentación en .NET Core 3.1, .NET 5, .NET 6, .NET 7, .NET 8 y .NET 9.

Para ver la lista completa de los requisitos de compatibilidad de la biblioteca .NET Core y de la arquitectura de procesadores de Datadog (incluidas las versiones heredadas y de mantenimiento), consulta los requisitos de compatibilidad.

Para instalar y empezar a utilizar

Instalación

Antes de empezar, asegúrate de haber instalado y configurado el Agent.

1. Instala el rastreador.
2. Activa el rastreador para tu servicio.
3. Visualiza tus datos en directo.

Instalación del rastreador

Después de instalar y configurar tu Datadog Agent, el siguiente paso es añadir la biblioteca de rastreo directamente en la aplicación para instrumentarla. Consulta más bibliografía con información sobre la compatibilidad.

Puedes instalar el rastreador .NET de Datadog en toda la máquina para que se instrumenten todos los servicios de la máquina, o puedes instalarlo aplicación por aplicación para que los desarrolladores gestionen la instrumentación a través de las dependencias de la aplicación. Para ver más instrucciones sobre la instalación en toda la máquina, haz clic en la pestaña de Windows o Linux. Para ver más instrucciones sobre la instalación aplicación por aplicación, haz clic en la pestaña de NuGet.

ADD datadog-dotnet-apm-<TRACER_VERSION>.tar.gz /opt/datadog/
COPY --chown=$APP_UID --from=<OTHER_STAGE> /empty/ /var/log/datadog/dotnet/

Activación del rastreador para tu servicio

Para activar el rastreador .NET para tu servicio, configura las variables de entorno necesarias y reinicia la aplicación.

Para obtener más información sobre los diferentes métodos de configurar variables de entorno, consulta la Proceso de configuración de variables de entorno.

Visualización en directo de tus datos

Después de activar el rastreador .NET para tu servicio:

1. Reinicia tu servicio.

2. Crea la carga de la aplicación.

3. En Datadog, ve a APM > APM Traces (APM* > **Trazas APM).

Configuración

Si es necesario, configura la biblioteca de rastreo para que envíe datos de telemetría sobre el rendimiento de la aplicación, según sea necesario, incluida la configuración del etiquetado unificado de servicios. Para ver más detalles, consulta la configuración de bibliotecas.

Instrumentación personalizada

La instrumentación personalizada depende de tu instrumentación automática e incluye pasos adicionales según el método:

Para obtener más información sobre cómo añadir tramos y etiquetas (tags) para la instrumentación personalizada, consulta la documentación para la instrumentación personalizada de .NET.

Configuración de variables de entorno para procesos

Para adjuntar la instrumentación automática a tu servicio, debes configurar las variables de entorno obligatorias antes de iniciar la aplicación. Consulta la sección Activar el rastreador para tu servicio para identificar las variables de entorno que debes configurar, dependiendo del método que has utilizado para instalar el rastreador .NET y sigue los siguientes ejemplos para configurar las variables de entorno correctamente, según el entorno de tu servicio instrumentado.

Windows

Servicios de Windows

En el Editor de registro, crea un valor de cadena múltiple llamado Environment en la clave HKLM\System\CurrentControlSet\Services\<SERVICE NAME> y configura los datos de valor como:

CORECLR_ENABLE_PROFILING=1

Set-ItemProperty HKLM:SYSTEM\CurrentControlSet\Services\<SERVICE NAME> -Name Environment -Value 'CORECLR_ENABLE_PROFILING=1'

IIS

Una vez instalado el MSI, no es necesaria ninguna configuración adicional para instrumentar tus sitios de IIS automáticamente. Sigue los siguientes pasos para configurar variables de entorno adicionales, heredadas por todos los sitios de IIS:

1. Abre el Editor de registro, busca el valor de cadena múltiple llamado Environment en la clave HKLM\System\CurrentControlSet\Services\WAS y añade las variables de entorno, una por cada línea. Por ejemplo, para añadir la inyección de logs y métricas de tiempos de ejecución, añade las siguientes líneas a los datos de valor:

   DD_LOGS_INJECTION=true
   DD_RUNTIME_METRICS_ENABLED=true
   

2. Ejecuta los siguientes comandos para reiniciar los IIS:

   net stop /y was
   net start w3svc
   # Also, start any other services that were stopped when WAS was shut down.
   

Aplicaciones de consola

Para instrumentar una aplicación de consola automáticamente, antes de iniciar tu aplicación configura las variables de entorno desde un archivo de lote:

rem Set required environment variables
SET CORECLR_ENABLE_PROFILING=1

rem (Optional) Set additional Datadog environment variables, for example:
SET DD_LOGS_INJECTION=true
SET DD_RUNTIME_METRICS_ENABLED=true

rem Start application
dotnet.exe example.dll

Linux

Script de bash

Para configurar las variables de entorno obligatorias desde un archivo bash antes de iniciar tu aplicación:

# Set required environment variables
export CORECLR_ENABLE_PROFILING=1
export CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
export CORECLR_PROFILER_PATH=/opt/datadog/Datadog.Trace.ClrProfiler.Native.so
export DD_DOTNET_TRACER_HOME=/opt/datadog

# (Optional) Set additional Datadog environment variables, for example:
export DD_LOGS_INJECTION=true
export DD_RUNTIME_METRICS_ENABLED=true

# Start your application
dotnet example.dll

Contenedor Docker de Linux

Para configurar las variables de entorno obligatorias en un contenedor Docker de Linux:

# Set required environment variables
ENV CORECLR_ENABLE_PROFILING=1
ENV CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
ENV CORECLR_PROFILER_PATH=/opt/datadog/Datadog.Trace.ClrProfiler.Native.so
ENV DD_DOTNET_TRACER_HOME=/opt/datadog

# (Optional) Set additional Datadog environment variables, for example:
ENV DD_LOGS_INJECTION=true
ENV DD_RUNTIME_METRICS_ENABLED=true

# Start your application
CMD ["dotnet", "example.dll"]

systemctl (por servicio)

Cuando utilizas systemctl para ejecutar aplicaciones .NET como un servicio, puedes añadir las variables de entorno necesarias para que se carguen para un servicio específico.

1. Crea un archivo llamado environment.env que contenga:

   # Set required environment variables
   CORECLR_ENABLE_PROFILING=1
   CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
   CORECLR_PROFILER_PATH=/opt/datadog/Datadog.Trace.ClrProfiler.Native.so
   DD_DOTNET_TRACER_HOME=/opt/datadog
   
   # (Optional) Set additional Datadog environment variables, for example:
   DD_LOGS_INJECTION=true
   DD_RUNTIME_METRICS_ENABLED=true
   

2. En el archivo de configuración del servicio, haz referencia a esto como un EnvironmentFile en el bloque de servicios:

   [Service]
   EnvironmentFile=/path/to/environment.env
   ExecStart=<command used to start the application>
   

3. Reinicia el sevicio .NET para que la configuración de la variable de entorno se aplique.

systemctl (todos los servicios)

Cuando utilizas systemctl para ejecutar aplicaciones .NET como un servicio, también puedes configurar variables de entorno para que se carguen para todos los servicios que ejecuta systemctl.

1. Ejecuta systemctl set-environment para configurar las variables de entorno obligatorias:

   # Set required environment variables
   systemctl set-environment CORECLR_ENABLE_PROFILING=1
   systemctl set-environment CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
   systemctl set-environment CORECLR_PROFILER_PATH=/opt/datadog/Datadog.Trace.ClrProfiler.Native.so
   systemctl set-environment DD_DOTNET_TRACER_HOME=/opt/datadog
   
   # (Optional) Set additional Datadog environment variables, for example:
   systemctl set-environment DD_LOGS_INJECTION=true
   systemctl set-environment DD_RUNTIME_METRICS_ENABLED=true
   

2. Ejecuta systemctl show-environment para verificar que se hayan configurado las variables de entorno.

3. Reinicia el servicio de .NET para aplicar las variables de entorno.

Referencias adicionales

Más enlaces, artículos y documentación útiles:

Conectar logs de aplicaciones .NET con trazas (traces)DOCUMENTACIÓN Métricas de tiempos de ejecuciónDOCUMENTACIÓN Extensión del servicio de aplicaciones Microsoft AzureDOCUMENTACIÓN Explorar tus servicios, recursos y trazasDOCUMENTACIÓN Monitorización .NET con Datadog APM y rastreo distribuidoBLOG Monitorización de aplicaciones contenedorizadas ASP.NET CoreBLOG Despliegue de aplicaciones ASP.NET Core en Azure App ServiceBLOG Optimizar el rendimiento de tu aplicación .NET con el Datadog Continuous ProfilerBLOG Ejemplos de instrumentación personalizadaCÓDIGO FUENTE Código fuenteCÓDIGO FUENTE