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.
| Label | Level | Constant |
|---|---|---|
| Error level | 2 | BW_TRACE_ERROR |
| Warning level | 4 | BW_TRACE_WARNING |
| Notice level | 8 | BW_TRACE_NOTICE |
| Information level – standard | 16 | BW_TRACE_INFO |
| Debug level | 32 | BW_TRACE_DEBUG |
| Verbose level – noisier than Debug | 64 | BW_TRACE_VERBOSE |
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.
| Fully qualified file name | Include full path to source file |
| Include trace record count | Show trace records output |
| Include timestamp | Show current time, Elapsed, Time since last trace record |
| Include current filter | Show comma separated filter nesting |
| Include number of queries | Show cumulative queries performed |
| Include post ID | Show the post ID |
| Include memory/peak usage | Show current memory used and peak usage |
| Include files loaded count | Show number of PHP files loaded |
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
| Data | Contents |
|---|---|
| …class-BW-trace-controller.php | file name |
| (408:0) | Line number:trace level |
| BW_trace_controller::trace_startup | function / method name |
| (1) | calls to trace from this API |
| 1 | trace record count |
| 0 | trace record errors |
| 2019-12-03T22:28:46+00:00 | Current time |
| 0.000000 | Elapsed time |
| 0.000000 | Time since last trace record |
| cf! | Current filter |
| 16 | Hook count |
| 1 | Number of queries |
| 0 | Post ID |
| 2097152/2097152 | Memory usage / peak usage |
| 256M | Memory limit |
| F=188 | Trace file count |
| Trace level: Information level – standard | Trace text |
| 16 | Trace value |
| bwecho’s not yet traced |
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.
