Trace options – trace records

In the Options box, use the Trace records section to set the required tracing level, the optional information to write for each trace record and whether or not to only trace requests from a specific IP.

Trace level

Select the level of tracing required from the drop down list.

Trace records with a value of 0 – BW_TRACE_ALWAYS – are always produced regardless of the trace level. As you increase the trace level more trace records are produced.

Check boxes

Select the check boxes to control the data content of each trace record.

The trace record output is also affected by the oik action options Count action hooks and filters checkbox setting.

When none of the boxes are checked the trace record produced at trace startup will be like this, but on one line:

wp-content/plugins/oik-bwtrace/includes/
class-BW-trace-controller.php(408:0) 
BW_trace_controller::trace_startup(1) 0 16 
Trace level: Information level - standard 16 

When all boxes are checked the trace record will be like this:

C:\apache\htdocs\wordpress\wp-content\plugins\oik-bwtrace\includes\
class-BW-trace-controller.php(408:0) 
BW_trace_controller::trace_startup(1) 1 0 
2019-12-03T22:28:46+00:00 0.000000 0.000000 
cf! 16 1 0 2097152/2097152 256M F=188 
Trace level: Information level - standard 16 

Broken down this record shows

Trace specific IP

If you want to trace requests from a specific IP then you can enter this value in the Trace specific IP field of the Trace records box.

This can be useful when tracing a staging or live site.