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

Realice esta llamada antes de que se active el evento de carga de la ventana (cuando se transmiten esos datos) para que el atributo se incluya en el evento PageView . Una vez que se establece un atributo, la plataforma New Relic lo registra con todos los eventos hasta que se recarga la página o el atributo se desactiva manualmente.

Si está utilizando monitoreo SPA con una versión de agente compatible, el atributo establecido con esta llamada también se incluirá en el evento newrelic.interaction . Sin embargo, los atributos configurados mediante la API SPA tendrán prioridad sobre estos atributos.

Los errores del atributo personalizado se incluirán en el evento en la página de errores de JS. Para ver o log errores para un atributo personalizado a través de API, utilice la llamada noticeError de la API del navegador.

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