Recoger atributo personalizado

Cuando se trata de informar datos personalizados que las soluciones New Relic no informan de forma predeterminada, dos de las soluciones más populares son atributo personalizado y evento personalizado. Este documento entrará en más detalles sobre por qué usaría el atributo personalizado.

Para algunas soluciones de New Relic, una forma de informar datos personalizados a New Relic es utilizar un atributo personalizado. Al agregar un atributo personalizado a tus datos, podrás realizar un análisis más profundo y personalizado de tu negocio. Por ejemplo, para el monitoreo del navegador New Relic, puede crear un atributo personalizado para rastrear el nombre de usuario asociado con una solicitud lenta o fallida.

Importante

El atributo personalizado cuenta para los GB ingeridos y son datos facturables.

Requisitos

Los atributos personalizados están disponibles para estas soluciones New Relic:

APM
monitoreo del navegador
Monitoreo de moviles
Monitoreo de infraestructura
Monitor sintético

Entraremos en más detalles sobre estas opciones a continuación.

Recomendaciones para crear y usar atributo personalizado

En New Relic, los atributos son pares de valores principales que proporcionan metadatos sobre el evento al que están adjuntos.

Un patrón común al crear un atributo personalizado es capturar información del usuario, como nombre, ID, correo electrónico y más. Esto le permite crear una asociación entre sus datos operativos y sus datos comerciales. Por ejemplo, si tiene la información del usuario, vincula su mesa de servicio y los datos de CRM con los datos operativos en New Relic.

Otros tipos de contexto empresarial podrían incluir:

Token de clientes
Segmento de mercado de clientes
Clasificación del valor de los clientes
Los valores de control del flujo de trabajo no son obvios en el URIStem
Contexto de privilegios de usuario/producto/cuenta

El contexto operativo podría incluir:

¿Qué banderas características se utilizaron?
A qué almacenamiento de datos se accedió
¿A qué caché se accedió?
Qué errores se detectaron e ignoraron (partición por error)

Una vez que agrega un atributo personalizado, puede consultarlo en New Relic y crear gráficos personalizados a partir de esos datos. Por ejemplo, si usó la API agente de Java para agregar un atributo userId a su evento Transaction y TransactionError , podría crear una consulta NRQL usando ese atributo, como:

SELECT count(*) FROM TransactionError 
  WHERE userId = '1401961100' FACET dateOf(timestamp), `error.message` 
  SINCE 1 week ago

APM: Grabar atributo personalizado

Importante

Revise la lista de términos reservados utilizados por NRQL. El uso de términos reservados puede causar problemas.

Para habilitar y usar el atributo personalizado para APM, siga el procedimiento para su agente :

La colección de atributos personalizados está habilitada de forma predeterminada en Java. Puede recopilar atributos personalizados mediante XML y las API del agente Java. Estos dos métodos se pueden utilizar juntos. Tenga en cuenta que la recopilación de atributos personalizados requiere que el jar de la API Java de New Relic esté en la ruta de clases de la aplicación.

Método	How to do it
Especificar atributo en XML	XML le permite especificar un atributo personalizado sin cambiar nada de su código fuente. Puede tener varios archivos XML para atributos personalizados que estén agrupados por alguna faceta lógica. Para configurar un atributo personalizado para su aplicación Java a través de XML: Revise la documentación del agente de Java de New Relic sobre el formato de archivo XML, métodos y clases, y ejemplos. Desde su directorio `Extensions` dentro del agente de Java New Relic, cree un único archivo XML. Defina los métodos que desea que New Relic monitor editando su archivo XML directamente. Defina un archivo de instrumentación XML utilizando la UIde New Relic. Esto puede requerir una configuración adicional en el bloque `common:` de tu newrelic.yml . Consulte Report custom attributes en Opciones de instrumentación para obtener más detalles.
Llame a la API del agente	Example 1: Adding custom attributes to transactions Para recopilar atributos personalizados utilizando la API de llamada del agente, utilice los métodos pertinentes: Para cada método para el que desee registrar un atributo, llame a `NewRelic.addCustomParameter(...)`. Opcional: incluya o excluya ciertos atributos con `attributes.include` y `attributes.exclude`. Por ejemplo, para registrar una variable denominada `userId`, incluya este código en el método principal: `NewRelic.addCustomParameter("userId", userId);` Example 2: Adding custom attributes to spans in distributed traces Para recopilar atributos personalizados utilizando la API de llamada del agente, utilice los métodos pertinentes: Para cada intervalo (método que se está ejecutando actualmente) para el que desea registrar un atributo, llame a `NewRelic.getAgent().getTracedMethod().addCustomAttribute(...)`. Opcional: incluya o excluya ciertos atributos con `span_events.attributes.include` y `span_events.attributes.exclude`. Por ejemplo, para registrar una variable denominada `userId` en el intervalo actual, incluya este código en el método asociado: `NewRelic.getAgent().getTracedMethod().addCustomAttribute("userId", userId);`
Recopilar atributo de usuario	El agente de Java también incluye un mecanismo integrado para habilitar el atributo de usuario y recopilar información del usuario de `HttpServletRequest.getUserPrincipal()` como atributo personalizado.

Método

How to do it

Especificar atributo en XML

XML le permite especificar un atributo personalizado sin cambiar nada de su código fuente. Puede tener varios archivos XML para atributos personalizados que estén agrupados por alguna faceta lógica.

Para configurar un atributo personalizado para su aplicación Java a través de XML:

Revise la documentación del agente de Java de New Relic sobre el formato de archivo XML, métodos y clases, y ejemplos.
Desde su directorio Extensions dentro del agente de Java New Relic, cree un único archivo XML.
Defina los métodos que desea que New Relic monitor editando su archivo XML directamente.
Defina un archivo de instrumentación XML utilizando la UIde New Relic. Esto puede requerir una configuración adicional en el bloque common: de tu
newrelic.yml
. Consulte
Report custom attributes
en Opciones de instrumentación para obtener más detalles.

Llame a la API del agente

Example 1: Adding custom attributes to transactions

Para recopilar atributos personalizados utilizando la API de llamada del agente, utilice los métodos pertinentes:

Para cada método para el que desee registrar un atributo, llame a NewRelic.addCustomParameter(...).
Opcional: incluya o excluya ciertos atributos con attributes.include y attributes.exclude.
Por ejemplo, para registrar una variable denominada userId, incluya este código en el método principal:
```
NewRelic.addCustomParameter("userId", userId);
```
Example 2: Adding custom attributes to spans in distributed traces
Para recopilar atributos personalizados utilizando la API de llamada del agente, utilice los métodos pertinentes:
Para cada intervalo (método que se está ejecutando actualmente) para el que desea registrar un atributo, llame a NewRelic.getAgent().getTracedMethod().addCustomAttribute(...).
Opcional: incluya o excluya ciertos atributos con span_events.attributes.include y span_events.attributes.exclude.
Por ejemplo, para registrar una variable denominada userId en el intervalo actual, incluya este código en el método asociado:
```
NewRelic.getAgent().getTracedMethod().addCustomAttribute("userId", userId);
```

Recopilar atributo de usuario

El agente de Java también incluye un mecanismo integrado para habilitar el atributo de usuario y recopilar información del usuario de HttpServletRequest.getUserPrincipal() como atributo personalizado.

La colección de atributos personalizados está habilitada de forma predeterminada en .NET. Para recopilar atributos personalizados, llame a los métodos API relevantes:

Para cada método para el que desee registrar un atributo, llame a AddCustomAttribute.
Opcional: incluya o excluya el atributo con las opciones de configuración include y exclude .
Por ejemplo, para registrar un atributo para un código de cupón (cadena) y un código de identificación de artículo (número), podría incluir este código en el método principal:
```
IAgent agent = NewRelic.Api.Agent.NewRelic.GetAgent();
ITransaction transaction = agent.CurrentTransaction;

transaction
    .AddCustomAttribute("Discount Code", "Summer Super Sale")
    .AddCustomAttribute("Item Code", 31456);
```

La colección de atributos personalizados está habilitada de forma predeterminada en Node.js. Para recopilar atributos personalizados, llame al método API correspondiente:

Para cada atributo que desee registrar, llame a newrelic.addCustomAttribute.
Para registrar múltiples atributos usando una sola llamada, use newrelic.addCustomAttributes.
Por ejemplo, para registrar un atributo para un código de cupón y un código de identificación de artículo, podría incluir esto en el método principal:
```
newrelic.addCustomAttributes({
  "Discount Code": "Summer Super Sale",
  "Item Code": 31456
});
```

La colección de atributos personalizados está habilitada de forma predeterminada en PHP. Para recopilar atributos personalizados, llame al método API correspondiente para cada método en el que desee registrar un atributo;

newrelic_add_custom_parameter para eventos de transacción y tramos
newrelic_add_custom_span_parameter solo para tramos
Por ejemplo, para registrar una variable denominada $userId, incluya este código en el método principal:
```
newrelic_add_custom_parameter ('userID', $userId)
```

La colección de atributos personalizados está habilitada de forma predeterminada en Python. Para recopilar atributos personalizados, llame a add_custom_attribute para cada método en el que desee registrar un atributo.

Por ejemplo, para registrar una variable denominada user_id, incluya este código en el método principal:

newrelic.agent.add_custom_attribute('user_id', user_id)

La colección de atributos personalizados está habilitada de forma predeterminada en Ruby. Para recopilar atributos personalizados, llame al método add_custom_attributes . Por ejemplo, para registrar una variable denominada @user_id, incluya este código en el método principal:

::NewRelic::Agent.add_custom_attributes({ user_id: @user.id })

Monitoreo de navegador: Registro de atributo personalizado

El agente del navegador proporciona una API para especificar detalles adicionales asociados con una vista de página o interacción con el navegador, ya sea reenviando un atributo desde APM al monitoreo del navegador o especificando un atributo personalizado a través de JavaScript. Los valores reenviados desde el agente APM son codificados e inyectados en el atributo browser por nuestro agente del navegador.

Monitoreo de infraestructura: Registro de atributos personalizados

Nuestro monitoreo de infraestructura le permite crear atributos personalizados que se utilizan para anotar los datos del agente de infraestructura. Puede utilizar estos metadatos para filtrar su entidad, agrupar sus resultados y anotar sus datos.

Monitoreo de móviles: Registro de atributos personalizados

El agente móvil incluye API de llamada para registrar el atributo personalizado:

Para obtener una descripción general de
datos personalizados, consulte Insertar evento personalizado y atributo
Método de Android: setAttribute
Método iOS: setAttribute

Monitor sintético: Grabación de atributo personalizado

Consulte Sintético monitor atributo personalizado.

Te ofrecemos esta traducción automática para facilitar la lectura.

Importante

Requisitos

Recomendaciones para crear y usar atributo personalizado

APM: Grabar atributo personalizado

Importante

Go

Java

.NET

Node.js

PHP

Python

Ruby

Monitoreo de navegador: Registro de atributo personalizado

Monitoreo de infraestructura: Registro de atributos personalizados

Monitoreo de móviles: Registro de atributos personalizados

Monitor sintético: Grabación de atributo personalizado

Te ofrecemos esta traducción automática para facilitar la lectura.

Recoger atributo personalizado

Importante

Requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}

Recomendaciones para crear y usar atributo personalizado

APM: Grabar atributo personalizado

Importante

Java

.NET

Node.js

PHP

Python

Ruby

Monitoreo de navegador: Registro de atributo personalizado

Monitoreo de infraestructura: Registro de atributos personalizados

Monitoreo de móviles: Registro de atributos personalizados

Monitor sintético: Grabación de atributo personalizado

Requisitos