PHPackages                             squinones/woof - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Logging & Monitoring](/categories/logging)
4. /
5. squinones/woof

ActiveLibrary[Logging & Monitoring](/categories/logging)

squinones/woof
==============

Woof - DataDogStatsD Client

1.0.0(11y ago)34.0k2MITPHP

Since Jun 11Pushed 11y agoCompare

[ Source](https://github.com/squinones/woof)[ Packagist](https://packagist.org/packages/squinones/woof)[ Docs](https://github.com/squinones/woof)[ RSS](/packages/squinones-woof/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

\#Woof - A simple DataDogStatsD Client for PHP 5.4+

[![Build Status](https://camo.githubusercontent.com/60c06427db95c1e6cb9eac7e94525daec1c5f36f55746c77a2ff83c2c0307027/68747470733a2f2f7472617669732d63692e6f72672f737175696e6f6e65732f776f6f662e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/squinones/woof)

Woof is a simple PHP client for the DataDog agent, used to send metrics information to DataDog.

Woof uses non-blocking UDP connections to send data with a minimal risk to application perfomance and is *deeply* inspired by [Alex Corsley's library](https://github.com/anthroprose/php-datadogstatsd)

\##Usage (Shamelessly cribbed from here: )

\###Creating a client

```
// Create a new client (localhost:8125 is the default)
$woof = new Woof("localhost", 8125);
```

\###Gauges Gauges measure the value of a particular thing at a particular time, like the amount of fuel in a car’s gas tank or the number of users connected to a system.

```
$woof->gauge("gas_tank.level", 0.75);
$woof->gauge("users.active", 1001);
```

\###Counters Counters track how many times something happened per second, like the number of database requests or page views.

```
$woof->increment("database.query.count");
$woof->increment("page_view.count", 10);
$woof->decrement("available.threads");
```

\###Histograms Histograms track the statistical distribution of a set of values, like the duration of a number of database queries or the size of files uploaded by users. Each histogram will track the average, the minimum, the maximum, the median and the 95th percentile.

```
$woof->histogram("database.query.time", 0.5);
$woof->histogram("file.upload.size", filesize($file));
```

\###Sets Sets are used to count the number of unique elements in a group. If you want to track the number of unique visitor to your site, sets are a great way to do that.

```
$woof->set("users.uniques", $user->getId());
```

\###Timers StatsD only supports histograms for timing, not generic values (like the size of uploaded files or the number of rows returned from a query). Timers are essentially a special case of histograms, so they are treated in the same manner by DogStatsD for backwards compatibility.

```
$woof->timer("response.time", 200);
```

\###Tags Tags are a Datadog specific extension to StatsD. They allow you to tag a metric with a dimension that’s meaningful to you and slice and dice along that dimension in your graphs. For example, if you wanted to measure the performance of two video rendering algorithms, you could tag the rendering time metric with the version of the algorithm you used.

```
$woof->increment("api.requests", 1, ["api"]);               // adds #api tag
$woof->increment("api.errors", 1, ["error_code" => 400]);   // adds #error_code:400 tag
```

\###Sample Rates The overhead of sending UDP packets can be too great for some performance intensive code paths. To work around this, StatsD clients support sampling, that is to say, only sending metrics a percentage of the time. For example:

```
$woof->histogram("my.histogram", 1, [], 0.5);
```

will only be sent to the server about half of the time, but it will be multipled by the sample rate to provide an estimate of the real data.

\###Events Not currently supported

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

4351d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e2bf767c58e7679899cdc29a36452c5f33f439fa330824c996ac801646caf1ac?d=identicon)[ieatkillerbees](/maintainers/ieatkillerbees)

---

Top Contributors

[![ieatkillerbees](https://avatars.githubusercontent.com/u/1664653?v=4)](https://github.com/ieatkillerbees "ieatkillerbees (1 commits)")

---

Tags

loggingstatsdDataDogprofilingdevops

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/squinones-woof/health.svg)

```
[![Health](https://phpackages.com/badges/squinones-woof/health.svg)](https://phpackages.com/packages/squinones-woof)
```

###  Alternatives

[monolog/monolog

Sends your logs to files, sockets, inboxes, databases and various web services

21.4k964.9M7.0k](/packages/monolog-monolog)[itsgoingd/clockwork

php dev tools in your browser

5.9k27.6M94](/packages/itsgoingd-clockwork)[sentry/sentry

PHP SDK for Sentry (http://sentry.io)

1.9k227.1M273](/packages/sentry-sentry)[sentry/sentry-laravel

Laravel SDK for Sentry (https://sentry.io)

1.3k114.3M154](/packages/sentry-sentry-laravel)[datadog/php-datadogstatsd

An extremely simple PHP datadogstatsd client

19124.6M15](/packages/datadog-php-datadogstatsd)[ptrofimov/clockwork-cli

Command-line interface for Clockwork, the tool for debugging and profiling PHP applications

43116.1k](/packages/ptrofimov-clockwork-cli)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)