En este documento se describen las plantillas y el código de muestra disponibles para ayudarte a crear monitores sintéticos. Las funciones de ejemplo están disponibles en el repositorio de GitHub Google Cloud/synthetics-sdk-nodjs
.
Si escribes pruebas y no utilizas una plantilla, asegúrate de que la prueba se supere a menos que se produzca una Error
. Te recomendamos que uses la biblioteca Assert
para asegurarte de que, cuando se produzcan errores, se atribuyan a la línea de código adecuada.
Plantillas genéricas
Las plantillas genéricas se configuran para recoger datos de trazas y registros de solicitudes HTTP salientes. La solución utiliza el módulo auto-instrumentation-node de OpenTelemetry y el registrador Winston. Debido a la dependencia de los productos de código abierto, es posible que se produzcan cambios en la estructura de los datos de traza y de registro. Por lo tanto, los datos de registro y de seguimiento recogidos solo deben usarse con fines de depuración.
Puedes implementar tu propio método para recoger datos de trazas y registros de solicitudes HTTP salientes. Para ver un ejemplo de enfoque personalizado, consulta la clase SyntheticAutoInstrumentation
.
Ejemplo genérico de Node.js
El ejemplo generic-synthetic-nodejs
muestra cómo consultar una URL. Este ejemplo contiene lo mismo que la función predeterminada
que muestra la consola Google Cloud . Para ver el ejemplo completo, haz clic en more_vert Más y, a continuación, selecciona Ver en GitHub.
Ejemplo de TypeScript
En el ejemplo de generic-synthetic-typescript
se muestra cómo consultar una URL. Para ver el ejemplo completo, haz clic en more_vert Más y, a continuación, selecciona Ver en GitHub.
Plantilla de Puppeteer
Si usas Puppeteer, te recomendamos que empieces con el ejemplo de generic-puppeteer-nodejs
.
Configuración obligatoria de Puppeteer
Para usar Puppeteer, asegúrate de que has completado los siguientes pasos:
Incluye
.puppeteerrc.cjs
en el directorio de origen de tu función de Cloud Run:Añade la siguiente secuencia de comandos al archivo
package.json
de tu función de Cloud Run:"scripts": { "gcp-build": "node node_modules/puppeteer/install.mjs" },
Ejemplo de marionetista
El ejemplo generic-puppeteer-nodejs
muestra cómo usar Puppeteer con tu función de Cloud Run. Para ver el ejemplo completo, haz clic en more_vert Más y, a continuación, selecciona Ver en GitHub.
Plantilla de Selenium WebDriver
Si usas Selenium WebDriver, te recomendamos que empieces con el ejemplo de generic-selenium-nodejs
. El ejemplo, que está disponible en GitHub, incluye un archivo index.js
y un archivo package.json
.
Para ver el ejemplo completo, haz clic en more_vert Más y, a continuación, selecciona Ver en GitHub.
Plantilla Mocha
Si escribes pruebas que dependen de la plantilla Mocha,
piensa si una secuencia de pruebas debe continuar o detenerse cuando se
produce un error. Para detener una secuencia de pruebas después de un error, debes definir la marca bail
.
Para ver un ejemplo completo que incluye el despliegue de una API, un conjunto de pruebas de Mocha de ejemplo para los endpoints de la API y cómo configurar el monitor sintético, consulta la entrada de blog Google Cloud Tutorial de monitorización sintética.
En el ejemplo mocha-url-ok
se muestra cómo una función de Cloud Run puede invocar una suite de pruebas de Mocha y se proporciona una suite de pruebas de ejemplo.
Para ver el ejemplo completo, haz clic en more_vert Más y, a continuación, selecciona Ver en GitHub.
Plantilla de enlace roto
En el ejemplo de broken-links-ok
se muestra cómo configurar un comprobador de enlaces rotos.
En esta plantilla, solo debe especificar los valores del objeto options
. Este objeto especifica el URI que se va a probar y los parámetros de la prueba.
Si usas Puppeteer, asegúrate de completar los pasos de la configuración obligatoria de Puppeteer.
Para ver el ejemplo completo, haz clic en more_vert Más y, a continuación, selecciona Ver en GitHub.
Siguientes pasos
- Crear un monitor sintético
- Crear un comprobador de enlaces rotos
- Gestionar monitores sintéticos
- Consultar los resultados de los monitores sintéticos