Ce document décrit les modèles et les exemples de code disponibles
pour vous aider à créer
une surveillance synthétique. Les exemples de fonctions sont disponibles
Dépôt GitHub Google Cloud/synthetics-sdk-nodjs
.
Si vous écrivez des tests sans vous appuyer sur un modèle, assurez-vous
passe à moins qu'une erreur Error
ne soit générée. Nous vous recommandons
d'utiliser la bibliothèque Assert
pour vous assurer
En cas d'échec, ils sont attribués à la ligne de code appropriée.
Modèles génériques
Les modèles génériques sont configurés pour collecter les données de trace et de journal les requêtes HTTP sortantes. La solution exploite le Module auto-instrumentation-node OpenTelemetry et le winston logger. En raison de la dépendance aux produits Open Source, vous devez vous attendre à des changements la structure des données de trace et de journal. Par conséquent, les données de trace et les données des journaux ne doivent être utilisées qu'à des fins de débogage.
Vous pouvez implémenter votre propre approche pour collecter les données de trace et de journal des appels sortants
Requêtes HTTP. Pour obtenir un exemple d'approche personnalisée,
consultez la classe SyntheticAutoInstrumentation
.
Exemple de code Node.js générique
L'exemple generic-synthetic-nodejs
illustre
comment interroger une URL. Cet exemple contient la même fonction que la fonction par défaut
affichées par la console Google Cloud. Pour afficher l'exemple complet, cliquez sur more_vert More (Plus).
puis sélectionnez Afficher sur GitHub.
Exemple TypeScript
Exemple generic-synthetic-typescript
montre comment interroger une URL. Pour afficher l'exemple complet, cliquez sur more_vert More (Plus).
puis sélectionnez Afficher sur GitHub.
Modèle Puppeteer
Si vous utilisez Puppeteer, envisagez de commencer par la
Exemple de generic-puppeteer-nodejs
.
Configuration Puppeteer requise
Pour utiliser Puppeteer, procédez comme suit:
Incluez
.puppeteerrc.cjs
dans le répertoire source de votre Cloud Functions:Ajoutez le script suivant au fichier
package.json
de votre Cloud Functions:"scripts": { "gcp-build": "node node_modules/puppeteer/install.mjs" },
Exemple Puppeteer
L'exemple generic-puppeteer-nodejs
montre comment
utiliser Puppeteer avec votre fonction Cloud. Pour afficher l'exemple complet, cliquez sur more_vert More (Plus).
puis sélectionnez Afficher sur GitHub.
Modèle WebDriver pour Selenium
Si vous utilisez Selenium WebDriver, envisagez de commencer par la
Exemple de generic-selenium-nodejs
. L'échantillon,
qui est disponible sur GitHub, inclut un fichier index.js
et un fichier package.json
.
Pour afficher l'exemple complet, cliquez sur more_vert Plus, puis sélectionnez Afficher sur GitHub.
Modèle de moka
Si vous écrivez des tests qui reposent sur le modèle Mocha,
déterminez ensuite si une série de tests doit se poursuivre ou s'arrêter
une défaillance se produit. Pour arrêter une séquence de tests après un échec, vous devez définir le paramètre
bail
.
Pour un exemple de bout en bout incluant le déploiement d'une API, un exemple de test Mocha pour les points de terminaison de l'API et comment configurer la surveillance synthétique, consultez le blog Tutoriel sur la surveillance synthétique Google Cloud.
L'exemple mocha-url-ok
montre comment
une fonction Cloud peut appeler
Mocha et fournit un exemple de suite de tests.
Pour afficher l'exemple complet, cliquez sur more_vert More (Plus).
puis sélectionnez Afficher sur GitHub.
Modèle de lien non fonctionnel
broken-links-ok
montre comment configurer un vérificateur de liens non fonctionnels.
Pour ce modèle, vous ne spécifiez que les valeurs de l'objet options
. Ce
spécifie l'URI à tester et les paramètres du test.
Si vous utilisez Puppeteer, veillez à remplir les Étapes de configuration de Puppeteer.
Pour afficher l'exemple complet, cliquez sur more_vert Plus, puis sélectionnez Afficher sur GitHub.
Étape suivante
- Créer une surveillance synthétique
- Créer un vérificateur de liens non fonctionnels
- Gérer la surveillance synthétique
- Explorer les résultats de la surveillance synthétique