If your WordPress site is experiencing slowness in production or staging, Tideways helps pinpoint performance bottlenecks. Tideways is a lightweight Application Performance Monitoring (APM) tool that lets you analyze PHP execution times, identify slow database queries, and track errors and performance trends over time.
Why Use Tideways Instead of Xdebug?
Xdebug, which comes pre-installed in Seravo's local Docker development environment, adds significant overhead to PHP execution and is intended strictly for local development. Production and staging environments require lightweight background monitoring that does not slow down page loads for visitors, along with a centralized dashboard for analyzing long-term performance data.
For this reason, Seravo's server environment includes a built-in Tideways agent pre-configured to work seamlessly with WordPress.
How Tideways Works in Seravo's Environment
Tideways has minimal impact on site performance, allowing it to run continuously in the background:
Automatic sampling: In Seravo's environment, Tideways collects execution traces and profiling data for 1% of PHP requests on production sites and 10% of requests in staging environments.
Environment separation: Data from production and staging environments is automatically separated into distinct log streams in the Tideways dashboard.
Comprehensive analysis: Tideways provides timeline and call-graph views similar to Xdebug and Webgrind, while storing historical traces in the cloud, automatically detecting bottlenecks, and supporting alerts via email, Slack, GitHub, and other integrations.
Tideways dashboard showing overall application response time, errors, and performance trends.
Tideways timeline view breaking down the duration of a single PHP request and its database queries.
Note: Tideways' free trial does not include all features. For example, monitoring multiple separate environments (such as both production and staging) requires a paid Tideways subscription.
Prerequisites
Before setting up Tideways, ensure you have:
SSH access to your site: You need SSH access to the server to store your API key and restart PHP.
A Tideways account: Sign up at tideways.com. If you want to monitor a staging environment in addition to production, verify that your plan supports multi-environment monitoring.
Setting Up Tideways
Because the Tideways agent is pre-installed on Seravo's servers, setup only requires a Tideways account and an application-specific API key:
Create an account and application: Register at tideways.com, create a new application in the dashboard, and copy its API key (for example,
A0A0A0A0A0A0A0A0).Save the API key on the server: Connect to your site's production server via SSH and save the key to
/data/wordpress/.tideways.key:echo 'A0A0A0A0A0A0A0A0' > /data/wordpress/.tideways.key
Restart PHP: Activate the Tideways background daemon with your API key by running:
wp-restart-php
Verify incoming data: Return to the Tideways dashboard. Profiling data will begin appearing as your site serves uncached requests requiring PHP execution.
Tip: If you also want to monitor an existing staging environment, connect to the staging container via SSH, save the same API key to /data/wordpress/.tideways.key, and run wp-restart-php there as well. Also ensure that .tideways.key is never committed to a public Git repository. To disable Tideways later, remove /data/wordpress/.tideways.key and run wp-restart-php.
Inviting Your Team and Seravo Experts
In the Tideways dashboard, you can create an organization and invite team members so everyone involved in development can inspect collected performance metrics.
Creating an organization in the Tideways dashboard to manage team members.
Seravo's monthly hosting plan does not include site-specific code optimization, but our experts are available for hourly performance consulting. If needed, you can temporarily invite a Seravo developer to your Tideways organization to investigate bottlenecks directly from the collected data.
Inviting a new user to a Tideways organization via email address.
Common Issues and Troubleshooting
No data appears in the Tideways dashboard after setup:
Confirm that you ran
wp-restart-phpon the server after creating/data/wordpress/.tideways.key.Run
cat /data/wordpress/.tideways.keyto verify the file contains no extra whitespace or quotation marks.Keep in mind that requests served directly from Nginx's page cache do not invoke PHP at all. Trigger data collection by loading uncached pages (such as the WordPress admin dashboard or a WooCommerce checkout page).
Staging environment data does not appear in Tideways: Ensure
/data/wordpress/.tideways.keyhas also been created inside the staging container,wp-restart-phphas been run in staging, and your Tideways plan supports multiple environments.
See Also
Tideways helps you uncover real-world bottlenecks in production without guesswork or slowing down your site. If you need assistance activating your Tideways key or investigating site performance, our support team is happy to help at [email protected].




