Nuevas características y mejoras

• Soporte para CRaC 2250

• Compatibilidad con JDK24 2284

• Se agregaron opciones de ejemplificación cuando existe un traceparent entrante 2279

  • Estas opciones definen cómo debe el agente manejar la ejemplificación de intervalos, dependiendo de las decisiones de ejemplificación que se tomaron para su intervalo principal por una entidad ascendente. Las opciones de configuración remote_parent_sampled y remote_parent_not_sampled especifican qué hacer en caso de que el principal span fue muestreado o no, respectivamente. Consulte la documentación para obtener detalles completos de configuración.

• Soporte para Undertow como módulo independiente 2269

  • Esta instrumentación está deshabilitada de forma predeterminada para evitar conflictos con la instrumentación Wildfly existente. Para habilitar esta instrumentación para aplicaciones de servidor Undertow independientes, emplee la configuración:

  class_transformer:
     com.newrelic.instrumentation.undertow-server-1.1.0:
       enabled: true

  Copia

• Soporte para el cliente Couchbase 2203

  • Si el módulo experimental del cliente Couchbase está actualmente en uso, elimínelo de su directorio de extensiones antes de actualizar a esta versión del agente de Java.

Correcciones

• Corregir transacciones 'Desconocidas' de Netty 2274

  • Esta solución mueve los cambios anteriores de instrumentación de netty detrás de una bandera característica, lo que brinda visibilidad adicional en algunos casos que involucran transacciones HTTP2. Para volver a habilitar este detalle (con el posible costo de ver transacciones "Desconocidas"), use la configuración:

  netty:
      http2:
        frame_read_listener:
          start_transaction: true

  Copia

• Refactorizar la obtención de ID de Docker de AWS para usar un tiempo de espera de 5 segundos de 2275

• Bandera de característica para aplicar la corrección ArrayIndexOutOfBoundsException de Kotlin a todos los métodos 2307

  • Esta corrección soluciona errores que pueden observar al ejecutar el agente de Java en un entorno donde se emplean funciones de suspensión de Kotlin. Para emplear esta solución, configure la propiedad del sistema -Dnewrelic.config.class_transformer.clear_return_stacks=true

• Evitar el bloqueo de caché para el análisis de sentencias de base de datos largas 2294

• Agregar configuración para especificar si java.sql es cargado por el cargador de clases de la plataforma 2267

Desusos

Los siguientes módulos de instrumentación están obsoletos y se eliminarán en la próxima versión principal:

• aws-wrap-0.7.0
• java.completable-future-jdk8
• play-2.3
• netty-3.4
• Struts v1

Actualizar a la última versión

Para identificar qué versión del agente de Java estás usando actualmente, ejecuta java -jar newrelic.jar -v. Su versión de agente de Java se imprimirá en su consola.

Luego, para actualizar a la última versión del agente de Java:

1. Haga una copia de seguridad de todo el directorio raíz del agente de Java en otra ubicación. Cambie el nombre de ese directorio a NewRelic_Agent#.#.#, donde #.#.# es el número de versión del agente.
2. Descargar el agente..
3. Descomprima el archivo de descarga del nuevo agente y luego copie newrelic-api.jar y newrelic.jar en el directorio raíz del agente de Java original.
4. Compare su newrelic.yml antiguo con el newrelic.yml recién descargado del zip y actualice el archivo si es necesario.
5. Reinicie su despachador de Java.

Si tiene problemas después de la actualización del agente de Java, restaure desde el directorio del agente New Relic respaldado.

Actualizar diferencias de configuración del agente

Agregamos nuevas configuraciones a newrelic.yml a medida que lanzamos nuevas versiones del agente. Puede usar diff u otra utilidad de diferenciación para ver qué ha cambiado y agregar la nueva configuración a su archivo anterior. Asegúrese de no sobrescribir ninguna personalización que haya realizado en el archivo, como su clave de licencia, el nombre de la aplicación o los cambios en la configuración predeterminada.

Por ejemplo, si diff los archivos newrelic.yml predeterminados para las versiones 7.10.0 y 7.11.0 del agente de Java , los resultados impresos en la consola serán como:

➜ diff newrelic_7.10.0.yml newrelic_7.11.0.yml
...
107a108,119
>       # Whether the log events should include context from loggers with support for that.
>       include_context_data:
>
>         # When true, application logs will contain context data.
>         enabled: false
>
>         # A comma separated list of attribute keys whose values should be sent to New Relic.
>         #include:
>
>         # A comma separated list of attribute keys whose values should not be sent to New Relic.
>         #exclude:
>
125a138
>
128c141
<     enabled: false
---
>     enabled: true
...

En este ejemplo, estas líneas se agregaron al valor predeterminado newrelic.yml en el agente de Java versión 7.11.0. Si está migrando a la versión 7.11.0 o superior, debe agregar estas nuevas líneas a su newrelic.yml original.

Declaración de apoyo:

• New Relic recomienda que actualices el agente periódicamente para garantizar que obtengas las últimas características y beneficios de rendimiento. Además, las versiones anteriores ya no recibirán soporte cuando lleguen al final de su vida útil.