Ruby agent release notesRSS

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

Característica: agregar asignación de nombres de consulta de la base de datos mediante comentarios SQL

Las consultas de la base de datos ahora se pueden nombrar explícitamente usando comentarios SQL. Las consultas pueden incluir /* NewRelicQueryName: CustomName */ comentarios para asignar nombres estables para un mejor seguimiento e identificación. Esto es especialmente útil para rastrear consultas específicas de la base de datos durante regresiones de rendimiento o incidentes. PR#3480

Característica: agregar instrumentación del logger semántico

El agente ahora admite el reenvío de logs y la decoración de Semantic Logger para la gema semantic_logger versiones 4.6.0+. Si utilizaba previamente el apéndice integrado de New Relic de Semantic Logger, se recomienda elegir un enfoque para evitar enviar logs duplicados. La instrumentación de Semantic Logger de New Relic se puede deshabilitar estableciendo instrumentation.semantic_logger en disabled. PR#3467

Gracias a @jdelStrother por proporcionar retroalimentación valiosa que ayudó a dar forma a esta instrumentación.

Característica: agregar nueva configuración 'ignored_middleware_classes'

Una nueva opción de configuración, ignored_middleware_classes, permite a los usuarios excluir middlewares específicos de la instrumentación (ej. Rack::Cors). El valor predeterminado es una matriz vacía. Issue#1814 PR#3481

Característica: agregar nueva API NewRelic::Agent.add_transaction_log_attributes

Una nueva API, NewRelic::Agent.add_transaction_log_attributes, permite a los usuarios agregar atributos personalizados a nivel de transacción a los logs de eventos para la transacción actual. Estos atributos solo se aplicarán a los logs creados dentro del alcance de la transacción actual. PR#3472

Corrección de error: proporcionar opción de configuración para reducir la cardinalidad de las métricas de broadcast de ActionCable

De forma predeterminada, las métricas para las llamadas al método broadcast de ActionCable incluyen el valor del broadcasting. Este valor puede tener muy alta cardinalidad. Ahora, la opción de configuración :simplify_action_cable_broadcast_metrics permite a los usuarios eliminar el valor de transmisión del nombre de la métrica. Esto crea una métrica que se ve como: Ruby/ActionCable/broadcast. Cuando esta opción de configuración está habilitada, el valor de transmisión se agregará como un atributo de span. PR#3463

Corrección de errores: eliminar la instrucción require inactiva de 'digest/md5' para el cumplimiento de FIPS/FedRAMP

En la versión 7.1.0 del agente, el uso de MD5 se reemplazó por SHA1 para el cumplimiento de FIPS (PR). Sin embargo, el antiguo require para 'digest/md5' no se eliminó. Eliminamos el requisito para ayudar a nuestros usuarios de FIPS/FedRAMP. ¡Gracias a @ashleyboehs por informarnos sobre esto! Issue#3469 PR#3470

Bugfix: impedir que el agente se inicie durante rails test para evitar el retraso en el apagado

Anteriormente, el agente causaba un retraso de cierre de -3 segundos al ejecutar el comando rails test. La constante Rails::Command::TestCommand se ha agregado a la lista autostart.denylisted_constants predeterminada para evitar que el agente se inicie durante las ejecuciones de pruebas de Rails. Gracias a @varyform por informarnos sobre esto. PR#3478

Corrección de errores: soluciona las advertencias "no se puede calcular el tiempo de transacción transcurrido" al usar el servidor web Falcon

El agente ahora usa Fiber.current.object_id en lugar de Thread.current.object_id para rastrear el estado de la transacción cuando se ejecuta en Falcon, lo que evita colisiones de requests concurrentes que comparten el mismo hilo. También soluciona un "NameError: uninitialized constant Async::HTTP::VERSION" al usar Falcon. Gracias a @97jaz y @gsar por informarnos sobre esto. PR#3483

Corrección de errores: corregir error tipográfico en harvest.rb que causaba NoMethodError

Un error tipográfico en lib/new_relic/agent/agent_helpers/harvest.rb causó un NoMethodError: undefined method 'agent' for NewRelic:Module. Gracias a @oakbow por informar este problema. PR#3484

Corrección de error: elimina el uso del obsoleto ObjectSpace._id2ref

El agente ahora usa un enfoque alternativo en lugar del método ObjectSpace._id2ref obsoleto, eliminando las advertencias de obsolescencia al ejecutarse en Ruby 4.0+. PR#3490

Corrección de error: se corrigió NoMethoError en la instrumentación de logging

Anteriormente, cuando la instrumentación de la gema Logging intentaba decorar los logs locales, lanzaba un NoMethodError si encontraba un objeto que no era una cadena. Esto ya está solucionado. PR#3501

Función: Introducir Agente híbrido para soporte de rastreo de OpenTelemetry

Las API de rastreo de OpenTelemetry ahora pueden traducirse a telemetría de New Relic con las nuevas funciones de agente híbrido del agente Ruby de New Relic. Esto permite que la gema newrelic_rpm se comporte de manera similar a un SDK de OpenTelemetry, aceptando llamadas de la API de OpenTelemetry y convirtiéndolas en Transacciones y Segmentos de New Relic con atributos y nombres familiares.

Las siguientes opciones de configuración se relacionan con las funciones del Agente híbrido:

Característica: Agregar opción de configuración error_collector.backtrace_truncate_location

Se agregó una nueva opción de configuración, error_collector.backtrace_truncate_location, que permite al usuario especificar dónde truncar el backtrace cuando el número de marcos excede error_collector.max_backtrace_frames. Las opciones son 'top' (elimina marcos del inicio), 'middle' (elimina marcos del medio, conservando el inicio y el final) o 'end' (elimina marcos del final). El valor predeterminado es 'middle'. PR#3424

Función: Agregar instrumentación de la gema Logging

El agente ahora registrará los logs generados por la gema Logging. PR#3420

Función: Agregar opción de configuración utilization.detect_in_parallel

Se ha agregado una nueva opción de configuración, utilization.detect_in_parallel, que controla si el agente utiliza hilos al detectar información del proveedor de la nube para acelerar el inicio del agente. Cuando se establece en false, la detección de proveedores se ejecuta secuencialmente sin crear hilos. El valor predeterminado es true. PR#3439

Feature: Add support for forking processes in Parallel gem instrumentation

Parallel gem instrumentation has been added to allow more consistent monitoring in processes forked using the Parallel gem. PR#3405

Feature: Add support for Grape v3.1.0

Grape's release of v3.1.0 introduced changes that were incompatible with the agent's instrumentation, causing issues when collecting transaction names. The agent has been updated to properly extract class names for transaction naming in the updated Grape API structure. PR#3413

Bugfix: Create health check files in forked processes

The agent now properly initializes health check loops after forking, ensuring each process generates its own health check file. This fix also has the effect of correctly including entity.guid values in the health check files. PR#3409 Issue#3408

Bugfix: Fix sidekiq.ignore_retry_errors

The configuration option sidekiq.ignore_retry_errors: true was continuing to report retry errors. The agent now correctly ignores retry errors and only reports when jobs permanently fail. PR#3399

Cambio importante: Eliminar la compatibilidad con Ruby 2.4 y 2.5

Se ha eliminado la compatibilidad con las versiones 2.4 y 2.5 de Ruby. La nueva versión mínima requerida de Ruby es ahora la 2.6. PR#3314

Cambio importante: Eliminación del rastreo entre aplicaciones (CAT)

Anteriormente, el Cross Application Tracing (CAT) fue desaprobado a favor del Distributed Tracing. La funcionalidad CAT ahora ha sido eliminada. La opción de configuración cross_application_tracer.enabled ha sido eliminada. Los métodos de la API pública 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 y NewRelic::Agent::Transaction::ExternalRequestSegment#read_response_headers también se han eliminado. PR#3333

Cambio importante: Renombrar las métricas y segmentos de ActiveJob

Las métricas de ActiveJob se han actualizado para incluir el nombre de la clase del trabajo para informes más específicos. Este es un cambio importante y puede requerir la actualización de paneles o alertas personalizadas. PR#3370 PR#3320

• Formato antiguo: Ruby/ActiveJob/<QueueName>/<Method>
• Nuevo formato: Ruby/ActiveJob/<QueueName>/<ClassName>/<Method>

Además, los segmentos creados para las acciones de puesta en cola de Active Job ahora incluyen la clase de trabajo.

• Formato antiguo: ActiveJob/<QueueAdapter>/Queue/<Event>/Named/<QueueName>
• Nuevo formato: ActiveJob/<QueueAdapter>/Queue/<Event>/Named/<QueueName>/<ClassName>

Cambio importante: Renombrar el comando bin/newrelic a bin/newrelic_rpm

El archivo ejecutable para la CLI del agente se ha renombrado de bin/newrelic a bin/newrelic_rpm. Este cambio resuelve un conflicto de nombres con la herramienta CLI independiente de New Relic. PR#3323

Cambio importante: Eliminar el comando CLI newrelic deployments

El comando CLI newrelic deployments obsoleto se ha eliminado. Para rastrear los cambios y las implementaciones en New Relic, consulte nuestra guía sobre Seguimiento de cambios para obtener una lista de las opciones disponibles. PR#3299

Cambio importante: Eliminar el método NewRelic::Agent::SqlSampler#notice_sql

Los usuarios deben llamar a NewRelic::Agent::Datastores.notice_sql en su lugar. PR#3338

Cambio importante: Eliminar argumentos no utilizados de varias API de NewRelic::Agent::Datastores

Se han eliminado los argumentos de los métodos de las siguientes API de la clase NewRelic::Agent::Datastores:

• NewRelic::Agent::Datastores.notice_sql, anteriormente tenía tres argumentos posicionales, query, scoped_metric y elapsed. Ahora, solo tiene query.
• NewRelic::Agent::Datastores.notice_statement, anteriormente tenía dos argumentos posicionales query y elapsed. Ahora solo tiene query.
• NewRelic::Agent::Datastores.wrap requiere un proc. Anteriormente, el proc recibía tres argumentos: el resultado del yield, el nombre de la métrica con ámbito más específico y el tiempo transcurrido de la llamada. Ahora, solo recibe uno: el resultado del yield.

Los valores de los argumentos eliminados se derivan del segmento actual en el momento de la llamada. PR#3347

Cambio importante: Eliminar la función experimental Políticas de seguridad configurables (CSP)

La función experimental, Políticas de seguridad configurables (CSP), ya no es compatible y se ha eliminado. PR#3292

Cambio importante: Eliminar la compatibilidad con las versiones de Puma '<' 3.9.0

La versión mínima de Puma ahora compatible es 3.9.0 o superior. PR#3326

Cambio importante: Mejorar la validación y coerción de la configuración

Los mecanismos internos utilizados para forzar y validar los valores proporcionados para la configuración del agente ahora son más eficientes y precisos.

• Los mensajes de advertencia ahora se registrarán en el archivo newrelic_agent.log cuando se proporcione nil como valor de configuración para una configuración que no lo admita.
• Se permiten valores enteros para los tipos de configuración Float
• Se permiten valores Float para los tipos de configuración Integer
• Se evitan las interrupciones fatales cuando se puede encontrar un valor predeterminado para reemplazar un valor de entrada no válido PR#3341

Cambio importante: Reemplazar la opción 'default' con 'adaptive' para los muestreadores remotos de tracing distribuido

Anteriormente, la opción predeterminada para distributed_tracing.sampler.remote_parent_sampled y distributed_tracing.sampler.remote_parent_not_sampled era default, que utilizaba el muestreador adaptativo preexistente. La opción default ha sido renombrada a adaptive. PR#3363

Función: Agregar logger como dependencia

La gema logger ahora se enumera como una dependencia del agente para garantizar la funcionalidad de logging continuo y la compatibilidad con Ruby 4.0.0 y versiones más recientes. PR#3293

Función: Agregar la opción de configuración de lista de permitidos de notificación de Active Support

Una nueva opción de configuración, instrumentation.active_support_notifications.active_support_events, permite a los usuarios definir una lista de permitidos de nombres de eventos de notificaciones de Active Support a los que el agente debe suscribirse. De forma predeterminada, el agente se suscribe a todos los eventos de Active Support: Caching y Active Support: Messages. PR#3327

Función: Usar la compresión Gzip integrada de Ruby

El agente ahora utiliza el método Zlib.gzip incorporado de la biblioteca estándar de Ruby para la compresión, reemplazando la implementación personalizada anterior. PR#3332

Función: Agregar la validación de argumentos para la API NewRelic::Agent#record_custom_event

La API NewRelic::Agent#record_custom_event ahora genera un ArgumentError cuando se proporciona un event_type no válido. Un tipo de evento válido debe consistir solo en caracteres alfanuméricos, guiones bajos (_), dos puntos (:) o espacios ( ). PR#3319

Función: Agregar opciones de configuración de muestreo raíz

Ahora puede configurar el comportamiento de muestreo para los rastreos que se originan dentro del servicio actual utilizando distributed_tracing.sampler.root. PR#3330

Hay cuatro modos disponibles:

Función: Agregar opciones de muestreo basadas en la proporción de ID de rastreo

El agente ahora puede muestrear rastreos utilizando el algoritmo de muestreador basado en la proporción de ID de rastreo de OpenTelemetry. PR#3330 Esto muestrea rastreos en función de una probabilidad entre 0,0 y 1,0 basada en el ID de rastreo.

Para usar esta opción, primero debe configurar su configuración de muestreador de rastreo distribuido en trace_id_ratio_based y luego configurar el muestreador distributed_tracing.sampler.*.trace_id_ratio_based.ratio correspondiente en un Float entre 0.0 y 1.0.

Por ejemplo:

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

Esta configuración muestrearía aproximadamente el 50% de sus rastreos para todos los rastreos donde el elemento principal remoto se muestrea.

Esta opción está disponible para:

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

Función: Agregar GUID de entidad a los archivos de comprobación de estado de Agent Control

Cuando el agente se inicia dentro de un entorno de Control de agente, se crea un archivo de verificación de estado en la ubicación de archivo configurada para cada proceso de agente. Este archivo ahora incluye el guid de la entidad relacionada con el agente cuando está disponible. PR#3371

Corrección de errores: Resolver un NoMethodError en la detección de utilización de GCP.

La lógica de descubrimiento de metadatos de GCP ahora manejará con elegancia nil o valores inesperados, evitando fallos en la inicialización del servicio. PR#3388