Ruby agent release notesRSS

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

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