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
    ]
  }

  Copiar

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

Descrição

Faça essa chamada antes que o evento de carregamento da janela seja acionado (quando os dados são transmitidos) para que o atributo seja incluído no evento PageView . Depois que um atributo é definido, a plataforma New Relic o registra com todos os eventos até que a página seja recarregada ou o atributo seja desmarcado manualmente.

Se você estiver utilizando o monitoramento SPA com uma versão de agente compatível, o atributo definido com esta chamada também será incluído no evento newrelic.interaction . No entanto, os atributos definidos através da API do SPA terão precedência sobre estes atributos.

Erros de atributo personalizado serão incluídos em evento na página Erros JS. Para visualizar ou log erros de um atributo personalizado por meio da API, use a chamada noticeError da API do browser.

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 .

Parâmetro

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