KairosDB Telnet API 提供对指标的存储操作和查询KairosDB当前的版本。
数据点有一个指标、值、时间戳和一个或多个的标记列表。标记用来标示数据属性。
指标名、标记名和值区分大小写的,并且只能包含以下字符:字母数字字符,可以含有"."、"/"、"-"、"_"。
如果一个数据点的指标不存在,将被创建。
put
可以通过telnet 4242端口进行数据的提交。
数据格式为:
1
|
put
<
metric
name
>
<
time
stamp
>
<
value
>
<
tag
>
<
tag
>
.
.
.
/
n
|
Metric name: 指标名称只能是字母数字-_. 。
Time stamp:时间戳可以是毫秒或秒。秒是为了和OpenTSDB兼容。Cassandra支持毫秒数据存储。注意:REST API只支持毫秒时间戳。
value: 值可以是一个长或双精度值。
Tag:一系列的key=value键值对。
注意:发送的数据后面必须跟一个换行符。
例如:
1
2
3
4
5
6
7
8
9
|
#!/bin/bash
# Current time in milliseconds
now
=
$
(
(
$
(
date
+
%
s
%
N
)
/
1000000
)
)
metric
=
load_value_test
value
=
42
host
=
10.92.4.4
echo
"put $metric $now $value host=www.ttlsa.com"
|
nc
-
w
30
$
host
4242
|
version
该命令返回KairosDB版本信息。
1
|
version
/
n
|
输出:
1
2
|
KairosDB
0.9.4
|
使用netcat:
1
|
echo
"version"
|
nc
-
w
30
localhost
4242
|
收 藏
转载请注明:成长的对话 » KairosDB Telnet API