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 |
---|---|
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 Passar um valor |
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)