Title: StatsD WordPress Client
Author: Aaron Edwards
Published: <strong>April 29, 2014</strong>
Last modified: August 18, 2020

---

Search plugins

![](https://ps.w.org/statsd/assets/banner-772x250.jpg?rev=905061)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/statsd_131313.svg)

# StatsD WordPress Client

 By [Aaron Edwards](https://profiles.wordpress.org/uglyrobot/)

[Download](https://downloads.wordpress.org/plugin/statsd.0.2.zip)

 * [Details](https://pcd.wordpress.org/plugins/statsd/#description)
 * [Reviews](https://pcd.wordpress.org/plugins/statsd/#reviews)
 *  [Installation](https://pcd.wordpress.org/plugins/statsd/#installation)
 * [Development](https://pcd.wordpress.org/plugins/statsd/#developers)

 [Support](https://wordpress.org/support/plugin/statsd/)

## Description

For live environment no-latency massively-scalable application metric tracking and
code profiling via [Etsy’s StatsD](http://codeascraft.com/2011/02/15/measure-anything-measure-everything/)
+ Graphite.

Tracks everything in WordPress and Multisite:

 * Logins (success, fails, logout)
 * Password resets (attempts/successes)
 * User count (guage)
 * Users (registrations, spam, ham)
 * Posting (publish, trash, delete)
 * Commenting (received, approved, trashed, spam, unspam)
 * Attachments (Add, edit, delete)
 * XML-RPC (every command individually, you can rollup)
 * Multisite blog count (guage)
 * Multiiste blog actions (new, spam, ham, archive, unarchive, delete, undelete)
 * Page generation times
 * Query count (type + time when SAVEQUERIES defined)
 * Remote HTTP requests (count, time – by host)
 * WP Cron calls
 * WP Emails
 * and more!

Requires [StatsD](https://github.com/etsy/statsd) on localhost or a server on your
private network.

You can also call the $statsd global class in other plugin/theme code for instant
tracking of any application metric. See API usage instructions: https://github.com/
domnikl/statsd-php/blob/develop/README.md

Contribute at [GitHub](https://github.com/uglyrobot/wordpress-statsd).

### To Do

Want to implement batch collection and send of metrics via one or minimal UDP packets
required based on connection time.

## Screenshots

 * [[
 * Example dashboard created in Graphite with data collected from this plugin.
 * [[
 * Track any other application stat in your WordPress site with 1 line of code in
   your plugin/theme.

## Installation

 1. Install [StatsD](https://github.com/etsy/statsd) on localhost or a server on your
    private network.
 2. If StatsD is not on localhost, define the local daemon IP in wp-config.php: `define('
    STATSD_IP', 'x.x.x.x' );`
 3. Install the plugin
 4. Activate or Network Activate on multisite
 5. That’s it!

See the FAQ for more advanced configuration.

## FAQ

By default the parent namespace used for stats is “yourdomain_yourpath.wordpress._”
where yourdomain\_yourpath would be “www\_domain\_com\_blog” if your site is http://
www.domain.com/blog/. You can override the parent namespace via the `define('STATSD\
_NAMESPACE', 'mysite.myserver');` define in wp-config.php. This one is very important,
controls how it shows up in Graphite stats.
 This should be segmented, left to right
general to specific. All “.” trigger segments. For example: applicationname.server
like ‘wpmudev.app1’ or ‘edublogs.web4’. That allows for drilling down, but can still
wrapup in graphs with ‘edublogs.‘ etc.

Can also be run as an mu-plugin by dropping statsd.php in `/wp-content/mu-plugins/`.

If needed you can overide the default UDP port of 8125 via `define('STATSD_PORT',
xxxx);` define.

If you have a very high traffic site you can lower the default 0.5 sample rate for
per-pageload calls via `STATSD_SAMPLE_RATE`.

If you don’t want to send HTTP metrics per page URL, you can disable this via SKIP_URL_METRICS

Contribute at [GitHub](https://github.com/uglyrobot/wordpress-statsd).

## Reviews

![](https://secure.gravatar.com/avatar/76b74b052c98504b5989e983d0c5fbe671c1535ec3b01024f520f0709cb9b2d9?
s=60&d=retro&r=g)

### 󠀁[Proven to work well](https://wordpress.org/support/topic/proven-to-work-well/)󠁿

 [WPMU DEV – Your All-in-One WordPress Platform](https://profiles.wordpress.org/wpmudev/)
September 3, 2016

We use on hundreds of high traffic websites and it’s quite useful for monitoring
and debugging.

 [ Read all 1 review ](https://wordpress.org/support/plugin/statsd/reviews/)

## Contributors & Developers

“StatsD WordPress Client” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Aaron Edwards ](https://profiles.wordpress.org/uglyrobot/)

[Translate “StatsD WordPress Client” into your language.](https://translate.wordpress.org/projects/wp-plugins/statsd)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/statsd/), check out
the [SVN repository](https://plugins.svn.wordpress.org/statsd/), or subscribe to
the [development log](https://plugins.trac.wordpress.org/log/statsd/) by [RSS](https://plugins.trac.wordpress.org/log/statsd/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 0.2

 * Ability to disable per url metrics for HTTP calls via SKIP_URL_METRICS define–
   props @Sophie Haskins

#### 0.1

 * Initial Release

## Meta

 *  Version **0.2**
 *  Last updated **6 years ago**
 *  Active installations **10+**
 *  WordPress version ** 3.7 or higher **
 *  Tested up to **4.6.30**
 *  Language
 * [English (US)](https://wordpress.org/plugins/statsd/)
 * Tags
 * [graphite](https://pcd.wordpress.org/plugins/tags/graphite/)[metrics](https://pcd.wordpress.org/plugins/tags/metrics/)
   [multisite](https://pcd.wordpress.org/plugins/tags/multisite/)[stats](https://pcd.wordpress.org/plugins/tags/stats/)
 *  [Advanced View](https://pcd.wordpress.org/plugins/statsd/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/statsd/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/statsd/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/statsd/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/statsd/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/statsd/reviews/?filter=1)

[Add my review](https://wordpress.org/support/plugin/statsd/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/statsd/reviews/)

## Contributors

 *   [ Aaron Edwards ](https://profiles.wordpress.org/uglyrobot/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/statsd/)