onema/php-datadogstatsd

这是一个极其简单的 PHP datadogstatsd 客户端。这是从 https://www.datadoghq.com/ github 仓库中找到的库的分支。

0.4.1 2016-07-27 04:09 UTC

This package is not auto-updated.

Last update: 2024-09-26 01:20:45 UTC


README

这是一个极其简单的 PHP datadogstatsd 客户端。需要 PHP >= 5.3.0。

查看 CHANGELOG.md 了解更改。

安装

Composer

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

"datadog/php-datadogstatsd": "0.3.*"

注意:Composer 中发布的第一个版本是 0.0.3

或手动

github.com/DataDog/php-datadogstatsd 复制仓库

设置: require './libraries/datadogstatsd.php';

用法

增加

增加事物

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

减少

减少事物

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

计时

计时事物

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

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

提交事件

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

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

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

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

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

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