Ruby agent release notesRSS

Feature: Continuous Profiling (preview)

Continuous Profiling is a new feature which is not yet generally available for use. The agent-side component code is now present in the agent but to actually use it ahead of the General Availability release, you will need to contact your New Relic sales representative to join the preview early.

Continuous Profiling repeatedly samples the Ruby call stacks of your running application and reports them to New Relic, so you can see which methods are consuming the most CPU time (or allocating the most objects) in production, without adding code to your app.

To turn it on, add the stackprof and google-protobuf gems to your application's Gemfile, then set profiling.enabled to true:

profiling.enabled: true

With only profiling.enabled set, the agent samples CPU time every 10 milliseconds for the life of the process. These options let you tune that behavior:

PR#3617

Feature: Add support for Dalli 5.1.1

Dalli 5.1.1 added arguments to some of the methods the agent instruments, which could raise an ArgumentError on multi-key operations or cause request options to be silently dropped. Now, the agent accepts and forwards a variable number of positional and keyword arguments for these methods. PR#3683

Característica: reportar un nombre de host único para Worker Pools y Jobs de Google Cloud Run

El soporte para el nombre de host de Cloud Run, agregado en el PR#3609, detectaba Cloud Run solo a través de K_REVISION, la variable de entorno establecida por los Services de Cloud Run. El agente ahora también reconoce CLOUD_RUN_REVISION (Worker Pools) y CLOUD_RUN_EXECUTION (Jobs), por lo que utilization.gcp_cloud_run.use_instance_as_host ahora se aplica a los tres tipos de recursos. Cuando utilization.gcp_cloud_run.include_revision_in_host es true, el nombre de host se crea a partir de cualquiera de estas variables que esté presente —por ejemplo, {CLOUD_RUN_EXECUTION}-{instance id} para un Job. Issue#3651 PR#3652

Característica: agregar opción de configuración browser_monitoring.version

Los clientes ahora pueden fijar la versión exacta del cargador del agente del browser que inyecta New Relic al establecer la nueva opción de configuración browser_monitoring.version. Consulte la política de EOL del agente del browser para saber qué versiones están disponibles y son compatibles actualmente. PR#3663

Característica: agregar span.kind a las bibliotecas de trabajos en segundo plano

Ahora, el atributo span.kind se agregará a las operaciones produce y consume de las bibliotecas de trabajos en segundo plano. Esto incluye ActiveJob, Sidekiq, Resque y DelayedJob. PR#3636

Corrección de errores: la instrumentación de DelayedJob ya no se reinstala en cada trabajador en el modo prepend

Cuando la instrumentación de DelayedJob se instala mediante prepend (el valor predeterminado), crear más de un Delayed::Worker en el mismo proceso provocaba que el agente registrara “Installing DelayedJob instrumentation” y reinicializara el plug-in de nuevo para cada worker adicional. Esto era inofensivo pero ruidoso; ahora solo se realiza una vez por proceso, lo que coincide con el comportamiento de instrumentación de cadena existente. PR#3654

Corrección de errores: los valores de configuración de la lista de permitidos ya no distinguen entre mayúsculas y minúsculas

Anteriormente, las opciones de configuración en la lista de permitidos requerían una coincidencia exacta de mayúsculas y minúsculas, por lo que un valor con un uso de mayúsculas y minúsculas inesperado —como OBFUSCATED o ObFuScAtEd para slow_sql.record_sql — volvía silenciosamente al valor predeterminado. Las opciones de configuración que se validan con una lista de permitidos ahora coinciden con los valores independientemente de las mayúsculas y minúsculas, por lo que ambos se tratan igual que obfuscated. Issue#3613 PR#3645

Corrección de error: la instrumentación de Puma funciona cuando Puma se carga de forma diferida

Con gem "puma", require: false, Puma aún no estaba cargado cuando se ejecutó la comprobación de dependencia del agente, por lo que la instrumentación de Puma fallaba al instalarse. El agente ahora reconoce Puma::RackHandler como evidencia de que Puma está presente, lo que soluciona este problema. Problema#3641 PR#3650

Corrección de error: resuelve ArgumentError en operaciones de múltiples claves con Dalli 5.1.0

Esta corrección actualiza la instrumentación de Dalli para aceptar y reenviar argumentos de opciones de solicitud opcionales en operaciones múltiples y en canalización. ¡Agradecemos a @dbackeus por contribuir con una corrección! PR#3642

Corrección de error: las requests de Async::HTTP ya no generan NoMethodError cuando un segmento no se inicia

Si el agente encontraba un error interno al crear el segmento para una request de Async::HTTP, la instrumentación continuaba usando ese segmento faltante y podía generar un NoMethodError. Esto ya está solucionado, gracias a @ydah. PR#3640

Característica: agregar transaction_tracer.cap_segment_artifacts opción de configuración

Las transacciones de larga duración con muchos segmentos pueden causar un uso de memoria en continuo aumento durante la vida útil de la transacción. El agente ahora ofrece una opción de configuración transaction_tracer.cap_segment_artifacts opcional (el valor predeterminado es false). Cuando está habilitado, una vez que se alcanza transaction_tracer.limit_segments, el agente también deja de registrar el tiempo exclusivo para cualquier segmento creado posteriormente en esa transacción, lo que reduce el uso de memoria a costa de datos de tiempo menos precisos para la transacción. PR#3615

Característica: agregar instrumentación de server-statistics de Puma

El agente ahora realiza un muestreo de las estadísticas del servidor de todo el clúster de Puma y las reporta como métricas de intervalo de tiempo Ruby/Puma/*, incluyendo backlog, running, pool_capacity, max_threads y requests_count. Las estadísticas se muestrean en modo único y en modo agrupado cuando preload_app! está habilitado. Esta instrumentación está deshabilitada de forma predeterminada. Habilítela configurando disable_puma_instrumentation en false. Cuando está habilitado, el agente inicia un hilo de informes en el proceso maestro de Puma para entregar estas métricas, lo que ejecuta una conexión de agente adicional junto con los trabajadores de Puma. El intervalo de muestreo es configurable a través de la nueva configuración puma.sample_rate (60 segundos de forma predeterminada). Requiere Puma 6.6 o posterior. Consulte nuestros documentos para obtener más información. PR#3578

Característica: reportar un nombre de host único para las instancias de Google Cloud Run

El agente ahora detecta Cloud Run y reporta el ID de la instancia de GCP como el nombre de host para que se puedan distinguir las instancias individuales. Antes de este cambio, todos los nombres de host de Google Cloud Run eran localhost. Esta característica está controlada por la nueva opción de configuración utilization.gcp_cloud_run.use_instance_as_host (true de forma predeterminada). Establezca utilization.gcp_cloud_run.include_revision_in_host (false de forma predeterminada) en true para reportar el nombre de host como {K_REVISION}-{instance id} en su lugar, donde K_REVISION es el nombre de revisión de Cloud Run. Issue#3295 PR#3609

Corrección de errores: el SQL lento ya no se registra después de transaction_tracer.limit_segments excedido

Una vez que una transacción excedía transaction_tracer.limit_segments, los segmentos de almacenamiento de datos creados posteriormente aún podían tener su SQL lento registrado. El agente ahora deja de registrar SQL lento para cualquier segmento creado después de que se alcanza el límite. PR#3615

Corrección de errores: los planes de explicación podían apuntar a la base de datos incorrecta en aplicaciones Rails de múltiples bases de datos (Rails >= 7.2)

En Rails 7.2+, el agente recopiló planes de explicación utilizando una conexión del grupo predeterminado/compartido de la aplicación en lugar de una dedicada. Esto afectó principalmente a las aplicaciones de múltiples bases de datos. Los planes de explicación podrían generarse en la base de datos incorrecta, y una explicación fallida podría dejar una conexión compartida en mal estado, afectando a requests no relacionadas. El agente ahora usa su propia conexión dedicada para los planes de explicación, como lo hacía antes de Rails 7.2, y restablece o descarta esa conexión cada vez que falla un intento de explicación, por lo que nunca se reutiliza una mala conexión. Issue#3610 PR#3612

Corrección de errores: la instrumentación de monitoreo de browser ya no falla con FrozenError

Cuando el primer fragmento del cuerpo de una respuesta era un String congelado y había múltiples fragmentos, la instrumentación del navegador se encontraba con un FrozenError y el encabezado de tiempos del navegador nunca se inyectaba. Esto comenzó a aparecer con ERB 6.0.3+, que empezó a congelar más de sus cadenas compiladas. Este problema ya fue solucionado. Issue#3624 PR#3625

Corrección de errores: normalizar los valores de configuración booleanos para permitir cualquier uso de mayúsculas y minúsculas

En la versión 9.x, el agente aceptaba valores booleanos en mayúsculas, como "FALSE", y valores con mayúsculas y minúsculas como "True". La versión 10.0.0 incluyó el PR#3341, que eliminó involuntariamente el requisito de no distinguir entre mayúsculas y minúsculas. Esto provocó que las opciones de configuración de los usuarios que tenían cualquier uso de mayúsculas y minúsculas además de todo en minúsculas volvieran a los valores predeterminados. Ahora, el agente vuelve a utilizar comprobaciones que no distinguen entre mayúsculas y minúsculas. Issue#3632 PR#3633

Característica: los eventos SpanLink ahora son compatibles con el agente Hybrid

Los spans creados por una API de OpenTelemetry ahora pueden tener Span Links asociados a ellos. Los enlaces se pueden agregar al inicio de un span, pasándolos al argumento links o llamando a la API OpenTelemetry::Trace::Span#add_link. PR#3586

Característica: los eventos SpanEvent ahora son compatibles con el agente Hybrid

Los spans creados por una API de OpenTelemetry ahora pueden tener eventos SpanEvent asociados a través de la API OpenTelemetry::Trace::Span#add_event. Los eventos SpanEvent capturan anotaciones con timestamp en un span y se envían a New Relic junto con el span principal. PR#3587

Característica: establecer el tipo de span en todos los spans del agente Hybrid

Anteriormente, solo los spans de OpenTelemetry que se traducían en segmentos de solicitudes externas o segmentos de almacenamiento de datos agregaban el tipo de span como atributo. Ahora, el agente agrega el tipo de span a todos los spans de OpenTelemetry donde el valor está disponible. PR#3589

Característica: agregar soporte para OpenTelemetry::Tracer#start_root_span

La API OpenTelemetry::Tracer#start_root_span ahora se puede usar para forzar el inicio de una transacción para un span determinado, siempre que tenga un tipo de span :server o :consumer. Para cualquier otro tipo de span, no realizará ninguna operación. Este método se usa más comúnmente en la instrumentación de trabajos en segundo plano. PR#3588

Corrección de error: solucionar que instrumentation.rails_event_logger: false no deshabilite la instrumentación

Anteriormente, establecer instrumentation.rails_event_logger en false no deshabilitaba la instrumentación de Rails.event como se esperaba; se seguía instalando durante el arranque de Rails. Esto ya fue solucionado. PR#3564

Corrección de error: normalizar los valores de tipo booleano a disabled para las claves de configuración de instrumentación

Anteriormente, solo disabled desactivaba una clave de configuración de instrumentation.*. Ahora, los valores de tipo booleano como false, no o off también se resuelven como disabled y evitan que se instale la instrumentación. PR#3579

Corrección de error: las métricas de compatibilidad de logging por biblioteca ahora reflejan el estado de instrumentación de cada biblioteca

Anteriormente, las métricas de Supportability/Logging/Ruby/{library}/{enabled|disabled} informaban el valor de la configuración global de application_logging.enabled para cada biblioteca, en lugar del estado real de cada biblioteca. Como resultado, la métrica informaba enabled incluso cuando se había deshabilitado la instrumentación de logging para una biblioteca específica o no se estaba usando la gema de esa biblioteca en absoluto. Ahora, la métrica de cada biblioteca refleja si su propia instrumentación de logging está habilitada. PR#3571