Implementar repetições de chamadas HTTP com retirada exponencial com o HttpClientFactory e as políticas do Polly

A abordagem recomendada para repetições com retirada exponencial é aproveitar as bibliotecas do .NET mais avançadas como a biblioteca Polly de software livre.

A Polly é uma biblioteca .NET que fornece resiliência e recursos de tratamento de falhas temporárias. Você pode implementar essas funcionalidades por meio da aplicação de políticas da Polly como repetição, disjuntor, isolamento do bulkhead, tempo limite e fallback. O Polly é direcionado ao .NET Framework 4.x e ao .NET Standard 1.0, 1.1 e 2.0 (que dá suporte ao .NET Core e posteriores).

As etapas a seguir mostram como você pode usar as repetições HTTP com o Polly integrado ao IHttpClientFactory, o que foi explicado na seção anterior.

Instalar os pacotes do .NET

Primeiro, você precisará instalar o pacote Microsoft.Extensions.Http.Polly.

• Instalar do Visual Studio
• Instalar com a CLI do dotnet
• Instalar com a CLI do nuget.exe
• Instalar com o console do Gerenciador de Pacotes (PowerShell)

Fazer referência aos pacotes do .NET 8

O IHttpClientFactory está disponível desde o .NET Core 2.1, mas recomendamos o uso dos pacotes do .NET 8 mais recentes a partir do NuGet no seu projeto. Normalmente, você também precisa referenciar o pacote de extensão Microsoft.Extensions.Http.Polly.

Configurar um cliente com a política de repetição da Polly, na inicialização do aplicativo

O método AddPolicyHandler() é aquele que adiciona políticas aos objetos HttpClient que você usará. Nesse caso, ele está adicionando a política do Polly para repetições de HTTP com retirada exponencial.

Para obter uma abordagem mais modular, a política de repetição de Http pode ser definida em um método separado no arquivo Program.cs, como mostra o seguinte código:

static IAsyncPolicy<HttpResponseMessage> GetRetryPolicy()
{
    return HttpPolicyExtensions
        .HandleTransientHttpError()
        .OrResult(msg => msg.StatusCode == System.Net.HttpStatusCode.NotFound)
        .WaitAndRetryAsync(6, retryAttempt => TimeSpan.FromSeconds(Math.Pow(2,
                                                                    retryAttempt)));
}

Conforme mostrado nas seções anteriores, você precisa definir uma configuração HttpClient de cliente nomeada ou tipada na configuração de aplicativos Program.cs padrão. Agora você adiciona código incremental especificando a política para as repetições Http com retirada exponencial, conforme a seguir:

// Program.cs
builder.Services.AddHttpClient<IBasketService, BasketService>()
        .SetHandlerLifetime(TimeSpan.FromMinutes(5))  //Set lifetime to five minutes
        .AddPolicyHandler(GetRetryPolicy());

Com a Polly, você pode definir uma política de repetição com o número de repetições, a configuração de retirada exponencial e as ações a serem executadas quando houver uma exceção de HTTP, como registrar o erro em log. Nesse caso, a política é configurada para tentar seis vezes com uma repetição exponencial, começando em dois segundos.

Adicionar uma estratégia de tremulação à política de repetição

Uma política de repetição regular pode afetar o sistema em casos de alta simultaneidade e escalabilidade e sob alta contenção. Para superar os picos de repetições semelhantes provenientes de muitos clientes em caso de interrupções parciais, uma boa solução alternativa é adicionar uma estratégia de variação à política ou ao algoritmo de repetição. Essa estratégia pode aprimorar o desempenho geral do sistema de ponta a ponta. Conforme recomendado em Polly: repetição com variação, uma boa estratégia de variação pode ser implementada por intervalos de repetição suaves e distribuídos uniformemente, aplicados com um atraso de repetição inicial mediano bem controlado em uma retirada exponencial. Essa abordagem ajuda a espalhar os picos quando o problema surge. O princípio é ilustrado pelo seguinte exemplo:

var delay = Backoff.DecorrelatedJitterBackoffV2(medianFirstRetryDelay: TimeSpan.FromSeconds(1), retryCount: 5);

var retryPolicy = Policy
    .Handle<FooException>()
    .WaitAndRetryAsync(delay);

Recursos adicionais

• Padrão de repetiçãohttps://video2.skills-academy.com/azure/architecture/patterns/retry

• Polly e IHttpClientFactoryhttps://github.com/App-vNext/Polly/wiki/Polly-and-HttpClientFactory

• Polly (biblioteca de tratamento de falhas transitórias e resiliência do .NET)https://github.com/App-vNext/Polly

• Polly: repetição com variaçãohttps://github.com/App-vNext/Polly/wiki/Retry-with-jitter

• Marc Brooker. Jitter: Making Things Better With Randomness (Variação: melhorando as coisas com aleatoriedade) https://brooker.co.za/blog/2015/03/21/backoff.html