Debug Logs & Verification
Real-time diagnostic logging, error tracing, and verifying event delivery in Zaraz and ad platform debuggers.
Debug Logs & Verification
Section titled “Debug Logs & Verification”When troubleshooting e-commerce setups or custom payment gateways, the debug log shows what WP Zbridge sent and what came back.
Detailed Logging
Section titled “Detailed Logging”Warnings and errors are always logged. To also log every dispatch and check:
- Go to Zbridge > Diagnostics and find Debugging.
- Tick Detailed logging and click Save Changes.
- It switches itself off 24 hours later, so the log doesn’t fill up.
Each log line shows its details (such as the HTTP status and CF-Ray ID). Use Clear log to start fresh.
Zaraz Debugger
Section titled “Zaraz Debugger”Cloudflare’s Zaraz debugger shows every event, trigger and tool action on the pages you visit. Under Diagnostics > Debugging, click Open site with the Zaraz debugger: WP Zbridge sets Cloudflare’s zarazDebug cookie in your browser and opens your site. Turn the debugger off removes the cookie.
- Pro with a Cloudflare API token: uses the debug key from your live Zaraz configuration.
- Otherwise: uses the debug key in the container WP Zbridge exports. If you set up Zaraz another way, copy the debug key from Zaraz > Settings and run
zaraz.debug("KEY")in your browser console.
See Cloudflare’s Zaraz debug mode docs.
Support Info
Section titled “Support Info”Copy support info collects versions, your edition, Setup Health, settings and the last 50 log lines into one block to paste into a support email. API tokens, access tokens, license keys, the debug key and the Events API path are left out.
The same information, plus a setup check, appears under Tools > Site Health.
Viewing Logs
Section titled “Viewing Logs”The built-in dark log console displays recent log lines chronologically:
[INFO]Successful server dispatches and syncs (detailed logging only).[WARNING]Server events that reached Cloudflare but were not handled by Zaraz, with the CF-Ray ID.[DEBUG]Orders skipped because the browser already reported them or the server already sent them (detailed logging only).[ERROR]HTTP connection failures, expired Cloudflare tokens, or cURL timeouts with exact error payloads.
External Platform Debuggers
Section titled “External Platform Debuggers”- Google Analytics 4 DebugView: Open GA4 > Admin > DebugView to see events arriving in real time.
- Meta Events Manager Test Events: Enter your website URL under Test Events to confirm events arrive with their
event_id.