Este documento descreve os modelos e o exemplo de código disponíveis
para ajudar você a criar monitores sintéticos. Os exemplos de funções estão disponíveis na
Repositório do GitHub do Google Cloud/synthetics-sdk-nodjs
(link em inglês).
Se você cria testes e não usa um modelo, garanta que eles
seja transmitida, a menos que uma Error
seja gerada. Recomendamos
use a biblioteca Assert
para garantir que
quando ocorrem falhas, elas são atribuídas à linha de código correta.
Modelos genéricos
Os modelos genéricos são configurados para coletar dados de trace e registro para solicitações HTTP de saída. A solução usa Módulo auto-instrumentation-node do OpenTelemetry e o winston logger. Devido à dependência de produtos de código aberto, você deve esperar mudanças no a estrutura dos dados de rastreamento e registro. Portanto, o trace coletado e os dados de registro só devem ser usados para fins de depuração.
Você pode implementar sua própria abordagem para coletar rastreamento e dados de registro para
solicitações HTTP. Para um exemplo de abordagem personalizada,
consulte a classe SyntheticAutoInstrumentation
.
Amostra genérica do Node.js
O exemplo generic-synthetic-nodejs
ilustra
como consultar um URL. Este exemplo contém a mesma função que a padrão
exibidos pelo console do Google Cloud. Para acessar o exemplo completo, clique em more_vert Mais,
e selecione Ver no GitHub.
Exemplo do TypeScript
O exemplo generic-synthetic-typescript
ilustra como consultar um URL. Para acessar o exemplo completo, clique em more_vert Mais,
e selecione Ver no GitHub.
Modelo do Puppeteer
Se você usa o Puppeteer, comece com a
Exemplo de generic-puppeteer-nodejs
.
Configuração necessária do Puppeteer
Para usar o Puppeteer, conclua as seguintes etapas:
Inclua
.puppeteerrc.cjs
no diretório de origem do seu Função do Cloud:Adicione o script a seguir ao arquivo
package.json
do seu Função do Cloud:"scripts": { "gcp-build": "node node_modules/puppeteer/install.mjs" },
Amostra do Puppeteer
O exemplo generic-puppeteer-nodejs
ilustra como
para usar o Puppeteer com a função do Cloud. Para acessar o exemplo completo, clique em more_vert Mais,
e selecione Ver no GitHub.
Modelo Selenium WebDriver
Se você usa o Selenium WebDriver, comece pela
Exemplo de generic-selenium-nodejs
. A amostra,
que está disponível no GitHub e inclui os arquivos index.js
e package.json
.
Para ver o exemplo completo, clique em more_vert Mais e selecione Ver no GitHub.
Modelo Mocha
Se você criar testes que dependem do modelo Mocha,
considerar se uma sequência de testes deve continuar ou parar quando uma
quando ocorre uma falha. Para interromper uma sequência de testes após uma falha, defina o
flag bail
.
Para um exemplo completo que inclui a implantação de uma API, um exemplo do teste Mocha para os endpoints de API e como configurar o monitor sintético, consulte o blog Tutorial de monitoramento sintético do Google Cloud.
O exemplo mocha-url-ok
ilustra como
uma função do Cloud pode invocar
Mocha (link em inglês) e oferece um exemplo de pacote de testes.
Para acessar o exemplo completo, clique em more_vert Mais,
e selecione Ver no GitHub.
Modelo de link corrompido
O broken-links-ok
exemplo ilustra como configurar um verificador de links corrompidos.
Para este modelo, especifique apenas os valores do objeto options
. Isso
especifica o URI a ser testado e os parâmetros do teste.
Se você usa o Puppeteer, certifique-se de concluir o Etapas de configuração necessárias do Puppeteer.
Para ver o exemplo completo, clique em more_vert Mais e selecione Ver no GitHub.
A seguir
- Criar um monitor sintético
- Criar um verificador de links corrompidos
- Gerenciar monitores sintéticos
- Explorar os resultados do monitor sintético