turbometrics

By robbsie

0+ active installationsVersion 1.2.0

Real User Monitoring for WordPress — Core Web Vitals from your real visitors, directly in your dashboard.

Description

turbometrics measures the real performance of your
WordPress website from your visitors’ perspective — not
from a lab environment.

While synthetic tools (like Lighthouse or PageSpeed Insights)
measure your site under controlled conditions, turbometrics
shows what your real visitors experience: on their devices,
with their internet connection, from their region.

What the plugin does

  • Automatically embeds the turbometrics tracking script
    in the <head> of every page
  • Measures LCP, CLS, INP, FCP and TTFB from your real visitors
  • Optionally excludes WordPress administrators from tracking
  • Marks WooCommerce checkout pages separately for precise analysis
  • Reports plugin, theme, WordPress and PHP updates to
    turbometrics the moment they happen, so a slower site can be
    traced back to the update that caused it
  • Shows Core Web Vitals and all 5 metrics directly in the
    WordPress dashboard widget
  • Shows in the dashboard widget whether a metric got better or
    worse than in the 7 days before, with a 30-day sparkline for
    each metric (for all devices together)
  • Switches the dashboard widget between all devices, mobile
    and desktop
  • Names the likely cause in the dashboard widget when the site
    got slower after an update, with a link to the details
  • Shows the number of open alerts and the slowest pages of the
    last 7 days in the dashboard widget
  • Marks plugins on the Plugins screen that turbometrics links to
    a slowdown, to JavaScript errors or to slow interactions
  • Shows the real-user values of the page you are looking at
    (LCP, INP, CLS, page views) in the admin bar on the front end;
    can be switched off in the settings

Core Web Vitals

Google evaluates websites based on three signals:

  • LCP (Largest Contentful Paint) — loading time of main content
  • CLS (Cumulative Layout Shift) — visual stability during load
  • INP (Interaction to Next Paint) — response time to clicks

turbometrics shows you whether your site meets these thresholds
for real visitors — and alerts you when it does not.

Privacy

  • No cookies and no browser fingerprinting
  • No personal data such as names, email addresses or complete
    IP addresses is stored with the performance data
  • IP addresses are used only to determine the country and are
    anonymized before storage
  • JavaScript error messages are technical texts of your site’s
    scripts and can in individual cases contain page content. They
    are shortened to 200 characters and cleaned before storage:
    email addresses, longer digit sequences and URL parameters are
    removed. No IP address is stored with JavaScript errors.
  • Can be used in compliance with the GDPR when declared in your
    privacy policy

Requirements

An active turbometrics account with a Live Data plan is required.
Free trial available at turbometrics.io.

External Services

This plugin embeds a tracking script from turbometrics.io
(https://turbometrics.io/tm.min.js). The script sends
performance measurements of your visitors’ page views to
https://turbometrics.io/api/tm: the five metrics, the phases
of LCP and INP, the address of the LCP image and of the script
that delayed an interaction (both without parameters), and
cleaned JavaScript error messages (at most 5 per page view).

In the WordPress admin the plugin calls the turbometrics API at
https://turbometrics.io/api/v1 (/me, /rum/sites,
/rum/sites/{id}/summary, /rum/sites/{id}/history,
/rum/sites/{id}/pages, /rum/sites/{id}/alerts,
/rum/sites/{id}/breakdown, and /attributions?host=… for
diagnoses) to validate your API key and to display your metrics
in the dashboard widget, on the Plugins screen and in the admin
bar. For the diagnoses it sends the site’s host name (the domain
connected in turbometrics). For the admin bar it asks for the
values of the page path an administrator is looking at.
Requests identify the plugin with the header
x-turbometrics-client: wordpress-plugin/; its reads of
your site’s data do not count against your account’s daily API
quota. Each request carries the administrator’s language
(locale), so texts such as diagnoses come back in that
language. These calls only read data; nothing new about the
site or its visitors is sent from WordPress.

After a plugin, theme or WordPress update, an activation,
deactivation, deletion or theme switch, and once a day, the
plugin sends the state of the site to
https://turbometrics.io/api/v1/changes and /inventory:
the site’s host name, the slugs, versions and active state of
installed plugins and themes, the active theme, and the
WordPress and PHP version (major.minor). No content, users or
visitor data are sent. Nothing is sent without an API key.

The tracking script carries a short checksum of that state
(data-release), so measurements can be grouped by the code
version that served them.

turbometrics.io and turbometrics.de are the same service,
operated by TurboPress. turbometrics.de is the former domain
and redirects to turbometrics.io.

By using this plugin, you agree to the
Privacy Policy and
Terms of Service of turbometrics.io.

Installation

  1. Upload and activate the plugin
  2. Go to Settings → turbometrics and enter your API key
  3. Find your API key at turbometrics.io/profile/api
  4. Click “Test connection” — if successful, the script will be
    embedded automatically
  5. The dashboard widget appears immediately on the WordPress home screen

FAQ

Do I need a turbometrics account?

Yes. You need at least a Starter plan with Live Data feature.
A free trial is available.

Are cookies used?

No. turbometrics works completely without cookies.

Can I use the plugin in compliance with the GDPR?

It can be used in compliance with the GDPR when you declare it in
your privacy policy. turbometrics sets no cookies and does no
browser fingerprinting.
It collects technical performance data only; no personal data such
as names, email addresses or complete IP addresses is stored with
it. IP addresses are used only to determine the country and are
anonymized before storage. JavaScript error messages are technical
texts of your site’s scripts and can in individual cases contain
page content, so they are shortened to 200 characters and cleaned
before storage (email addresses, longer digit sequences and URL
parameters are removed). No IP address is stored with JavaScript
errors. A ready-made privacy policy
text is available in the turbometrics dashboard.

Does it work with WooCommerce?

Yes. When WooCommerce is active, checkout pages can be marked
separately for more precise performance analysis.

Are administrators tracked?

By default, no. Logged-in administrators are excluded from
tracking to avoid skewing measurement data. This option can
be disabled in the settings.

What happens to my data when I uninstall the plugin?

When uninstalling, all local WordPress options and caches
are deleted. Data in your turbometrics account remains and
can be deleted there.

Screenshots

Changelog

1.2.0

  • New: the dashboard widget shows for each metric whether it got better or worse than in the 7 days before (an arrow from 10 % change on) and a sparkline of the last 30 days, for all devices together.
  • New: a switch in the dashboard widget shows the figures for all devices, mobile or desktop (mobile and desktop without trend and sparkline). The widget remembers the choice.
  • New: when turbometrics links a slowdown to an update, the dashboard widget names the likely cause in one sentence, with the date and a link to the details. Only diagnoses turbometrics is reasonably sure about are shown.
  • New: the dashboard widget shows the number of open alerts and the five slowest pages of the last 7 days (LCP), each linked.
  • New: on the Plugins screen, plugins get a note when turbometrics links them to a slowdown after an update, when they cause JavaScript errors on at least 1 % of page views, or when they are involved in at least 20 % of the slowest interactions.
  • New: on the front end the admin bar shows LCP, INP, CLS and page views of the current page over the last 7 days. The values load in the background after the page has loaded. Can be switched off under Settings → turbometrics.
  • Change: data from turbometrics is cached for 5 minutes (daily history 1 hour, diagnoses and the plugin breakdown 15 minutes), failures for 2 minutes. The widget’s Refresh button reloads the summary and alerts only. The plugin’s reads no longer count against the account’s daily API quota. Requests carry the administrator’s language, so diagnoses arrive in German or English.
  • Note: the tracking script now also reports the phases of LCP and INP, the address of the LCP image and of the script that delayed an interaction (without parameters), and cleaned JavaScript error messages. The plugin itself sends nothing new.

1.1.0

  • New: updates, installs, activations, deactivations, deletions and theme switches are reported to turbometrics with the time they happened, together with the version before and after. turbometrics shows them on the site’s timeline, checks a monitored site right after the change and points to the update when a metric gets worse afterwards.
  • New: once a day the plugin sends the list of plugins and themes with their versions, the active theme, and the WordPress and PHP version. That also catches changes made outside WordPress, such as uploads via FTP or updates run by the host.
  • New: the tracking script carries a short checksum of the installed code (data-release), so real-user data can later be compared per release.
  • Fix: the connection test showed “Connected as Unknown” instead of the account’s email address.
  • For test installations, the API address can be set with the constant TURBOMETRICS_API_BASE in wp-config.php.

1.0.5

  • Change: the interface is now written in English, so it can be translated. Until now the source strings themselves were German, which left every other language stuck with German and made the plugin untranslatable on translate.wordpress.org.
  • New: a German translation ships with the plugin, so German installations look exactly as before.
  • Fix: the seventeen strings the dashboard widget and the settings page build in the browser were hard-coded in the script and could not be translated at all. They now come from the translation catalogue.
  • Fix: numbers and the time of the last refresh in the dashboard widget followed a fixed German format regardless of the language the site runs in. They now follow the locale of the person looking at it.
  • Fix: the plugin description was spread over two lines in the plugin header. WordPress reads only the first, so the Plugins screen showed half a sentence.

1.0.4

  • Fix: uninstalling now removes the cached summary transient. The previous cleanup counted site ids from 1 upwards and stopped at the first one it did not find, so it removed nothing unless the site id happened to be 1.
  • Tested against WordPress 7.1.

1.0.3

  • Change: turbometrics has moved from turbometrics.de to turbometrics.io — script URL, API endpoints and all dashboard links now use the new domain
  • Note: existing installations keep working, turbometrics.de redirects to turbometrics.io

1.0.2

  • Fix: “Test connection” now works before saving — uses input field value instead of only saved option

1.0.1

  • Fix: public_key extraction from embed_snippet
  • Fix: CWV assessment threshold reduced to 10 measurements
  • New: Reload button in dashboard widget

1.0.0

  • Initial release