Parámetros de monitorización y tests de Synthetic

Información general

En la página Synthetic Monitoring & Continuous Testing Settings (Parámetros de Synthetic Monitoring y Continuous Testing), puedes controlar los siguientes temas y acceder a ellos:

Parámetros predeterminados

Parámetros de etiquetas (tags) aplicados

En la página Usage Attribution (Atribución de uso), puedes configurar hasta tres etiquetas con las que desglosar los atributos de coste y uso. Selecciona Enforce tags for usage attribution on all tests (Aplicar etiquetas para la atribución de uso en todos los tests) para requerir que los usuarios introduzcan todas las etiquetas de atribución de uso configuradas al crear o editar tests de Synthetic. Con esta opción habilitada, los usuarios no podrán guardar los tests sin introducir todas las etiquetas necesarias.

Localizaciones predeterminadas

Elige las localizaciones predeterminadas para los detalles de tu test de API, test de API de varios pasos o test de navegador.

Tus opciones incluyen todas las localizaciones gestionadas disponibles que ofrece Datadog y las localizaciones privadas que configuraste para tu cuenta.

Cuando termines de seleccionar las localizaciones, haz clic en Save Default Locations (Guardar localizaciones predeterminadas).

Elige los tipos de navegador y dispositivo predeterminados para los detalles de tu test de navegador.

Las opciones de navegador son Google Chrome, Mozilla Firefox y Microsoft Edge. En cuanto a los dispositivos, puedes elegir entre un portátil grande, una tableta y un dispositivo móvil pequeño.

Cuando termines de seleccionar los navegadores y dispositivos, haz clic en Save Default Browsers & Devices (Guardar los navegadores y dispositivos predeterminados).

Etiquetas predeterminadas

Elige o añade las etiquetas predeterminadas para los detalles de tu test de API, test de API de varios pasos o test de navegador.

Cuando termines de seleccionar las etiquetas relacionadas, haz clic en Save Default Tags (Guardar etiquetas predeterminadas).

Tiempo de espera predeteriminado

Añade los tiempos de espera predeterminados para los detalles de tu test de API.

Cuando hayas terminado de introducir los nuevos tiempos de espera, haz clic en Save Default Timeouts (Guardar tiempos de espera predeterminados).

Frecuencia predeterminada

Elige o añade las frecuencias predeterminadas para los detalles de tu test de API, test de navegador o test de móvil.

Cuando hayas terminado de seleccionar las etiquetas relacionadas, haz clic en Save Default Frequencies (Guardar frecuencias predeterminadas).

Reintentos predeterminados

Elige o añade el número predeterminado de veces que deseas que tu test se reintente en caso de fallo para los detalles de tu test de API, test de navegador o test de móvil.

Cuando hayas terminado de introducir los valores de reintentos predeterminados, haz clic en Save Default Retries (Guardar reintentos predeterminados).

Dispositivos móviles predeterminados

Elige o añade los dispositivos móviles predeterminados que desees utilizar en los detalles de tu test de móvil.

Cuando hayas terminado de introducir los dispositivos móviles predeterminados, haz clic en Save Default Devices (Guardar dispositivos predeterminados).

Permisos

De forma predeterminada, solo los usuarios con roles Admin y Standard de Datadog pueden acceder a la página Default Settings (Parámetros predeterminados) de Synthetic Monitoring. Para obtener acceso a la página Default Settings (Parámetros predeterminados), tu usuario debe pasar a tener uno de estos dos roles predeterminados.

Si utilizas la función de rol personalizado, añade tu usuario a cualquier rol personalizado que incluya los permisos synthetics_default_settings_read y synthetics_default_settings_write.

Parámetros de integración

Página de parámetros de integración

Integración de APM para tests de navegador

Los encabezados de la integración de APM de Datadog permiten que Datadog vincule los tests de navegador con APM.

Define a qué endpoints deseas enviar los encabezados de APM añadiendo una URL a la lista Value (Valor). Si el endpoint está siendo rastreado y está permitido, los resultados de su test de navegador se vinculan automáticamente a su traza (trace) correspondiente.

Utiliza * para permitir nombres de dominio más amplios. Por ejemplo, añadir https://*.datadoghq.com/* permite todo en https://datadoghq.com/. Cuando termines de añadir las URL, haz clic en Save APM Integration Settings (Guardar los parámetros de la integración de APM).

Para obtener más información, consulta Conectar trazas (traces) de Synthetics y APM.

Recopilación de datos de Synthetic y aplicaciones de RUM

Para permitir que Datadog recopile datos RUM de tus tests, haz clic en Enable Synthetic RUM data collection (Habilitar la recopilación de datos RUM de Synthetic). Si está deshabilitada, no podrás editar el parámetro RUM de la grabación de test de navegador. Para aplicar los cambios, haz clic en Save RUM Data Collection (Guardar recopilación de datos RUM).

Selecciona una aplicación predeterminada para que los nuevos tests de navegador envíen datos. Utiliza el menú desplegable Default Application (Aplicación predeterminada) para seleccionar una aplicación de RUM que recopile datos de tests de navegador. Para aplicar los cambios, haz clic en Save RUM Data Applications (Guardar aplicaciones de datos RUM).

Para obtener más información, consulta Explorar RUM y Session Replay.

Localizaciones privadas

Para obtener más información, consulta Ejecutar tests de Synthetic desde localizaciones privadas.

Variables globales

Las variables globales son variables a las que se puede acceder desde todos los tests Synthetic. Se pueden utilizar en todos los tests únicos, tests de API de varios pasos, tests de navegador y tests de aplicaciones móviles de tu conjunto de tests.

Para crear una variable global, ve a la pestaña Global Variables (Variables globales) de la página Synthetic Monitoring & Continuous Testing > Settings (Synthetic Monitoring & Continuous Testing > Parámetros) y haz clic en + New Global Variable (+ Nueva variable global).

Elige el tipo de variable que quieres crear:

  1. Introduce un Variable Name (Nombre de variable). Solo puedes utilizar mayúsculas, números y guiones bajos. No pueden existir varias variables con el mismo nombre.
  2. Opcionalmente, completa Description (Descripción) y en Tags (Etiquetas) selecciona etiquetas para asociar con tu variable.
  3. Indica el valor quieres darle a tu variable en Value (Valor).
  4. Si lo deseas, puedes utilizar las funciones integradas para asignar valores a tu variable. Por ejemplo, haz clic en la función integrada {{ alphabetic(n) }} para rellenar el campo Value (Valor) con un ejemplo de valor alfabético.
  5. Opcionalmente, habilita la ofuscación de tu variable para ocultar su valor en los resultados de los tests.
Valor específico de la variable global

Están disponibles las siguientes funciones integradas:

{{ numeric(n) }}
Genera una cadena numérica con n dígitos.
{{ alphabetic(n) }}
Genera una cadena alfabética con n letras.
{{ alphanumeric(n) }}
Genera una cadena alfanumérica con n caracteres.
{{ date(n unit, format) }}
Genera una fecha en uno de los formatos aceptados de Datadog con un valor correspondiente a la fecha UTC en la que se inicia el test, más o menos n unidades.
{{ timestamp(n, unit) }}
Genera una marca de tiempo en una de las unidades aceptadas de Datadog con un valor correspondiente a la marca de tiempo UTC en la que se inicia el test, más o menos n unidades.
{{ uuid }}
Genera un identificador único universal (UUID) versión 4.
{{ public-id }}
Inyecta el ID público de tu test.
{{ result-id }}
Inyecta el ID de resultado de la ejecución de tu test.

Puedes crear variables desde los tests de HTTP existentes parseando los encabezados y los cuerpos de respuesta asociados o desde tus tests de API de varios pasos existentes utilizando las variables extraídas.

Variables disponibles que puedes extraer de un test de API de varios pasos
  1. Completa Variable Name (Nombre de variable). Recuerda que solo puede contener mayúsculas, números y guiones bajos.

  2. Opcionalmente, completa Description (Descripción) y en Tags (Etiquetas) selecciona etiquetas para asociar con tu variable.

  3. Habilita la ofuscación de tu variable para ocultar su valor en los resultados de los tests (opcional).

  4. Elige el test del que quieres extraer la variable.

  5. Si utilizas un test de API de varios pasos, extrae tu variable local del test. Si utilizas un test de HTTP, extrae la variable del encabezado o del cuerpo de la respuesta.

    • Extrae el valor del Response Header (Encabezado de la respuesta): utiliza el encabezado completo de la respuesta de la variable o parséalo con un regex.
    • Extrae el valor del Response Body (Cuerpo de la respuesta): parsea el cuerpo de la respuesta con un regex, un jsonpath, un xpath o utiliza el cuerpo completo de la respuesta.
    • Extrae el valor del Response Status Code (Código de estado de la respuesta).

Además de para extraer un valor, también puedes utilizar un regex para parsear lo siguiente:

  • Activar la coincidencia no solo con la primera instancia de un patrón, sino con todas las instancias del patrón proporcionado.
  • Ignorar las mayúsculas y minúsculas del patrón coincidente.
  • Activar la coincidencia con cadenas en varias líneas.
  • Tratar el patrón de regex como unicode.
  • Permitir el uso de puntos para identificar nuevas líneas.
  • Activar la coincidencia con un índice concreto de un patrón de regex.
  • Sustituir el patrón coincidente por un valor proporcionado.
Parsear el cuerpo de la respuesta de un test de HTTP con una expresión regular

Los valores de la variable se actualizan cuando se ejecuta el test del que se extrajeron.

Para generar y utilizar un TOTP en tus tests, crea una variable global donde introduzcas una clave secreta o carga un código QR que te haya proporcionado tu proveedor de autenticación.

  1. En Choose variable type (Elegir el tipo de variable), selecciona MFA Token.
  2. En Define Variable (Definir la variable), completa Variable Name (Nombre de variable). Recuerda que el nombre solo puede contener mayúsculas, números y guiones bajos.
  3. Opcionalmente, completa Description (Descripción) y en Tags (Etiquetas) selecciona etiquetas para asociar con tu variable.
  4. Añade la clave secreta a tu variable o carga la imagen de un código QR.
  5. Haz clic en + Generate (+ Generar) para crear un OTP. También puedes copiar el OTP generado con el icono de copia.
Crear un token MFA

Para obtener más información acerca de MFA basada en TOTP en un test de navegador, consulta TOTP para autenticación multifactor (MFA) en tests de navegador.

Para completar un recorrido del usuario con una clave de paso de tus tests de Synthetic, crea una variable global de autenticador virtual. Esta variable global se usa para generar y grabar claves de paso para todos tus tests de navegador de Synthetic. Para obtener más información, consulta Uso de claves de paso en tests de navegador.

  1. Accede a la pestaña Global Variables (Variables globales) en Synthetic Monitoring & Continuous Testing > Settings (Synthetic Monitoring & Continuous Testing > Parámetros) y haz clic en + New Global Variable (+ Nueva variable global).

  2. En la sección Choose variable type (Elegir tipo de variable), selecciona Virtual Authenticator (Autenticador virtual).

  3. En la sección Specify variable details (Especificar los detalles de la variable), completa Variable Name (Nombre de variable). Recuerda que el nombre solo puede contener mayúsculas, números y guiones bajos.

  4. Opcionalmente, completa Description (Descripción) y en Tags (Etiquetas) selecciona etiquetas para asociar con tu variable. Datadog creará un autenticador virtual que empleará para generar y almacenar tus claves de paso.

  5. En la sección Permissions settings (Parámetros de permisos), restringe el acceso a tu variable basada en roles en tu organización. Para obtener más información acerca de los roles, consulta la documentación sobre Control de acceso basado en roles (RBAC).

Crear un autenticador virtual

Una vez creadas, las variables globales se pueden usar en todos los tests de Synthetic. Para importar tus variables globales en tu test, haz clic en + Variables (+ Variables), escribe {{ en un campo en el que quieras añadir la variable y selecciona tu variable global.

Para obtener más información sobre las variables, consulta Test de HTTP, Test de API de varios pasos, Test de navegador, Test de aplicación móvil y la documentación de los pasos del test de navegador.

Permisos

De forma predeterminada, solo los usuarios con los roles Admin y Standard en Datadog pueden acceder a la página Global Variables (Variables globales) de Synthetic Monitoring. Podrás acceder a la página Global Variables (Variables globales) si tu usuario pasa a tener uno de esos dos roles predeterminados.

Si utilizas la función de rol personalizado, añade tu usuario a cualquier rol personalizado que incluya los permisos synthetics_default_settings_read y synthetics_default_settings_write.

Restringir el acceso

La restricción de acceso está disponible para usuarios con roles personalizados en sus cuentas. Si usas la función de rol personalizado, añade tu usuario a cualquier rol personalizado que incluya los permisos synthetics_global_variable_read y synthetics_global_variable_write.

Puedes restringir el acceso a una variable global basada en roles en tu organización. Cuando creas una variable global, elige qué roles (además de tu usuario) tienen permisos de lectura y escritura sobre tu variable global en Permissions settings (Parámetros de permisos).

Restringir el acceso a una variable global

Parámetros de integración

Página de parámetros de integración

Integración de APM para tests de navegador

Permite que las URL incluyan encabezados de la integración de APM. Los encabezados de la integración de APM de Datadog permiten que Datadog vincule los tests de navegador con APM.

Define los endpoints que quieres enviar a los encabezados de APM introduciendo una URL en el campo Value (Valor). Si el endpoint se está rastreando y esta acción está permitida, los resultados de tu test de navegador se asocian automáticamente a la traza correspondiente.

Utiliza * para permitir nombres de dominio más amplios. Por ejemplo, añadir https://*.datadoghq.com/* permite todo en https://datadoghq.com/. Cuando termines de añadir las URL, haz clic en Save APM Integration Settings (Guardar los parámetros de la integración de APM).

Para obtener más información, consulta Conectar trazas (traces) de Synthetics y APM.

Recopilación de datos de Synthetic y aplicaciones de RUM

Para permitir que Datadog recopile datos RUM de tus tests, haz clic en Enable Synthetic RUM data collection (Habilitar la recopilación de datos RUM de Synthetic). Si la deshabilitas, no podrás editar el parámetro RUM de la grabación de test de navegador. Cuando termines de habilitar la recopilación de datos, haz clic en Save RUM Data Collection (Guardar la recopilación de datos RUM).

Selecciona una aplicación de RUM del menú desplegable Default Application (Aplicación predeterminada) que recopile datos del test de navegador. Cuando hayas especificado la aplicación predeterminada, haz clic en Save RUM Data Applications (Guardar aplicaciones de datos RUM).

Para obtener más información, consulta Explorar RUM y Session Replay.

Referencias adicionales

PREVIEWING: piotr_wolski/update-dsm-docs