Esempi per i monitoraggi sintetici

Questo documento descrive i modelli e il codice campione disponibili per aiutarti a creare monitor sintetici. Le funzioni di esempio sono disponibili nel Google Cloud/synthetics-sdk-nodjs repository GitHub.

Se scrivi test e non utilizzi un modello, assicurati che il test venga superato a meno che non venga generato un Error. Ti consigliamo di utilizzare la Assert libreria per assicurarti che in caso di errori, questi vengano attribuiti alla riga di codice corretta.

Avviso: assicurati di aggiornare il valore del campo url prima di eseguire il deployment del codice campione. Non impostare questo campo su https://www.google.com.

Modelli generici

I modelli generici sono configurati per raccogliere dati di traccia e log per le richieste HTTP in uscita. La soluzione utilizza il modulo OpenTelemetry auto-instrumentation-node e il logger Winston. A causa della dipendenza dai prodotti open source, è probabile che la struttura dei dati di traccia e log cambi. Pertanto, i dati di traccia e log raccolti devono essere utilizzati solo a scopo di debug.

Nota: per attivare la raccolta di log e tracce, il codice deve importare il instantiateAutoInstrumentation e richiamare il instantiateAutoInstrumentation() prima di eseguire qualsiasi altra azione. Inoltre, assicurati che il codice specifichi logger come gestore di callback asincrono.

Puoi implementare il tuo approccio per raccogliere dati di traccia e log per le richieste HTTP in uscita. Per un esempio di approccio personalizzato, consulta la classe SyntheticAutoInstrumentation.

Esempio Node.js generico

L'esempio generic-synthetic-nodejs mostra come eseguire una query su un URL. Questo esempio contiene lo stesso della funzione predefinita visualizzata dalla Google Cloud console. Per visualizzare l'esempio completo, nella barra degli strumenti dell'esempio, seleziona il logo di GitHub.

const { instantiateAutoInstrumentation, runSyntheticHandler } = require('@google-cloud/synthetics-sdk-api');
// Run instantiateAutoInstrumentation before any other code runs, to get automatic logs and traces
instantiateAutoInstrumentation();
const functions = require('@google-cloud/functions-framework');
const axios = require('axios');
const assert = require('node:assert');

functions.http('SyntheticFunction', runSyntheticHandler(async ({logger, executionId}) => {
  /*
   * This function executes the synthetic code for testing purposes.
   * If the code runs without errors, the synthetic test is considered successful.
   * If an error is thrown during execution, the synthetic test is considered failed.
   */
  logger.info('Making an http request using synthetics, with execution id: ' + executionId);
  const url = 'https://www.google.com/'; // URL to send the request to
  return await assert.doesNotReject(axios.get(url));
}));

Esempio TypeScript

L'esempio generic-synthetic-typescript mostra come eseguire una query su un URL. Per visualizzare l'esempio completo, nella barra degli strumenti dell'esempio, seleziona il logo di GitHub.

import {runSyntheticHandler, instantiateAutoInstrumentation} from '@google-cloud/synthetics-sdk-api'
// Run instantiateAutoInstrumentation before any other code runs, to get automatic logs and traces
instantiateAutoInstrumentation();
import * as ff from '@google-cloud/functions-framework';
import axios from 'axios';
import assert from 'node:assert';
import {Logger} from 'winston';

ff.http('SyntheticFunction', runSyntheticHandler(async ({logger, executionId}: {logger: Logger, executionId: string|undefined}) => {
  /*
   * This function executes the synthetic code for testing purposes.
   * If the code runs without errors, the synthetic test is considered successful.
   * If an error is thrown during execution, the synthetic test is considered failed.
   */
  logger.info('Making an http request using synthetics, with execution id: ' + executionId);
  const url = 'https://www.google.com/'; // URL to send the request to
  return await assert.doesNotReject(axios.get(url));
}));

Modello Puppeteer

Se utilizzi Puppeteer, ti consigliamo di iniziare con l' generic-puppeteer-nodejs esempio.

Nota: le impostazioni predefinite per la memoria, la CPU e la sicurezza allocate potrebbero non essere sufficienti. Ti consigliamo di impostare la memoria su almeno 1 GiB.

Configurazione di Puppeteer richiesta

Per utilizzare Puppeteer, assicurati di completare i seguenti passaggi:

1. Includi .puppeteerrc.cjs nella directory di origine della funzione Cloud Run:

   const { join } = require('path');
   
   /**
    * @type {import("puppeteer").Configuration}
    */
   module.exports = {
     cacheDirectory: join(__dirname, '.cache', 'puppeteer'),
   };

2. Aggiungi il seguente script al file package.json della funzione Cloud Run:

   "scripts": {
        "gcp-build": "node node_modules/puppeteer/install.mjs"
   },
   

Esempio Puppeteer

L'esempio generic-puppeteer-nodejs mostra come utilizzare Puppeteer con la funzione Cloud Run. Per visualizzare l'esempio completo, nella barra degli strumenti dell'esempio, seleziona il logo di GitHub.

const { instantiateAutoInstrumentation, runSyntheticHandler } = require('@google-cloud/synthetics-sdk-api');
// Run instantiateAutoInstrumentation before any other code runs, to get automatic logs and traces
instantiateAutoInstrumentation();
const functions = require('@google-cloud/functions-framework');
const axios = require('axios');
const assert = require('node:assert');
const puppeteer = require('puppeteer');


functions.http('CustomPuppeteerSynthetic', runSyntheticHandler(async ({logger, executionId}) => {
 /*
  * This function executes the synthetic code for testing purposes.
  * If the code runs without errors, the synthetic test is considered successful.
  * If an error is thrown during execution, the synthetic test is considered failed.
  */

 // Launch a headless Chrome browser and open a new page
 const browser = await puppeteer.launch({ headless: 'new', timeout: 0});
 const page = await browser.newPage();

 // Navigate to the target URL
 const result = await page.goto('https://www.example.com', {waitUntil: 'load'});

 // Confirm successful navigation
 await assert.equal(result.status(), 200);

 // Print the page title to the console
 const title = await page.title();
 logger.info(`My Page title: ${title} ` + executionId);

 // Close the browser
 await browser.close();
}));

Modello Selenium WebDriver

Se utilizzi Selenium WebDriver, ti consigliamo di iniziare con l'esempio generic-selenium-nodejs. L'esempio, disponibile su GitHub, include un file index.js e package.json.

Nota: le impostazioni predefinite per la memoria, la CPU e la sicurezza allocate potrebbero non essere sufficienti. Ti consigliamo di impostare la memoria su almeno 1 GiB.

Per visualizzare l'esempio completo, nella barra degli strumenti dell'esempio, seleziona il logo di GitHub.

const {
  instantiateAutoInstrumentation,
  runSyntheticHandler,
} = require('@google-cloud/synthetics-sdk-api');
// Run instantiateAutoInstrumentation before any other code runs, to get automatic logs and traces
instantiateAutoInstrumentation();
const functions = require('@google-cloud/functions-framework');
const assert = require('node:assert');

const { Builder, Browser, By } = require('selenium-webdriver');
const chrome = require('selenium-webdriver/chrome');

/*
 * This function executes the synthetic code for testing purposes.
 * If the code runs without errors, the synthetic test is considered successful.
 * If an error is thrown during execution, the synthetic test is considered failed.
 */
functions.http(
  'CustomSeleniumSynthetic',
  runSyntheticHandler(async ({ logger, executionId }) => {
    /*
     * Construct chrome options
     * Note: `setChromeBinaryPath` must be set to '/srv/bin/chromium' when running in
     *   GCF (but will need to be changed if running on local machine).
     */
    const options = new chrome.Options();
    options.setChromeBinaryPath('/srv/bin/chromium');
    options.addArguments('--headless', '--disable-gpu', '--no-sandbox');

    // Launch headless chrome webdriver with options
    const driver = await new Builder()
      .forBrowser(Browser.CHROME)
      .setChromeOptions(options)
      .build();

    // Navigate to the target URL
    await driver.get('https://example.com');

    // Retrieve title and `a` tag of page
    const title = await driver.getTitle();
    const aTag = await driver.findElement(By.css('a')).getText();

    // assert title is as expected and print to console
    await assert.equal(title, 'Example Domain');
    logger.info(`My URL title is: ${title} ` + executionId);

    await driver.quit();
  })
);

Modello Mocha

Se scrivi test che si basano sul modello Mocha, valuta se una sequenza di test deve continuare o interrompersi quando si verifica un errore. Per interrompere una sequenza di test dopo un errore, devi impostare il bail flag.

Per un esempio end-to-end che include il deployment di un'API, una suite di test Mocha di esempio per gli endpoint API e la configurazione del monitor sintetico, consulta il blog Google Cloud Tutorial sul monitoraggio sintetico.

L'esempio mocha-url-ok mostra come una funzione Cloud Run può richiamare una suite di test Mocha e fornisce una suite di test di esempio. Per visualizzare l'esempio completo, nella barra degli strumenti dell'esempio, seleziona il logo di GitHub.

const functions = require('@google-cloud/functions-framework');
const GcmSynthetics = require('@google-cloud/synthetics-sdk-mocha');

/*
 * This is the server template that is required to run a synthetic monitor in
 * Google Cloud Functions.
 */

functions.http('SyntheticMochaSuite', GcmSynthetics.runMochaHandler({
  spec: `${__dirname}/mocha_tests.spec.js`
}));

/*
 * This is the file may be interacted with to author mocha tests. To interact
 * with other GCP products or services, users should add dependencies to the
 * package.json file, and require those dependencies here A few examples:
 *  - @google-cloud/secret-manager:
 *        https://www.npmjs.com/package/@google-cloud/secret-manager
 *  - @google-cloud/spanner: https://www.npmjs.com/package/@google-cloud/spanner
 *  - Supertest: https://www.npmjs.com/package/supertest
 */

const {expect} = require('chai');
const fetch = require('node-fetch');

it('pings my website', async () => {
  const url = 'https://google.com/'; // URL to send the request to
  const externalRes = await fetch(url);
  expect(externalRes.ok).to.be.true;
});

Modello di link interrotti

L'esempio broken-links-ok mostra come configurare un controllo dei link interrotti. Per questo modello, devi specificare solo i valori dell'oggetto options. Questo oggetto specifica l'URI da testare e i parametri del test.

Se utilizzi Puppeteer, assicurati di completare i passaggi di configurazione di Puppeteer richiesti.

Nota: le impostazioni predefinite per la memoria, la CPU e la sicurezza allocate potrebbero non essere sufficienti. Ti consigliamo di impostare la memoria su almeno 1 GiB.

Per visualizzare l'esempio completo, nella barra degli strumenti dell'esempio, seleziona il logo di GitHub.

const functions = require('@google-cloud/functions-framework');
const GcmSynthetics = require('@google-cloud/synthetics-sdk-broken-links');

const options = {
  origin_uri: "https://example.com",
  // link_limit: 10,
  // query_selector_all: "a", // https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelectorAll
  // get_attributes: ['href'], // https://developer.mozilla.org/en-US/docs/Web/API/Element/getAttribute
  // link_order: "FIRST_N", // "FIRST_N" or "RANDOM"
  // link_timeout_millis: 30000, // timeout per link
  // max_retries: 0, // number of retries per link if it failed for any reason
  // wait_for_selector: '', // https://pptr.dev/api/puppeteer.page.waitforselector
  // per_link_options: {},
    /*
    // example:
      per_link_options: {
        'http://fake-link1': { expected_status_code: "STATUS_CLASS_4XX" },
        'http://fake-link2': { expected_status_code: 304 },
        'http://fake-link3': { link_timeout_millis: 10000 },
        'http://fake-link4': {
          expected_status_code: "STATUS_CLASS_3XX",
          link_timeout_millis: 10,
        },
      },
    */
  // total_synthetic_timeout_millis: 60000 // Timeout set for the entire Synthetic Monitor
  // screenshot_options: { capture_condition: 'FAILING', storage_location: '' }
};

functions.http('BrokenLinkChecker', GcmSynthetics.runBrokenLinksHandler(options));

Passaggi successivi

• Creare un monitor sintetico
• Creare un controllo dei link interrotti
• Gestire i monitor sintetici
• Esplorare i risultati dei monitor sintetici