Monitorización de aplicaciones Electron con el SDK del Navegador
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.
Instalación
Para instalar el SDK del navegador Datadog para que sea compatible con aplicaciones Electron:
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.
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
});
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: