README

从 https://github.com/DataDog/php-datadogstatsd 分支而来。

安装

Composer

将以下内容添加到您的 composer.json

"lsjroberts/datadog-statsd": "0.1.*"

设置

Laravel 4

将服务提供者添加到您的 Laravel 应用程序中的 app/config/app.php 文件。在 providers 数组中添加

'DataDog\Statsd\StatsdServiceProvider',

然后在同一文件中将外观添加到 facades 数组中，以创建别名

'Statsd' => 'DataDog\Statsd\Facades\Illuminate',

独立

如果您正在使用其他框架或编写独立项目，可以直接调用

use DataDog\Statsd\Facades\Agnostic as Statsd;

使用

增加

用于增加事物

Statsd::increment('your.data.point');
Statsd::increment('your.data.point', .5);
Statsd::increment('your.data.point', 1, array('tagname' => 'value'));

减少

用于减少事物

Statsd::decrement('your.data.point');

计时

用于计时事物

$start_time = microtime(true);
run_function();
Statsd::timing('your.data.point', microtime(true) - $start_time);

Statsd::timing('your.data.point', microtime(true) - $start_time, 1, array('tagname' => 'value'));

提交事件

需要 PHP >= 5.3.0 和 PECL http 扩展

要提交事件，您需要首先使用您的 Datadog 凭证配置库，因为事件函数直接提交到 Datadog，而不是发送到本地 dogstatsd 实例。

$apiKey = 'myApiKey';
$appKey = 'myAppKey';

Statsd::configure($apiKey, $appKey);
Statsd::event('A thing broke!', array(
	'alert_type'      => 'error',
	'aggregation_key' => 'test_aggr'
));
Statsd::event('Now it is fixed.', array(
	'alert_type'      => 'success',
	'aggregation_key' => 'test_aggr'
));

这是您在 Datadog 事件流中会看到的内容

您可以在 API 选项卡 中找到您的 API 和应用程序密钥。

有关事件可选值的更多文档，请参阅 http://docs.datadoghq.com/api/#events/。

请注意，虽然使用此库发送指标速度快，因为它是在本地通过 UDP 发送，但发送事件将会较慢，因为它直接通过 HTTP 将数据发送到 Datadog。我们希望在不久的将来改进这一点。

原始作者

Alex Corley - anthroprose@gmail.com