<?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 Andrew Braga on Medium]]></title>
        <description><![CDATA[Stories by Andrew Braga on Medium]]></description>
        <link>https://medium.com/@andrewjpa?source=rss-15e3cb627ff4------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*VdgdMAbxlN4fF8nQI8677A.jpeg</url>
            <title>Stories by Andrew Braga on Medium</title>
            <link>https://medium.com/@andrewjpa?source=rss-15e3cb627ff4------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Tue, 17 Nov 2026 17:20:53 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@andrewjpa/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[Como mudar o nível mínimo do log da aplicação em tempo de execução]]></title>
            <link>https://medium.com/localizalabs/como-mudar-o-n%C3%ADvel-m%C3%ADnimo-do-log-da-aplica%C3%A7%C3%A3o-em-tempo-de-execu%C3%A7%C3%A3o-com-configcat-e-serilog-db0bc672b6cd?source=rss-15e3cb627ff4------2</link>
            <guid isPermaLink="false">https://medium.com/p/db0bc672b6cd</guid>
            <category><![CDATA[serilog]]></category>
            <category><![CDATA[tecnologia]]></category>
            <category><![CDATA[configcat]]></category>
            <category><![CDATA[tech]]></category>
            <category><![CDATA[código]]></category>
            <dc:creator><![CDATA[Andrew Braga]]></dc:creator>
            <pubDate>Wed, 01 Nov 2023 11:22:47 GMT</pubDate>
            <atom:updated>2023-11-01T11:24:45.169Z</atom:updated>
            <content:encoded><![CDATA[<h3>Como mudar o nível mínimo do log da aplicação em tempo de execução com ConfigCat e Serilog</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/797/1*AvBJa0xHce375Qvk8-_bhw.png" /><figcaption>Logos do ConfigCat e Serilog</figcaption></figure><p>O log da aplicação desempenha um papel crucial na solução de problemas e no monitoramento de sistemas, fornecendo insights valiosos sobre o comportamento da mesma em tempo de execução. Ele permite rastrear o fluxo de execução do programa, identificar e resolver erros de tempo de execução e analisar o desempenho do sistema.</p><p>Um aspecto importante do registro em log são os níveis, que categorizam os eventos registrados com base na gravidade. Além de organizar as entradas de log, eles também permitem controlar o detalhamento da saída do log e filtrar as entradas com base em seu significado.</p><p>Na maioria dos sistemas de produção, o nível mínimo de log padrão é definido como INFO, o que significa que apenas registros com nível superior ou igual a INFO serão registrados. No entanto, há situações em que pode ser necessário ajustar o nível mínimo do log para aumentar ou diminuir o detalhamento dos logs.</p><p>Geralmente, uma aplicação bem projetada deve permitir que você modifique o nível mínimo de log sem precisar reiniciá-la. Depois que essa alteração for feita, ela também deverá se propagar perfeitamente em todas as instâncias da aplicação, permitindo que a escrita dos logs seja dinâmica, o que otimiza os custos de armazenamento dos logs e facilita a pesquisa na plataforma utilizada para visualizar esses logs, devido ao volume de logs aceitável.</p><p>Quando desejamos que a aplicação escreva logs de nível DEBUG para validar algum cenário específico por um curto espaço de tempo, a modificação do nível mínimo de log nos ajuda a alcançar esse objetivo. Após as escritas serem suficientes para analisar esse cenário, podemos facilmente restaurar o nível de log para o valor anterior aos testes.</p><p>Portanto, este artigo explorará um dos métodos para alterar dinamicamente os níveis de log em tempo de execução de aplicações implementadas em .NET, eliminando a necessidade de reinicializações da aplicação, utilizando <a href="https://serilog.net/">Serilog</a> e <a href="https://configcat.com/">ConfigCat</a>.</p><p><strong>Serilog</strong> é uma biblioteca para gerar log de informações em aplicações .NET, que trabalha com <strong>Sinks</strong>, uma estrutura que permite salvar quaisquer tipos de informação, de forma organizada durante a execução da aplicação. Por exemplo, para fazer com que o <strong>Serilog</strong> escreva seus logs em um arquivo, basta utilizar o <strong>Sink.File</strong>. O mesmo princípio se aplica a e-mails com o <strong>Sink.Email</strong> e até ao Discord com o <strong>Sink.Discord</strong>. E se você precisar armazenar os logs em um local específico que os <strong>Sinks</strong> padrões não atendem, você pode personalizar seus próprios <strong>Sinks</strong>.</p><p><strong>ConfigCat</strong> é um conhecido Toggle Service, que permite ativar e desativar facilmente recursos, alterar suas configurações e distribuir atualizações para usuários ou grupos específicos. Esse serviço oferece três maneiras de verificar as atualizações das informações em sua SDK: <strong>Auto polling</strong> (padrão), <strong>Manual Polling</strong> e <strong>Lazy loading</strong>. No <strong>Auto polling</strong>, é necessário informar na configuração do cliente o intervalo de tempo em segundos para a realização da chamada REST ao Toggle Service e atualizar as informações. No <strong>Manual Polling</strong>, é necessário chamar o método ForceRefresh do cliente sempre que necessário atualizar as informações. E, por fim, o <strong>Lazy loading</strong>, que é semelhante ao <strong>Auto Polling</strong> na configuração, mas com a diferença de que esse intervalo de tempo é usado para uma estratégia de cache. Em outras palavras, quando chamamos o método GetValue, a SDK verifica se o cache está vencido. Se estiver, ela faz uma nova chamada REST ao Toggle Service; caso contrário, ela retorna o último valor obtido.</p><h3>Implementação de exemplo</h3><p>A partir da versão 1.4.11, o <strong>Serilog</strong> possui uma nova classe chamada <strong>LoggingLevelSwitch</strong>, que permite alterar o nível de log da aplicação em tempo de execução. Abaixo, segue como a instância dessa classe deve ser utilizada na configuração do log:</p><pre>var levelSwitch = new LoggingLevelSwitch();<br>levelSwitch.MinimumLevel = LogEventLevel.Information;<br><br>Log.Logger = loggerConfiguration<br>    .MinimumLevel.ControlledBy(levelSwitch) //preenche o parâmetro aqui<br>    .WriteTo<br>    .Console()<br>    .CreateLogger();</pre><p>No entanto, existe uma forma mais interessante de implementar a utilização do <strong>LoggingLevelSwitch</strong>, que é através da injeção de dependência, como nesta implementação abaixo:</p><pre>var levelSwitch = new LoggingLevelSwitch();<br>levelSwitch.MinimumLevel = LogEventLevel.Information;<br><br>builder.Services.AddSingleton&lt;LoggingLevelSwitch&gt;(levelSwitch);</pre><p>E nesta implementação abaixo, utilizamos essa injeção de dependência no construtor de uma classe que vai servir para mudar o nível de log através de uma chamada de API. Essa chamada atualiza a configuração através do <strong>Manual Polling</strong> e ao obter o valor do Toggle Service, preenche o atributo MinimumLevel da instância do <strong>LoggingLevelSwitch</strong>.</p><pre>public class LogLevelController : Controller<br>{<br>    private readonly LoggingLevelSwitch loggingLevelSwitch;<br>    private readonly ConfigCatClient configCatClient;<br><br>    public LogLevelController(LoggingLevelSwitch loggingLevelSwitch, ConfigCatClient configCatClient)<br>    {<br>        this.loggingLevelSwitch = loggingLevelSwitch;<br>        this.configCatClient = configCatClient;<br>    }<br><br>    public async Task ChangeLogLevel()<br>    {<br>        configCatClient.ForceRefresh();<br>      <br>        var levelName = configCatClient.GetValue(&quot;LogLevel&quot;, &quot;Information&quot;);<br><br>        var newLogLevel = Enum.TryParse&lt;LogEventLevel&gt;(levelName, out LogEventLevel lel) ? lel : LogEventLevel.Information;<br><br>        loggingLevelSwitch.MinimumLevel = newLogLevel;<br>    }<br>}</pre><p>A cada chamada do método ChangeLogLevel, é possível modificar o nível mínimo do log. Para realizar a modificação para um valor diferente do padrão, deve existir uma configuração chave-valor no <strong>ConfigCat</strong> chamada “LogLevel” contendo o nome do nível de log que deseja modificar, e esse valor será preenchido no console da ferramenta, conforme exibido abaixo:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/718/1*yG2QJR3UwIt_gxiUszvI3w.png" /><figcaption>Captura de tela da configuração selecionada no console que contém a chave do exemplo</figcaption></figure><p>Para integrar o Toggle Service com a aplicação, é preciso obter o SDK Key, que fica na parte superior da configuração que contém a chave que será utilizada e implementar a injeção de dependência do client, configurando o tipo de integração e preencher o parâmetro da SDK Key com o valor obtido. Segue abaixo a imagem do local para obter a SDK Key e a implementação da injeção de depedendência:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*dWlS3wHgvLKIpMUucnVuVw.png" /><figcaption>Captura de tela da parte superior da configuração selecionada no console</figcaption></figure><pre>const string VARIAVEL_AMBIENTE_SDK_KEY_CONFIGCAT = &quot;SDK_KEY_CONFIGCAT&quot;;<br><br>Environment.SetEnvironmentVariable(VARIAVEL_AMBIENTE_SDK_KEY_CONFIGCAT, &quot;&lt;&lt;Valor da SDK Key&gt;&gt;&quot;) //preenche com o valor da SDK Key<br><br>builder.Services.AddSingleton(scope =&gt;<br>    ConfigCatClient.Get(Environment.GetEnvironmentVariable(VARIAVEL_AMBIENTE_SDK_KEY_CONFIGCAT), options =&gt;<br>    {<br>        options.PollingMode = PollingModes.ManualPoll;<br>    }));</pre><p>E por fim, se na configuração da aplicação o nível mínimo de log modificado for WARN, somente os logs com níveis de log WARN, ERROR e FATAL serão registrados, ou se o nível mínimo de log modificado for VERBOSE, todos os logs da aplicação serão registrados, e assim por diante.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=db0bc672b6cd" width="1" height="1" alt=""><hr><p><a href="https://medium.com/localizalabs/como-mudar-o-n%C3%ADvel-m%C3%ADnimo-do-log-da-aplica%C3%A7%C3%A3o-em-tempo-de-execu%C3%A7%C3%A3o-com-configcat-e-serilog-db0bc672b6cd">Como mudar o nível mínimo do log da aplicação em tempo de execução</a> was originally published in <a href="https://medium.com/localizalabs">#LocalizaLabs</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>