Información general

Las métricas de tiempo de ejecución monitorizan el uso de memoria, la recolección de basura y la paralelización de tu aplicación. Las bibliotecas de rastreo de Datadog recopilan automáticamente estas métricas de entornos compatibles y las envían al Agent.

Estas métricas te permiten identificar cuellos de botella, solucionar problemas de rendimiento y optimizar el uso de los recursos. Al consultar las métricas de tiempo de ejecución junto con las trazas y los logs, obtendrás una visibilidad completa del estado y el rendimiento de tu aplicación.

Compatibilidad

Las métricas de tiempo de ejecución están disponibles para varios lenguajes de programación y tiempos de ejecución, con distintos niveles de compatibilidad y opciones de configuración.

net localgroup "Performance Monitor Users" "IIS APPPOOL\DefaultAppPool" /add

Instrucciones de instalación

Para configurar las métricas en tiempo de ejecución, debes configurar tanto el Datadog Agent como tu aplicación.

1. Configurar el Datadog Agent

Habilita DogStatsD para el Agent. Por defecto, el Datadog Agent está configurado para ingerir métricas con UDP a través del puerto 8125.

Configuración específica de contenedor

Cuando el Agent se ejecuta en entornos de contenedores, es necesaria una configuración adicional:

1. Define dogstatsd_non_local_traffic: true en tu archivo de configuración principaldatadog.yaml, o define la variable de entorno DD_DOGSTATSD_NON_LOCAL_TRAFFIC=true.
2. Sigue estas instrucciones de configuración específica de contenedor:

3. Define DD_SITE en el Datadog Agent como para asegurarte de que el Agent envía los datos a la localización Datadog correcta.

2. Configurar la aplicación

Configura las métricas de tiempo de ejecución en tu aplicación utilizando variables de entorno. Algunos lenguajes también permiten configurar métricas de tiempo de ejecución directamente en el código.

Variables de entorno

Utiliza las siguientes variables de entorno para configurar métricas de tiempo de ejecución en tu aplicación:

DD_RUNTIME_METRICS_ENABLED

Por defecto: true para Java, false para todos los demás lenguajes
Descripción: Activa la recopilación de métricas de tiempo de ejecución. Las métricas se envían al Datadog Agent, según lo configurado para la aplicación instrumentada.

DD_RUNTIME_METRICS_RUNTIME_ID_ENABLED

Por defecto: true para Java, false para Node.js, Ruby y Python. No existe para .NET y Go. Siempre se indica runtime_id.
Descripción: Habilita métricas en tiempo de ejecución mejoradas, proporcionando una etiqueta (tag) runtime_id junto con cada métrica. runtime_id representa el identificador de procesos de la aplicación y te permite correlacionar directamente las métricas de tiempo de ejecución con aplicaciones individuales en ejecución.

DD_AGENT_HOST

Por defecto: localhost
Descripción: Define la dirección del host para el envío de métricas de la biblioteca de rastreo. Puede ser un nombre de host o una dirección IP.

DD_DOGSTATSD_PORT

Por defecto: 8125
Descripción: Define el puerto para el envío de métricas de la biblioteca de rastreo.

Configuración basada en códigos

Además de las variables de entorno, algunos lenguajes permiten configurar métricas de tiempo de ejecución directamente en el código.

from ddtrace.runtime import RuntimeMetrics
RuntimeMetrics.enable()

# config/initializers/datadog.rb
require 'datadog/statsd'
require 'datadog' # Use 'ddtrace' if you're using v1.x

Datadog.configure do |c|
  c.runtime_metrics.enabled = true

  # Optionally, you can configure the DogStatsD instance used for sending runtime metrics.
  # DogStatsD is automatically configured with default settings if `dogstatsd-ruby` is available.
  # You can configure with host and port of Datadog agent; defaults to 'localhost:8125'.
  c.runtime_metrics.statsd = Datadog::Statsd.new
end

// Basic configuration
tracer.Start(tracer.WithRuntimeMetrics())

// With custom DogStatsD address
tracer.Start(
  tracer.WithRuntimeMetrics(),
  tracer.WithDogstatsdAddr("custom-host:8125")
)

const tracer = require('dd-trace').init({
  // Other tracer options...
  runtimeMetrics: true
})

Dashboards

Una vez finalizada la configuración, puedes ver las métricas de tiempo de ejecución en:

• Página con información del servicio instrumentado
• Pestaña Métricas del gráfico de llama
• Dashboards de tiempo de ejecución por defecto

Solucionar problemas

• Para asociar métricas de tiempo de ejecución dentro de los gráficos de llama, asegúrate de que la etiqueta env (que distingue entre mayúsculas y minúsculas) está configurada y coincide en todo tu entorno.
• Para que las métricas de tiempo de ejecución aparezcan en la página del servicio al utilizar Fargate, asegúrate de que DD_DOGSTATSD_TAGS está configurado en la tarea de tu Agent y que la etiqueta env configurada coincide con la env del servicio instrumentado.

Datos recopilados

Cada lenguaje compatible recopila un conjunto de métricas de tiempo de ejecución que proporcionan información sobre el uso de la memoria, la recolección de basura, el uso de la CPU y otros indicadores de rendimiento.

Referencias adicionales

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

Correlacionar logs y trazasDOCUMENTACIÓN Instrumenta tu aplicación de forma manual para crear trazas.DOCUMENTACIÓN Explorar tus servicios, recursos y trazas (traces)DOCUMENTACIÓN