Troubleshooting

This guide addresses common issues when setting up and using DebugHawk.

No Data Appearing in Dashboard

Your DebugHawk dashboard shows no data after plugin installation. Common causes:

Ad Blockers

Some browsers and browser extensions block DebugHawk's performance data collection:

• uBlock Origin
• AdBlock Plus
• Brave Browser Shields

To resolve this, disable ad blockers on your site or add your domain to the extension's allowlist.

Configuration Issues

Verify your configuration in wp-config.php:

define( 'DEBUGHAWK_CONFIG', [
    'enabled'  => true,
    'endpoint' => 'https://ingest.debughawk.com/your-endpoint',
    'secret'   => 'your-secret-key',
] );

Common mistakes:

• Using incorrect endpoint URL
• Wrong secret key
• Placing configuration after wp-settings.php is loaded

Missing Performance Metrics

Some Core Web Vitals metrics like INP (Interaction to Next Paint) or CLS (Cumulative Layout Shift) don't appear for all page views. Not all browsers support every performance metric. Safari doesn't currently support INP measurement, and older browser versions may lack support for certain metrics. Some metrics only appear in specific scenarios, like INP which requires user interaction to be measured.

Data Sampling Confusion

Your dashboard reports fewer page views than actual traffic.

Check Your Sample Rate

If you've configured sampling, only a percentage of requests are monitored:

'sample_rate' => 0.1, // Only 10% of requests are tracked

For accurate data during initial setup, use 100% sampling:

'sample_rate' => 1, // Monitor all requests