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.

Si te interesa probar aplicaciones basadas en la MFA, consulta la guía exclusiva y envía tus comentarios al equipo de monitorización Synthetic para que te ayuden a mejorar los sistemas que más importan a tus equipos.

Configuración del test

Define la configuración de tu test de navegador.

  1. Introduce una URL de inicio: La URL desde la que tu test de navegador inicia el escenario.
Para ver más opciones, consulta Opciones avanzadas.
  1. Añade un nombre: El nombre del test de tu navegador.

  2. 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.

  3. 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.
  4. Selecciona localizaciones gestionadas y privadas: Selecciona localizaciones en todo el mundo que estén gestionados por Datadog o crea localizaciones privadas para ejecutar tu test de navegador desde localizaciones personalizadas o en redes privadas.

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

    AmericasAPACEMEA
    Canada Central (AWS)Hong Kong (AWS)Cape Town (AWS)
    Northern California (AWS)Mumbai (AWS)Frankfurt (AWS)
    Northern Virginia (AWS)Seoul (AWS)Ireland (AWS)
    Ohio (AWS)Singapore (AWS)London (AWS)
    Oregon (AWS)Sydney (AWS)Paris (AWS)
    São Paulo (AWS)Tokyo (AWS)Stockholm (AWS)
    Virginia (Azure)Osaka (AWS)Milan (AWS)
    Jakarta (AWS)Bahrain (AWS)

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

    Americas
    US-West

    También puedes utilizar el túnel de tests continuos para activar tests en tu configuración de desarrollo local o en tu pipeline CI/CD para realizar tests en entornos internos.

  5. 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.

Opciones avanzadas

Selecciona Deshabilitar CORS para evitar que la política de Uso compartido de recursos entre orígenes (CORS) bloquee tu test. Para evitar que la política de Seguridad del contenido (CSP) bloquee tu test, selecciona Deshabilitar CSP.

  • Cabeceras de solicitud: Define las cabeceras en los campos Nombre y Valor para añadir o anular las cabeceras predeterminadas del navegador. Por ejemplo, puedes configurar el Agent de usuario en la cabecera para identificar scripts de Datadog.
  • Cookies: Define cookies que añadir a las cookies predeterminadas del navegador. Introduce una cookie por línea, utilizando la sintaxis de Set-Cookie.
  • Autenticación HTTP: Autentícate a través de HTTP Basic, Digest o NTLM con un nombre de usuario y una contraseña. Tus credenciales se utilizan en cada paso del test del navegador. Nota: La autenticación a través de HTTP Basic se puede utilizar para sitios web que solicitan credenciales de usuario a través de un aviso del sistema del navegador.

Las opciones de solicitud se definen en cada ejecución del test y se aplican a cada paso de tu test del navegador en el momento de la ejecución, no en el momento de la grabación. Si necesitas que estas opciones permanezcan activas para grabar los pasos siguientes, aplica manualmente las opciones en la página desde la que estás grabando y crea pasos posteriores en tu test.

Selecciona Ignorar error de certificado del servidor para indicar al test que omita los errores en el certificado del servidor.

  • Certificado de cliente: Realiza tests en sistemas que requieren certificados de cliente haciendo clic en Cargar archivo y cargando tu archivo de certificado y tu clave privada. Solo se aceptan certificados PEM.
  • Dominios de certificados de cliente: Una vez cargados los archivos de certificado, el certificado de cliente se aplica al dominio de la URL de inicio. Para aplicar el certificado de cliente en otro dominio, especifica el dominio en el campo Valor.

Puedes incluir comodines en la URL.

Introduce la URL del proxy a través del cual quieres enviar las solicitudes en el campo URL de proxy como http://<YOUR_USER>:<YOUR_PWD>@<YOUR_IP>:<YOUR_PORT>.

Puedes incluir variables globales en la URL.

Seleccione No realizar capturas de pantalla en este test para evitar que se realicen capturas de pantalla en los pasos de tu test.

Esta opción de privacidad está disponible como opción avanzada en el nivel de cada paso del test y garantiza que no aparezcan datos confidenciales en los resultados del test. Si se impide que el test realice capturas de pantalla, será más difícil encontrar fallos y solucionarlos. Para obtener más información, consulta Seguridad de los datos.

Introduce una cantidad de tiempo en segundos que el test deberá esperar antes de declarar el paso de test inicial como fallido.

Por defecto, la zona horaria está definida en UTC y el idioma en inglés (En). Para definir un idioma, utiliza el [código ISO] de 2 o 3 dígitos correspondiente[19].

Variables

Create local variables

To create a local variable, click Create a Local Variable. 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 Configuración en la URL de inicio y en 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 obtener más información sobre el uso de variables durante la grabación del test del navegador, consulta Pasos de un test de 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.

Regla para las alertas de un test de navegador
  • 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. 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 fallido. 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 del navegador. Este campo permite el formato Markdown estándar y admite las siguientes variables condicionales:

    Variable condicionalDescripció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 localizaciones que fallan.

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

  3. Especifica una frecuencia de reenvío de notificaciones. Para evitar el reenvío de notificaciones en caso de tests fallidos, deja la opción como Never renotify if the monitor has not been resolved.

  4. Haz clic en Guardar detalles y grabar test para guardar la configuración de tu test y grabar los pasos del navegador.

Para obtener más información, consulta Uso de monitores de tests Synthetic.

Para grabar tus pasos

Los tests sólo se pueden grabar desde Google Chrome. Para grabar tu test, descarga la extensión Datadog para la grabación de tests para Google Chrome.

Durante la grabación de un test de navegador puedes cambiar de pestaña 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. Tu test de navegador debe interactuar primero con la página (a través de un clic), antes de poder realizar una aserción. Al grabar todos los pasos del test, el test del navegador puede cambiar de pestaña automáticamente durante la ejecución del test.

Test de grabación de un test de navegador
  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 enriquecer tu escenario:

    Pasos del test de navegador

    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 al estado esperado.

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

Permisos

De manera predeterminada, sólo 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 utilizas la función rol personalizado, añade tu usuario a cualquier rol personalizado que incluya permisos de synthetics_read y synthetics_write.

Restringir el acceso

La restricción de acceso está disponible para los clientes que utilizan roles personalizados en sus cuentas.

Puedes restringir el acceso a un test de navegador en función de los roles de tu organización. Al crear un test de navegador, elige qué roles (además de tu usuario) pueden leer y escribir tu test.

Definir permisos para tu test

Referencias adicionales

[19] https://www.loc.gov/standards/iso639-2/php/code_list.php