Información general

Electron es un marco de código abierto que puede utilizarse para crear aplicaciones de escritorio multiplataforma para macOS y Windows.

Puedes instalar y configurar el SDK del navegador Datadog para iniciar aplicaciones de monitorización creadas con Electron.

Nota: El SDK del navegador sólo admite la monitorización de procesos de renderizado de una aplicación. No inicializa o monitoriza nada instalado en el proceso principal. Para obtener más información, consulta la documentación del proceso de renderizado de Electron.

El SDK del navegador Datadog sólo admite la monitorización de procesos de renderizado de una aplicación Electron

Instalación

Para instalar el SDK del navegador Datadog para que sea compatible con aplicaciones Electron:

  1. Configura e instala la monitorización del Navegador RUM dentro de cada proceso de renderizado, siguiendo los pasos para CDN sínc, CDN asínc, o NPM.

  2. Configura el parámetro allowFallbackToLocalStorage como true en la configuración de inicialización de RUM de cada proceso de renderizado, como se muestra a continuación.

    Nota: Esta configuración permite a Datadog recopilar datos RUM sin depender de las cookies del navegador.

    • Si tu objetivo son páginas disponibles en Internet (mediante el protocolo https://), no necesitas este parámetro.
    • Si está integrando páginas dentro de tu aplicación (utilizando el protocolo file://), Datadog necesita almacenar las sesiones de forma local, ya que las cookies no están disponibles.
    datadogRum.init({
      applicationId: '<DATADOG_APPLICATION_ID>',
      clientToken: '<DATADOG_CLIENT_TOKEN>',
      site: '<DATADOG_SITE>',
      ...
      allowFallbackToLocalStorage: true
      });
    
  3. Una vez que hayas configurado el SDK correctamente, tus datos rellenarán el Explorador RUM.

Solucionar problemas

Soporte para aplicaciones Electron híbridas

La política del mismo origen impide el seguimiento de una aplicación en una misma sesión en la que las páginas se cargan tanto de forma local (file://) como remota (http(s)://).

Esto significa que una aplicación que utiliza Electron para integrar una página de inicio y que luego redirige al usuario a un sitio web alojado en Internet da lugar a la creación de dos sesiones para ese usuario: una para la parte del inicio de archivos locales incorporados (file://) de la aplicación y otra para la parte remota (https:// archivos disponibles en Internet).

Sesiones de corta duración para instancias con varias ventanas activas a la vez

Un problema con la latencia de replicación del almacenamiento local entre ventanas puede provocar la creación de una sesión de corta duración (menos de 1 segundo). Para solucionar este problema, asegúrate de que se crean e inicializan varias ventanas con un intervalo de más de 10 ms.

Referencias adicionales

Additional helpful documentation, links, and articles: