Te ofrecemos esta traducción automática para facilitar la lectura.
En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.
Los atributos New Relic son pares de valores principales que contienen información que determina las propiedades de un evento o transacción. Estos pares de valores principales pueden ayudarle a obtener mayor información valiosa en su aplicación y anotar los datos cuando la consulte. También puede reenviar automáticamente información del usuario a New Relic.
Tanto el atributo predeterminado como el personalizado son visibles en traza de la transacción, rastreo distribuido y análisis de errores; Evento APM y evento del browser en el panel. Puedes personalizar exactamente qué atributo se enviará a cada uno de estos destinos.
Este documento describe el atributo del agente de Java, detalla cómo habilitar o deshabilitar el atributo y describe las reglas que sigue el agente para determinar qué atributo incluir o excluir para un destino.
El código de estado de respuesta para una solicitud web. La clave para este atributo es http.statusCode. Nota: Las versiones del agente inferiores a 8.0.0 usaban el atributo httpResponseCode.
La configuración predeterminada para cada destino es:
Traza de la transacción: Habilitado
Análisis de errores: habilitado
Evento APM: Habilitado
Evento browser : Deshabilitado
El mensaje de estado de respuesta, si está presente para una solicitud web. La clave para este atributo es http.statusText. Nota: Las versiones del agente inferiores a 8.0.0 usaban el atributo httpResponseMessage.
La configuración predeterminada para cada destino es:
Traza de la transacción: Habilitado
Análisis de errores: habilitado
Evento APM: Habilitado
Evento browser : Deshabilitado
El nombre del hilo. La clave para este atributo es jvm.thread_name.
La configuración predeterminada para cada destino es:
Traza de la transacción: Habilitado
Análisis de errores: habilitado
Evento APM: Deshabilitado
Evento browser : no disponible
El nombre de un hilo bloqueado. La clave para este atributo es jvm.lock_thread_name.
La configuración predeterminada para cada destino es:
Traza de la transacción: No disponible
Análisis de errores: habilitado
Evento APM: No disponible
Evento browser : no disponible
Atributo agregado mediante una llamada al NewRelic.addCustomParameter(...) agente de Java API. El nombre de clave para este atributo depende de lo que especifique cuando llame al método.
La configuración predeterminada para cada destino es:
Traza de la transacción: Habilitado
Análisis de errores: habilitado
Evento APM: Deshabilitado
Evento browser : Deshabilitado
Importante
Antes de crear un atributo personalizado, revise la lista de términos reservados utilizados por NRQL de New Relic. De lo contrario, es posible que obtenga resultados inesperados.
Antes de crear un atributo personalizado, revise la lista de términos reservados utilizados por NRQL de New Relic. De lo contrario, podría obtener resultados inesperados.
Atributo agregado a una llamada NoticeError() en la API del agente de Java. El nombre de clave para este atributo depende de lo que especifique cuando llame al método.
La configuración predeterminada para cada destino es:
Traza de la transacción: No disponible
Análisis de errores: habilitado
Evento APM: No disponible
Evento browser : no disponible
El agente de Java puede capturar los siguientes encabezados de respuesta y solicitud como atributo:
Encabezados de solicitud HTTP capturados:
request.headers.referer
request.headers.accept
request.headers.contentLength
request.headers.host
request.headers.userAgent
Encabezado de respuesta capturado: response.headers.contentType
El agente no captura otros encabezados de solicitud.
El sistema de atributos no se aplica a ningún valor de encabezado distinto de los enumerados anteriormente. Si desea capturar encabezados de solicitud adicionales que no figuran aquí, debe usar la opción de configuración custom_request_headers para especificar encabezados que el agente debe capturar. Alternativamente, puede registrar directamente los encabezados usted mismo utilizando el método addCustomParameter() de la API del agente de Java.
La configuración predeterminada para cada destino es:
Traza de la transacción: Habilitado
Análisis de errores: habilitado
Evento APM: Habilitado
Evento browser : Deshabilitado
El agente de Java captura los métodos de solicitud GET, POST y PUT de forma predeterminada como parte del atributo request.method .
Los parámetros de solicitud de la transacción no se capturan de forma predeterminada. Utilice la API addCustomParameter() agente de Java para capturar el parámetro de solicitud.
La clave para estos atributos es request.parameters.*. Si le preocupa capturar información confidencial, puede utilizar estas opciones:
Evite el uso de comodines en attributes.include. En su lugar, especifique explícitamente cada campo para capturar.
Si desea utilizar un comodín en attributes.include, excluya explícitamente los campos confidenciales usando attributes.exclude.
Recopilar atributo de usuario
Con el agente de Java de APM, puede recopilar automáticamente información del usuario editando su archivo de configuración. Luego puede ejecutar NRQL consulta con la información del usuario sin necesidad de crear un atributo personalizado manualmente. Esta característica está disponible con el agente de Java 3.10.0 de New Relic o mas alto.
# This instrumentation reports the name of the user principal returned from
# HttpServletRequest.getUserPrincipal() when servlets and filters are invoked.
com.newrelic.instrumentation.servlet-user:
enabled:true
Reinicie su servidor web.
Si está utilizando el 8.1.0 versión del agente de Java, o superior, puedes consultar el atributo enduser.id ya sea habilitando com.newrelic.instrumentation.servlet-user o usando la API pública y esperando unos minutos. Por ejemplo, podría utilizar la siguiente consulta NRQL para obtener un recuento único de todos los usuarios:
SELECT uniqueCount(enduser.id)FROMTransaction SINCE 1day ago
Puede configurar qué tipos de atributo, o qué atributo específico, reporta el agente de Java a New Relic. Esto a menudo se hace por razones de seguridad, cuando hay ciertos atributos sensibles que no desea que se informen a New Relic. Para saber qué configuraciones anulan otras configuraciones, consulte las reglas de configuración de atributos.
El agente de Java sigue estas reglas al determinar qué atributo incluir o excluir para un destino:
Si establece la propiedad principal attributes.enabled en false, el agente no informa ningún atributo en absoluto.
Configuración del agente:
attributes.enabled: false
attributes.include: request.parameters.*
error_collector.attributes.enabled: true
Teclas de entrada:
foo
bar
request.parameters.foo
request.parameters.bar
Salida del agente:
Traza de la transacción: Sin atributo
Análisis de errores: Sin atributo
Evento APM: Sin atributo
Evento browser : Sin atributo
Cuando configura habilitado en false para un destino, el agente ignora su configuración de inclusión/exclusión y no informa ningún atributo para ese destino.
Configuración del agente:
transaction_tracer.attributes.enabled: false
attributes.include: one, two*
transaction_tracer.attributes.include: three, four
Teclas de entrada:
one
two
three
four
Salida del agente:
Traza de la transacción: Sin atributo
Análisis de errores: one, two
Evento APM: one, two
Evento browser : Sin atributo
Las propiedades .exclude anulan las propiedades .include .
Configuración del agente:
attributes.enabled: true
attributes.include: foo, myCustomAtt
attributes.exclude: password, myCustomAtt
Teclas de entrada:
foo
myCustomAtt
password
Salida del agente:
Traza de la transacción: foo
Análisis de errores: foo
Evento APM: foo
Evento browser : foo
Si varios atributos de inclusión o exclusión afectan a la misma clave, la configuración más específica tendrá prioridad.
Configuración del agente:
attributes.enabled: true
attributes.include: foo, myCustomAtt
attributes.exclude: password, myCustomAtt
browser_monitoring.attributes.enabled: true
Teclas de entrada:
food
food.bread
food.fruit.banana
food.fruit.apple
Salida del agente:
Traza de la transacción: food.fruit.apple
Análisis de errores: food.fruit.banana, food.fruit.apple