setCustomAttribute

Sintaxis

newrelic.setCustomAttribute(name: string, value: string|number|boolean|null[, persist: boolean])

Agrega un nombre y valor de atributo personalizado definido por el usuario al evento posterior en la página.

Requisitos

Browser Lite, Pro o Pro+SPA agente (v593 o superior)
- Para soporte de persist parámetro o null valor, se requiere la versión 1.230.0 o superior del agente.
- Para soporte de valor boolean , se requiere la versión del agente 1.245.0 o superior.
Si está utilizando npm para instalar el agente del navegador, debe habilitar al menos una función al crear una instancia de la clase BrowserAgent . Por ejemplo, agregue lo siguiente en la matrizfeatures :
```
import { Metrics } from '@newrelic/browser-agent/features/metrics'

const options = {
  info: { ... },
  loader_config: { ... },
  init: { ... },
  features: [
    Metrics
  ]
}
```

Para obtener más información, consulte la documentación de instalación del navegador NPM.

Descripción

Establece un atributo personalizado para la sesión de su agente. Una vez que se establece un atributo, la plataforma New Relic lo registra con todos los eventos compatibles hasta que se recarga la página o el atributo se anula manualmente.

Se admiten los siguientes eventos de Browser:

Nombre del evento	Notas
`AjaxRequest`
`BrowserInteraction`	Los atributos establecidos mediante el método SPA `setAttribute` tienen prioridad sobre los atributos establecidos por `setCustomAttribute`.
`BrowserPerformance`
`JavaScriptError`	Para ver o registrar errores para un atributo personalizado a través de la API, utilice la llamada a la API del navegador `noticeError`.
`Log`	Los atributos personalizados proporcionados al método `log` en el argumento `options.customAttributes` tienen prioridad sobre los atributos establecidos por `setCustomAttribute`.
`PageAction`
`PageView`	Realice esta llamada antes de que se active el evento de carga de la ventana (cuando se transmiten esos datos) para que los atributos se incluyan en el evento `PageView`.
`PageViewTiming`
`UserAction`

Con la bandera persist, el atributo también se puede almacenar en el browser, de modo que las visitas posteriores a páginas del mismo origen within a session lo conserven en el evento. Tenga en cuenta que esta funcionalidad puede variar según la configuración de privacidad browser del usuario final. Si esta función se llama con value = null, el atributo se eliminará de both el evento y el almacenamiento de la página actual, independientemente del indicador persist .

Importante

¡Tenga en cuenta que el atributo persistente tiene prioridad sobre info.jsAttributes claves del mismo nombre! Por ejemplo, un atributo persistente someName establecido en somedomain.com/pageA anulará cualquier someName que esté configurado estáticamente en el bloque de información de somedomain.com/pageB, asumiendo que comparten el mismo almacenamiento (de sesión).

Parámetros

Parámetro	Descripción
`name` cadena	Requerido. Nombre del atributo. Aparece como columna en el evento `PageView` . También aparecerá como una columna en el evento `PageAction` si lo estás usando. Evite el uso de palabras NRQL reservadas cuando nombre el atributo/valor.
`value` cadena O entero O booleano O nulo	Requerido. Valor del atributo. Aparece como el valor en la columna de atributo nombrado en el evento `PageView` . Aparecerá como una columna en el evento `PageAction` si lo está utilizando. atributo personalizado los valores no pueden ser objetos complejos, sólo tipos simples como cadenas, enteros y booleanos. Pasar un valor `null` anula cualquier atributo existente con el mismo nombre. Evite el uso de palabras NRQL reservadas cuando nombre el atributo/valor.
`persist` booleano	Opcional. Si se establece en `true`, el par nombre-valor también se establecerá en la API de almacenamiento del browser. Luego, en las siguientes páginas instrumentadas que se cargan dentro de la misma sesión, el par se volverá a aplicar como un atributo personalizado. El valor predeterminado es `false`.

Parámetro

Descripción

name

cadena

Requerido. Nombre del atributo. Aparece como columna en el evento PageView . También aparecerá como una columna en el evento PageAction si lo estás usando.

Evite el uso de palabras NRQL reservadas cuando nombre el atributo/valor.

value

cadena O entero O booleano O nulo

Requerido. Valor del atributo. Aparece como el valor en la columna de atributo nombrado en el evento PageView . Aparecerá como una columna en el evento PageAction si lo está utilizando. atributo personalizado los valores no pueden ser objetos complejos, sólo tipos simples como cadenas, enteros y booleanos.

Pasar un valor null anula cualquier atributo existente con el mismo nombre.

Evite el uso de palabras NRQL reservadas cuando nombre el atributo/valor.

persist

booleano

Opcional. Si se establece en true, el par nombre-valor también se establecerá en la API de almacenamiento del browser. Luego, en las siguientes páginas instrumentadas que se cargan dentro de la misma sesión, el par se volverá a aplicar como un atributo personalizado.

El valor predeterminado es false.

Ejemplos

Obtenga JavaScript/jQuery para elementos HTML

Este ejemplo utiliza JavaScript/jQuery para obtener los valores de los siguientes elementos HTML en una página generada por Drupal:

<link rel="shortlink" href="/node/1111" />
<h1>Using NRQL</h1>

New Relic los reporta como atributo personalizado. Esto es útil para consultar PageView y PageAction evento.

var node_id = jQuery("link[rel='shortlink']").attr("href");
var node_title = jQuery('h1').text();

if (typeof newrelic == 'object') {
  newrelic.setCustomAttribute('nodeId', node_id);
  newrelic.setCustomAttribute('title', node_title);
}

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

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

Requisitos

Descripción

Importante

Parámetros

Ejemplos

Obtenga JavaScript/jQuery para elementos HTML

Sintaxis