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

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

setUserId

Sintaxe

newrelic.setUserId(value: string|null)

Adiciona uma string de identificador definida pelo usuário ao evento subsequente na página.

Requisitos

  • Agente browser Lite, Pro ou Pro+SPA (v1.230.0 ou superior)

  • 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

Ao executar esta função com um valor válido, o agente browser registra o valor como o atributo enduser.id com todos os eventos até que o atributo seja desdefinido manualmente. O identificador será armazenado no browser, para que as visitas subsequentes à página da mesma origem o anexem no evento within a session span. 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, qualquer ID de usuário existente será excluído de both o evento e o armazenamento da página atual.

O ID será anexado ao evento JavaScriptError em particular para uso Errors Inbox . Se você estiver usando o monitoramento SPA com uma versão de agente compatível, o ID do usuário também será incluído no evento newrelic.interaction .

Parâmetro

Parâmetro

Descrição

value

string OU nulo

Obrigatório. Um identificador de string para o usuário final, útil para vincular todos os eventos do browser a um usuário específico. O parâmetro value não precisa ser exclusivo. Se os IDs forem exclusivos, o chamador será responsável por essa validação.

Passar um valor null desativa qualquer ID de usuário existente.

Exemplos

Marcando o "início da sessão" de um usuário final

newrelic.setUserId('user-1234-v1.0')

Parando evento de atributo ao usuário atual

newrelic.setUserId(null)