Ruby agent release notesRSS

Feature: Report a unique hostname for Google Cloud Run Worker Pools and Jobs

Cloud Run hostname support, added in PR#3609, detected Cloud Run only through K_REVISION, the environment variable set by Cloud Run Services. The agent now also recognizes CLOUD_RUN_REVISION (Worker Pools) and CLOUD_RUN_EXECUTION (Jobs), so utilization.gcp_cloud_run.use_instance_as_host now applies to all three resource types. When utilization.gcp_cloud_run.include_revision_in_host is true, the hostname is built from whichever of these variables is present — for example, {CLOUD_RUN_EXECUTION}-{instance id} for a Job. Issue#3651 PR#3652

Feature: Add browser_monitoring.version configuration option

Customers can now pin the exact browser agent loader version New Relic injects by setting the new browser_monitoring.version configuration option. See the browser agent EOL policy for which versions are currently available and supported. PR#3663

Feature: Add span.kind to background job libraries

Now, the span.kind attribute will be added to produce and consume operations from background job libraries. This includes ActiveJob, Sidekiq, Resque and DelayedJob. PR#3636

Bugfix: DelayedJob instrumentation no longer reinstalls itself on every worker under prepend mode

When DelayedJob instrumentation is installed via prepend (the default), creating more than one Delayed::Worker in the same process caused the agent to log "Installing DelayedJob instrumentation" and reinitialize the plugin again for each additional worker. This was harmless but noisy; it's now only done once per process, matching the existing chain-instrumentation behavior. PR#3654

Bugfix: Allowlisted configuration values are no longer case sensitive

Previously, allowlisted configuration options required an exact case match, so a value with unexpected casing — like OBFUSCATED or ObFuScAtEd for slow_sql.record_sql — would silently fall back to the default. Configuration options that validate against an allowlist now match values regardless of case, so both are treated the same as obfuscated. Issue#3613 PR#3645

Bugfix: Puma instrumentation works when Puma is lazy-loaded

With gem "puma", require: false, Puma was not yet loaded when the agent's dependency check ran, so Puma instrumentation would fail to install. The agent now recognizes Puma::RackHandler as evidence that Puma is present, fixing this issue. Issue#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

Característica: agregar soporte para Dalli 5.0 y corregir la instrumentación del metaprotocolo

El agente ahora es compatible con Dalli 5.0+, que eliminó Dalli::Protocol::Binary a favor del metaprotocolo exclusivamente. Para Dalli 3.2.0+, La instrumentación de pipelined_get ahora tiene como objetivo correctamente a Dalli::Protocol::Base (donde se define el método) en lugar de a Dalli::Protocol::Binary, lo que corrige una brecha donde las llamadas de get_multi quedaban sin instrumentar al usar el metaprotocolo. Para Dalli 5.0+, el agente instrumenta adicionalmente Dalli::Protocol::Meta#read_multi_req, que es invocado por la optimización get_multi de servidor único de Dalli. PR#3541

Característica: agregar la opción de configuración active_record_use_table_name

Una nueva opción de configuración, active_record_use_table_name, usa el nombre de la tabla de un modelo de Active Record en lugar de su nombre de clase al nombrar métricas, spans y segmentos de traza de la transacción. Esto puede ser particularmente útil para reducir la cardinalidad en aplicaciones que utilizan herencia de tabla única. La opción tiene como valor predeterminado false para conservar el comportamiento existente. PR#3540

Característica: ocultar parcialmente las claves de licencia en los registros del agente

Anteriormente, el agente ocultaba por completo las claves de licencia de New Relic en los registros del agente. Ahora, los primeros 10 caracteres son visibles mientras que el resto se reemplaza con *. Esto conserva lo suficiente para solucionar problemas relacionados con la región sin exponer la parte secreta de la clave. PR#3547

Corrección de error: corrige la incompatibilidad de la instrumentación de Semantic Logger con rails_semantic_logger

Anteriormente, se generaba un ArgumentError cuando una excepción llegaba a ActionDispatch::DebugExceptions al usar rails_semantic_logger. Esto fue solucionado. ¡Gracias a @jdelStrother por reportar esto! PR#3548