Microservices Engine:Configurar uma política de nova tentativa

Pré-requisitos

• Uma instância de cloud-native gateway foi criada.

• Pelo menos uma rota está configurada para o gateway.

Condições de nova tentativa de rota

Quando uma solicitação para um service de backend falha, o cloud-native gateway pode repetir automaticamente a requisição com base nas condições que você configurar. As condições de nova tentativa são específicas do protocolo. A lista a seguir descreve as condições disponíveis para os protocolos HTTP e gRPC.

• As seguintes condições de nova tentativa estão disponíveis para o protocolo HTTP:

  • 5xx: O cloud-native gateway repete a solicitação com falha se o service de backend retornar qualquer resposta 5xx ou se ocorrer uma desconexão, redefinição ou tempo limite de leitura.

    Nota

    A condição 5xx inclui as condições connect-failure e refused-stream.

  • reset: O cloud-native gateway repete a solicitação com falha se ocorrer uma desconexão, redefinição ou tempo limite de leitura.

  • connect-failure: O cloud-native gateway repete a solicitação com falha se a requisição falhar devido a uma desconexão.

  • refused-stream: O cloud-native gateway repete a solicitação com falha se o service de backend redefinir o stream com o código de erro REFUSED_STREAM.

  • retriable-status-codes: O cloud-native gateway repete a solicitação se o código de status HTTP na resposta do service de backend corresponder a um código de status de nova tentativa especificado por você.

    Nota

    O uso de códigos de status de nova tentativa só é possível se você especificar retriable-status-codes como condição de nova tentativa.

• As condições abaixo aplicam-se ao protocolo gRPC:

  • cancelled: A repetição ocorre quando o código de status gRPC no cabeçalho de resposta do service de backend gRPC for cancelled.

  • deadline-exceeded: Indicado para cenários em que o código de status gRPC no cabeçalho de resposta do service de backend gRPC é deadline-exceeded.

  • internal: Use esta condição quando o código de status gRPC no cabeçalho de resposta do service de backend gRPC for internal.

  • resource-exhausted: Mais adequado para situações onde o código de status gRPC no cabeçalho de resposta do service de backend gRPC é resource-exhausted.

  • unavailable: Recomendado quando o código de status gRPC no cabeçalho de resposta do service de backend gRPC for unavailable.

Configurar uma política de nova tentativa de rota

1. Faça login no console MSE. Na barra de navegação superior, selecione uma região.

2. No painel de navegação à esquerda, escolha Cloud-native Gateway > Gateways. Na página Gateways, clique em ID do gateway.

3. No painel de navegação à esquerda, clique em Routes. Em seguida, clique em aba Routes.

4. Localize a rota que deseja modificar e clique em Policies na coluna Actions.

5. Na aba Policies, clique em Retry.

6. Configure os parâmetros na regra Retry e clique em Save.

   Parâmetro	Descrição
   Retry Times	Número máximo de vezes que uma solicitação com falha será repetida. Valores válidos: 0 a 10. Recomenda-se um valor não superior a 2. Nota O valor 0 desativa as novas tentativas.
   Retry Condition	Selecione as condições de nova tentativa adequadas à sua carga de trabalho. É possível selecionar várias condições, descritas em Route retry conditions.
   Retry Status Code	Especifique os códigos de status HTTP cujas respostas devem ser repetidas. Vários códigos de status HTTP podem ser configurados. Nota É necessário especificar retriable-status-codes no campo Retry Condition antes de configurar o Retry Status Code.
   Enable	Alternância para ativar ou desativar a política de nova tentativa de rota. Enable: A política de nova tentativa de rota do gateway entra em vigor. Disable: A política personalizada de nova tentativa de rota não entra em vigor. Nota Ao desativar a política personalizada de nova tentativa, o gateway reverte para sua configuração interna padrão. O número padrão de novas tentativas é 2, e as condições padrão são connect-failure, refused-stream, unavailable, cancelled e retriable-status-codes.

   Após configurar e ativar a política de nova tentativa, envie solicitações de teste para a rota e verifique se as requisições com falha são repetidas conforme as condições e a contagem de tentativas configuradas.