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.
Este documento describe el atributo del agente New Relic Node.js, 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.
Sugerencia
Esta configuración de atributos se aplica a la versión 2.7.1 o superior del agente Node.js. Si utiliza una versión anterior del agente, consulte Actualizar la configuración de atributos legacy .
Buscar y utilizar atributo
El atributo New Relic son pares de valores principales que contienen información que determina las propiedades de los datos de eventos y transacciones . El atributo puede ayudarle a obtener mayor información valiosa en su aplicación y anotar los datos en New Relic.
El atributo (tanto predeterminado como personalizado) se puede encontrar en:
Puedes personalizar exactamente qué atributo se enviará a cada uno de estos destinos.
Sugerencia
A partir de la versión 6.10.0 del agente Node.js, cuando habilita rastreo distribuido y/o Infinite Tracing, la información del evento Transaction se aplica al Span actualmente disponible de la transacción. Debido a esto, es posible que desees aplicar la configuración de atributo para Transaction evento a Span evento o aplicarlos como configuración de atributo global.
El código de estado de respuesta para una solicitud web. La clave para este atributo es 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
Note: El atributo httpResponseCode (valor de cadena) se elimina a partir de la versión 7.0.0 del agente. En su lugar, se debe utilizar http.statusCode (valor entero).
El mensaje de estado de respuesta, si está presente para una solicitud web. La clave para este atributo es 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
Note: El atributo httpResponseMessage (valor de cadena) se elimina a partir de la versión 7.0.0 del agente. En su lugar, se debe utilizar http.statusText (valor de cadena).
Atributo agregado a una llamada addCustomAttribute() a la API del agente de Node.js. 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: Habilitado
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, pueden producirse resultados inesperados.
Atributo agregado a una llamada noticeError() en la API del agente de Node.js. 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 Node.js puede capturar encabezados de respuesta y solicitud como atributo. De forma predeterminada, el agente de Node.js recopilará todos los encabezados de solicitud que no estén excluidos.
Encabezados de solicitud HTTP excluidos de forma predeterminada:
request.headers.cookie
request.headers.authorization
request.headers.proxy-authorization
request.headers.set-cookie*
request.headers.x-*
Encabezado de respuesta capturado: response.headers.content-type
Puede desactivar la recopilación de todos los encabezados configurando allow_all_headers en false en su archivo newrelic.js .
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
Solicitar parámetro de la transacción. El agente Node.js no captura el parámetro de forma predeterminada. Todos los parámetros GET se pueden capturar si la entrada request.parameters.* se agrega a attributes.include o se puede agregar un parámetro de solicitud específico a la lista, por ejemplo, request.parameters.foo o request.parameters.bar. Para capturar el parámetro POST, utilice la llamada API del agente addCustomAttribute() Node.js.
Configurar atributo
Puede personalizar qué tipos de atributos envía el agente de Node.js a cada destino. Esto es más común por razones de seguridad, cuando tienes cierto atributo sensible que no quieres que se informe a New Relic.
Utilice las siguientes propiedades de configuración junto con las reglas de atributo para habilitar o deshabilitar el atributo:
Deshabilitado por defecto. Establezca esto en true para que el agente solo recopile todos los encabezados, excepto aquellos filtrados por las reglas exclude .
Habilitado de forma predeterminada. Establezca esto en false para deshabilitar la matriz attributes.include .
Habilita o deshabilita el atributo por completo. Si establece un destino en false, no se enviará ningún atributo a ese destino independientemente de su configuración de inclusión/exclusión. Si un destino está habilitado, todos los atributos del usuario se envían a ese destino de forma predeterminada.
Especifique las claves de atributos particulares que desea que el agente informe a New Relic. Para todos los destinos, esta es una lista de cadenas que está vacía de forma predeterminada. Las propiedades .exclude anulan las propiedades .include . Para deshabilitar todos los valores .include , establezca attributes.include_enabled en false.
Especifique claves de atributos particulares que no desea que el agente informe a New Relic. Para todos los destinos, esta es una lista de cadenas que está vacía de forma predeterminada. Las propiedades .exclude anulan las propiedades .include .
Reglas de atributos
El agente de Node.js 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