Activar Dynamic Instrumentation para Ruby

Documentos > Instrumentación Dinámica > Enabling Dynamic Instrumentation > Activar Dynamic Instrumentation para Ruby

Join the Preview

Dynamic Instrumentation para Ruby está en vista previa limitada, y no está disponible para todos los clientes. Solicita acceso para unirse a la lista de espera. Ten en cuenta que se aplican algunas limitaciones a la vista previa.

Request Access

Dynamic Instrumentation es una característica de apoyo para las bibliotecas de rastreo de Datadog. Si ya estás utilizando APM para recopilar trazas (traces) para tu aplicación, asegúrate de que tu Agent y biblioteca de rastreo están en la versión requerida. A continuación, ve directamente a la activación de Dynamic Instrumentation en el paso 4.

Nota: Dynamic Instrumentation sólo es compatible con aplicaciones que se ejecuten en el entorno production (RAILS_ENV, RACK_ENV, etc.).

Instalación

Instala o actualiza tu Agent a la versión 7.45.0 o posterior.
Si aún no tienes APM habilitado, en tu configuración del Agent, establece la variable de entorno DD_APM_ENABLED en true y escuchando en el puerto 8126/TCP.
Instala o actualiza la biblioteca de rastreo de Ruby a la versión 2.9.0 o posterior, siguiendo las instrucciones pertinentes.
Ejecuta tu servicio conDynamic Instrumentation habilitada, al configurar la variable de entorno DD_DYNAMIC_INSTRUMENTATION_ENABLED en true. Especifica las etiquetas de servicio unificado DD_SERVICE, DD_ENV y DD_VERSION para que puedas filtrar y agrupar tus instrumentaciones y dirigirte a los clientes activos a través de estas dimensiones.
Después de iniciar tu servicio con la Dynamic Instrumentation activada, puedes empezar a utilizar Dynamic Instrumentation en la página APM > Dynamic Instrumentation.

Configuración

Configura la Instrumentación dinámica mediante las siguientes variables de entorno:

Variable de entorno	Tipo	Descripción
`DD_DYNAMIC_INSTRUMENTATION_ENABLED`	Booleano	Selecciona `true` para activar la Instrumentación dinámica.
`DD_SERVICE`	Cadena	El nombre de servicio, por ejemplo, `web-backend`.
`DD_ENV`	Cadena	El nombre de entorno, por ejemplo, `production`.
`DD_VERSION`	Cadena	La versión de tu servicio.
`DD_TAGS`	Cadena	Las etiquetas para aplicar a los datos producidos. Debe ser una lista de `<key>:<value>` separados por comas como: `layer:api,team:intake`.