README

Phetric 是一个库，允许您将 PHP 应用程序级别的指标发送到捕获器（例如 MetricCatcher），然后以有趣和吸引人的方式提供这些指标。

许可证

MIT 许可证授权。

如何使用 Phetric

如果您没有使用自动加载器，您需要包含发送者（这将引入所有其他内容）

require_once('phetric/Sender.php');

接下来，您需要告诉 Phetric 它应该在有了指标后将其发送到何处。当我们初始化发送者时，我们需要说明我们想要我们的指标在哪里，我们想要发送到什么端口，以及一个可选的字符串，该字符串将被添加到所有指标之前。这有助于识别发送请求的应用程序。

Phetric_Sender::init( 'localhost', '1420', $prepend );

最后，我们可以发送我们的指标。Phetric 实现了仪表、计数器、计量器、直方图和计时器。当您创建一个新的指标时，您需要使用名称创建它，并且对于除计时器之外的所有内容，标记我们的值。

仪表

// Create a metric and mark some data
$gauge = Phetric_Gauge::create('label');
$gauge->mark(42414);

计时器

计时器以微秒计算从开始到停止的时间间隔。

// Create a Timer and call it
$blue = Phetric_Timer::create('blue');
$blue->start();

// Do something

// Stop our Timer
$blue->stop();

计数器

计数器默认为 1，如果您在标记时不指定数字

// One line example
Phetric_Counter::create('orange')->mark(123);

计量器

计量器测量事件随时间的变化率（例如，“每秒请求”）。除了平均速率之外，计量器还跟踪 1 分钟、5 分钟和 15 分钟的移动平均值。

Phetric_Meter::create('red')->mark(123);

直方图

直方图用于测量值的统计分布。除了最小值、最大值、平均值等之外，它还测量中位数、75%、90%、95%、98%、99%以及99.9%的分位数。

$yellow = Phetric_Histogram::create('yellow');
$yellow->mark(13);

检查你发送的数据

如果你不想运行本地版本的MetricCatcher，这个bash函数将使用netcat监听1420端口，并将所有通过UDP到达的数据输出。

catcher(){
    while true;
    do
        nc -w 1 -l -u 1420;
    done;
}

行政事项

作者

Phetric是由Aaron Jorbin编写的，他在AddThis工作期间完成了它。[Aaron Jorbin的网站](http://aaron.jorb.in)[Aaron Jorbin的邮箱](mailto:aaron@jorb.in)。

使用Composer与Phetric配合使用

Phetric可以通过[packagist](https://packagist.org.cn/packages/clearspring/phetric)获取，多亏了[https://github.com/ammmze](https://github.com/ammmze)。

错误及其他

请在Phetric的GitHub页面报告错误或请求新功能：[http://github.com/addthis/Phetric](http://github.com/addthis/Phetric)

工作机会

在撰写本文时，AddThis正在招聘；即使这一行的责任来自很久以前，他们可能仍然在招聘。如果你对做Web应用、处理大数据，并且喜欢聪明、有趣的同事感兴趣，请查看[http://www.addthis.com/careers](http://www.addthis.com/careers)。AddThis位于华盛顿特区（Tysons Corner）附近，并在纽约、洛杉矶等地方设有办公室。

clearspring / phetric

维护者

详细信息