Squid Web Cache wiki

Squid Web Cache documentation

🔗 What Debug Sections and debug_options in squid.conf are all about

🔗 Synopsis

Sometimes people need to see more than just the fatal or critical problems occurring within Squid.

Squid contains its own debugging system broken into sections and levels.

They are configured in squid.conf with the debug_options setting as a list of Section,Level pairs. Each pair is set left-to-right. If a section is mentioned twice the last mentioned level is used.

Generally only ALL,0 is used, to display any major issues in need of urgent fix. These are problems fatal to squid and if your squid is crashing the problem is mentioned in cache.log at level 0.

Administrators may also set debug_options ALL,1 to get a report of issues which are not causing critical problems to squid, but which may be fatal to certain client requests. These messages usually also indicate network issues the admin should be looking at fixing.

Higher debugging levels are available if an issue needs tracking step-by-step through the code. They go up to 9, though 6 contain most information needed by the developers to debug.

🔗 What the Levels mean

level 0

level 1

level 2

level 3-4

level 5

**level 6

level 7-8

level 9

🔗 What the Section numbers mean

We take great pains to keep debug sections consistent across releases. The current catalog of debug sections is at https://github.com/squid-cache/squid/blob/master/doc/debug-sections.txt

Categories: KnowledgeBase

Navigation: Site Search, Site Pages, Categories, 🔼 go up