Información general

Los tests de navegador son escenarios ejecutados por Datadog en tus aplicaciones web. Se ejecutan a intervalos periódicos configurables desde varias localizaciones en todo el mundo, desde varios navegadores y dispositivos. Estos tests verifican tanto que tus aplicaciones están activas y responden a las solicitudes, como que se cumplen las condiciones definidas en tus escenarios.

Configuración del test

Puedes crear un test utilizando una de las siguientes opciones:

Crear un test a partir de una plantilla

1. Pasa el ratón por encima de una de las plantillas ya rellenadas y haz clic en View Template (Ver plantilla). Se abrirá un panel lateral en el que se mostrará la información de configuración rellenada previamente, que incluye: detalles de tests, condiciones de alerta, pasos e incluso variables.
2. Haz clic en +Create Test (+Crear test) para abrir la página de configuración, en la que podrás revisar y editar las opciones de configuración rellenadas previamente. Los campos presentados son idénticos a aquellos disponibles cuando se crea un test desde cero.
3. Haz clic en Save & Quit (Guardar y salir) en la esquina superior derecha para enviar tu test de navegador.
   
   

Crear un test desde cero

1. Haz clic en la plantilla + para iniciar un nuevo test de navegador desde cero.
2. Introduce una URL de inicio: La URL desde la que tu test de navegador inicia el escenario.
3. Añade un nombre: El nombre del test de tu navegador.
4. Selecciona etiquetas (tags) de entorno y adicionales: Define la etiqueta env y otras etiquetas relacionadas, adjuntas a tu test de navegador. Utiliza el formato <KEY>:<VALUE> para filtrar por <VALUE> una <KEY> determinada.

5. Selecciona navegadores y dispositivos: Los navegadores (como Chrome, Firefox y Edge) y los dispositivos (como Laptop Large, Tablet y Mobile Small) en los que vas a ejecutar tu test.

   • Para un dispositivo portátil grande, las dimensiones son 1440 píxeles x 1100 píxeles.
   • Para una tableta, las dimensiones son 768 píxeles x 1020 píxeles.
   • Para un dispositivo móvil pequeño, las dimensiones son 320 píxeles x 550 píxeles.

6. Selecciona localizaciones gestionadas y privadas: Selecciona entre una lista de localizaciones de todo el mundo, que son administradas por Datadog, o crea localizaciones privadas para ejecutar tu test de navegador desde localizaciones personalizadas o dentro de redes privadas.

   Nota: También puedes utilizar el túnel de Continuous Testing para activar tests en tu configuración de desarrollo local o en tu pipeline CI/CD para probar entornos internos.

7. Ajusta la frecuencia de los tests: los intervalos varían de cada cinco minutos a una vez por semana. Para solicitar una frecuencia de un minuto, ponte en contacto con el servicio de asistencia.

8. Haz clic en Save & Edit Recording (Guardar y editar grabación) para enviar tu test de navegador.

Localizaciones

Datadog’s out-of-the-box managed locations allow you to test public-facing websites and endpoints from regions where your customers are located.

AWS:

GCP:

Azure:

The Datadog for Government site (US1-FED) uses the following managed location:

Fragmentos

Cuando configures un nuevo test de navegador de Synthetic Monitoring, utiliza fragmentos para rellenar automáticamente tus dispositivos y regiones, en lugar de seleccionar estas opciones manualmente. Están disponibles los siguientes fragmentos:

• Screen sizes (Tamaños de pantalla): realiza automáticamente tus tests de navegador en una pantalla de tamaño específico en todos los navegadores:

  • Large (Grande)
  • Tablet (Tableta)
  • Mobile (Móvil)

• Multi-region check (Check multiregión): prueba automáticamente tu sitio web en una localización en cada una de las tres regiones geográficas principales (AMER, APAC y EMEA).
  
  

Opciones avanzadas

Create local variables

To create a local variable, click + All steps > Variables. You can select one of the following available builtins to add to your variable string:

{{ numeric(n) }}

Generates a numeric string with n digits.

{{ alphabetic(n) }}

Generates an alphabetic string with n letters.

{{ alphanumeric(n) }}

Generates an alphanumeric string with n characters.

{{ date(n unit, format) }}

Generates a date in one of Datadog’s accepted formats with a value corresponding to the UTC date the test is initiated at + or - n units.

{{ timestamp(n, unit) }}

Generates a timestamp in one of Datadog’s accepted units with a value corresponding to the UTC timestamp the test is initiated at +/- n units.

{{ uuid }}

Generates a version 4 universally unique identifier (UUID).

{{ public-id }}

Injects the Public ID of your test.

{{ result-id }}

Injects the Result ID of your test run.

To obfuscate local variable values in test results, select Hide and obfuscate variable value. Once you have defined the variable string, click Add Variable.

Uso de variables globales

Puedes utilizar las variables globales definidas en Settings (Configuración) en la Starting URL (URL de inicio) y Advanced Options (Opciones avanzadas) de los detalles del test de tu navegador, así como en la grabación del test.

Para visualizar una lista de las variables disponibles:

• En los detalles de los tests de tu navegador: Escribe {{ en el campo deseado.

• En la grabadora de los tests de tu navegador: Importa la variable en tu test, luego escribe {{ en el campo deseado o inyecta la variable en tu aplicación para utilizarla.

Para más información sobre el uso de variables en la grabación del test del navegador, consulta Pasos del test del navegador.

Definir las condiciones de alerta

Puedes personalizar las condiciones de alerta para definir las circunstancias en las que quieres que un test envíe una alerta de notificación.

• Se activa una alerta si cualquier aserción falla durante X minutos desde cualquier localización n de N. Esta regla para alertas permite especificar durante cuánto tiempo y en cuántas localizaciones debe fallar un test antes de que se active la notificación.
• Reintenta X veces antes de que la localización se marque como fallida. Esto permite definir cuántos fallos de tests consecutivos deben producirse para que una localización se considere fallida. Por defecto, hay una espera de 300 ms antes de reintentar un test que ha fallado. Este intervalo puede configurarse con la API.

Configurar el monitor de tests

Se envía una notificación según el conjunto de condiciones de alerta. Utiliza esta sección para definir qué mensajes enviar a tus equipos y cómo hacerlo.

1. Introduce un mensaje para el test de navegador o utiliza los mensajes prerellenados de monitor. Este campo permite el formato Markdown estándar y admite las siguientes variables condicionales:

   Variable condicional	Descripción
   {{#is_alert}}	Mostrar cuando el monitor envía alertas.
   {{^is_alert}}	Mostrar a menos que el monitor envía alertas.
   {{#is_recovery}}	Mostrar cuando el monitor se recupera de una alert.
   {{^is_recovery}}	Mostrar a menos que el monitor se recupere de una alert.
   {{#is_renotify}}	Mostrar cuando el monitor vuelva a enviar una notificación.
   {{^is_renotify}}	Mostrar a menos que el monitor vuelva a enviar una notificación.
   {{#is_priority}}	Mostrar cuando el monitor coincide con la prioridad (de P1 a P5).
   {{^is_priority}}	Mostrar a menos que el monitor coincida con la prioridad (de P1 a P5).

   Los mensajes de notificación incluyen el mensaje definido en esta sección e información sobre las ubicaciones que fallan. Los mensajes prerellenados de monitor se incluyen en la sección del cuerpo del mensaje:

   Por ejemplo, para crear un monitor que itere sobre los pasos extrayendo variables para los tests de navegador, añade lo siguiente al mensaje de monitor:

   {{! List extracted variables across all successful steps }}
   # Extracted variables
   {{#each synthetics.attributes.result.steps}}
   {{#if extractedValue}}
   * **Name**: `{{extractedValue.name}}`
   **Value:** {{#if extractedValue.secure}}*Obfuscated (value hidden)*{{else}}`{{{extractedValue.value}}}`{{/if}}
   {{/if}}
   {{/each}}
   

2. Selecciona los miembros del equipo y los servicios a los que notificar.

3. Especifica una frecuencia para volver a enviar la notificación. Para evitar una nueva notificación en caso de error en tests, activa la opción Stop re-notifying on X occurrences.

4. Haz clic en Save & Start Recording (Guardar e iniciar grabación) para guardar la configuración de test y grabar los pasos del navegador.

Para más información, consulta Notificaciones de Synthetic Monitoring.

Para grabar tus pasos

Los tests solo se pueden grabar desde Google Chrome y Microsoft Edge. Para grabar tu test, descarga la extensión de Grabación de tests de Datadog.

Puedes cambiar de pestaña en una grabación del test de navegador para realizar una acción en tu aplicación (como hacer clic en un enlace que abre otra pestaña) y añadir otro paso de test. El test de navegador debe interactuar primero con la página (a través de un clic) antes de poder realizar una confirmación. Al grabar todos los pasos de test, el test de navegador puede cambiar de pestaña automáticamente en la ejecución de test.

1. También puedes seleccionar Abrir en una ventana emergente en la parte superior derecha de la página para abrir la grabación del test en una ventana emergente independiente. Esto es útil si tu aplicación no admite ser abierta en un iframe o si quieres evitar problemas de tamaño en la grabación. También puedes abrir la ventana emergente en Modo incógnito para empezar a grabar tu test desde un navegador nuevo, libre de sesiones ya iniciadas, cookies de tu navegador actual, etc.

2. También puedes habilitar Datadog para recopilar automáticamente datos RUM al ejecutar grabaciones de los pasos del test de tu navegador. Para obtener más información, consulta Explorar RUM y Session Replay.

3. Haz clic en Iniciar grabación para empezar a grabar el test de tu navegador.

4. A medida que haces clic en tu aplicación en el recorrido del usuario que quieres monitorizar, tus acciones se graban automáticamente y se utilizan para crear pasos en el escenario de test de tu navegador a la izquierda.

5. Además de los pasos grabados automáticamente, también puedes utilizar los pasos disponibles en la esquina superior izquierda para mejorar tu escenario:

   Datadog recomienda finalizar tu test de navegador con una aserción para confirmar que el recorrido ejecutado por el test del navegador ha dado como resultado el estado esperado.

6. Una vez que termines tu escenario, haz clic en Guardar e iniciar test.

Repetición de pasos

La repetición de pasos te permite volver a ejecutar uno o más pasos de tu test de navegador directamente en tu navegador con la extensión Grabación de test de Datadog. Esta función te ayuda a establecer el estado correcto cuando añades o editas pasos en medio de un test, por lo que no necesitas hacerlo manualmente.

Permiso de depuración

Los pasos basados en JavaScript y las simulaciones de pulsaciones de teclas requieren el permiso del depurador.

La primera vez que la extensión se actualice a una versión que requiera permiso de depuración, verás una solicitud de permiso y la extensión se desactivará hasta que la apruebes:

Haz clic en el menú de tres puntos para aceptar el permiso.

Cómo utilizar la Repetición del paso

Puedes repetir los pasos de tres maneras:

1. Repetición de paso único: reejecuta un único paso:

Pasa el ratón por encima del paso, y haz clic en el botón de reproducción para repetir solo este paso.

2. Repetición de todos los pasos: ejecuta toda la secuencia de pasos definida en la grabadora:

Haz clic en el botón repetir todo (⏩︎) en la parte superior de la lista de pasos para repetir todos los pasos.

3. Repetición de los pasos seleccionados: ejecuta un subconjunto de pasos que selecciones en la lista de pasos:

Selecciona los pasos que deseas repetir y, a continuación, haz clic en el botón de repetición seleccionado (⏩︎) en la parte superior de la lista de pasos.

Compatibilidad con la función de repetición de pasos

La siguiente tabla resume qué tipos de paso de test de navegador admiten la repetición de pasos:

Tipos de pasos no compatibles con la repetición de pasos

Permisos

De manera predeterminada, solo los usuarios con los roles de administrador de Datadog y estándar de Datadog pueden crear, editar y eliminar tests de navegador Synthetic. Para crear, editar y eliminar tests de navegador Synthetic, actualiza tu usuario a uno de esos dos roles predeterminados.

Si estás utilizando la función de rol personalizado, añade tu usuario a cualquier rol que incluya permisos synthetics_read y synthetics_write.

Restringir el acceso

Utiliza el control de acceso detallado para limitar quién tiene acceso a tu test en función de roles, equipos o usuarios individuales:

1. Abre la sección de permisos del formulario.
2. Haz clic en Edit Access (Editar acceso).

3. Haz clic en Restrict Access (Restringir el acceso).
4. Selecciona equipos, roles o usuarios.
5. Haz clic en Add (Añadir).
6. Selecciona el nivel de acceso que deseas asociar a cada uno de ellos.
7. Haz clic en Done (Listo).

Referencias adicionales

Más enlaces, artículos y documentación útiles:

Historial de versiones de Synthetic MonitoringGUÍA Prácticas recomendadas para la creación de tests de extremo a extremoBLOG Centro de aprendizaje de Datadog: Empezando con los tests de navegador SyntheticCENTRO DE APRENDIZAJE Introducción a los tests de navegadorDOCUMENTACIÓN Más información sobre los monitores de test SyntheticDOCUMENTACIÓN Creación y gestión de tests de navegador Synthetic con TerraformSITIO EXTERNO Cómo ayudé a mi cliente a escalar sus tests de navegador con DatadogBLOG