<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Ruan Rodrigues on Medium]]></title>
        <description><![CDATA[Stories by Ruan Rodrigues on Medium]]></description>
        <link>https://medium.com/@ruanrodrigues_47045?source=rss-bd6bf98affb3------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*i_z0s3WEfeqZ2yw77nlPYQ.jpeg</url>
            <title>Stories by Ruan Rodrigues on Medium</title>
            <link>https://medium.com/@ruanrodrigues_47045?source=rss-bd6bf98affb3------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sat, 21 Nov 2026 19:10:39 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@ruanrodrigues_47045/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[[Guia Prático] Como implementar circuit breaker em .NET Core com Polly e HttpClientFactory]]></title>
            <link>https://medium.com/@ruanrodrigues_47045/guia-pr%C3%A1tico-como-implementar-circuit-breaker-em-net-core-com-polly-e-httpclientfactory-ccd1fc2a685e?source=rss-bd6bf98affb3------2</link>
            <guid isPermaLink="false">https://medium.com/p/ccd1fc2a685e</guid>
            <category><![CDATA[circuit-breaker]]></category>
            <category><![CDATA[design-patterns]]></category>
            <category><![CDATA[csharp]]></category>
            <dc:creator><![CDATA[Ruan Rodrigues]]></dc:creator>
            <pubDate>Tue, 19 Aug 2025 01:43:23 GMT</pubDate>
            <atom:updated>2025-08-19T01:43:23.539Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*YgdeGbIKnrgr3W2R" /></figure><h3>[Guia Prático] Como implementar circuit breaker em .NET Core com Polly e HttpClientFactory</h3><h3>Recordando o post anterior sobre Circuit Breaker</h3><p>Em aplicações distribuídas, dependemos de APIs externas, bancos e serviços terceiros. Quando um deles falha, chamadas repetidas podem saturar o servidor, gerando lentidão e até derrubando todo o sistema. O <strong>circuit breaker</strong> atua como um disjuntor: quando detecta falhas seguidas, <strong>abre o circuito</strong> e interrompe as chamadas por um tempo, protegendo sua aplicação.</p><p>No <strong>.NET Core</strong>, podemos implementar circuit breaker facilmente usando <strong>HttpClientFactory</strong> junto com <strong>Polly</strong>, uma biblioteca de resiliência bastante madura.</p><h3>Problema sem proteção</h3><p>Imagine um cenário simples:</p><ul><li>Sua API chama um serviço de pagamentos.</li><li>O serviço fica instável e responde com erros ou demora muito.</li><li>Sua aplicação continua tentando, esgota conexões e trava.</li></ul><p>O resultado? Seu sistema fica tão lento que nem responde requisições saudáveis. O circuit breaker resolve isso.</p><h3>Ferramentas que vamos usar</h3><ul><li><strong>.NET 8 (ou superior)</strong> com Web API.</li><li><strong>HttpClientFactory</strong> para gerenciar conexões.</li><li><strong>Polly</strong> para criar políticas de retry, timeout e circuit breaker.</li></ul><p>Instalação do Polly:</p><pre>dotnet add package Microsoft.Extensions.Http.Polly</pre><h3>Criando o projeto Web API</h3><p>Crie um projeto simples:</p><pre>dotnet new webapi -n CircuitBreakerDemo<br>cd CircuitBreakerDemo</pre><p>Esse template já traz um controlador de exemplo e suporte ao Swagger.</p><h3>Registrando HttpClient com Polly</h3><p>No arquivo Program.cs, vamos configurar um <strong>HttpClient</strong> com políticas de resiliência.</p><pre>using Polly;<br>using Polly.CircuitBreaker;<br>using Polly.Timeout;<br><br>var builder = WebApplication.CreateBuilder(args);<br><br>// Configuração do HttpClient com Polly<br>builder.Services.AddHttpClient(&quot;ExternalApi&quot;, client =&gt;<br>{<br>    client.BaseAddress = new Uri(&quot;https://api.externa.dev/&quot;);<br>})<br>.AddPolicyHandler(Policy.TimeoutAsync&lt;HttpResponseMessage&gt;(2)) // Timeout de 2s<br>.AddTransientHttpErrorPolicy(policy =&gt; policy.WaitAndRetryAsync(3, retry =&gt; <br>    TimeSpan.FromMilliseconds(200 * retry))) // Retry com backoff<br>.AddTransientHttpErrorPolicy(policy =&gt; policy.CircuitBreakerAsync(<br>    handledEventsAllowedBeforeBreaking: 5, // após 5 falhas<br>    durationOfBreak: TimeSpan.FromSeconds(15), // espera 15s<br>    onBreak: (outcome, delay) =&gt;<br>    {<br>        Console.WriteLine($&quot;⚡ Circuito ABERTO por {delay.TotalSeconds}s!&quot;);<br>    },<br>    onReset: () =&gt; Console.WriteLine(&quot;✅ Circuito FECHADO novamente.&quot;),<br>    onHalfOpen: () =&gt; Console.WriteLine(&quot;🔄 Circuito em HALF-OPEN, testando...&quot;)));</pre><p>Aqui combinamos <strong>timeout + retry + circuit breaker</strong>. O HttpClient está pronto para resiliência.</p><h3>Criando um controller para testar</h3><p>Vamos criar um controlador simples que consome essa API externa.</p><p><strong>Controllers/QuotesController.cs</strong></p><pre>using Microsoft.AspNetCore.Mvc;<br><br>[ApiController]<br>[Route(&quot;[controller]&quot;)]<br>public class QuotesController : ControllerBase<br>{<br>    private readonly IHttpClientFactory _httpClientFactory;<br>    public QuotesController(IHttpClientFactory httpClientFactory)<br>    {<br>        _httpClientFactory = httpClientFactory;<br>    }<br>    [HttpGet(&quot;{currency}&quot;)]<br>    public async Task&lt;IActionResult&gt; GetQuote(string currency)<br>    {<br>        var client = _httpClientFactory.CreateClient(&quot;ExternalApi&quot;);<br>        try<br>        {<br>            var response = await client.GetAsync($&quot;/quotes/{currency}&quot;);<br>            if (!response.IsSuccessStatusCode)<br>                return StatusCode((int)response.StatusCode, &quot;Erro ao consultar cotação.&quot;);<br>            var content = await response.Content.ReadAsStringAsync();<br>            return Ok(content);<br>        }<br>        catch (BrokenCircuitException)<br>        {<br>            return StatusCode(503, &quot;Circuito aberto. Serviço indisponível temporariamente.&quot;);<br>        }<br>        catch (TimeoutRejectedException)<br>        {<br>            return StatusCode(504, &quot;Timeout ao consultar serviço externo.&quot;);<br>        }<br>    }<br>}</pre><h3>Simulando falhas da API externa</h3><p>Para testar, podemos usar um serviço falso, como o <strong>Mocky.io</strong> ou criar uma API local que retorna erro 500 aleatoriamente.</p><p>Exemplo de endpoint instável (em outra API):</p><pre>app.MapGet(&quot;/quotes/{currency}&quot;, (string currency) =&gt;<br>{<br>    if (Random.Shared.Next(1, 3) == 1) // 50% de chance<br>        return Results.StatusCode(500);<br>    return Results.Ok(new { currency, value = 5.37, timestamp = DateTime.UtcNow });<br>});</pre><h3>Testando o comportamento do breaker</h3><ol><li>Faça várias requisições para /quotes/USD.</li><li>Após 5 falhas consecutivas, o circuito será <strong>aberto</strong>.</li><li>Durante 15 segundos, todas as requisições retornarão <strong>503</strong> imediatamente.</li><li>Depois disso, o breaker entra em <strong>Half-Open</strong>: algumas chamadas passam.</li><li>Se funcionarem, o circuito <strong>fecha</strong>. Se falharem, <strong>abre novamente</strong>.</li></ol><h3>Logs e monitoramento básico</h3><p>No código do onBreak, onReset e onHalfOpen, você já pode incluir logs. Em produção, integre com <strong>Application Insights, Prometheus ou OpenTelemetry</strong>.</p><h3>Configurações recomendadas</h3><ul><li><strong>Timeout</strong> curto (1–3s).</li><li><strong>Retry</strong> com backoff + jitter para evitar overload.</li><li><strong>Circuit breaker</strong> com 5 a 10 falhas antes de abrir, durationOfBreak de 15–30s.</li><li>Ajuste os valores conforme a criticidade do serviço.</li></ul><h3>Checklist rápido para produção</h3><p>✅ Health Checks para serviços externos<br>✅ Logs estruturados dos eventos do breaker<br>✅ Dashboards de taxa de erro e latência<br>✅ Alarmes quando o breaker ficar aberto por muito tempo<br>✅ Estratégias de fallback (cache, dados default)</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=ccd1fc2a685e" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Circuit Breaker ou um sistema travado misterioso ?]]></title>
            <link>https://medium.com/@ruanrodrigues_47045/circuit-breaker-ou-um-sistema-travado-misterioso-e5bca826fb25?source=rss-bd6bf98affb3------2</link>
            <guid isPermaLink="false">https://medium.com/p/e5bca826fb25</guid>
            <category><![CDATA[csharp]]></category>
            <category><![CDATA[circuit-breaker]]></category>
            <category><![CDATA[clean-code]]></category>
            <category><![CDATA[software-development]]></category>
            <category><![CDATA[design-patterns]]></category>
            <dc:creator><![CDATA[Ruan Rodrigues]]></dc:creator>
            <pubDate>Tue, 05 Aug 2025 01:16:28 GMT</pubDate>
            <atom:updated>2025-08-06T18:26:46.671Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/600/1*n1Mhj9ktxTAuQuB65rgxHQ.jpeg" /></figure><h3>Por que seu sistema ainda não sabe a hora de parar ?</h3><p>Quantas vezes já nos deparamos com aquela API externa que estamos consultando dentro de nossas aplicações e a mesma vem a falhar inumeras vezes deixando nossos serviços de mãos vazias e sem saber para onde ir, resultando em atrasos de requisições e deixando o cliente enfurecido ? É problemas como esse que o Circuit Breaker nos apresenta uma saída.</p><ul><li>Fechado (<strong><em>Closed</em></strong>): Tudo funciona normalmente, as requisições passam livremente.</li><li>Aberto (<strong><em>Open</em></strong>): Após um certo número de falhas, o disjuntor “abre”, bloqueando novas requisições por um tempo.</li><li>Meio-aberto (<strong><em>Half-Open</em></strong>): Após um intervalo, algumas requisições-teste são permitidas. Se forem bem-sucedidas, o circuito volta ao estado fechado; se falharem, volta ao aberto.</li></ul><h3>Por que usar?</h3><ul><li>Evita sobrecarregar sistemas que já estão com problema.</li><li>Previne “falhas em cascata” (um serviço quebrado derrubar geral).</li><li>Dá tempo para recuperação (tenta de novo só depois de uma pausa).</li></ul><h3>Exemplos rápidos</h3><h3>1. API de Pagamento</h3><p>Você vende ingressos online e usa uma API de pagamentos de terceiros.</p><p>O sistema de pagamento cai de repente.</p><p><strong>Sem circuit breaker:</strong></p><ul><li>Toda nova tentativa (do usuário ou automática) só piora, lotando ainda mais o serviço.</li></ul><p><strong><em>Com</em> circuit breaker:</strong></p><ul><li>Depois de, por exemplo, 3 falhas, sua aplicação para de enviar requisições por um tempo.</li><li>O usuário recebe retorno rápido (“Tente novamente mais tarde”) e seu sistema não sobrecarrega.</li></ul><h3>2. Comunicação entre Microserviços</h3><p>Você tem arquitetura de microserviços e o serviço A faz chamadas HTTP para o serviço B.</p><ul><li>O serviço B trava ou fica lento.</li><li>O A seguiria tentando e esperando timeout, gastando recursos.</li><li>Com circuit breaker: Após falhas seguidas, o A para de tentar por um período, liberando recursos.</li></ul><h3>3. Gateway de Armazenamento de Arquivos</h3><p>Um serviço faz uploads para armazenamento na nuvem. O storage passa por uma indisponibilidade temporária.</p><ul><li><strong>Sem circuit breaker</strong>: sua aplicação fica tentando e entope a fila.</li><li><strong>Com circuit breaker</strong>: bloqueia logo as tentativas, evitando fila acumulada até tudo voltar ao normal.</li></ul><h3>Configurações principais</h3><ul><li><strong>Quantidade de falhas:</strong> Quantos erros antes de abrir o circuito?</li><li><strong>Tempo de break:</strong> Quanto tempo fica aberto até tentar de novo?</li><li><strong>Exceções:</strong> Quais falhas contam? (erros, timeout, etc.)</li><li><strong>Estado meio-aberto:</strong> Quantas requisições de teste pra fechar de novo?</li></ul><h3>Prós e Contras</h3><p><strong>Prós:</strong></p><ul><li>Previne falhas em cascata</li><li>Reduz desperdício de recursos</li><li>Dá resposta rápida ao usuário</li></ul><p><strong>Contras:</strong></p><ul><li>Requer ajuste cuidadoso</li><li>Pode atrasar a recuperação</li><li>Adiciona um pouco de complexidade</li></ul><h3>Pensamento final</h3><p>O circuit breaker é uma ferramenta simples e poderosa para tornar seu sistema mais resiliente, principalmente em arquiteturas distribuídas ou na nuvem. Fácil de implementar (principalmente com bibliotecas como Polly no .NET), ele transforma grandes quedas em problemas pontuais — e seus usuários seguem felizes, mesmo quando outros serviços falham! É sempre importante levar em consideração a tratativa de falhas quando estamos nos comunicando com outros sistemas.</p><p>No próximo artigo irei mostrar como podemos utilizar esse padrão no .NET com a biblioteca Polly.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=e5bca826fb25" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>