Configuración del agente de Java: archivo de configuración

Para crear el directorio de extensiones:

1. Navegue hasta el directorio donde se encuentran newrelic.jar y newrelic.yml . Cree un directorio llamado extensions.
2. En newrelic.yml, verifique que la propiedad extensions.dir no esté configurada.

Para utilizar un directorio de extensiones de Java existente:

1. En su archivo newrelic.yml , busque la sección common .
2. Utilice la propiedad extensions.dir para especificar la ubicación del archivo.

Esta configuración es required. Debe especificar la clave de licencia asociada con su cuenta New Relic. Esta clave vincula los datos de su agente a su cuenta en el servicio New Relic.

Esta configuración es required. Define el nombre de la aplicación utilizada para informar datos a New Relic.

Si enable_auto_app_naming es falso, el agente informa todos los datos a esta aplicación. De lo contrario, el agente reporta solo tareas en segundo plano (transacción para aplicaciones no web) a esta aplicación.

Para informar datos a más de una aplicación, separe los nombres de las aplicaciones con un punto y coma. Por ejemplo, para informar datos a My Application y My Application 2 utilice esto:

app_name: My Application;My Application 2

Para conocer más métodos para nombrar su aplicación, consulte Nombrar su aplicación Java.

Bandera para habilitar al agente. Utilice esta configuración para forzar que el agente se ejecute o no.

El umbral apdex_t en segundos para la puntuación Apdex de la aplicación. Para las versiones 1.2.008 o superiores del agente de Java, el valor apdex_t se establece en la UI y el valor en newrelic.yml se ignora.

Número para diferenciar las JVM para la misma aplicación en la misma máquina. New Relic usa host/port para ser único, por lo que puede distinguir las JVM colocando un modificador como este en los argumentos de inicio de cada JVM:

-Dnewrelic.config.appserver_port=8081

Una vez que haya utilizado appserver_port para nombrar las JVM y reiniciarlas, debería poder verlas individualmente en el menú desplegable y en la interfaz de creación de perfiles.

Permite el registro de texto sin formato de todos los datos enviados a New Relic en el archivo de registro del agente. Esta configuración es dinámica, por lo que al ejecutar agente notará cambios en newrelic.yml sin reiniciar la JVM.

Especifica una ruta a un paquete de certificado SSL personalizado que utilizará el agente para establecer una conexión segura con New Relic. Si su paquete de certificado SSL personalizado no incluye certificados que sean suficientes para conectarse a New Relic, deberá fusionar los certificados requeridos en su paquete de certificados personalizado.

Permite generar informes de datos por separado para cada aplicación web. Configúrelo en true para habilitar la compatibilidad con la denominación automática de aplicaciones. El nombre de cada aplicación web se detecta automáticamente y el agente reporta datos por separado para cada una. Esto proporciona un desglose del rendimiento más detallado para las aplicaciones web en New Relic.

Para obtener más información, consulte Nomenclatura automática de aplicaciones.

Para conocer más métodos para nombrar su aplicación, consulte Nombrar su aplicación Java.

Habilita la denominación de transacciones basada en componentes. Establezca en true para habilitar la denominación de transacciones basada en componentes. Establezca en false para utilizar el URI de una solicitud web como nombre de la transacción. Para más información, consulte Naming transacción web.

Habilita toda la instrumentación mediante una anotación @Trace . Deshabilitar esto hace que se ignoren las anotaciones @Trace .

Evento ingest URI utilizado por alguna característica del agente. Por defecto el extremo de ingestión de producción estadounidense. Se puede configurar manualmente para enviar eventos a otro extremo de ingesta (por ejemplo, producción de la UE: https://insights-collector.eu01.nr-data.net/v1/accounts/events).

Los clientes que cumplen con FedRAMP deben utilizar el extremo compatible con FedRAMP: https://gov-insights-collector.newrelic.com/v1/accounts/events

Define la ubicación del directorio de extensiones opcionales. Si esta propiedad no está configurada, el agente buscará un subdirectorio denominado extensions en el mismo directorio que newrelic.jar y newrelic.yml.

Para habilitar la alta seguridad , esta propiedad debe establecerse en true y la propiedad de alta seguridad en la interfaz de usuario de New Relic debe estar habilitada. Habilitar la alta seguridad significa que SSL está activado, los parámetros de la cola de solicitudes y mensajes no se recopilan y la consulta no se puede enviar a New Relic en su forma original.

Proporciona la capacidad de configurar un extremo compatible con FedRAMP para que lo utilice el agente, con el valor gov-collector.newrelic.com.

Una Insert clave de API válida para su cuenta. El agente no lo utiliza actualmente.

Adjunte etiqueta a esta aplicación.

Tenga en cuenta que esta opción ahora habilita etiquetas, que reemplazaron la característica de etiqueta. Aún puedes consultar tus etiquetas históricas. Se pueden adjuntar varias etiquetas utilizando un punto y coma como separador de la siguiente manera:

-Dnewrelic.config.labels="tagName1:tagValue1;tagName2:tagValue2;tagName3:tagValue3"

En casos excepcionales, podría producirse una pérdida de memoria con la instrumentación que utiliza la API legacy heredada para realizar un seguimiento del ciclo de vida de los servlets asíncronos o Jetty Continuations. La pérdida de memoria se manifestaría como transacciones filtradas que se suspendieron pero nunca se reanudaron. Esta configuración actúa como una solución para evitar que ocurra tal escenario. Se recomienda habilitar esta solución solo cuando se produzca una pérdida de memoria de este tipo.

Limita la cantidad de líneas que el agente recopila de cada rastreo del stack. Aumentar este valor puede afectar el rendimiento, porque aumenta la cantidad de memoria que utiliza el agente y la cantidad de datos enviados a New Relic.

Métrica ingest URI utilizada por algún agente característico. Por defecto el extremo de ingestión de producción estadounidense. Se puede configurar manualmente para enviar métrica a otro extremo de ingesta (ejemplo de URI de producción de la UE: https://metric-api.eu.newrelic.com/metric/v1).

Los clientes que cumplen con FedRAMP deben utilizar el extremo compatible con FedRAMP: https://gov-metric-api.newrelic.com/metric/v1

El host proxy a través del cual conectarse al recopilador New Relic. Si se utiliza un proxy, se requiere la configuración del host. Otras configuraciones de proxy son opcionales.

La contraseña para la autenticación de proxy. Si se utiliza un proxy, se requiere la configuración del host. Otras configuraciones de proxy son opcionales. La configuración de nombre de usuario y contraseña se utilizará para autenticarse en los desafíos de autenticación básica desde un servidor proxy.

El número de puerto del host proxy. Si se utiliza un proxy, se requiere la configuración del host. Otras configuraciones de proxy son opcionales.

El nombre de usuario para la autenticación de proxy, como la autenticación básica (texto sin cifrar). Si se utiliza un proxy, se requiere la configuración del host. Otras configuraciones de proxy son opcionales. La configuración de nombre de usuario y contraseña se utilizará para autenticarse en los desafíos de autenticación básica desde un servidor proxy.

El esquema de proxy utilizado. La configuración proxy_scheme: "https" permitirá que el agente se conecte a través de servidores proxy utilizando el esquema HTTPS.

Si se informan errores para Reactor Netty. El valor predeterminado es falso. Si se establece en verdadero, se informarán los errores de Reactor Netty.

Habilite el apagado retrasado de JVM para darle al agente la oportunidad de enviar los datos métricos más recientes a New Relic antes del cierre de JVM.

La cantidad de segundos después de los cuales el agente utilizará la configuración send_data_on_exit .

Habilite los informes de la configuración de JVM a New Relic.

Cuando se establece en true, las propiedades de JVM se enviarán a New Relic.

Requiere conexiones al recopilador New Relic para pasar por SSL.

El agente se comunica con New Relic a través de HTTPS de forma predeterminada, y New Relic requiere HTTPS para todo el tráfico hacia APMy la API REST de New Relic.

Este trabajo se realiza de forma asincrónica con los subprocesos que procesan el código de su aplicación, por lo que el tiempo de respuesta no se verá afectado directamente por este cambio.

Permita que el agente se conecte al recolector New Relic inmediatamente después del inicio de la aplicación.

Para obtener detalles más concisos de la traza de la transacción, el agente no informa los futuros de Scala como segmentos de transacción, y esos futuros no contribuyen al tiempo total de la transacción.

Habilitar scala_futures_as_segments aumenta sus gastos generales. Si desea que Scala Futures se informe como segmentos de transacción para poder verlos en una traza de la transacción, puede habilitarlo:

scala_futures_as_segments:
  enabled: true

A partir de la versión del agente 8.7.0, si se establece en verdadero y el Agente se ejecuta con JBoss EAP/Wildfly, esto evitará que el agente requiera que el cargador de clases del sistema cargue cualquier clase del paquete javax.management . Esto se agrega para ayudar a solucionar problemas de inicio de la aplicación con los módulos JBoss cuando se utiliza la API de administración J2EE/Jakarta. Se proporciona más información en el documento de resolución de problemas de JBoss/Wildfly.

Indicador de expiración que permite que el agente se ejecute con versiones de Java no compatibles.

Establezca un nombre para mostrar para decorar la etiqueta "host:puerto" en la UI de New Relic. Requiere agente de Java 3.17 o superior.

Cadena que contiene una ruta completa al archivo de configuración de newrelic. Si está vacío, el agente supone newrelic.yml está en el mismo directorio que newrelic.jar.

Habilite el registro de depuración.

Cadena que contiene la configuración del entorno que utilizará el agente.

Cadena que contiene el directorio de inicio del agente. El valor predeterminado es el mismo directorio que el archivo jar del agente.

Cadena que contiene el nombre del agente archivo de log.

Esta configuración se puede utilizar para activar o desactivar todos los atributos.

Si los atributos están habilitados, las claves de atributos que se encuentran en esta lista se enviarán a New Relic. Separe las claves de la lista con una coma; Por ejemplo:

key1, key2, key3

Consulte también las reglas de atributos del agente.

Todas las claves de atributos encontradas en esta lista no se enviarán a New Relic. Separe las claves de la lista con una coma; Por ejemplo:

key1, key2, key3

Consulte también las reglas de atributos del agente.

El informe de atributos se puede configurar a través de los siguientes medios.

YAML:

attributes:
http_attribute_mode: both

Propiedad del sistema:

-Dnewrelic.config.attributes.http_attribute_mode=both

Variable ambiental:

NEW_RELIC_ATTRIBUTES_HTTP_ATTRIBUTE=both

Las opciones de configuración son:

• standard : Los informes utilizarán estándares (es decir, OTEL) atributo. Se recomienda esta configuración. Minimizará el impacto en la funcionalidad y mantendrá el nivel más bajo de ingesta para los informes de atributos.
• legacy : Los informes se realizarán mediante el atributo HTTP reintroducido; esta configuración puede afectar la funcionalidad actual o futura.
• both : Esta es la configuración predeterminada, los informes se realizarán mediante el atributo HTTP reintroducido y el atributo OTEL. Esta configuración también aumentará su ingesta de datos.

La cantidad de segundos después de los cuales el agente caducará automáticamente un token asíncrono que no ha caducado explícitamente con token.expire(). Para obtener instrucciones de uso, consulte token: conectar subprocesos asíncronos.

La cantidad de segundos después de los cuales el agente finalizará automáticamente un segmento que no haya finalizado explícitamente con segment.end() o segment.ignore(). Para obtener instrucciones de uso, consulte Segmentos: actividad asíncrona arbitraria de tiempo.

De forma predeterminada, el agente inserta automáticamente la API de llamada en JSP compilados para inyectar el JavaScript de monitoreo en las páginas web. Establezca este atributo en false para desactivar este comportamiento.

Cuando auto_instrument es true, de forma predeterminada todas las páginas están instrumentadas. Enumere todas las páginas que desea que la instrumentación automática omita aquí. Aún puede utilizar instrumentación manual en estas páginas.

Por ejemplo:

browser_monitoring:
  disabled_auto_pages: /WEB-INF/jsp/testpage_1.jsp, /WEB-INF/jsp/testpage_2.jsp

Esta configuración se puede utilizar para activar o desactivar todos los atributos de monitoreo del navegador. Estos son los datos que puedes consultar. Si attributes.enabled es falso en el nivel raíz, no se enviará ningún atributo en el monitoreo del navegador independientemente de cómo esté configurada esta propiedad en browser_monitoring .

Si los atributos están habilitados para browser_monitoring, todas las claves de atributos que se encuentran en esta lista se enviarán a New Relic en las vistas de página. Para obtener más información, consulte las reglas de atributos del agente.

Todas las claves de atributos que se encuentran en esta lista no se enviarán a New Relic en las visitas a la página. Para obtener más información, consulte las reglas de atributos del agente.

Si su aplicación se comporta como se esperaba, es posible que desee desactivar el interruptor.

Personalice el porcentaje de memoria dinámica libre por debajo del cual debería activarse el interruptor. Cuando el porcentaje de memoria dinámica libre es menor que memory_threshold y el tiempo de CPU dedicado a la recolección de basura es mayor que gc_cpu_threshold, el interruptor se activa. Para que sea menos probable que el interruptor se dispare, disminuya memory_threshold y/o aumente gc_cpu_threshold. Ajuste estos valores según sea necesario, según el rendimiento operativo y el comportamiento de su aplicación.

Personalice el porcentaje de tiempo de CPU de recolección de basura por encima del cual debería activarse el interruptor. Cuando el porcentaje de memoria de montón libre es menor que memory_threshold y el tiempo de CPU dedicado a la recolección de basura es mayor que gc_cpu_threshold, el interruptor se activa. Para que sea menos probable que el interruptor se dispare, disminuya memory_threshold y/o aumente gc_cpu_threshold. Ajuste estos valores según sea necesario, según el rendimiento operativo y el comportamiento de su aplicación.

Determina si el agente sondea la API de metadatos de AWS.

Determina si el agente sondea la API de metadatos de Azure.

Determina si el agente sondea la API de metadatos de Google Cloud Platform.

Determina si el agente informa la variable de entorno KUBERNETES_SERVICE_HOST .

Determina si el agente lee las variables de entorno de Pivotal Cloud Foundry.

Determina si el agente lee la información Docker del sistema de archivos.

La métrica a nivel de código está deshabilitada de forma predeterminada en la versión 7.10.0 del agente. Establezca esto en verdadero para activarlo. A partir de la versión 7.11.0 del agente, el valor predeterminado es, como se indicó anteriormente, true.

El rastreo multiaplicación está habilitado por defecto. Establezca esto en falso para desactivarlo.

Esto habilita el servicio de evento personalizado.

El tamaño máximo de un valor de atributo, después del cual el valor se truncará. El valor predeterminado es 255 bytes (en codificación de juego de caracteres UTF-8) y el límite máximo es 4095.

Esta configuración existe en el agente de Java versión 8.9.0+.

El número máximo de eventos personalizados muestreados se informa cada 60 segundos.

Cuando está habilitada, la denominación mejorada de transacciones Spring nombrará cualquier transacción que se origine en un controlador Spring después de la ruta definida y el método HTTP. Por ejemplo: /customer/v1/edit (POST). Esto incluye controladores que implementan o amplían interfaces/clases con anotaciones relacionadas con WebMVC (@RestController, @Controller, @RequestMapping, etc.).

De forma predeterminada, esto está configurado en false, que nombrará la transacción para esos tipos de controladores según el nombre de clase y el método del controlador. Por ejemplo; CustomerController/edit. Esta es la lógica de nomenclatura heredada de versiones anteriores del agente. Los controladores "estándar", con todas las anotaciones relevantes presentes en la clase real, seguirán recibiendo nombres según la ruta y el método HTTP.

Esta configuración existe en el agente de Java versión 8.9.0+.

Cadena que contiene el nombre completo de la clase de anotación que utiliza el agente para determinar qué métodos especificados por el usuario instrumentar. Para obtener más información sobre anotaciones personalizadas, consulte Colección Java métrica personalizada.

Habilite esta opción para capturar el nombre userPrincipal . Este nombre se incluye como traza de la transacción (con nombres de atributo user y enduser.id), y se puede consultar. Esto también le permite ver en Errors Inbox cuántos usuarios se ven afectados por un grupo de errores.

Establezca esto en false para deshabilitar el rastreo distribuido. Por ejemplo, en el archivo de configuración, usarías:

distributed_tracing:
  enabled: false

Aquí hay otras opciones para desactivar rastreo distribuido:

Propiedad del sistema:

-Dnewrelic.config.distributed_tracing.enabled=false

Variables ambientales:

NEW_RELIC_DISTRIBUTED_TRACING_ENABLED=false

De forma predeterminada, las versiones compatibles del agente utilizan tanto el encabezado newrelic como los encabezados W3C Trace Context para rastreo distribuido. El encabezado rastreo distribuido newrelic permite la interoperabilidad con agentes más antiguos que no admiten encabezados W3C Trace Context . Las versiones del agente que admiten encabezados W3C Trace Context los priorizarán sobre newrelic encabezados para rastreo distribuido.

Si no desea utilizar el encabezado newrelic, configurarlo en true hará que el agente excluya el encabezado newrelic y solo use encabezados W3C Trace Context para rastreo distribuido.

Por ejemplo, para excluir newrelic encabezados en el archivo de configuración, usaría:

distributed_tracing:
  exclude_newrelic_header: true

Para excluir newrelic encabezados usando una propiedad del sistema, usaría:

-Dnewrelic.config.distributed_tracing.exclude_newrelic_header=true

Habilitar la recopilación de errores.

Los nombres de clases de excepción especificados se ignorarán y no afectarán la tasa de errores ni la puntuación de Apdex, ni se informarán a APM. Cannot be specified by system property.

Esta configuración es dinámica, por lo que al ejecutar agente notará cambios en newrelic.yml sin reiniciar la JVM.

Por ejemplo:

error_collector:
  ignore_classes:
    - "com.example.MyException"
    - "com.example.DifferentException"

Se puede utilizar una variable de entorno para enumerar los nombres de clases de excepción que desea ignorar:

NEW_RELIC_ERROR_COLLECTOR_IGNORE_CLASSES="[\"com.example.MyException\", \"com.example.DifferentException\"]"

Especifique nombres de clases de excepción que el agente debe ignorar. Los mensajes ignorados no afectarán la tasa de errores o la puntuación Apdex, ni serán reportados a APM. Contiene yaml pares que constan de:

• Un nombre de clase de excepción completo que no debe informarse a APM

  Y

• Una lista de excepciones messagecon las que comparar (se requiere al menos una)

  Si el nombre de la clase de excepción coincide con un error pero el mensaje no, entonces se ignorará ese error will not . Las cadenas de mensajes utilizan contains para hacer coincidir. Un mensaje no se puede proporcionar por sí solo y siempre debe ir acompañado de un nombre de clase completo. Cannot be specified by system property.

  Esta configuración es dinámica, por lo que al ejecutar agente notará cambios en newrelic.yml sin reiniciar la JVM.

  Por ejemplo:

  error_collector:
    ignore_messages:
      com.example.MyException:
        - "Some error message to ignore"
        - "Some other error message to ignore"
      com.example.DifferentException:
        - "Some different error message to ignore"

  Copia

  Se puede utilizar una variable de entorno para enumerar nombres de clases de excepción y mensajes que desea ignorar:

  NEW_RELIC_ERROR_COLLECTOR_IGNORE_MESSAGES="{\"com.example.MyException\": [\"Some error message to ignore\", \"Some other error message to ignore\"], \"com.example.DifferentException\": [\"Some different error message to ignore\"]}"

  Copia

Una lista separada por comas compuesta por rangos individuales y discontinuos de códigos de estado HTTP que no deben tratarse como errores.

Si esta propiedad se comenta en el archivo de configuración newrelic.yml , el código de estado 404 se ignorará automáticamente. Cuando se utiliza la configuración del lado del servidor, se debe especificar el código de estado 404 para que se ignore.

Esta configuración es dinámica, por lo que al ejecutar agente notará cambios en newrelic.yml sin reiniciar la JVM.

Por ejemplo:

error_collector:
  ignore_status_codes: 404,507-511

Evita que clases de excepción específicas afecten la tasa de errores o la puntuación de Apdex y al mismo tiempo informa los errores a APM. Cannot be specified by system property.

Esta configuración es dinámica, por lo que al ejecutar agente notará cambios en newrelic.yml sin reiniciar la JVM.

Por ejemplo:

error_collector:
  expected_classes:
    - "com.example.MyException"
    - "com.example.DifferentException"

Se puede utilizar una variable de entorno para enumerar los nombres de clases de excepción esperadas:

NEW_RELIC_ERROR_COLLECTOR_EXPECTED_CLASSES="[\"com.example.MyException\", \"com.example.DifferentException\"]"

Contiene pares de yaml que constan de un nombre de clase de excepción completo que debe marcarse como se esperaba y, por lo tanto, evitar que afecte la tasa de errores o la puntuación de Apdex y una lista de excepciones messagecon las que comparar, la última de las cuales es obligatoria al menos una. . Si el nombre de la clase de excepción coincide con un error pero el mensaje no, entonces ese error will not se marcará como se esperaba y, por lo tanto, afectará la tasa de errores y la puntuación de Apdex.

Las cadenas de mensajes utilizan contains para hacer coincidir. Un mensaje no se puede proporcionar por sí solo y siempre debe ir acompañado de un nombre de clase completo. Cannot be specified by system property.

Esta configuración es dinámica, por lo que al ejecutar agente notará cambios en newrelic.yml sin reiniciar la JVM.

Por ejemplo:

error_collector:
  expected_messages:
    com.example.MyException:
      - "Some expected error message"
      - "Some other expected error message"
    com.example.DifferentException:
      - "Some different expected error message"

Se puede utilizar una variable de entorno para enumerar los nombres y mensajes de clases de excepción esperados:

NEW_RELIC_ERROR_COLLECTOR_EXPECTED_MESSAGES="{\"com.example.MyException\": [\"Some error message to ignore\", \"Some other error message to ignore\"], \"com.example.DifferentException\": [\"Some different error message to ignore\"]}"

Una lista separada por comas compuesta por rangos individuales y discontinuos de códigos de estado HTTP que se marcarán como se esperaba y, por lo tanto, se evitará que afecten la tasa de errores o la puntuación Apdex.

Esta configuración es dinámica, por lo que al ejecutar agente notará cambios en newrelic.yml sin reiniciar la JVM.

Por ejemplo:

error_collector:
  expected_status_codes: 415,500-506

Los códigos de estado esperados también pueden estar con la variable de entorno NEW_RELIC_ERROR_COLLECTOR_EXPECTED_STATUS_CODES .

Esta configuración se puede utilizar para activar o desactivar todos los atributos para errores de traza. Si attributes.enabled es false en el nivel raíz, no se enviará ningún atributo a los errores de traza independientemente de cómo se establezca esta propiedad en error_collector.

Si los atributos están habilitados para errores de traza, todas las claves de atributos que se encuentran en esta lista se enviarán a New Relic en errores de traza. Para obtener más información, consulte las reglas de atributos del agente.

Las claves de atributos que se encuentran en esta lista no se enviarán a New Relic en caso de errores de traza. Para obtener más información, consulte las reglas de atributos del agente.

Cuando se detectan varios errores en una transacción, solo se informará el último error de forma predeterminada. En cambio, establecer esta propiedad en false informará solo el primer error que se detecte. Para obtener más información, consulte la API NoticeError. Por ejemplo:

error_collector:
  ignoreErrorPriority: false

Todos los nombres de clases de excepción especificados no se tratarán como errores. Obsoleto a partir de agente de Java 3.40.0 y reemplazado por ignore_classes.

Por ejemplo:

error_collector:
  ignore_errors: some.other.MyException

Esta configuración se puede utilizar para controlar la recopilación de URI de solicitud saliente para errores y la traza de la transacción. Establezca esto en verdadero para deshabilitar la recopilación de esta información.

Establezca un nombre para mostrar para decorar la etiqueta "host:puerto" en la UI de New Relic.

Si no se puede determinar el nombre del host, se utilizará la dirección IP del host. Esta propiedad determina si se debe utilizar la dirección IPv4 o IPv6. El valor predeterminado es IPv4.

Para obtener ayuda para obtener una entrada de host de observador de traza Infinite Tracing válida, consulte buscar o crear un observador de traza.

Puedes configurar esto a través de YAML:

infinite_tracing:
  trace_observer:
    host: YOUR_TRACE_OBSERVER_HOST

También puede utilizar la propiedad del sistema newrelic.config.infinite_tracing.trace_observer.host o la variable de entorno NEW_RELIC_INFINITE_TRACING_TRACE_OBSERVER_HOST.

De forma predeterminada, las anotaciones @TraceLambda están deshabilitadas. Para utilizar la funcionalidad de anotación para rastrear métodos lambda, debe habilitar explícitamente la característica de la siguiente manera:

Puedes configurar esto a través de YAML:

instrumentation:
  trace_lambda:
    enabled: true

También puede utilizar la propiedad del sistema newrelic.config.instrumentation.trace_lambda.enabled=true o la variable de entorno NEW_RELIC_INSTRUMENTATION_TRACE_LAMBDA_ENABLED.

Se utiliza para habilitar/deshabilitar la recopilación y los informes de jar.

Se utiliza para habilitar/deshabilitar la colección de archivos temporales. Los archivos jar temporales son aquellos que residen en el directorio especificado por la propiedad del sistema java.io.tmpdir.

El número máximo de archivos jar para procesar por segundo. Debe ser positivo.

Configúrelo en true para habilitar la creación de perfiles en tiempo real con JFR. Esta configuración se aplicará dinámicamente y no requiere reiniciar JVM.

Establezca en true para habilitar el registro de auditoría que mostrará todas las métricas y eventos JFR en cada lote de cosecha. El registro de auditoría es extremadamente detallado y sólo debe usarse con fines de resolución de problemas.

Esta configuración se puede utilizar para activar o desactivar todas las funciones de JMX.

Esta configuración se puede habilitar para permitir que el agente de Java exponga metadatos de enlace a través de JMX remoto.

Configúrelo en true para habilitar la característica principal de logs en el contexto. Cuando está habilitado, se habilita instrumentación adicional framework de registro, independientemente de si los registros se decoran o se envían a New Relic.

Establezca en false para deshabilitar completamente esta característica, incluida la recopilación de log métrica.

Habilita el envío de log de aplicación a New Relic.

Establece esto en true para que tu registro decorado se envíe a New Relic.

Establezca esto en false si no desea que su registro decorado se envíe a New Relic.

Un entero positivo que especifica el número máximo de líneas de registro por minuto que se enviarán.

Establezca esto en 0 para deshabilitar efectivamente el envío de registros.

Establezca esto en un valor más bajo para reducir la cantidad de líneas log enviadas (puede causar muestreo log ). Establezca esto en un valor más alto para enviar más líneas log .

Cada log recibe la misma prioridad que su transacción asociada. Los registros que ocurren fuera de una transacción recibirán una prioridad aleatoria. Es posible que algunos registros no se incluyan porque están limitados por max_samples_stored. Por ejemplo, si el registro max_samples_stored se establece en 10 000 y la transacción 1 tiene 10 000 entradas log , solo se registrarán las entradas log de la transacción 1. Si la transacción 1 tiene menos de 10 000 registros, recibirá todos los registros de la transacción 1. Si todavía hay espacio, recibirás todo el registro de la transacción 2, y así sucesivamente.

Si después de todo se registran los registros de transacciones muestreadas y no han alcanzado el límite en max_samples_stored, entonces se envían mensajes de registro de transacciones que no estaban en nuestro muestreo. Si queda alguno, se registran mensajes de registro fuera de la transacción.

Establezca esto en true envío de datos de contexto como atributo log a New Relic.

Establezca esto en false si no desea que los datos de contexto en el registro se envíen a New Relic.

Si context_data está habilitado para el reenvío de registros, todas las claves de atributos que se encuentran en esta lista se enviarán a New Relic en los log . Si esta lista está vacía, se enviarán todos los atributos.

Si context_data está habilitado para el reenvío de registros, todas las claves de atributos que se encuentran en esta lista NO se enviarán a New Relic en log .

La lista de inclusión y exclusión sigue las reglas Exclude overrides include, More specific rules take priority, Keys are case-sensitive y Use an asterisk for wildcards definidas en las reglas de atributo.

Permite capturar información métrica sobre su registro y nivel de registros, que se muestra en un gráfico en la página APM Summary .

Deje esto configurado en true para permitir que el agente capture información métrica sobre su registro.

Establezca esto en false para desactivar esta característica.

Esto controla si las líneas log almacenadas localmente están decoradas o no. Esto es independiente de si el reenvío de registros está habilitado o no y se utiliza para ayudar a los clientes que desean utilizar una solución de reenvío de registros separada.

Establezca esto en true para que el agente agregue metadatos de enlace de logs en el contexto a líneas log almacenadas localmente por el marco compatible.

Establezca esto en false para desactivar la característica de decoración local. Esto no afectará la decoración de las líneas log que se envían a New Relic.

Establezca en true para actualizar el registro diariamente.

El número máximo de archivos de registro que se deben conservar cuando se utiliza la rotación log .

El nombre del archivo de registro no calificado o la cadena STDOUT que iniciará log en la salida estándar.

El camino del archivo de registro.

El nivel de detalle log . Cuando cambie esta configuración en el archivo de configuración yaml del agente, se actualizará dinámicamente. Sin embargo, la variable de entorno y la propiedad del sistema no se actualizarán dinámicamente.

El agente utiliza su propio archivo de registro para mantener su registro separado del de su aplicación. Las opciones válidas, en orden de detalle, son:

• off

• severe

• warning

• info

• fine

• finer

• finest

  Advertencia

  No utilice el registro debug o trace a menos que el soporte de New Relic le solicite que los utilice. Estos niveles de registro pueden generar gastos generales excesivos. Para la mayoría de situaciones, use info.

  Esta configuración es dinámica, por lo que al ejecutar agente notará cambios en newrelic.yml sin reiniciar la JVM.

El tamaño del archivo de registro en kilobytes al que se rota el archivo de registro. Establezca en 0 para no tener límite.

Agrega propiedades de mensaje al atributo tracer. Establezca esto en false para desactivarlo.

Para deshabilitar completamente todas las funciones de seguridad, establezca este indicador en falso. Esta propiedad se lee solo una vez al inicio de la aplicación. El valor predeterminado es falso.

Determina si los datos de seguridad se envían a New Relic o no. Cuando esto está deshabilitado y agente.enabled es verdadero, el módulo de seguridad se ejecutará pero no se enviarán datos. El valor predeterminado es falso.

Modo de suministro de New Relic Security: IAST. El valor predeterminado es IAST. Debido a la naturaleza invasiva del escaneo IAST, NO habilite este modo ni en un entorno de producción ni en un entorno donde se procesen datos de producción.

URL de conexión SaaS de New Relic Security. Este es el extremo al que el agente de seguridad envía datos, debe coincidir con ese entorno que has configurado para el APM agente de Java.

Producción de EE. UU.: wss://csec.nr-data.net

Habilite la detección de eventos de seguridad de RCI. El valor predeterminado es verdadero.

Habilite la detección de eventos de seguridad RXSS. El valor predeterminado es verdadero.

Habilite la detección de eventos de seguridad de deserialización. El valor predeterminado es verdadero.

Se utiliza para habilitar/deshabilitar la detección de transacciones lentas.

Determina cuánto tiempo debe tardar una transacción en milisegundos para que se informe un evento SlowTransaction .

Si esto se establece en verdadero, se verificará que cada transacción supere el umbral definido al finalizar la transacción. Tenga en cuenta que si una gran cantidad de transacciones excede el umbral, esto puede resultar costoso desde el punto de vista computacional ya que se envía un rastreo del stack con cada evento SlowTransaction.

Se utiliza para habilitar/deshabilitar el informe de eventos de extensión.

Determina el número de eventos de intervalo que se pueden capturar durante un ciclo de recolección de agente. Disponible en agente de Java 7.4.0 y superior.

Esta configuración se puede utilizar para activar o desactivar todos los atributos del evento span. Si attributes.enabled en el nivel raíz es false, no se enviará ningún atributo al evento span independientemente de cómo esté configurada esta propiedad (span_events.attributes.enabled).

Si los atributos están habilitados para el evento span, todas las claves de atributos que se encuentran en esta lista se enviarán a New Relic en span_events. Para obtener más información, consulte las reglas de atributos del agente.

Todas las claves de atributos que se encuentran en esta lista no se enviarán a New Relic en el evento span. Para obtener más información, consulte las reglas de atributos del agente.

De forma predeterminada, está configurado en false, lo que significa que el agente envía mensajes de todas las excepciones al recolector de New Relic.

• Si lo configura en true, el agente elimina las excepciones de los mensajes para evitar que capture información confidencial sin darse cuenta.
• Si habilita el modo de alta seguridad, se establece automáticamente en true.
• Si configura enabled en true pero desea que el agente capture mensajes de excepciones específicas, agregue las excepciones a su lista de 'permitidos'.

Si configura enabled en true pero desea que el agente capture mensajes para excepciones específicas, agregue cada excepción a whitelist, separada por una coma.

Si configura enabled en true pero desea que el agente capture mensajes para excepciones específicas, agregue cada excepción a allowed_classes, separada por una coma.

Habilitar el hilo generador de perfiles.

Habilitar el servicio de transacción evento.

El número máximo de eventos de transacción muestreados informados cada 60 segundos.

Una lista de mapas con las claves emparejadas header_name y el header_alias opcional. Elija uno o más encabezados de solicitud HTTP personalizados para agregar como atributo de transacción.

Puede enumerar múltiples configuraciones de encabezado:

transaction_events:
  custom_request_headers:
    -
      header_name: "X-Custom-Header-1"
    -
      header_name: "X-Custom-Header-2"
      header_alias: "CustomHeader2alias"

En el primer conjunto de mapas, el agente captura y reporta X-Custom-Header-1 como el nombre del encabezado para un valor correspondiente del objeto de solicitud. El header_name también será el nombre del atributo enviado a New Relic.

En el segundo conjunto de mapas, el encabezado de la solicitud es X-Custom-Header-2, pero CustomHeader2alias es el nombre enviado a New Relic.

Esta configuración se puede utilizar para activar o desactivar todos los atributos del evento de transacción. Si attributes.enabled es false en el nivel raíz, no se enviará ningún atributo al evento de transacción independientemente de cómo se establezca esta propiedad en transaction_events.

Si los atributos están habilitados para el evento de transacción, todas las claves de atributos que se encuentran en esta lista se enviarán a New Relic en el evento de transacción. Para obtener más información, consulte las reglas de atributos del agente.

Todas las claves de atributos que se encuentran en esta lista no se enviarán a New Relic en el evento de transacción. Para obtener más información, consulte las reglas de atributos del agente.

Esta configuración se puede utilizar para activar o desactivar todos los atributos de los segmentos de transacciones. Si attributes.enabled en el nivel raíz es false, no se enviará ningún atributo a los segmentos de transacciones independientemente de cómo esté configurada esta propiedad (transaction_segments.attributes.enabled).

Si los atributos están habilitados para los segmentos de transacciones, todas las claves de atributos que se encuentran en esta lista se enviarán a New Relic en los segmentos de transacciones. Para obtener más información, consulte las reglas de atributos del agente.

Todas las claves de atributos que se encuentran en esta lista no se enviarán a New Relic en los segmentos de transacción. Para obtener más información, consulte las reglas de atributos del agente.

El rastreador de transacciones está habilitado de forma predeterminada. Establezca esto en false para desactivarlo.

Determina si el agente capturará el plan EXPLAIN para consulta lenta. Solo es compatible con MySQL y PostgreSQL.

Umbral en segundos para el tiempo de ejecución de la consulta por debajo del cual no se capturarán la consulta lenta y el plan EXPLAIN (si es compatible). Relevante para consulta lenta solo cuando record_sql está configurado en raw o obfuscated. Relevante para los planes EXPLAIN solo cuando explain_enabled está establecido en true.

El límite de caracteres para la cadena de consulta SQL. Si tiene muchas consultas SQL lentas con grandes cantidades de información, esto podría afectar negativamente el rendimiento o la rapidez con la que ve sus datos en New Relic. Aumente el valor gradualmente hasta encontrar el equilibrio adecuado entre información y rendimiento.

Establezca en true para habilitar el registro de consultas en el archivo de registro del agente en lugar de cargarlo en New Relic. Las consultas se registran utilizando el modo record_sql .

Cuando el rastreador de transacciones está activado, las declaraciones de consulta se pueden registrar opcionalmente. La grabadora tiene tres modos:

• off: No enviar consulta.
• raw: Envíe la declaración de consulta en su forma original.
• obfuscated: elimina los literales numéricos y de cadena.

Esta opción es solo para Play 2.x+. La instrumentación de Play/Scala puede usar Thread.getStackTrace() para mejorar el nombre del rastreador, pero a costa de una mayor sobrecarga.

Define un umbral (en segundos) para recopilar el rastreo del stack de una llamada SQL. Cuando las sentencias SQL superen este umbral, el agente capturará el rastreo actual de la pila. Esto es útil para identificar de dónde se originan las llamadas SQL largas.

Utilice esta configuración para controlar la variedad de su traza de la transacción. top_n es un número entero que representa el número de transacciones lentas y únicas para las que se creará la traza.

• Si desea que la traza de la transacción refleje con mayor precisión la transacción más lenta real en su aplicación, establezca este valor en lower.

• Si desea probar una matriz de transacción más diversa, haga el valor higher.

  Un valor de 0 significaría que only la transacción más lenta siempre es la traza. Sin embargo, se considera que esto no es óptimo porque es posible que tenga una o dos transacciones que siempre sean las más lentas, y ver repetidamente esa misma traza de la transacción probablemente no le dará mucho valor.

  Si la misma transacción suele ser la más lenta, la configuración top_n permite que el agente de Java (con el tiempo) muestree las transacciones n más lentas. Esto le brinda mayor variedad y más información valiosa para su aplicación.

El umbral de tiempo utilizado para determinar cuándo una transacción es elegible para ser traza. Cuando el tiempo de respuesta de la transacción supere este umbral, se registrará una traza de la transacción y se enviará a New Relic.

El valor predeterminado es apdex_f (predeterminado), que establece el umbral en el nivel Apdex "Frustrated" (cuatro veces el apdex_t valor ). También puede establecer un umbral de tiempo específico ingresando un valor flotante que represente una cantidad de segundos.

De forma predeterminada, el modo de alta seguridad no permite que el agente recopile consulta lenta. Habilite esta opción para recopilar consultas de Cassandra desde el controlador DataStax, incluso con la alta seguridad habilitada. Si no utiliza alta seguridad, el agente cobra consulta lenta automáticamente.

Para el controlador DataStax 2.1.2, añade esta regla a tu lista de 'permitidos':

transaction_tracer:
  slow_query_whitelist:
    'com.newrelic.instrumentation.cassandra-datastax-2.1.2'

Para el controlador DataStax 3.0.0, añade esta regla a tu lista de 'permitidos':

transaction_tracer:
  slow_query_whitelist:
    'com.newrelic.instrumentation.cassandra-datastax-3.0.0'

De forma predeterminada, el modo de alta seguridad no permite que el agente recopile consulta lenta. Habilite esta opción para recopilar consultas de Cassandra desde el controlador DataStax, incluso con la alta seguridad habilitada. Si no utiliza alta seguridad, el agente cobra consulta lenta automáticamente.

Para el controlador DataStax 2.1.2, añade esta regla a tu lista de 'permitidos':

transaction_tracer:
  collect_slow_queries_from:
    'com.newrelic.instrumentation.cassandra-datastax-2.1.2'

Para el controlador DataStax 3.0.0, añade esta regla a tu lista de 'permitidos':

transaction_tracer:
  collect_slow_queries_from:
    'com.newrelic.instrumentation.cassandra-datastax-3.0.0'

Esta configuración se puede utilizar para activar o desactivar todos los atributos de la traza de la transacción. Si attributes.enabled en el nivel raíz es false, no se enviará ningún atributo a la traza de la transacción independientemente de cómo esté configurada esta propiedad (transaction_tracer.attributes.enabled).

Si los atributos están habilitados para la traza de la transacción, todas las claves de atributos que se encuentran en esta lista se enviarán a New Relic en la traza de la transacción. Para obtener más información, consulte las reglas de atributos del agente.

Todas las claves de atributos que se encuentran en esta lista no se enviarán a New Relic en la traza de la transacción. Para obtener más información, consulte las reglas de atributos del agente.

Limita la cantidad de tokens que se pueden crear por transacción. Aumentar este valor puede afectar el rendimiento, porque aumenta la cantidad de memoria que utiliza el agente y la cantidad de datos enviados a New Relic.

Limita la cantidad de segmentos que se pueden crear por transacción. Aumentar este valor puede afectar el rendimiento, porque aumenta la cantidad de memoria que utiliza el agente y la cantidad de datos enviados a New Relic.