setUserId

Sintaxis

newrelic.setUserId(value: string|null)

Agrega una cadena de identificador definida por el usuario al evento posterior en la página.

Requisitos

• Browser Lite, Pro o Pro+SPA agente (v1.230.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
    ]
  }

  Copia

  Para obtener más información, consulte la documentación de instalación del navegador npm.

Descripción

Al ejecutar esta función con un valor válido, el agente del navegador registra el valor como el atributo enduser.id con todos los eventos hasta que el atributo se desarme manualmente. El identificador se almacenará en el browser, de modo que las visitas posteriores a páginas del mismo origen lo adjunten en el evento within a session span. 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 un value = null, cualquier ID de usuario existente se eliminará del both evento de la página actual y del almacenamiento.

El ID se adjuntará al evento JavaScriptError, en particular para el uso Errors Inbox . Si está utilizando monitoreo SPA con una versión de agente compatible, el ID de usuario también se incluirá en el evento newrelic.interaction .

A partir de la versión 1.307.0 del agente, si el atributo resetSession se establece en true, cuando se actualiza el identificador de usuario, la sesión del agente del navegador se restablece. Sin embargo, la sesión no se restablece si el atributo enduser.id aún no se ha especificado.

Parámetros

Ejemplos: un usuario por máquina/dispositivo

Marcar el inicio de una sesión de usuario

newrelic.setUserId('user-1234')

Dejar de atribuir eventos al usuario actual

// Note: events are still attributed to the same session id
newrelic.setUserId(null)

Ejemplos: múltiples usuarios por máquina/dispositivo

Marcar el inicio de una sesión de usuario

// Note: associates the specified userid to the current session id
newrelic.setUserId('user-1234', true)

Cambiar a otra sesión de usuario

// Note: resets the session, events will be attributed to a new user + session id
newrelic.setUserId('user-567', true)

Finalizar una sesión de usuario

// Note: resets the session, effectively ending it.  Events will be attributed to a new session id going forward.
newrelic.setUserId(null, true)