RackPing Monitoring Widget for WordPress (Single-site)

Screenshots

1. RackPing WordPress widget setup page

RackPing WordPress widget setup page

2. RackPing WordPress widget display with Twenty Ten theme

RackPing WordPress widget display with Twenty Ten theme

Summary

Contributors: RackPing
Tags: monitoring, widget, badge
Requires at least: 2.8
Tested up to: 4.9.1
Stable tag: 1.0
License: GPLv2

Description

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.

Installation

Installing the RackPing Monitoring widget is the same as any other single-site WordPress widget:

  1. 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

  1. Check the following two files exist and have writable permissions by your web server:
cd /usr/share/wordpress/wp-content/plugins/rackping;
touch rackping_graph.png; chmod 666 rackping_graph.png;
touch rackping_log.php; chmod 666 rackping_log.php;
  1. "Plugins ... Activate", "Appearance ... Widgets ... RackPing Monitoring", then enter your RackPing login info (email, Blog key and Monitor ID).

You're done. Enjoy!

Plugin Usage

Use the RackPing widget wherever widgets are allowed in your WordPress theme.

Upgrade

Upgrade using the Wordpress Admin or overwrite your files/folder with the new files/folder, then deactivate and reactivate under "Plugins".

Dependencies

  • Uses WordPress 2.8+ API only.
  • No external or other dependencies.

Frequently Asked Questions

How Can I Localize the Language of the RackPing Widget?

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".

Availability

For maximum availability, please read the following:

  1. The plugin data file, rackping_graph.png, used to periodically save data must exist and be writable by the web server user.
  2. The logfile, rackping_log.php, though optional is helpful for debugging problems. It is automatically truncated after 50,000 bytes.
  3. The RackPing widget has comprehensive error handling, so should reliably operate without intervention.
  4. 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.
  5. 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.

Security

For maximum security when using WordPress plugins:

  1. The WordPress MySQL user should only access the wordpress database.
  2. Plugin program files should be owned by an OS user different than the web server or mysqld user, such as root on linux.
  3. The RackPing widget uses SSL when periodically retrieving the graph data.
  4. 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.)
  5. 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.

Troubleshooting

  1. 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
  1. 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.

  2. error messages will be logged to rackping_log.php and your web server's error log.

  3. You can enable limited debug logging with:

$ echo 1 >debug

To disable debugging output:

$ rm debug
  1. 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:
  1. Click on "Appearances ... RackPing Monitoring ... Delete" and "Plugins ... Deactivate"

  2. Start your MySQL client program and delete the old RackPing WordPress options row:

use wordpress;
select option_id into @a from wp_options where option_name='widget_rackping' limit 1;
select @a;
delete from wp_options where option_id=@a;

Changelog

1.0 Release Date - 15 November 2017

  • Initial release.

Resources

Downloads

Click to see all RackPing plugins