Debug Toolbar로 프로파일링

Django Debug Toolbar는 페이지에서 실행되는 쿼리 수를 정확히 보여 주므로, 막연한 추측이 아니라 사실에 근거해 최적화할 수 있습니다. 🔍

다른 패키지와 마찬가지로 pip를 사용해 추가합니다. 이는 개발 도구이므로 운영 환경에 배포되지 않습니다.

INSTALLED_APPS에 추가하면 Django가 패널을 불러오고 툴바가 존재한다는 것을 인식합니다.

이 도구의 미들웨어는 HTML 응답에 패널을 삽입하므로, 미들웨어 목록의 앞부분에 배치하는 것이 좋습니다.

툴바는 INTERNAL_IPS에 있는 IP에만 표시됩니다. 따라서 본인에게는 보이지만 실제 방문자에게는 숨길 수 있습니다.

가장 중요한 패널은 SQL입니다. 렌더링된 출력 바로 옆에서 페이지가 실행한 모든 쿼리와 실행 시간을 보여 줍니다.

예상보다 높은 쿼리 수는 N+1 문제를 나타내는 대표적인 징후입니다. 툴바가 이 수치를 놓치지 않도록 보여 줍니다.

루프가 반복해서 실행하는 거의 동일한 중복 쿼리도 표시하므로, 문제의 위치를 바로 파악할 수 있습니다.

select_related 또는 prefetch_related를 추가한 후 다시 불러와 수가 줄어드는지 확인하세요. 이것이 수정이 제대로 작동했다는 증거입니다.

느린 페이지가 항상 쿼리 수 때문인 것은 아닙니다. 툴바는 쿼리별 시간을 보여 주므로, 실제로 비용이 큰 쿼리를 찾아낼 수 있습니다.

툴바 설정을 DEBUG 플래그 뒤에 배치하세요. 내부 정보가 노출되고 페이지가 느려질 수 있으므로 운영 환경에서는 절대 표시되면 안 됩니다.

Debug Toolbar는 쿼리 수와 실행 시간을 측정하여 N+1 문제를 찾고 수정 사항을 확인하도록 도와줍니다. 설치하고, IP를 허용한 뒤, 개발 환경에서만 사용하세요. ✅