Funciones y clases de biblioteca aplicables a todos los canaries Funciones y clases de biblioteca Node.js que solo se aplican a los canaries de la UI Clases y funciones de biblioteca Node.js que se aplican sólo a los canaries de la API

Funciones de la biblioteca disponibles para los scripts de canarios de Node.js mediante Puppeteer

En esta sección se describen las funciones de biblioteca disponibles para los scripts de canarios de Node.js.

Temas

Funciones y clases de biblioteca aplicables a todos los canaries
Funciones y clases de biblioteca Node.js que solo se aplican a los canaries de la UI
Clases y funciones de biblioteca Node.js que se aplican sólo a los canaries de la API

Funciones y clases de biblioteca aplicables a todos los canaries

Las siguientes funciones de biblioteca de CloudWatch Synthetics para Node.js son útiles para todos los canaries.

Clase de Synthetics

Las siguientes funciones para todos los canaries están en la clase de Synthetics.

Temas

addExecutionError(errorMessage, ex);
getCanaryName();
getCanaryArn();
getCanaryUserAgentString();
getRuntimeVersion();
getLogLevel();
setLogLevel();

addExecutionError(errorMessage, ex);

errorMessage describe el error y ex es la excepción que se ha encontrado

addExecutionError puede usarse para establecer errores de ejecución para el valor controlado. Se produce un error en el valor controlado sin interrumpir la ejecución del script. Tampoco afecta a las métricas de successPercent.

Debe realizar un seguimiento de los errores como errores de ejecución sólo si no son importantes para indicar el éxito o el error del script valor controlado.

A continuación, se muestra un ejemplo del uso de un addExecutionError. Está supervisando la disponibilidad de su punto de conexión y tomando capturas de pantalla después de que la página se haya cargado. Debido a que el hecho de no tomar una captura de pantalla no determina la disponibilidad del punto de enlace, puede detectar cualquier error que encuentre al tomar capturas de pantalla y agregarlos como errores de ejecución. Las métricas de disponibilidad seguirán indicando que el punto de conexión está activo y en ejecución, pero el estado del valor controlado se marcará como fallido. El siguiente bloque de código de muestra detecta dicho error y lo agrega como un error de ejecución.


try {
    await synthetics.takeScreenshot(stepName, "loaded");
} catch(ex) {
    synthetics.addExecutionError('Unable to take screenshot ', ex);
}

getCanaryName();

Devuelve el nombre del valor controlado.

getCanaryArn();

Devuelve el ARN del valor controlado.

getCanaryUserAgentString();

Devuelve el agente de usuario personalizado del valor controlado.

getRuntimeVersion();

Esta función está disponible en la versión de tiempo de ejecución syn-nodejs-puppeteer-3.0 y en posteriores. Devuelve la versión de tiempo de ejecución de Synthetics del valor controlado. Por ejemplo, el valor de devuelto podría ser syn-nodejs-puppeteer-3.0.

getLogLevel();

Recupera el nivel de registro actual para la biblioteca de Synthetics. Los valores posibles son los siguientes:

0: depuración
1: información
2: advertencia
3: error

Ejemplo:


let logLevel = synthetics.getLogLevel();

setLogLevel();

Establece el nivel de registro de la biblioteca de Synthetics. Los valores posibles son los siguientes:

0: depuración
1: información
2: advertencia
3: error

Ejemplo:


synthetics.setLogLevel(0);

Clase SyntheticsConfiguration

Esta clase solo está disponible en la versión de tiempo de ejecución de syn-nodejs-2.1 o en posteriores.

La clase SyntheticsConfiguration se puede utilizar para configurar el comportamiento de las funciones de biblioteca de Synthetics. Por ejemplo, puede utilizar esta clase para configurar la función executeStep() para no tomar capturas de pantalla.

Pueden establecerse configuraciones de CloudWatch Synthetics a nivel global, que se aplican a todos los pasos de canaries. También se pueden anular estas configuraciones en el nivel de paso al pasar los pares clave y valor de configuración.

Se pueden pasar opciones en el nivel de paso. Para ver ejemplos, consulte async executeStep(stepName, functionToExecute, [stepConfig]); y executeHttpStep(stepName, requestOptions, [callback], [stepConfig]).

Temas

setConfig(options)
Supervisión visual

setConfig(options)

options es un objeto, que es un conjunto de opciones configurables para el valor controlado. En las siguientes secciones se explican los posibles campos en options.

setConfig(options) para todos los canaries

Para los canaries que utilizan syn-nodejs-puppeteer-3.2 o posteriores, las (options) (opciones) para setConfig pueden incluir los siguientes parámetros:

includeRequestHeaders (booleano): si se deben incluir cabeceras de solicitud en el informe. El valor predeterminado es false.
includeResponseHeaders (booleano): si se deben incluir cabeceras de respuesta en el informe. El valor predeterminado es false.
restrictedHeaders (matriz): lista de valores de cabecera que se deben ignorar si se incluyen cabeceras. Esto aplica a las cabeceras de solicitud y respuesta. Por ejemplo, puede ocultar las credenciales al pasar includeRequestHeaders como true y restrictedHeaders como ['Authorization'].
includeRequestBody (booleano): si se debe incluir el cuerpo de la solicitud en el informe. El valor predeterminado es false.
includeResponseBody (booleano): si se debe incluir el cuerpo de respuesta en el informe. El valor predeterminado es false.

Si habilita includeResponseBody o logResponseBody, el objeto de datos no se devuelve en la respuesta de algunas API, como los clientes de la versión 3 de aws-sdk. Esto se debe a una limitación de Node.js y al tipo de objeto de respuesta utilizado.

setConfig(options) con respecto a las métricas de CloudWatch

Para los valores controlados que utilizan syn-nodejs-puppeteer-3.1 o posteriores, las (opciones) para setConfig pueden incluir los siguientes parámetros booleanos que determinan qué métricas publica el valor controlado. El valor predeterminado para cada una de estas opciones es true. Las opciones que comienzan con aggregated determinan si la métrica se emite sin la dimensión CanaryName. Se pueden utilizar estas métricas para ver los resultados agregados de todos los canaries. Las otras opciones determinan si la métrica se emite con la dimensión CanaryName. Se pueden usar estas métricas para ver los resultados de cada valor controlado individualmente.

Para obtener una lista de las métricas de CloudWatch que los canaries emiten, consulte Métricas de CloudWatch que los canaries publican.

failedCanaryMetric (booleano): si se debe emitir la métrica Failed (con la dimensión CanaryName) para este valor controlado. El valor predeterminado es true.
failedRequestsMetric (booleano): si se debe emitir la métrica Failed requests (con la dimensión CanaryName) para este valor controlado. El valor predeterminado es true.
_2xxMetric (booleano): si se debe emitir la métrica 2xx (con la dimensión CanaryName) para este valor controlado. El valor predeterminado es true.
_4xxMetric (booleano): si se debe emitir la métrica 4xx (con la dimensión CanaryName) para este valor controlado. El valor predeterminado es true.
_5xxMetric (booleano): si se debe emitir la métrica 5xx (con la dimensión CanaryName) para este valor controlado. El valor predeterminado es true.
stepDurationMetric (booleano): si se debe emitir la métrica Step duration (con las dimensiones CanaryName y StepName) para este valor controlado. El valor predeterminado es true.
stepSuccessMetric (booleano): si se debe emitir la métrica Step success (con las dimensiones CanaryName y StepName) para este valor controlado. El valor predeterminado es true.
aggregatedFailedCanaryMetric (booleano): si se debe emitir la métrica Failed (sin la dimensión CanaryName) para este valor controlado. El valor predeterminado es true.
aggregatedFailedRequestsMetric (booleano): si se debe emitir la métrica Failed Requests (sin la dimensión CanaryName) para este valor controlado. El valor predeterminado es true.
aggregated2xxMetric (booleano): si se debe emitir la métrica 2xx (sin la dimensión CanaryName) para este valor controlado. El valor predeterminado es true.
aggregated4xxMetric (booleano): si se debe emitir la métrica 4xx (sin la dimensión CanaryName) para este valor controlado. El valor predeterminado es true.
aggregated5xxMetric (booleano): si se debe emitir la métrica 5xx (sin la dimensión CanaryName) para este valor controlado. El valor predeterminado es true.
visualMonitoringSuccessPercentMetric (booleano): si se debe emitir la métrica visualMonitoringSuccessPercent para este valor controlado. El valor predeterminado es true.
visualMonitoringTotalComparisonsMetric (booleano): si se debe emitir la métrica visualMonitoringTotalComparisons para este valor controlado. El valor predeterminado es false.
includeUrlPassword (booleano): si se debe incluir una contraseña que aparezca en la dirección URL. De forma predeterminada, las contraseñas que aparecen en las direcciones URL se eliminan de los registros e informes para evitar que se divulgue información confidencial. El valor predeterminado es false.
restrictedUrlParameters (matriz): lista de la ruta URL o los parámetros de consulta que se van a editar. Esto aplica a las URL que aparecen en registros, informes y en errores. El parámetro no distingue entre mayúsculas y minúsculas. Puede pasar un asterisco (*) como un valor para editar todos los valores de ruta de URL y los parámetros de consulta. El valor predeterminado es una matriz vacía.
logRequest (booleano): si se debe registrar cada solicitud en los registros de valores controlados. Para canaries de UI, esto registra cada solicitud que el navegador envía. El valor predeterminado es true.
logResponse (booleano): si se debe registrar cada respuesta en los registros de valores controlados. Para canaries de UI, esto registra todas las respuestas que el navegador recibe. El valor predeterminado es true.
logRequestBody (booleano): si se deben registrar los cuerpos de la solicitud junto con las solicitudes en los registros de valores controlados. Esta configuración sólo aplica si logRequest es true. El valor predeterminado es false.
logResponseBody (booleano): si se deben registrar los cuerpos de respuesta junto con las respuestas en los registros de valores controlados. Esta configuración sólo aplica si logResponse es true. El valor predeterminado es false.

Si habilita includeResponseBody o logResponseBody, el objeto de datos no se devuelve en la respuesta de algunas API, como los clientes de la versión 3 de aws-sdk. Esto se debe a una limitación de Node.js y al tipo de objeto de respuesta utilizado.
logRequestHeaders (booleano): si se deben registrar cabeceras de solicitud junto con las solicitudes en registros de valores controlados. Esta configuración sólo aplica si logRequest es true. El valor predeterminado es false.

Debe tener en cuenta que includeRequestHeaders habilita cabeceras en artefactos.
logResponseHeaders (booleano): si se deben registrar cabeceras de respuesta junto con las respuestas en los registros de valores controlados. Esta configuración sólo aplica si logResponse es true. El valor predeterminado es false.

Debe tener en cuenta que includeResponseHeaders habilita cabeceras en artefactos.

nota

Las métricas de Duration y de SuccessPercent se emiten siempre para cada valor controlado con la métrica CanaryName y sin ella.

Métodos para habilitar o desactivar métricas

disableAggregatedRequestMetrics()

Desactiva que el valor controlado emita todas las métricas de solicitud que se emiten sin dimensión CanaryName.

disableRequestMetrics()

Deshabilita todas las métricas de solicitud, incluidas las métricas por valor controlado y las métricas agregadas en todos los valores controlados.

disableStepMetrics()

Desactiva todas las métricas de pasos, incluidas las métricas de éxito y de duración de los pasos.

enableAggregatedRequestMetrics()

Permite que el valor controlado emita todas las métricas de solicitud que se emiten sin dimensión CanaryName.

enableRequestMetrics()

Habilita todas las métricas de solicitud, incluidas las métricas por valor controlado y las métricas agregadas en todos los valores controlados.

enableStepMetrics()

Habilita todas las métricas de pasos, incluidas las métricas de éxito y de duración de los pasos.

get2xxMetric()

Muestra si el valor controlado emite una métrica 2xx con la dimensión CanaryName.

get4xxMetric()

Muestra si el valor controlado emite una métrica 4xx con la dimensión CanaryName.

get5xxMetric()

Muestra si el valor controlado emite una métrica 5xx con la dimensión CanaryName.

getAggregated2xxMetric()

Muestra si el valor controlado emite una métrica 2xx sin dimensión.

getAggregated4xxMetric()

Muestra si el valor controlado emite una métrica 4xx sin dimensión.

getAggregatedFailedCanaryMetric()

Muestra si el valor controlado emite una métrica Failed sin dimensión.

getAggregatedFailedRequestsMetric()

Muestra si el valor controlado emite una métrica Failed requests sin dimensión.

getAggregated5xxMetric()

Muestra si el valor controlado emite una métrica 5xx sin dimensión.

getFailedCanaryMetric()

Muestra si el valor controlado emite una métrica Failed con la dimensión CanaryName.

getFailedRequestsMetric()

Muestra si el valor controlado emite una métrica Failed requests con la dimensión CanaryName.

getStepDurationMetric()

Muestra si el valor controlado emite una métrica Duration con la dimensión CanaryName para este valor controlado.

getStepSuccessMetric()

Muestra si el valor controlado emite una métrica StepSuccess con la dimensión CanaryName para este valor controlado.

with2xxMetric(_2xxMetric)

Acepta un argumento booleano, que especifica si se emitirá una métrica 2xx con la dimensión CanaryName para este valor controlado.

with4xxMetric(_4xxMetric)

Acepta un argumento booleano, que especifica si se emitirá una métrica 4xx con la dimensión CanaryName para este valor controlado.

with5xxMetric(_5xxMetric)

Acepta un argumento booleano, que especifica si se emitirá una métrica 5xx con la dimensión CanaryName para este valor controlado.

withAggregated2xxMetric(aggregated2xxMetric)

Acepta un argumento booleano, que especifica si se emitirá una métrica 2xx sin dimensión para este valor controlado.

withAggregated4xxMetric(aggregated4xxMetric)

Acepta un argumento booleano, que especifica si se emitirá una métrica 4xx sin dimensión para este valor controlado.

withAggregated5xxMetric(aggregated5xxMetric)

Acepta un argumento booleano, que especifica si se emitirá una métrica 5xx sin dimensión para este valor controlado.

withAggregatedFailedCanaryMetric(aggregatedFailedCanaryMetric)

Acepta un argumento booleano, que especifica si se emitirá una métrica Failed sin dimensión para este valor controlado.

withAggregatedFailedRequestsMetric(aggregatedFailedRequestsMetric)

Acepta un argumento booleano, que especifica si se emitirá una métrica Failed requests sin dimensión para este valor controlado.

withFailedCanaryMetric(failedCanaryMetric)

Acepta un argumento booleano, que especifica si se emitirá una métrica Failed con la dimensión CanaryName para este valor controlado.

withFailedRequestsMetric(failedRequestsMetric)

Acepta un argumento booleano, que especifica si se emitirá una métrica Failed requests con la dimensión CanaryName para este valor controlado.

withStepDurationMetric(stepDurationMetric)

Acepta un argumento booleano, que especifica si se emitirá una métrica Duration con la dimensión CanaryName para este valor controlado.

withStepSuccessMetric(stepSuccessMetric)

Acepta un argumento booleano, que especifica si se emitirá una métrica StepSuccess con la dimensión CanaryName para este valor controlado.

Métodos para habilitar o desactivar otras características

withHarFile()

Acepta un argumento booleano, que especifica si se debe crear un archivo HAR para este valor controlado.

withStepsReport()

Acepta un argumento booleano, que especifica si se debe informar de un resumen de ejecución de pasos para este valor controlado.

withIncludeUrlPassword()

Acepta un argumento booleano, que especifica si se deben incluir las contraseñas que aparecen en las URL de los registros e informes.

withRestrictedUrlParameters()

Acepta una matriz de ruta de URL o parámetros de consulta para editar. Esto aplica a las URL que aparecen en registros, informes y en errores. Se puede pasar un asterisco (*) como un valor para redactar todos los valores de ruta de URL y los parámetros de consulta

withLogRequest()

Acepta un argumento booleano, que especifica si se debe registrar cada solicitud en los registros del valor controlado.

withLogResponse()

Acepta un argumento booleano, que especifica si se debe registrar cada respuesta en los registros del valor controlado.

withLogRequestBody()

Acepta un argumento booleano, que especifica si se debe registrar cada cuerpo de la solicitud en los registros del valor controlado.

withLogResponseBody()

Acepta un argumento booleano, que especifica si se debe registrar cada cuerpo de respuesta en los registros del valor controlado.

withLogRequestHeaders()

Acepta un argumento booleano, que especifica si se debe registrar cada cabecera de solicitud en los registros del valor controlado.

withLogResponseHeaders()

Acepta un argumento booleano, que especifica si se debe registrar cada cabecera de respuesta en los registros del valor controlado.

getHarFile()

Muestra si el valor controlado crea un archivo HAR.

getStepsReport()

Muestra si el valor controlado informa un resumen de ejecución de pasos.

getIncludeUrlPassword()

Muestra si el valor controlado incluye contraseñas que aparecen en las URL en los registros e informes.

getRestrictedUrlParameters()

Muestra si el valor controlado redacta la ruta de URL o los parámetros de consulta.

getLogRequest()

Muestra si el valor controlado registra cada solicitud en los registros del valor controlado.

getLogResponse()

Muestra si el valor controlado registra cada respuesta en los registros del valor controlado.

getLogRequestBody()

Muestra si el valor controlado registra cada cuerpo de la solicitud en los registros del valor controlado.

getLogResponseBody()

Muestra si el valor controlado registra cada cuerpo de respuesta en los registros del valor controlado.

getLogRequestHeaders()

Muestra si el valor controlado registra cada cabecera de solicitud en los registros del valor controlado.

getLogResponseHeaders()

Muestra si el valor controlado registra cada cabecera de respuesta en los registros del valor controlado.

Funciones para todos los valores controlados

withIncludeRequestHeaders(includeRequestHeaders)
withIncludeResponseHeaders(includeResponseHeaders)
withRestrictedHeaders(restrictedHeaders)
withIncludeRequestBody(includeRequestBody)
withIncludeResponseBody(includeResponseBody)
enableReportingOptions(): habilita todas las opciones de informes-- includeRequestHeaders, includeResponseHeaders, includeRequestBody, y includeResponseBody.
disableReportingOptions(): desactiva todas las opciones de informes-- includeRequestHeaders, includeResponseHeaders, includeRequestBody, y includeResponseBody.

setConfig(options) para canaries de la UI

Para canaries de la UI, setConfig puede incluir los siguientes parámetros booleanos:

continueOnStepFailure (booleano): si se debe continuar con la ejecución del script valor controlado después de que un paso falle (esto se refiere a la función executeStep). Si algún paso falla, la ejecución del valor controlado seguirá marcándose como fallida. El valor predeterminado es false.
harFile (booleano): si se crea un archivo HAR. El valor predeterminado es True.
screenshotOnStepStart (booleano): si se debe tomar una captura de pantalla antes de comenzar un paso.
screenshotOnStepSuccess (booleano): si se debe tomar una captura de pantalla después de completar un paso correctamente.
screenshotOnStepFailure (booleano): si se debe tomar una captura de pantalla después de que un paso falla.

Métodos para habilitar o desactivar las capturas de pantalla

disableStepScreenshots()

Deshabilita todas las opciones de captura de pantalla (screenshotOnStepStart, screenshotOnStepSuccess, y screenshotOnStepFailure).

enableStepScreenshots()

Habilita todas las opciones de captura de pantalla (screenshotOnStepStart, screenshotOnStepSuccess, y screenshotOnStepFailure). Estos métodos no están habilitados de forma predeterminada.

getScreenshotOnStepFailure()

Muestra si el valor controlado toma una captura de pantalla después de que un paso falla.

getScreenshotOnStepStart()

Muestra si el valor controlado toma una captura de pantalla antes de iniciar un paso.

getScreenshotOnStepSuccess()

Muestra si el valor controlado toma una captura de pantalla después de completar un paso correctamente.

withScreenshotOnStepStart(screenshotOnStepStart)

Acepta un argumento booleano, que indica si se debe tomar una captura de pantalla antes de iniciar un paso.

withScreenshotOnStepSuccess(screenshotOnStepSuccess)

Acepta un argumento booleano, que indica si se debe tomar una captura de pantalla después de completar un paso correctamente.

withScreenshotOnStepFailure(screenshotOnStepFailure)

Acepta un argumento booleano, que indica si se debe tomar una captura de pantalla después de que un paso falla.

Uso en valores controlados de la IU

Primero, importe la relación de Synthetics y obtenga la configuración.


// Import Synthetics dependency
const synthetics = require('Synthetics');

// Get Synthetics configuration
const synConfig = synthetics.getConfiguration();

A continuación, establezca la configuración para cada opción mediante llamadas al método SetConfig con una de las siguientes opciones.


// Set configuration values
    synConfig.setConfig({
        screenshotOnStepStart: true, 
        screenshotOnStepSuccess: false,
        screenshotOnStepFailure: false
    });


synConfig.withScreenshotOnStepStart(false).withScreenshotOnStepSuccess(true).withScreenshotOnStepFailure(true)

Para deshabilitar todas las capturas de pantalla, utilice la función disableStepScreenshots() como en este ejemplo.


synConfig.disableStepScreenshots();

Puede habilitar y desactivar las capturas de pantalla en cualquier punto del código. Por ejemplo, para desactivar las capturas de pantalla solo para un paso, se deben desactivar antes de ejecutar ese paso y habilitarlas después del paso.

setConfig(options) para canaries de la API

Para los canaries de la API, setConfig puede incluir los siguientes parámetros booleanos:

continueOnHttpStepFailure (booleano): si se continúa con la ejecución del script valor controlado después de que se produce un error en un paso HTTP (esto se refiere a la función executeHttpStep). Si algún paso falla, la ejecución del valor controlado seguirá marcándose como fallida. El valor predeterminado es true.

Supervisión visual

La supervisión visual compara las capturas de pantalla que se toman durante una ejecución de un valor controlado con las capturas de pantalla que se toman durante una ejecución de un valor controlado de línea de base. Si la discrepancia entre las dos capturas de pantalla está más allá de un porcentaje umbral, el valor controlado falla y se podrán ver las áreas con diferencias resaltadas en color en el informe de ejecución del valor controlado. La supervisión visual es compatible con canaries que ejecutan syn-puppeteer-node-3.2 y versiones posteriores. Por el momento no es compatible con canaries que ejecutan Python y Selenium.

Para habilitar la supervisión visual, agregue la siguiente línea de código al script valor controlado. Para obtener más información, consulta Clase SyntheticsConfiguration.


syntheticsConfiguration.withVisualCompareWithBaseRun(true);

La primera vez que el valor controlado se ejecuta correctamente después de agregar esta línea al script, utiliza las capturas de pantalla que se toman durante esa ejecución como línea de base para la comparación. Después de la primera ejecución del valor controlado, se puede usar la consola de CloudWatch para editar el valor controlado para realizar cualquiera de las siguientes acciones:

Establecer la siguiente ejecución del valor controlado como la nueva línea de base.
Establecer límites en la captura de pantalla de línea de base actual para designar áreas de la captura de pantalla que se ignorarán durante las comparaciones visuales.
Eliminar una captura de pantalla de ser utilizada para la supervisión visual.

Para obtener más información sobre cómo usar la consola de CloudWatch para editar un valor controlado, consulte Edición o eliminación de un valor controlado.

Otras opciones para la supervisión visual

syntheticsConfiguration.withVisualVarianceThresholdPercentage(desiredPercentage)

Establezca el porcentaje aceptable para la desviación de captura de pantalla en las comparaciones visuales.

syntheticsConfiguration.withVisualVarianceHighlightHexColor(“#fafa00”)

Establezca el color de resaltado que designa las áreas de desviación cuando vea los informes de ejecución del valor controlado que utilizan supervisión visual.

syntheticsConfiguration.withFailCanaryRunOnVisualVariance(failCanary)

Establezca si el valor controlado falla o no cuando hay una diferencia visual superior al umbral. El valor predeterminado es que el valor controlado falle.

Registrador de Synthetics

SyntheticsLogger escribe registros tanto en la consola como en un archivo de registro local, en el mismo nivel de registro. Este archivo de registro se escribe en ambas ubicaciones solo si el nivel de registro coincide con el deseado para la función de registro a la que se llamó o está por debajo de este.

Los valores “DEBUG:“, “INFO:“, etc. se anteponen a las instrucciones de registro del archivo de registro local para que coincidan con el nivel de registro de la función a la que se llamó.

Puede utilizar SyntheticsLogger si desea ejecutar la biblioteca de Synthetics en el mismo nivel de registro que el registro de valores controlados de Synthetics.

No es necesario que se utilice SyntheticsLogger para crear un archivo de registros que se carga en la ubicación de resultados de S3. En su lugar, puede crear un archivo de registro distinto en la carpeta /tmp. Los archivos creados en la carpeta /tmp se cargan en la ubicación de resultados de S3 como artefactos.

Para utilizar el registrador de la biblioteca de Synthetics:


const log = require('SyntheticsLogger');

Definiciones de funciones útiles:

log.debug(mensaje, ex);