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ê escrever testes e não depender de um modelo, verifique se o teste
é aprovado, a menos que uma Error
seja gerada. Recomendamos
que você use a biblioteca Assert
para garantir que,
quando ocorrerem falhas, elas sejam atribuídas à linha de código adequada.
Modelos genéricos
Os modelos genéricos são configurados para coletar dados de rastreamento e registro de 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 trace e registro. Portanto, o trace coletado e os dados de registro só devem ser usados para 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
.
Exemplo genérico de 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 conferir o exemplo completo, clique em more_vert Mais e selecione Ver no GitHub.
Exemplo de 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, siga estas etapas:
Inclua
.puppeteerrc.cjs
no diretório de origem do seu Função do Cloud Run:Adicione o script a seguir ao arquivo
package.json
do seu Função do Cloud Run:"scripts": { "gcp-build": "node node_modules/puppeteer/install.mjs" },
Exemplo do Puppeteer
O exemplo generic-puppeteer-nodejs
ilustra como
para usar o Puppeteer com a função do Cloud Run. Para conferir o exemplo completo, clique em more_vert Mais e selecione Ver no GitHub.
Modelo Selenium WebDriver
Se você usa o Selenium WebDriver, comece com o exemplo
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ê escrever testes que dependem do modelo Mocha,
considere se uma sequência de testes deve continuar ou parar quando uma
falha ocorrer. Para interromper uma sequência de testes após uma falha, defina a 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 Run 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, você só especifica os valores do objeto options
. Isso
especifica o URI a ser testado e os parâmetros do teste.
Se você usa o Puppeteer, conclua as etapas da Configuração obrigatória 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