About this plugin
liaison site health monitor is an admin-only diagnostic tool built for developers and operators who want clear visibility into WordPress performance characteristics without introducing undocumented runtime behavior.
php, and does not attempt to bypass or reimplement WordPress core database instrumentation.
Why this matters
Rather than intercepting or mutating the database layer, this plugin:
- Respects WordPress’s established debugging contract
- Uses core-supported query timing data
- Makes performance trade-offs explicit and auditable
- Avoids fragile hooks into internal execution paths
Requirements
php:
define( ‘SAVEQUERIES’, true );
This constant must be defined before WordPress bootstrap, as required by core.
If SAVEQUERIES is not enabled, slow query monitoring will be automatically disabled and the plugin will operate in site health metrics–only mode.
Features
- Site Health Metrics
- PHP memory usage
- Aggregate database query time
- REST API response latency
- Active plugin count
-
WordPress version
- Slow Query Monitoring (SAVEQUERIES-based)
-
Uses $wpdb->queries as the authoritative source
- Automatic slow query detection via time thresholds
- Query normalization and aggregation
- Persistent storage for historical analysis
-
Zero interference with query execution
Slow Query Monitoring
- WordPress records query timing into $wpdb->queries (core behavior).
- On admin page load:
- Plugin inspects recorded queries
-
Filters queries exceeding the configured threshold
- Slow queries are:
-
Normalized (values stripped)
- Stored in a plugin-owned table
- Aggregated results are displayed in the dashboard.
Why SAVEQUERIES Is Required
WordPress deliberately gates query timing behind SAVEQUERIES to ensure developers explicitly opt into performance overhead.
This plugin embraces that design decision:
- No attempt to override $wpdb
- No undocumented filters or runtime mutation
- No silent performance impact
Instead, it provides:
- Transparent prerequisites
- Predictable behavior
- Alignment with WordPress core debugging philosophy
This makes the plugin suitable for development, staging, and controlled production diagnostics.
Security Considerations
-
Admin-only access
- Dashboard restricted to privileged users.
-
No sensitive data exposure
- Query values are normalized before storage.
-
No runtime mutation
- Does not alter database execution flow.
-
Clear uninstall behavior
- Plugin-owned tables removed on uninstall.
Trade-offs / Limitations
Pros
- Uses WordPress-supported debugging mechanisms
- Easy to reason about and audit
- No fragile DB-layer interception
- Clear performance cost model
-
Ideal for learning and diagnosis
Cons
-
Requires SAVEQUERIES to be enabled
- Higher overhead than production-safe profilers
- Not intended for always-on monitoring
- Less suitable for high-traffic production sites
Testing
- Tested with SAVEQUERIES enabled and disabled.
- Verifies graceful degradation when unavailable.
- Manual validation of query timing accuracy.
- No dependency on non-core WordPress behavior.