Profiler em tempo real e interface de inspeção para Django que registra requisições, consultas SQL e blocos de código para ajudar a encontrar gargalos.
django-commons/django-debug-toolbar
Conjunto configurável de painéis do Django que mostra informações de depuração de cada requisição e resposta no navegador.
- Estrelas
- 8,379
- Forks
- 1,122
- Issues abertas
- 71
- Último commit
- há 4 dias
O que é?
O Django Debug Toolbar é uma ferramenta de desenvolvimento para projetos Django. Ele adiciona uma barra de ferramentas às páginas renderizadas, e cada painel mostra um tipo de informação de depuração sobre a requisição e a resposta atuais, como consultas SQL, headers, templates e tempos. Ao clicar em um painel, você vê mais detalhes sobre o conteúdo exibido.
A barra de ferramentas é composta por um conjunto configurável de painéis, e a comunidade também contribuiu com muitos painéis de terceiros. Atualmente, requer Django 5.2 ou posterior. Oferece suporte experimental às views assíncronas do Django, mas ainda não lida com requisições concorrentes.
A documentação online do projeto explica a instalação e a configuração. O pacote é distribuído sob a licença BSD-3-Clause.
Recursos principais
- 01Mostra as consultas SQL executadas durante uma requisição.
- 02Exibe headers da requisição e da resposta, templates e informações de tempo.
- 03Oferece suporte a painéis integrados e a painéis de terceiros contribuídos pela comunidade.
- 04Adiciona suporte experimental às views assíncronas do Django.
Casos de uso
- Encontrar problemas de consultas N+1 durante o desenvolvimento de uma view do Django.
- Inspecionar a renderização de templates e o contexto durante o desenvolvimento local.
- Verificar os headers da requisição e da resposta ao depurar um endpoint de API.
Início rápido
- 1
Siga as instruções de instalação e configuração da documentação
Antes de usar
- O suporte às views assíncronas do Django é experimental, e a barra de ferramentas ainda não consegue lidar com requisições simultâneas.
- É necessário usar o Django 5.2.0 ou posterior.
Em coleções
Tópicos
Perguntas frequentes
- O que é django-debug-toolbar?
- Conjunto configurável de painéis do Django que mostra informações de depuração de cada requisição e resposta no navegador. O Django Debug Toolbar é uma ferramenta de desenvolvimento para projetos Django. Ele adiciona uma barra de ferramentas às páginas renderizadas, e cada painel mostra um tipo de informação de depuração sobre a requisição e a resposta atuais, como consultas SQL, headers, templates e tempos. Ao clicar em um painel, você vê mais detalhes sobre o conteúdo exibido.
- django-debug-toolbar é gratuito? Qual é a licença?
- django-debug-toolbar é open source sob a licença BSD-3-Clause. Confira os termos da licença antes de usá-lo em produtos comerciais.
- django-debug-toolbar ainda é mantido?
- Manutenção ativa. O último commit de django-debug-toolbar foi em 3 de nov. de 2026.
- Para que posso usar django-debug-toolbar?
- Encontrar problemas de consultas N+1 durante o desenvolvimento de uma view do Django. Inspecionar a renderização de templates e o contexto durante o desenvolvimento local. Verificar os headers da requisição e da resposta ao depurar um endpoint de API.
- Como instalar django-debug-toolbar?
- Siga as instruções de instalação e configuração da documentação
- Onde consigo django-debug-toolbar?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/django-commons/django-debug-toolbar
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Profiler por amostragem para programas Python, que se conecta a processos em execução sem modificar o código nem reiniciá-los.
Profiler de memória para Python que rastreia alocações no código Python, em extensões nativas e no interpretador, com vários tipos de relatório.
Um tracer de Python de baixo overhead que registra chamadas de função e visualiza a execução do código em uma linha do tempo interativa.
Profiler linha a linha para Python que mostra quanto tempo cada linha do código-fonte de uma função decorada leva para executar.
Um amostrador de pilhas de chamadas para CPython, escrito em C, com baixo overhead e sem instrumentação, para perfilar processos Python em execução.