En este documento, se describen las plantillas y el código de muestra disponibles para ayudarte a crear monitores sintéticos. Las funciones de muestra están disponibles en el repositorio Google Cloud/synthetics-sdk-nodjs
de GitHub.
Si escribes pruebas y no dependes de una plantilla, asegúrate de que la prueba sea exitosa, a menos que se arroje una Error
. Te recomendamos que uses la biblioteca Assert
para asegurarte de que, cuando se produzcan fallas, se atribuyan a la línea de código adecuada.
Plantillas genéricas
Las plantillas genéricas están configuradas para recopilar datos de registro y seguimiento de las solicitudes HTTP salientes. La solución aprovecha el módulo auto-instrumentation-node de OpenTelemetry y el registrador de winston. Debido a la dependencia de los productos de código abierto, es posible que haya cambios en la estructura de los datos de seguimiento y registro. Por lo tanto, los datos de registro y de seguimiento recopilados solo deben usarse con fines de depuración.
Puedes implementar tu propio enfoque para recopilar datos de seguimiento y de registro de las solicitudes HTTP salientes. Para ver un ejemplo de un enfoque personalizado, consulta la clase SyntheticAutoInstrumentation
.
Muestra genérica de Node.js
En el ejemplo generic-synthetic-nodejs
, se muestra cómo consultar una URL. Esta muestra contiene lo mismo que la función predeterminada
que muestra la consola de Google Cloud.
Para ver la muestra completa de generic-synthetic-nodejs
, haz clic en more_vert Más
y, luego, selecciona Ver en GitHub:
Muestra de TypeScript
En el ejemplo generic-synthetic-typescript
, se muestra cómo consultar una URL.
Para ver la muestra completa de generic-synthetic-typescript
, haz clic en more_vert Más
y, luego, selecciona Ver en GitHub:
Plantilla de Puppeteer
Si usas Puppeteer, te recomendamos comenzar con la muestra de generic-puppeteer-nodejs
.
Configuración obligatoria de Puppeteer
Para utilizar Puppeteer, asegúrate de completar los siguientes pasos:
Incluye
.puppeteerrc.cjs
en el directorio del código fuente de tu Cloud Function:Agrega la siguiente secuencia de comandos al archivo
package.json
de la Cloud Function:"scripts": { "gcp-build": "node node_modules/puppeteer/install.mjs" },
Muestra de Puppeteer
En el ejemplo generic-puppeteer-nodejs
, se muestra cómo usar Puppeteer con tu Cloud Function.
Para ver la muestra completa de generic-puppeteer-nodejs
, haz clic en more_vert Más
y, luego, selecciona Ver en GitHub:
Plantilla de Selenium WebDriver
Si usas Selenium WebDriver, considera comenzar con la muestra de generic-selenium-nodejs
. La muestra, que está disponible en GitHub, incluye un archivo index.js
y package.json
.
Para ver la muestra completa de generic-selenium-nodejs
, haz clic en more_vert Más
y, luego, selecciona Ver en GitHub:
Plantilla Mocha
Si escribes pruebas que se basan en la plantilla Mocha, considera si una secuencia de pruebas debe continuar o detenerse cuando se produce una falla. Para detener una secuencia de pruebas después de una falla, debes configurar la marca bail
.
Para ver un ejemplo de extremo a extremo que incluya la implementación de una API, un paquete de pruebas de Mocha de muestra para los extremos de la API y cómo configurar el monitor sintético, consulta el blog Instructivo de supervisión sintética de Google Cloud.
En el ejemplo de mocha-url-ok
, se muestra cómo una Cloud Function puede invocar un paquete de pruebas Mocha y se proporciona un paquete de pruebas de muestra.
Para ver la muestra completa de mocha-url-ok
, haz clic en more_vert Más
y, luego, selecciona Ver en GitHub:
Plantilla de vínculo roto
En el ejemplo broken-links-ok
, se muestra cómo configurar un verificador de vínculos rotos.
Para esta plantilla, solo debes especificar los valores del objeto options
. Este objeto especifica el URI que se probará y los parámetros de la prueba. Para obtener más detalles, consulta el siguiente código:
Si usas Puppeteer, asegúrate de completar los pasos de Configuración obligatoria de Puppeteer.
Para ver la muestra completa de broken-links-ok
, haz clic en more_vert Más
y, luego, selecciona Ver en GitHub:
¿Qué sigue?
- Cómo crear un monitor sintético
- Crea un verificador de vínculos rotos
- Cómo administrar monitores sintéticos
- Cómo explorar los resultados del monitor sintético