Requisitos de compatibilidad

Runtimes de .NET Core soportados

El Tracer de .NET soporta instrumentación en .NET Core 3.1, .NET 5, .NET 6, .NET 7, .NET 8, .NET 9 y .NET 10.

Para una lista completa del soporte de la biblioteca y arquitectura de procesadores de .NET Core de Datadog (incluyendo versiones heredadas y de mantenimiento), consulta Requisitos de Compatibilidad.

Instalación y primeros pasos

Instalación

Antes de comenzar, asegúrese de haber instalado y configurado el Agent.

1. Instale el SDK.
2. Habilite el SDK para su servicio.
3. Vea sus datos en vivo.

Instale el SDK

Después de instalar y configurar su Agente de Datadog, el siguiente paso es agregar el SDK directamente en la aplicación para instrumentarla. Lea más sobre información de compatibilidad.

Puede instalar el Tracer .NET de Datadog a nivel de máquina para que todos los servicios en la máquina estén instrumentados, o puede instalarlo de manera específica por aplicación para permitir que los desarrolladores gestionen la instrumentación a través de las dependencias de la aplicación. Para ver las instrucciones de instalación a nivel de máquina, haga clic en la pestaña de Windows o Linux. Para ver las instrucciones de instalación por aplicación, haga 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/

Habilite el SDK para su servicio

Para habilitar el .NET Tracer para su servicio, establezca las variables de entorno requeridas y reinicie la aplicación.

Para información sobre los diferentes métodos para establecer variables de entorno, consulte Configurando variables de entorno del proceso.

Vea sus datos en vivo

Después de habilitar el .NET Tracer para su servicio:

1. Reinicie su servicio.

2. Cree carga de aplicación.

3. En Datadog, navegue a APM > Trazas de APM.

Configuración

Si es necesario, configure el SDK para enviar datos de telemetría de rendimiento de la aplicación según lo requiera, incluyendo la configuración de Etiquetado de Servicio Unificado. Lea Configuración de la Biblioteca para más detalles.

Instrumentación personalizada

La instrumentación personalizada depende de su instrumentación automática e incluye pasos adicionales dependiendo del método:

Para más información sobre cómo agregar tramos y etiquetas para instrumentación personalizada, consulta la documentación de instrumentación personalizada de .NET.

Configurando variables de entorno del proceso

Para adjuntar instrumentación automática a tu servicio, debes establecer las variables de entorno requeridas antes de iniciar la aplicación. Consulta la sección Habilitar el SDK para tu servicio para identificar qué variables de entorno establecer según tu método de instalación del Tracer de .NET y sigue los ejemplos a continuación para establecer correctamente las variables de entorno según el entorno de tu servicio instrumentado.

Windows

Servicios de Windows

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

CORECLR_ENABLE_PROFILING=1

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

IIS

Después de instalar el MSI, no se necesita configuración adicional para instrumentar automáticamente tus sitios de IIS. Para establecer variables de entorno adicionales que sean heredadas por todos los sitios de IIS, realiza los siguientes pasos:

1. Abre el Editor del Registro, busca el valor de cadena múltiple llamado Environment en la clave HKLM\System\CurrentControlSet\Services\WAS, y agrega las variables de entorno, una por línea. Por ejemplo, para agregar inyección de registros y métricas de tiempo de ejecución, agrega las siguientes líneas a los datos del valor:

   DD_LOGS_INJECTION=true
   DD_RUNTIME_METRICS_ENABLED=true
   

2. Ejecuta los siguientes comandos para reiniciar 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 automáticamente una aplicación de consola, establece las variables de entorno desde un archivo por lotes antes de iniciar tu aplicación:

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 establecer las variables de entorno requeridas 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 establecer las variables de entorno requeridas 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)

Al usar systemctl para ejecutar aplicaciones .NET como un servicio, puedes agregar las variables de entorno requeridas que se cargarán 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 del servicio:

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

3. Reinicia el servicio .NET para que los ajustes de las variables de entorno surtan efecto.

systemctl (todos los servicios)

Al usar systemctl para ejecutar aplicaciones .NET como un servicio, también puedes establecer variables de entorno que se cargarán para todos los servicios ejecutados por systemctl.

1. Establece las variables de entorno requeridas ejecutando systemctl set-environment:

   # 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. Verifica que las variables de entorno se hayan establecido ejecutando systemctl show-environment.

3. Reinicia el servicio .NET para que las variables de entorno surtan efecto.

Lectura adicional

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

Conectar los registros de la aplicación .NET a las trazasDOCUMENTACIÓN Métricas de tiempo de ejecuciónDOCUMENTACIÓN Extensión de Microsoft Azure App ServiceDOCUMENTACIÓN Explora tus servicios, recursos y trazasDOCUMENTACIÓN Monitoreo de .NET con Datadog APM y trazado distribuidoBLOG Monitorea aplicaciones ASP.NET Core en contenedoresBLOG Despliega aplicaciones ASP.NET Core en Azure App ServiceBLOG Optimice el rendimiento de su aplicación .NET con el Continuous Profiler de DatadogBLOG Ejemplos de instrumentación personalizadaCÓDIGO FUENTE Código fuenteCÓDIGO FUENTE