• /
  • EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Escreva testes da API Sintético (tempo de execução legado - Node.js 10 e inferior)

Importante

A partir de 26 de agosto de 2024, você não poderá mais criar novos monitores usando tempos de execução legados em locais públicos ou privados. Em 22 de outubro de 2024, encerraremos a vida útil das versões conteinerizadas minion privado (chamadas por minuto) e legado runtime do Synthetics.

Use testes de API de monitoramento sintético para monitor seus endpoints de API e garantir que estejam funcionando corretamente. A New Relic usa o módulo http-request internamente para fazer chamadas HTTP para seu endpoint e validar os resultados.

Consulte os [exemplos de tempo de execução API do Node 16.10 ou mais recente](Detalhes para escrever o script do tempo de execução do Node 16.10 para criar o monitor usando nosso tempo de execução mais recente do Synthetics.

Apresentamos aqui alguns exemplos de funções que mostram como usar o objeto $http para enviar sua solicitação. Para obter documentação detalhada sobre as opções disponíveis para este objeto, consulte o readme da solicitação http. (Observe que Request está obsoleto, mas essas opções ainda se aplicam.)

Dica

Para visualizar e compartilhar outros exemplos de testes de API, visite a seção de script Sintético do Fórum de Suporte ou a biblioteca de início rápido de monitoramento sintético.

Use o módulo de solicitação http da API

Os testes de API são desenvolvidos pelo módulo http-request , que está disponível por meio do objeto $http . A cada intervalo de frequência, a New Relic consulta seu endpoint em cada um dos locais selecionados. Para obter instruções sobre como criar um monitor, consulte Adicionando monitores.

Continue lendo para saber como definir metadados para sua solicitação, fazer uma solicitação GET, fazer uma solicitação POST e como validar os resultados.

Importante

Após um tempo de execução máximo de três minutos, o New Relic interrompe manualmente o script.

api-test-snap.png

one.newrelic.com > Synthetic monitoring > Create monitor: o editor script sugere funções, seletores e outros elementos para simplificar comandos de script (disponíveis no GitHub).

Configurar opções de solicitação

Para iniciar seu script:

  • Declare uma variável (como options) para armazenar seu objeto de opções de solicitação.
  • Defina opções de solicitação, como endpoint de URL e cabeçalhos personalizados.
  • Se você estiver configurando opções de SSL ou de agente, consulte Requisitos de SSL e AgentOptions. Recomendamos o uso de SSL para evitar a exposição de credenciais de texto simples em seus cabeçalhos.

Dica

Para obter uma lista completa de opções de solicitação compatíveis, consulte request(options, retorno de chamada) na documentação http-request no GitHub.

Aqui está um exemplo de metadados opcionais no objeto de opções:

For SSL and agentOptions: Se você estiver configurando opções de SSL ou fornecendo um objeto agentOptions , a propriedade agent no objeto de solicitação options precisará ser definida como $globalAgents.https ou $globalAgents.http para garantir que suas solicitações HTTP usem o agente global instrumentado.

Aqui está um exemplo de uso de uma opção SSL ou agentOptions:

Envie uma solicitação GET

Para fazer uma solicitação GET, use o método $http.get para enviar sua solicitação. Defina suas opções de solicitação, faça sua solicitação usando $http.get e valide a resposta para garantir que seu endpoint esteja retornando os resultados corretos.

Envie uma solicitação POST

Para fazer uma solicitação POST, use o método $http.post para enviar sua solicitação. Defina suas opções de solicitação, faça sua solicitação usando $http.post e valide a resposta para garantir que seu endpoint esteja retornando os resultados corretos.

Validar resultados

Para validar seus resultados, importe o módulo assert para definir seu caso de teste. Chame um método assert para validar a resposta do seu endpoint. Se alguma função assert falhar, todo o monitor será considerado uma verificação com falha. Isto pode acionar a notificação de alerta e afetar sua métrica.

Importante

O monitoramento sintético não permite exceções lançadas. Exceções lançadas resultam em falha de script. Use o módulo assert para validar seus resultados e use console.log() para log os resultados no console do Sintético.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.