Debugar aplicações django não seria tão fácil sem o debug toolbar

debug_toolbar
debug_toolbar

Demonstração do django debug toolbar

O django traz grandes facilidades, porém esconde perigos por trás dessa facilidade, e nisso está o uso excessivo de recursos por trás de toda automação que o framework proporciona, que ao invés de ajudar pode acabar atrapalhando. Entretanto para que possamos analisar os pontos fortes e fracos da nossa aplicação, precisamos de auxilio de alguma ferramenta de monitoramento e debug, e para tal tarefa temos o django debug toolbar.

Funcionamento da app

O django debug toolbar nos fornece a possibilidade de monitorar alguns recursos que são utilizados pelo django, como: tempo de utilização de cpu, versão do django, consultas sql que estão sendo executadas no banco, dentre outros. Para exibir os resultados das analises, a app exibe uma barra lateral em todas as páginas do seu projeto, no qual permite obter os dados relativo para cada página. Entretanto essa barra só é exibida enquanto a sua aplicação estiver em modo debug e para os endereços ips que forem autorizados.

Instalação e configuração

O primeiro passo é a instalação da debug toolbar, que é possível de duas formas: tanto pelo gerenciador de pacotes pip/easy_install, como baixando o pacote e instalando manualmente. Nesse exemplo optaremos por utilizar o gerenciador de pacotes para realizar a instalação.

ou utilizando o easy_install

Após realizada a instalação, precisamos apenas realizar algumas configurações para ativar o seu funcionamento e, a partir dai, consegui fazer uso dos seus recursos. No seu arquivo settings.py inclua os valores conforme demostrados abaixo:

Nesse momento daremos atenção a variável de configuração INTERNAL_IPS, essa é um configuração obrigatório para funcionamento da app, mesmo que seu projeto esteja em modo debug, se não definir os ips que serão permitido o uso da toolbar, ela não será exibido; isso porque, supondo que você possua um ambiente de homologação do seu projeto, e nesse ambiente o debug esteja ativado para facilitar o rastreamento de erros, porém esse ambiente é de acesso publico, sendo assim não há necessidade da toolbar ser exibida.

Configurações opcionais

Se você executou até os passos acima, sua debug toolbar já deve estar em funcionando perfeitamente, porém podemos customizar os recursos da ferramenta, uma configuração que costumo utilizar é, desativar a interceptação dos redirecionamentos, ou seja, a cada redirecionamento realizado, o django debug toolbar exibe uma tela intermediária onde mostra informações de debug para aquele processo, sendo necessário clicar em um botão para prosseguir com o redirecionamento.

Somente desative a interceptação dos redirecionamentos se tiver certeza que não há necessidade de monitorar os procedimentos antes de ser realizado o redirecionamento, geralmente desabilito apenas quando os redirecionamentos são realizados no painel admin.

Abaixo segue a tela de demonstração da analise dos sql que estão sendo executado na página.

Demo do analise do sql

Demo do analise do sql

O django debug toolbar não se limita apenas as opções pré configuradas em seu funcionamento, é possível ir muito além, desde profiles, até inclusão de novas extensões capazes de incrementar ainda mais a app. Para mais informações consulte o site do projeto

Leave a Comment.