Ruby agent release notesRSS

Bugfix: Resolve ArgumentError on multi-key operations with Dalli 5.1.0

This fix updates Dalli instrumentation to accept and forward optional request options arguments in multi and pipelined operations. Our thanks go to @dbackeus for contributing a fix! PR#3642

Bugfix: Async::HTTP requests no longer raise NoMethodError when a segment fails to start

If the agent encountered an internal error while creating the segment for an Async::HTTP request, the instrumentation went on to use that missing segment and could raise a NoMethodError. This is now fixed, thanks to @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

Característica: agregar instrumentación de Rails.event para logging estructurado

El agente ahora admite Rails.event como logs de evento estructurados. Cuando está habilitado, los eventos publicados a través de Rails.event.notify se capturan y reenvían a New Relic como logs de eventos. Las cargas de eventos, las etiquetas, el contexto, los timestamps y las ubicaciones de origen se capturan automáticamente como atributos de log.

Esta instrumentación se puede configurar con las siguientes opciones:

• instrumentation.rails_event_logger - Controla si la instrumentación de Rails.event está habilitada. De forma predeterminada, usa el valor de application_logging.enabled.
• instrumentation.rails_event_logger.event_names - Una matriz de nombres de eventos específicos para capturar. Cuando está vacío (predeterminado), se capturan todas las notificaciones de Rails.event. Utilice esto para filtrar eventos por nombre, por ejemplo: ['user.signup', 'payment.processed'].

PR#3526

Característica: agregar instrumentación para las continuaciones de Rails Active Job

El agente ahora instrumenta las continuaciones de Active Job de Rails, proporcionando visibilidad de la ejecución de pasos individuales dentro de trabajos de larga duración. Los nombres de los pasos se incluyen en las métricas de segmento (por ejemplo, Ruby/ActiveJob/default/MyJob/step/process_records) y se capturan atributos específicos del paso, como la posición del cursor, el estado reanudado y el estado interrumpido. Una nueva opción de configuración, disable_active_job_step_names, permite a los usuarios excluir los nombres de pasos de los nombres de métricas para reducir la cardinalidad de métricas si es necesario (el valor predeterminado es false). PR#3493

Característica: agregar sidekiq.separate_transactions opción de configuración

Una nueva opción de configuración, sidekiq.separate_transactions, permite que los trabajos de Sidekiq ejecutados durante una transacción web se ejecuten en su propia transacción separada. Cuando está habilitado, esto evita que el tiempo de ejecución del trabajo de Sidekiq se incluya en las métricas de transacciones web, proporcionando datos de rendimiento más precisos. La característica es opcional (predeterminado: falso) para mantener la compatibilidad con versiones anteriores. Esto solo afecta a los trabajos ejecutados durante transacciones web activas; los trabajos que se inician de forma independiente o anidados dentro de otros trabajos en segundo plano no se ven afectados. Issue#3364 PR#3514

Corrección de errores: actualizar las expresiones regulares que podrían haber sido vulnerables a ataques ReDOS

Anteriormente, el agente tenía algunas regexes identificadas como posibles objetivos de ataques de complejidad de tiempo polinómico (ReDOS). Esas expresiones regulares ahora se actualizaron para resolver las inquietudes. PR#3520

Corrección de errores: evitar caídas durante la creación de segmentos HTTPX

Anteriormente, si start_external_request_segment encontraba un error y devolvía nil, el agente generaba un NoMethodError al intentar agregar encabezados al segmento faltante. Hemos agregado una comprobación de seguridad para garantizar que la instrumentación maneje estos casos con elegancia.

¡Bravo a @thebravoman por el reporte! Issue#3509 PR#3510

Corrección de errores: hacer que Transaction#finish sea idempotente

Anteriormente, si el método Transaction#finish se llamaba múltiples veces, se podía crear más de una transacción para la misma operación. Ahora, un mutex protege las llamadas a Transaction#finish para garantizar que las operaciones de finalización solo se ejecuten una vez. PR#3513

Corrección de errores: Advertencia única de obsolescencia de Log para la API Datastores.wrap

Anteriormente, esta advertencia se registraba en cada llamada a Datastores.wrap. Ahora, solo se registrará en la primera llamada. Además, la documentación se ha actualizado para indicar el estado obsoleto del segundo y tercer argumento de devolución de llamada. Issue#3516 PR#3519