setCustomAttribute

Sintaxe

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

Adiciona um nome e valor de atributo personalizado definido pelo usuário ao evento subsequente na página.

Requisitos

Agente browser Lite, Pro ou Pro+SPA (v593 ou superior)
- Para suporte ao parâmetro persist ou ao valor null , é necessária a versão 1.230.0 ou superior do agente.
- Para suporte ao valor boolean , é necessária a versão 1.245.0 ou superior do agente.

Se estiver usando o npm para instalar o agente browser, você deverá ativar pelo menos um recurso ao instanciar a classe BrowserAgent . Por exemplo, adicione o seguinte na matrizfeatures :

import { Metrics } from '@newrelic/browser-agent/features/metrics'

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

Para obter mais informações, consulte a documentação de instalação do browser NPM.

Descrição

Define um atributo personalizado para a sessão do seu agente. Depois que um atributo é definido, a plataforma New Relic o registra com todos os eventos suportados até que a página seja recarregada ou o atributo seja desativado manualmente.

Os seguintes eventos do Browser são suportados:

Nome do evento	Notas
`AjaxRequest`
`BrowserInteraction`	Os atributos definidos usando o método SPA `setAttribute` têm precedência sobre os atributos definidos por `setCustomAttribute`.
`BrowserPerformance`
`JavaScriptError`	Para visualizar ou registrar erros de um atributo personalizado via API, use a chamada da API do navegador `noticeError`.
`Log`	Atributos personalizados fornecidos ao método `log` no argumento `options.customAttributes` têm precedência sobre os atributos definidos por `setCustomAttribute`.
`PageAction`
`PageView`	Faça esta chamada antes que o evento de carregamento da janela seja acionado (quando esses dados são transmitidos) para que os atributos sejam incluídos no evento `PageView`.
`PageViewTiming`
`UserAction`

Com o sinalizador persist , o atributo também pode ser armazenado no browser, para que as visitas subsequentes à página do mesmo período within a session de origem o mantenham no evento. Observe que esta funcionalidade pode variar dependendo das configurações de privacidade do browser do usuário final. Se esta função for chamada com value = null, o atributo será excluído de both o evento e o armazenamento da página atual, independentemente do sinalizador persist .

Importante

Esteja ciente de que os atributos persistentes têm precedência sobre info.jsAttributes chaves de mesmo nome! Por exemplo, um atributo persistente someName definido em somedomain.com/pageA substituirá qualquer someName que esteja estaticamente definido no bloco de informações de somedomain.com/pageB, assumindo que eles compartilhem o mesmo armazenamento (de sessão).

Parâmetro

Parâmetro	Descrição
`name` corda	Obrigatório. Nome do atributo. Aparece como coluna no evento `PageView` . Ele também aparecerá como uma coluna no evento `PageAction` se você o estiver usando. Evite usar palavras NRQL reservadas ao nomear o atributo/valor.
`value` string OU inteiro OU booleano OU nulo	Obrigatório. Valor do atributo. Aparece como o valor na coluna do atributo nomeado no evento `PageView` . Ele aparecerá como uma coluna no evento `PageAction` se você o estiver usando. valores de atributo personalizado não podem ser objetos complexos, apenas tipos simples como Strings, Inteiros e Booleanos. Passar um valor `null` desativa qualquer atributo existente com o mesmo nome. Evite usar palavras NRQL reservadas ao nomear o atributo/valor.
`persist` boleano	Opcional. Se definido como `true`, o par nome-valor também será definido na API de armazenamento do browser. Em seguida, nas páginas de instrumentos seguintes carregadas na mesma sessão, o par será reaplicado como um atributo personalizado. O padrão é `false`.

Descrição

name

corda

Obrigatório. Nome do atributo. Aparece como coluna no evento PageView . Ele também aparecerá como uma coluna no evento PageAction se você o estiver usando.

Evite usar palavras NRQL reservadas ao nomear o atributo/valor.

value

string OU inteiro OU booleano OU nulo

Obrigatório. Valor do atributo. Aparece como o valor na coluna do atributo nomeado no evento PageView . Ele aparecerá como uma coluna no evento PageAction se você o estiver usando. valores de atributo personalizado não podem ser objetos complexos, apenas tipos simples como Strings, Inteiros e Booleanos.

Passar um valor null desativa qualquer atributo existente com o mesmo nome.

Evite usar palavras NRQL reservadas ao nomear o atributo/valor.

persist

boleano

Opcional. Se definido como true, o par nome-valor também será definido na API de armazenamento do browser. Em seguida, nas páginas de instrumentos seguintes carregadas na mesma sessão, o par será reaplicado como um atributo personalizado.

O padrão é false.

Exemplos

Obtenha JavaScript/jQuery para elementos HTML

Este exemplo usa JavaScript/jQuery para obter os valores dos seguintes elementos HTML em uma página gerada pelo Drupal:

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

A New Relic os reporta como atributo personalizado. Isto é útil para consultar eventos PageView e PageAction .

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);
}

Esta tradução de máquina é fornecida para sua comodidade.

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

Requisitos

Descrição

Importante

Parâmetro

Exemplos

Obtenha JavaScript/jQuery para elementos HTML

Sintaxe