Resumen

Las pruebas de navegador son escenarios ejecutados por Datadog en sus aplicaciones web. Se ejecutan en intervalos periódicos configurables desde múltiples ubicaciones alrededor del mundo, desde múltiples navegadores y dispositivos. Estas pruebas verifican tanto que sus aplicaciones están activas y respondiendo a solicitudes, como que se cumplen las condiciones definidas en sus escenarios.

Configuración de prueba

Puede crear una prueba utilizando una de las siguientes opciones:

Crear una prueba a partir de una plantilla

1. Pase el cursor sobre una de las plantillas predefinidas y haga clic en Ver plantilla. Esto abre un panel lateral que muestra información de configuración predefinida, incluyendo: Detalles de la prueba, Condiciones de alerta, Pasos y, opcionalmente, Variables.
2. Haga clic en +Crear prueba para abrir la página de configuración, donde puede revisar y editar las opciones de configuración predefinidas. Los campos presentados son idénticos a los disponibles al crear una prueba desde cero.
3. Haga clic en Guardar y salir en la esquina superior derecha para enviar su prueba de navegador.
   
   

Construir una prueba desde cero

1. Haga clic en la plantilla + para iniciar una nueva prueba de navegador desde cero.
2. Ingrese una URL de inicio: La URL desde la cual su prueba de navegador inicia el escenario.
3. Agregue un nombre: El nombre de su prueba de navegador.
4. Seleccione entorno y etiquetas adicionales: Establezca el env y las etiquetas relacionadas adjuntas a su prueba de navegador. Utilice el <KEY>:<VALUE> formato para filtrar en un <VALUE> para un <KEY> dado.

5. Seleccione navegadores y dispositivos: Los navegadores (como Chrome, Firefox y Edge), y dispositivos (como Laptop Large, Tablet y Mobile Small) para ejecutar su prueba.

   • Para un dispositivo portátil grande, las dimensiones son 1440 píxeles x 1100 píxeles.
   • Para un dispositivo tablet, 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. Seleccione ubicaciones gestionadas y privadas: Seleccione de una lista de ubicaciones alrededor del mundo que son gestionadas por Datadog, o cree ubicaciones privadas para ejecutar su prueba de navegador desde ubicaciones personalizadas o dentro de redes privadas.

   Nota: También puede usar el Túnel de Pruebas Continuas para activar pruebas en su configuración de desarrollo local o en su canalización de CI/CD para probar entornos internos.

7. Establece la frecuencia de prueba: Los intervalos varían desde cada cinco minutos hasta una vez por semana. Para solicitar una frecuencia de un minuto, contacta al Soporte.

8. Haz clic en Guardar y Editar Grabación para enviar tu Prueba de Navegador.

Ubicaciones

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

Al configurar una nueva prueba de navegador de Monitoreo Sintético, utiliza fragmentos para completar automáticamente tus dispositivos y regiones, en lugar de seleccionar estas opciones manualmente. Los siguientes fragmentos están disponibles:

• Tamaños de pantalla: Realiza automáticamente tus pruebas de navegador en una pantalla de tamaño específico a través de los navegadores:

  • Grande
  • Tableta
  • Móvil

• Verificación multi-región: Prueba automáticamente tu sitio web contra una ubicación en cada una de las tres principales regiones geográficas (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.

Usa variables globales

Puede usar las variables globales definidas en Configuración en la URL de inicio y Opciones avanzadas de los detalles de su prueba de navegador, así como en la grabación de su prueba.

Para mostrar una lista de variables disponibles:

• En los detalles de su prueba en el navegador: Escriba {{ en el campo deseado.

• En el grabador de su prueba en el navegador: Importe la variable en su prueba, luego escriba {{ en el campo deseado o inyecte la variable en su aplicación para usarla.

Para más información sobre el uso de variables en la grabación de su prueba de navegador, consulte Pasos de prueba en el navegador.

Defina condiciones de alerta

Puede personalizar las condiciones de alerta para definir las circunstancias bajo las cuales desea que una prueba envíe una alerta de notificación.

Regla de alerta

Se activa una alerta si alguna afirmación falla durante X minutos desde cualquiera n de N ubicaciones. Esta regla de alerta le permite especificar cuánto tiempo y en cuántas ubicaciones una prueba debe fallar antes de activar la notificación.

Se activa una alerta solo si estas dos condiciones son verdaderas:

• Al menos una ubicación estuvo en fallo (al menos una afirmación falló) durante los últimos X minutos;
• En un momento durante los últimos X minutos, al menos N ubicaciones estaban en fallo.

En caso de fallo, reintente X veces antes de que la ubicación sea marcada como fallida. Esto le permite definir cuántos fallos consecutivos de prueba deben ocurrir para que una ubicación se considere fallida. Por defecto, hay una espera de 300ms antes de reintentar una prueba que falló. Este intervalo se puede configurar con la API.

Reintento rápido

Cuando una prueba falla, el reintento rápido le permite reintentar la prueba X veces después de Y ms antes de marcarla como fallida. Personalizar el intervalo de reintento ayuda a reducir falsos positivos y mejora la precisión de sus alertas.

Dado que el tiempo de actividad de la ubicación se calcula en función del resultado final de la prueba después de que se completan los reintentos, los intervalos de reintento rápido impactan directamente en lo que aparece en su gráfico de tiempo de actividad total. El tiempo de actividad total se calcula en función de las condiciones de alerta configuradas, y las notificaciones se envían en función del tiempo de actividad total.

Downtimes

To pause test execution during planned maintenance windows, select an existing Scheduled downtime in the Downtimes section. The test automatically pauses during the downtime’s scheduled time slots.

Note: You cannot create a new downtime from the test creation form. To create one, navigate to Settings > Downtimes.

Configure el seguimiento de prueba

Se envía una notificación de acuerdo con el conjunto de condiciones de alerta establecidas. Utilice esta sección para definir cómo y qué mensaje enviar a sus equipos.

1. Ingrese un mensaje para su prueba de navegador o use mensajes de seguimiento predefinidos. Este campo permite el formato estándar de Markdown y admite las siguientes variables condicionales:

   Variable Condicional	Descripción
   {{#is_alert}}	Show when the monitor alerts.
   {{^is_alert}}	Show unless the monitor alerts.
   {{#is_recovery}}	Show when the monitor recovers from alerta.
   {{^is_recovery}}	Show unless the monitor recovers from alerta.
   {{#is_renotify}}	Show when the monitor renotifies.
   {{^is_renotify}}	Show unless the monitor renotifies.
   {{#is_priority}}	Show when the monitor matches priority (P1 to P5).
   {{^is_priority}}	Mostrar a menos que el seguimiento coincida con la prioridad (P1 a P5).

   Notification messages include the message defined in this section and information about the failing locations. Pre-filled monitor messages are included in the message body section:

   For example, to create a monitor that iterates over steps extracting variables for browser tests, add the following to the monitor message:

   {{! Liste las variables extraídas de todos los pasos exitosos }}
   # Variables extraídas
   {{#each synthetics.attributes.result.steps}}
   {{#if extractedValue}}
   * **Nombre**: `{{extractedValue.name}}`
   **Valor:** {{#if extractedValue.secure}}*Ofuscado (valor oculto)*{{else}}`{{{extractedValue.value}}}`{{/if}}
   {{/if}}
   {{/each}}
   

2. Choose team members and services to notify.

3. Specify a renotification frequency. To prevent renotification on failing tests, check the option Stop re-notifying on X occurrences.

4. Click Save & Start Recording to save your test configuration and record your browser steps.

For more information, see Synthetic Monitoring notifications.

Record your steps

Tests can be only recorded from Google Chrome and Microsoft Edge. To record your test, download the Datadog Record Test extension.

You can switch tabs in a browser test recording to perform an action on your application (such as clicking on a link that opens another tab) and add another test step. Your browser test must interact with the page first (through a click) before it can perform an assertion. By recording all of the test steps, the browser test can switch tabs automatically at test execution.

1. Opcionalmente, seleccione Abrir en una ventana emergente en la parte superior derecha de la página para abrir su grabación de prueba en una ventana emergente separada. Esto es útil si su aplicación no admite abrirse en un iframe o si desea evitar problemas de tamaño durante la grabación. También puede abrir la ventana emergente en Modo Incógnito para comenzar a grabar su prueba desde un navegador fresco, libre de sesiones ya iniciadas, cookies de su navegador existente, y más.

2. Opcionalmente, habilite Datadog para recopilar automáticamente datos de RUM al ejecutar grabaciones de pasos desde su prueba de navegador. Para más información, consulta Explorar RUM y Reproducción de Sesiones.

3. Haga clic en Iniciar Grabación para comenzar a grabar su prueba de navegador.

4. A medida que hace clic en su aplicación mientras recorre el viaje del usuario que desea monitorear, sus acciones se graban automáticamente y se utilizan para crear pasos dentro de su escenario de prueba de navegador a la izquierda.

5. Además de los pasos grabados automáticamente, también puede usar los pasos disponibles en la esquina superior izquierda para enriquecer su escenario:

   Datadog recomienda finalizar su prueba de navegador con una afirmación para confirmar que el viaje ejecutado por la prueba de navegador resultó en el estado esperado.

6. Una vez que haya terminado su escenario, haga clic en Guardar y Lanzar Prueba.

Reproduzca sus pasos

Para volver a ejecutar uno o más pasos de su prueba de navegador directamente en su navegador, descargue la extensión de Prueba de Grabación de Datadog.

La función de Reproducción de Pasos le ayuda a depurar pasos individuales, alcanzar el estado correcto de la aplicación al editar una prueba de navegador, y confirmar flujos completos antes de guardar su prueba.

Nota: La Reproducción de Pasos puede comportarse de manera diferente a una ejecución completa de prueba Synthetic Monitoring debido a diferentes condiciones (versión del navegador, red, agente de usuario, estado de inicio de sesión) o limitaciones.

Cómo usar la reproducción de pasos

Puede reproducir pasos de tres maneras:

1. Reproducción de un solo paso: Reejecute un solo paso:

Pase el cursor sobre el paso y haga clic en el botón de reproducción para reproducir únicamente este paso.

2. Reproduzca todos los pasos: Ejecute toda la secuencia de pasos tal como se definió en el grabador:

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

3. Reproduzca pasos seleccionados: Ejecute un subconjunto de pasos que seleccione en la lista de pasos:

Seleccione los pasos que desea reproducir y luego haga clic en el botón de reproducir seleccionados (⏩︎) en la parte superior de la lista de pasos.

Soporte para la función de reproducción de pasos

La siguiente tabla resume qué tipos de pasos de prueba de navegador son compatibles con la reproducción de pasos:

Tipos de paso no soportados por la reproducción de pasos

Permiso de depurador

Para estar lo más cerca posible de una ejecución completa de prueba de Synthetic Monitoring, algunos pasos como los basados en JavaScript o simulaciones de pulsaciones de teclas requieren el permiso de depurador para ser reproducidos.

La primera vez que la extensión se actualiza a una versión que requiere permiso de depurador, aparece una solicitud de permiso y la extensión se desactiva hasta que la apruebe:

Haga clic en los tres puntos Menú para aceptar el permiso.

Permisos

Por defecto, solo los usuarios con los roles Datadog Admin y Datadog Standard pueden crear, editar y eliminar pruebas de navegador Synthetic. Para obtener acceso para crear, editar y eliminar pruebas de navegador Synthetic, actualice su usuario a uno de esos dos roles predeterminados.

Si está utilizando la función de rol personalizado, agregue su usuario a cualquier rol personalizado que incluya synthetics_read y synthetics_write permisos.

Restringir acceso

Utilice control de acceso granular para limitar quién tiene acceso a su prueba según roles, equipos o usuarios individuales:

1. Abra la sección de permisos del formulario.
2. Haga clic en Editar Acceso.

3. Haga clic en Restringir Acceso.
4. Seleccione equipos, roles o usuarios.
5. Haga clic en Agregar.
6. Seleccione el nivel de acceso que desea asociar con cada uno de ellos.
7. Haga clic en Done.

Para saber más

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

Comenzando con Pruebas de NavegadorDOCUMENTACIÓN Aprender sobre monitores de pruebas SyntheticDOCUMENTACIÓN Historial de versiones de Synthetic MonitoringGUÍA Centro de Aprendizaje de Datadog: Comenzando con pruebas de navegador SyntheticCENTRO DE APRENDIZAJE Mejores prácticas para crear pruebas de extremo a extremoBLOG Simplificando la resolución de problemas a lo largo del recorrido del usuario con Synthetic Monitoring de DatadogBLOG Cómo ayudé a mi cliente a escalar sus pruebas de navegador con DatadogBLOG Crear y gestionar pruebas de navegador Synthetic con TerraformSITIO EXTERNO