Ruby agent release notesRSS

Bugfix: Action Controller instrumentation no longer errors when it can't identify the controller class

When the agent could not identify a request's controller class, it logged TypeError: no implicit conversion of nil into String and then NoMethodError: undefined method 'finish' for nil, and recorded no data for that request. These transactions are now named Controller/(unknown)/<action> and recorded normally. PR#3691

Bugfix: Prevent Parallel workers from hanging when reporting large payloads

When parallel instrumentation was enabled, Parallel.each/Parallel.map with in_processes: could hang forever. Each worker inherited the pipe write ends the agent registered for its earlier siblings, so those pipes couldn't reach end-of-file, and the agent's pipe listener thread blocked waiting on one of them. Any worker whose data exceeded the operating system pipe buffer then blocked on exit. Now, the agent closes each pipe's write end in the parent right after forking, and the listener no longer blocks on a single pipe while others still have data waiting. Thank you to @yayamochi for reporting this bug. Issue#3680 PR#3688

Bugfix: gRPC calls no longer fail on requests from Synthetics monitors

When a request from a Synthetics monitor made a gRPC call, the agent added X-NewRelic-Synthetics to the call's metadata. gRPC only allows lowercase metadata keys, so the call raised ArgumentError: 'X-NewRelic-Synthetics' is an invalid header key. The agent now sends the synthetics headers in lowercase. gRPC server transactions also now read the synthetics headers from incoming metadata, so a gRPC service called during a Synthetics check records its trace and Synthetics attributes. PR#3693

Característica: perfilado continuo (versión preliminar)

El perfilado continuo es una nueva característica que aún no está disponible para uso general. El código del componente del lado del agente ya está presente en el agente, pero para usarlo realmente antes del lanzamiento de disponibilidad general, deberá comunicarse con el representante de ventas de New Relic para unirse a la versión preliminar de forma anticipada.

Continuous Profiling toma muestras repetidamente de los stack de llamadas de Ruby de la aplicación en ejecución y los reporta a New Relic, para que pueda ver qué métodos consumen más tiempo de CPU (o asignan más objetos) en producción, sin agregar código a la aplicación.

Para activarlo, agregue las gemas stackprof y google-protobuf al Gemfile de la aplicación, y luego establezca profiling.enabled en true:

profiling.enabled: true

Con solo profiling.enabled configurado, el agente toma muestras del tiempo de CPU cada 10 milisegundos durante la vida del proceso. Estas opciones le permiten ajustar ese comportamiento:

PR#3617

Característica: agregar soporte para Dalli 5.1.1

Dalli 5.1.1 agregó argumentos a algunos de los métodos instrumentados por el agente, lo que podría generar un ArgumentError en operaciones de múltiples claves o hacer que las opciones de solicitud se descarten silenciosamente. Ahora, el agente acepta y reenvía un número variable de argumentos posicionales y de palabras clave para estos métodos. 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