KairosDB Telnet API

KairosDB Telnet API 提供对指标的存储操作和查询KairosDB当前的版本。

数据点有一个指标、值、时间戳和一个或多个的标记列表。标记用来标示数据属性。文章源自运维生存时间-https://www.ttlsa.com/kairosdb/kairosdb-telnet-api/

指标名、标记名和值区分大小写的，并且只能包含以下字符：字母数字字符，可以含有"."、"/"、"-"、"_"。文章源自运维生存时间-https://www.ttlsa.com/kairosdb/kairosdb-telnet-api/

如果一个数据点的指标不存在，将被创建。文章源自运维生存时间-https://www.ttlsa.com/kairosdb/kairosdb-telnet-api/

put

可以通过telnet 4242端口进行数据的提交。文章源自运维生存时间-https://www.ttlsa.com/kairosdb/kairosdb-telnet-api/

数据格式为：文章源自运维生存时间-https://www.ttlsa.com/kairosdb/kairosdb-telnet-api/

put <metric name> <time stamp> <value> <tag> <tag>... /n

Metric name： 指标名称只能是字母数字-_. 。文章源自运维生存时间-https://www.ttlsa.com/kairosdb/kairosdb-telnet-api/

Time stamp：时间戳可以是毫秒或秒。秒是为了和OpenTSDB兼容。Cassandra支持毫秒数据存储。注意：REST API只支持毫秒时间戳。文章源自运维生存时间-https://www.ttlsa.com/kairosdb/kairosdb-telnet-api/

value: 值可以是一个长或双精度值。文章源自运维生存时间-https://www.ttlsa.com/kairosdb/kairosdb-telnet-api/

Tag：一系列的key=value键值对。文章源自运维生存时间-https://www.ttlsa.com/kairosdb/kairosdb-telnet-api/

注意：发送的数据后面必须跟一个换行符。文章源自运维生存时间-https://www.ttlsa.com/kairosdb/kairosdb-telnet-api/

例如：文章源自运维生存时间-https://www.ttlsa.com/kairosdb/kairosdb-telnet-api/

#!/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版本信息。文章源自运维生存时间-https://www.ttlsa.com/kairosdb/kairosdb-telnet-api/

version /n

输出：文章源自运维生存时间-https://www.ttlsa.com/kairosdb/kairosdb-telnet-api/

KairosDB
0.9.4

使用netcat：文章源自运维生存时间-https://www.ttlsa.com/kairosdb/kairosdb-telnet-api/

echo "version" | nc -w 30 localhost 4242