Ruby agent release notesRSS

Breaking Change: Remove support for Ruby 2.4 and 2.5

Support for Ruby versions 2.4 and 2.5 has been removed. The new minimum required Ruby version is now 2.6. PR#3314

Breaking Change: Removal of Cross Application Tracing (CAT)

Previously, Cross Application Tracing (CAT) was deprecated in favor of Distributed Tracing. CAT functionality has now been removed. The configuration option cross_application_tracer.enabled has been removed. Public API methods NewRelic::Agent::External.process_request_metadata, NewRelic::Agent::External.get_response_metadata, NewRelic::Agent::Transaction::ExternalRequestSegment#process_response_metadata, NewRelic::Agent::Transaction::ExternalRequestSegment#get_request_metadata, and NewRelic::Agent::Transaction::ExternalRequestSegment#read_response_headers have also been removed. PR#3333

Breaking Change: Rename ActiveJob metrics and segments

ActiveJob metrics have been updated to include the job's class name for more specific reporting. This is a breaking change and may require updating custom dashboards or alerts. PR#3370 PR#3320

• Old format: Ruby/ActiveJob/<QueueName>/<Method>
• New format: Ruby/ActiveJob/<QueueName>/<ClassName>/<Method>

In addition, segments created for Active Job enqueuing actions now include the job class.

• Old format: ActiveJob/<QueueAdapter>/Queue/<Event>/Named/<QueueName>
• New format: ActiveJob/<QueueAdapter>/Queue/<Event>/Named/<QueueName>/<ClassName>

Breaking Change: Rename bin/newrelic command to bin/newrelic_rpm

The executable file for the agent's CLI has been renamed from bin/newrelic to bin/newrelic_rpm. This change resolves a name collision with the standalone New Relic CLI tool. PR#3323

Breaking Change: Remove the newrelic deployments CLI command

The deprecated newrelic deployments CLI command has been removed. To track changes and deployments in New Relic, please see our guide to Change Tracking for a list of available options. PR#3299

Breaking Change: Remove the NewRelic::Agent::SqlSampler#notice_sql method

Users should call NewRelic::Agent::Datastores.notice_sql instead. PR#3338

Breaking Change: Remove unused arguments from various NewRelic::Agent::Datastores APIs

The following APIs from the NewRelic::Agent::Datastores class have had method arguments removed:

• NewRelic::Agent::Datastores.notice_sql, previously had three positional arguments, query, scoped_metric and elapsed. Now, it only has query.
• NewRelic::Agent::Datastores.notice_statement, previously had two positional arguments query and elapsed. Now it only has query.
• NewRelic::Agent::Datastores.wrap requires a proc. Previously the proc received three arguments: the result of the yield, the most specific scoped metric name, and the elapsed time of the call. Now, it only receives one: the result of the yield.

The values of the removed arguments are derived from the current segment at the time of the call. PR#3347

Breaking Change: Remove experimental feature Configurable Security Policies (CSP)

The experimental feature, Configurable Security Policies (CSP), is no longer supported and has been removed. PR#3292

Breaking Change: Remove support for Puma versions < 3.9.0

The minimum version of Puma now supported is 3.9.0 or higher. PR#3326

Breaking Change: Improve configuration validation and coercion

The internals used to coerce and validate the values provided for agent configuration are now more performant and more accurate.

• Warning messages will now be logged to the newrelic_agent.log file when nil is provided as a config value for a setting that does not support it.
• Integer values are permitted for Float configuration types
• Float values are permitted for Integer configuration types
• Fatal interruptions are prevented when a default value can be found to replace an invalid input value PR#3341

Breaking Change: Replace 'default' option with 'adaptive' for distributed tracing remote parent samplers

Previously, the default option for distributed_tracing.sampler.remote_parent_sampled and distributed_tracing.sampler.remote_parent_not_sampled was default, which used the pre-existing adaptive sampler. The default option has been renamed to adaptive. PR#3363

Feature: Add logger as a dependency

The logger gem is now listed as a dependency of the agent to ensure continued logging functionality and support for Ruby 4.0.0 and newer versions. PR#3293

Feature: Add Active Support notification allowlist configuration option

A new configuration option, instrumentation.active_support_notifications.active_support_events, allows users to define an allowlist of Active Support notifications event names for the agent to subscribe to. By default, the agent subscribes to all Active Support: Caching and Active Support: Messages events. PR#3327

Feature: Use Ruby's built-in Gzip compression

The agent now uses the built-in Zlib.gzip method from the Ruby standard library for compression, replacing the previous custom implementation. PR#3332

Feature: Add argument validation for the NewRelic::Agent#record_custom_event API

The NewRelic::Agent#record_custom_event API now raises an ArgumentError when an invalid event_type is provided. A valid event type must consist only of alphanumeric characters, underscores (_), colons (:), or spaces ( ). PR#3319

Feature: Add root sampling configuration options

You can now configure the sampling behavior for traces that originate within the current service using distributed_tracing.sampler.root. PR#3330

There are four modes available:

Feature: Add Trace ID Ratio Based sampling options

The agent can now sample traces using the OpenTelemetry Trace ID Ratio Based sampler algorithm. PR#3330 This samples traces based on a probability between 0.0 and 1.0 based on the trace ID.

To use this option, you must first set your distributed tracing sampler configuration to trace_id_ratio_based and then set the corresponding distributed_tracing.sampler.*.trace_id_ratio_based.ratio sampler to a Float between 0.0 and 1.0.

For example:

distributed_tracing.sampler.remote_parent_sampled: 'trace_id_ratio_based'
  distributed_tracing.sampler.remote_parent_sampled.trace_id_ratio_based.ratio': 0.5

This configuration would sample approximately 50% of your traces for all traces where the remote parent is sampled.

This option is available for:

• distributed_tracing.sampler.root
• distributed_tracing.sampler.remote_parent_sampled
• distributed_tracing.sampler.remote_parent_not_sampled

Feature: Add Entity GUID to Agent Control health check files

When the agent is started within an Agent Control environment, a health check file is created at the configured file location for every agent process. This file now includes the guid of the entity related to the agent when available. PR#3371

Bugfix: Resolve a NoMethodError in GCP utilization detection.

The GCP metadata discovery logic will now gracefully handle nil or unexpected values, preventing service initialization crashes. PR#3388

característica: Recordatorio de desuso para SqlSampler#notice_sql API

El método NewRelic::Agent::SqlSampler#notice_sql está obsoleto y se eliminará en una futura versión principal. En su lugar, el usuario debería llamar a NewRelic::Agent::Datastores.notice_sql. PR#3345

característica: Aviso de desuso para el segundo y tercer argumento en Datastores.notice_sql API

El segundo (scoped_metric) y tercer (elapsed) argumento del método NewRelic::Agent::Datastores.notice_sql están obsoletos. Hace tiempo que no se emplean con este método. En cambio, estos valores se establecerán en función del segmento actual cuando se llame a la API. PR#3345

característica: Aviso de desuso para el segundo argumento en Datastores.notice_statement API

El segundo argumento (elapsed) en el método NewRelic::Agent::Datastores.notice_statement está obsoleto. Hace tiempo que no se emplea este método. En cambio, este valor se establecerá en función del segmento actual cuando se llama a la API. PR#3346

característica: Aviso de desuso para el segundo y tercer argumento de proc en APIDatastores.wrap

El método NewRelic::Agent::Datastores.wrap está cambiando. En una futura versión principal, proc solo aceptará un único argumento, el resultado del rendimiento. El nombre de la métrica con alcance y los argumentos transcurridos se eliminarán, ya que se eliminan del método Datastores.notice_sql. El nombre de la métrica con alcance y los valores transcurridos se derivan del segmento actual cuando se realiza el ajuste. PR#3346

característica: Agregar sidekiq.ignore_retry_errors opción de configuración

Se agregó una nueva opción de configuración, sidekiq.ignore_retry_errors, para controlar si se capturan los reintentos de trabajo de Sidekiq. Los errores de reintento se capturan de forma predeterminada, pero ahora si sidekiq.ignore_retry_errors se establece en true, el agente ignorará las excepciones generadas durante los intentos de reintento de Sidekiq y solo informará el error si el trabajo falla permanentemente. Gracias DonGiulio por reconocer esta mejora y aportar una solución. PR#3317

característica: Aviso de obsolescencia para la grabación de despliegue mediante Capistrano

El envío de información de despliegue de aplicaciones mediante una receta de Capistrano está obsoleto y se eliminará en la versión 10.0.0 del agente. Para el registro de despliegue, consulte nuestra guía de seguimiento de cambios para obtener una lista de las opciones disponibles.

característica: Emplee la configuración de ejemplificación principal remota para tomar decisiones en más escenarios

Anteriormente, las opciones de configuración distributed_tracing.sampler.remote_parent_sampled y distributed_tracing.sampler.remote_parent_not_sampled se empleaban para la decisión de ejemplificación sola cuando estaban presentes los encabezados traceparent y tracestate. Ahora, estas opciones de configuración se aplican en los casos en que falta el encabezado tracestate y cuando solo está disponible el encabezado newrelic. Este cambio hace que la ejemplificación de latitud distribuida sea más consistente y previsible. PR#3306

característica: Instrumentación en un solo paso para Kubernetes

El APM Kubernetes implementa automáticamente la conexión automática de la aplicación y gestiona las actualizaciones del agente dentro del despliegue Kubernetes. Esta función salió de la vista previa y ahora está disponible de forma general. Obtenga más información sobre la conexión automática de Kubernetes. PR#2635 PR#3287

Característica: Aviso de desuso para Ruby 2.4 y Ruby 2.5

La compatibilidad del agente Ruby con las versiones Ruby 2.4 y 2.5 está obsoleta y se eliminará en la versión 10.0.0 del agente. La nueva versión mínima requerida de Ruby será Ruby 2.6 y dejaremos de realizar pruebas con Ruby 2.4 y 2.5. PR#3288

Característica: Aviso de desuso del comando newrelic deployments

La compatibilidad para grabar la implementación mediante el comando newrelic deployments ahora está obsoleta y se eliminará en la versión 10.0.0 del agente.

En el futuro, habrá varias formas automatizadas y manuales de registrar cambios en New Relic. Consulte nuestra guía de seguimiento de cambios para obtener una lista de las opciones disponibles. PR#3262

Característica: Recordatorio de obsolescencia para el seguimiento de múltiples aplicaciones

El seguimiento de múltiples aplicaciones quedó obsoleto desde la versión principal 8.0.0 del agente Ruby. Eliminaremos el soporte para este producto por completo en la versión 10.0.0 del agente. PR#3288

Característica: Garantizar la compatibilidad con Ruby 3.5 cambiar al método#source_location

Se actualizó el agente para analizar correctamente el valor de retorno del método #source_location, que está cambiando en Ruby 3.5 de una matriz de dos elementos a una matriz de cinco elementos. Este cambio mantiene el soporte para versiones anteriores de Ruby y al mismo tiempo agrega soporte para la versión futura. PR#3257

Característica: En modo Serverless APM, use el nombre de la fuente del evento como prefijo del nombre de la transacción

El agente ahora empleará el nombre de origen del evento como prefijo para el nombre de la transacción en el modo APM Serverless. Esto ayudará a identificar mejor la fuente de la transacción en la UI New Relic. PR#3245

Bugfix: revertir la lógica modificada sobre cómo rastreamos el hilo en el que comienza el lapso

Este cambio restaura el comportamiento anterior de seguimiento del hilo en el que comienza el lapso, solucionando los problemas que surgieron de la lógica actualizada. Gracias @david-zw-liu por informarnos sobre esto. PR#3248