README

描述

用PHP编写的KairosDB客户端库。本软件包提供方便的功能来读取和写入时间序列数据。它使用HTTP协议与您的KairosDB集群进行通信。

入门指南

安装（Composer）

$ composer require 'danibrutal/kairosdb-client:dev-master'

连接到您的数据库

连接到KairosDB数据库很简单。您需要一个主机名和一个端口号。默认端口号是8080。

有关更多信息，请参阅KairosDB 文档。

插入数据

我们可以添加一个单独的数据点

require 'vendor/autoload.php';

$client = new KairosDB\Client('localhost', 8090);
$tags = ['host'=> 'precise64'];
$metricName = 'network_out';

for($i=2; $i<100; $i++) {
    $dataPointValue = $i *2;
    $client->addDataPoint($metricName, $dataPointValue, $tags);
    usleep(100);
}

或者使用批量插入

require 'vendor/autoload.php';

$client = new \KairosDB\Client('localhost', 8090);
$tags = ['host'=> 'precise64'];
$metricName = 'network_out';

$dataPointCollection = new \KairosDB\DataPointCollection($metricName, $tags);

for($i=2; $i<100; $i++) {
    $dataPointValue = $i *2;    
    $dataPointCollection->addPoint($dataPointValue);
    usleep(100);
}

$client->addDataPoints($dataPointCollection);

查询数据点

需要起始日期，如果未指定，则默认为NOW。还需要查询的指标。可选地，可以添加标签以缩小搜索范围。

require 'vendor/autoload.php';

$client = new KairosDB\Client('localhost', 8090);

$queryBuilder = new \KairosDB\QueryBuilder();
$tags = ['host'=> 'precise64'];

$query = $queryBuilder
    ->start(['value'=> '1', 'unit' => 'days'])
    ->cache(10)
    ->addMetric('network_in')
    ->tags($tags)
    ->build();

$results = $client->query($query);

查询指标名称

您可以在KairosDB中获取所有指标名称的列表。

require 'vendor/autoload.php';

$client = new KairosDB\Client('localhost', 8090);

$results = $client->getMetricNames($query);

查询标签名称

类似地，您可以在KairosDB中获取所有标签名称的列表。

require 'vendor/autoload.php';

$client = new KairosDB\Client('localhost', 8090);

$results = $client->getTagNames($query);

查询标签值

并列出所有标签值。

require 'vendor/autoload.php';

$client = new KairosDB\Client('localhost', 8090);

$results = $client->getTagValues($query);

自定义数据类型

待实现

KairosDB 文档

请参阅http://kairosdb.github.io/kairosdocs/以获取文档。