RackPing Monitoring Widget for WordPress (Single-site)
RackPing monitors your web site or blog and can display daily performance graphs using plugins, including on your WordPress blog with the WordPress widget like this:
Some use cases for the RackPing WordPress widget are:
- monitor your blog from RackPing.com and display the daily performance graph on your WordPress single-site blog in the sidebar
- monitor your ecommerce or web site from RackPing.com and display the daily performance graph on your WordPress single-site blog in the sidebar.
- if you are using hosted, VIP or multi-site WordPress, then an easy-to-install alternative is the RackPing HTML plugin.
RackPing Monitoring Widget for WordPress (Single-site) Instructions
TLDR for experienced WP admins:
The RackPing WordPress (Single-site) widget follows the WordPress widget programming guidelines and installs like any other standard widget:
- download and unzip in your usual WordPress plugins folder (the final structure should look something like
- The WordPress admin screen will request your RackPing email and 'blog_key' from the "My Company" page, and if you have more than one monitoring check, the 'mid' from the "My Monitors" page.
- Wait 15 minutes and verify your the RackPing widget is updating in your WordPress blog sidebar. If not, read the logfile.
Full Installation Instructions
RackPing WordPress widget setup page
RackPing WordPress widget display with Twenty Ten theme
Tags: monitoring, widget, badge
Requires at least: 2.8
Tested up to: 4.9.1
Stable tag: 1.0
RackPing monitors your web site and helps you visualize connection and performance problems. This WordPress widget lets you display a small version of RackPing Monitoring results on your blog.
Installing the RackPing Monitoring widget is the same as any other single-site WordPress widget:
- Extract all files from the ZIP file, making sure to keep the file/folder structure intact, and then, upload the RackPing plugin folder 'rackping/' and files to your WordPress server. A typical directory location for the rackping widget folder is: /usr/share/wordpress/wp-content/plugins/rackping
See Also: "Installing Plugins" article on the WP Codex
- Check the following two files exist and have writable permissions by your web server:
touch rackping_graph.png; chmod 666 rackping_graph.png;
touch rackping_log.php; chmod 666 rackping_log.php;
- "Plugins ... Activate", "Appearance ... Widgets ... RackPing Monitoring", then enter your RackPing login info (email, Blog key and Monitor ID).
You're done. Enjoy!
Use the RackPing widget wherever widgets are allowed in your WordPress theme.
Upgrade using the Wordpress Admin or overwrite your files/folder with the new files/folder, then deactivate and reactivate under "Plugins".
- Uses WordPress 2.8+ API only.
- No external or other dependencies.
For now, just make a backup of rackping.php, and then update the link with lang=en to your language code, and translate the following phrases in-place: "RackPing Performance Graph" and "Updated".
For maximum availability, please read the following:
- The plugin data file, rackping_graph.png, used to periodically save data must exist and be writable by the web server user.
- The logfile, rackping_log.php, though optional is helpful for debugging problems. It is automatically truncated after 50,000 bytes.
- The RackPing widget has comprehensive error handling, so should reliably operate without intervention.
- You may want to use an internal monitoring tool on your system, web server or PHP error logs (see php.ini for the error log setting) and rackping_log.php.
- The updated monitoring image is refreshed every 15 minutes or so by the WordPress scheduler. Each page view of your blog will read it from the file cache, rackping_graph.png.
For maximum security when using WordPress plugins:
- The WordPress MySQL user should only access the
- Plugin program files should be owned by an OS user different than the web server or mysqld user, such as
root on linux.
- The RackPing widget uses SSL when periodically retrieving the graph data.
- The RackPing monitoring Blog key can only read graph data. It does not have access to other account settings. (Use your RackPing Blog Key, not the RackPing API Key.)
- The logfile, rackping_log.php, has a PHP header to prevent web users from reading the log entries if your web server is correctly configured to process PHP scripts.
- after copying the widget, you can verify that you have the right version of PHP with:
$ php -l rackping.php
No syntax errors detected in rackping.php
if the widget is working correctly, the file rackping_graph.png should be populated immediately after plugin activation and updated every 15 minutes or so. Try reloading your blog a few times to trigger the WordPress scheduler.
error messages will be logged to rackping_log.php and your web server's error log.
You can enable limited debug logging with:
$ echo 1 >debug
To disable debugging output:
$ rm debug
- if the widget appears to be installed correctly but rackping_graph.png is empty or not being updated every 15 minutes or so, there may be multiple, differing copies of your RackPing login info in the MySQL WordPress options table:
Click on "Appearances ... RackPing Monitoring ... Delete" and "Plugins ... Deactivate"
Start your MySQL client program and delete the old RackPing WordPress options row:
select option_id into @a from wp_options where option_name='widget_rackping' limit 1;
delete from wp_options where option_id=@a;
- If the graph is still not updating, you can install the WP Crontrol plugin to view and trigger the WordPress scheduler. This can save a lot of debugging time!
1.0 Release Date - 15 November 2017
Click to see all RackPing plugins