README

#Woof - PHP 5.4+ 的简单 DataDogStatsD 客户端

Woof 是 DataDog 代理的简单 PHP 客户端，用于向 DataDog 发送指标信息。

Woof 使用非阻塞 UDP 连接以最小化对应用程序性能的风险发送数据，并且深受 Alex Corsley 的库的启发。

##使用方法（无耻地借鉴自此处： http://docs.datadoghq.com/guides/dogstatsd/)

###创建客户端

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

###仪表仪表用于测量特定事物在特定时间的值，例如汽车油箱中的燃油量或连接到系统的用户数量。

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

###计数器计数器跟踪每秒钟发生的事情的次数，例如数据库请求或页面浏览量。

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

###直方图直方图跟踪一组值的统计分布，例如多个数据库查询的持续时间或用户上传的文件大小。每个直方图将跟踪平均值、最小值、最大值、中位数和第95个百分位数。

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

###集合集合用于计算组中唯一元素的数量。如果您想跟踪您网站上的唯一访问者数量，集合是一个很好的方法。

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

###计时器StatsD 只支持直方图来计时，而不是通用值（如上传文件的大小或查询返回的行数）。计时器实际上是直方图的一个特殊案例，因此 DogStatsD 以相同的方式处理它们，以保持向后兼容。

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

###标签标签是 Datadog 对 StatsD 的特定扩展。它们允许您使用对您有意义的维度对指标进行标记，并在图中根据该维度进行切片和切块。例如，如果您想测量两个视频渲染算法的性能，您可以将渲染时间指标标记为使用的算法版本。

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

###采样率发送 UDP 数据包的开销对于一些性能密集型代码路径可能太大。为了解决这个问题，StatsD 客户端支持采样，即只发送一定比例的时间的指标。例如

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

将只有大约一半的时间发送到服务器，但将通过采样率乘以以提供实际数据的估计。

###事件目前不支持

squinones / woof

维护者

详细信息

README