试用时间序列数据库InfluxDB

Hadoop集群监控需要使用时间序列数据库，今天花了半天时间调研使用了一下最近比较火的InfluxDB，发现还真是不错，记录一下学习心得。

Influx是用Go语言写的，专为时间序列数据持久化所开发的，由于使用Go语言，所以各平台基本都支持。类似的时间序列数据库还有OpenTSDB，Prometheus等。

OpenTSDB很有名，性能也不错，但是基于HBase，要用那个还得先搭一套HBase，有点为了吃红烧肉自己得先去杀猪，烫皮，拔毛的感觉。Prometheus相关文档和讨论太少，而InfluxDB项目活跃，使用者多，文档也比较丰富，所以先看看这个。Influx可以说是LevelDB的Go语言修改版实现，LevelDB采用LSM引擎，效率很高，Influx是基于LSM引擎再修改的TSM引擎，专为时间序列设计。

InfluxDB 架构原理介绍

LevelDB 架构原理介绍

下午跟七牛的CrazyJVM聊了一下，因为七牛都是用Go，所以也大量部署了Influx给大型企业级用户使用，据说是全球最大的InfluxDB集群，七牛也给Influx提交了大量的Patch，结果Influx通过早期开源弄得差不多稳定了，突然就闭源了，这也太不局气了，然后搞Cluster功能收费，单机功能免费使用。

昨天看了一会文档，今天试用了一下，感觉很不错，值得推荐。把学习了解的内容记录下来，供爱好者参考，也省的自己时间长忘了。

InfluxDB其实不能说像哪个数据库，初上手感觉更像Mongo类型的NoSQL，但是有意思的是，它提供了类SQL接口，对开发人员十分友好。命令行查询结果的界面又有点像MySQL，挺有意思的。

不写安装部署和CLI接口，因为实在没得可写，直接yum或者apt就装了。service一启动，再influx命令就进命令行了，网上一大堆安装教程

InfluxDB有几个关键概念是需要了解的。

database：相当于RDBMS里面的库名。创建数据库的语句也十分相似。一进去就可以先创建一个数据库玩，加不加分号都行。

CREATE DATABASE 'hadoop'

然后需要创建一个用户，我省事点，直接创建一个最高权限，就看了一天，然后直接写REST接口去了，权限管理慢慢再细看。

CREATE USER "xianglei" WITH PASSWORD 'password' WITH ALL PRIVILEGES

使用查询语句插入一条数据

INSERT hdfs,hdfs=adh,path=/ free=2341234,used=51234123,nonhdfs=1234

Influx没有先建立schema的概念，因为Influx允许存储的数据是schemeless的，表在这里叫做measurement，数据在插入时如果没有表，则自动创建该表。

measurement: 相当于RDBMS里面的数据表名。

在上面的INSERT语句中，跟在insert后面的第一个hdfs就是measurement，如果不存在一个叫做hdfs的，就自动创建一个叫做hdfs的表，否则直接插入数据。

然后是tags，tags的概念类似于RDBMS里面的查询索引名，这里的tags是hdfs=adh和path=/，等于我建立了两个tags。

free往后统称叫fields，tags和fields之间用空格分开，tags和fields内部自己用逗号分开。tags和fields名称可以随意填写，主要是一开始设计好就行。

所以，对以上插入语句做一个注释的话，就是这样。

INSERT [hdfs(measurement)],[hdfs=adh,path=/(tags)] [free=2341234,used=51234123,nonhdfs=1234(fields)]

然后即可查询该数据

SELECT free FROM hdfs WHERE hdfs='adh' and path='/'

name: hdfs
time                    free
----                    ----
1485251656036494252     425234
1485251673348104714     425234

SELECT * FROM hdfs LIMIT 2

name: hdfs
time                  free    hdfs    nonhdfs  path   used
----                  ----    ----    -------  ----   ----
1485251656036494252   425234  adh     1341     /      23412
1485251673348104714   425234  adh     1341     /      23412

这里的where条件，即是上面tags里面的hdfs=adh和path=/，所以tags可以随意添加，但是在插入第一条数据的时候，最好先设计好你的查询条件。当然，你插入的任何数据，都会自动添加time列，数了数，应该是纳秒级的时间戳。

上面是Influx的基本概念和基本使用的记录，下面是接口开发的使用。以Tornado示例Restful查询接口。

Influx本身支持restful的HTTP API，python有直接封装的接口可以调用，直接 pip install influxdb即可

influxdb-python文档

Talk is cheap, show me your code.

Models  Influx模块，用于连接influxdb

class InfluxClient:
    def __init__(self):
        self._conf = ParseConfig()
        self._config = self._conf.load()
        self._server = self._config['influxdb']['server']
        self._port = self._config['influxdb']['port']
        self._user = self._config['influxdb']['username']
        self._pass = self._config['influxdb']['password']
        self._db = self._config['influxdb']['db']
        self._retention_days = self._config['influxdb']['retention']['days']
        self._retention_replica = self._config['influxdb']['retention']['replica']
        self._retention_name = self._config['influxdb']['retention']['name']
        self._client = InfluxDBClient(self._server, self._port, self._user, self._pass, self._db)

    def _create_database(self):
        try:
            self._client.create_database(self._db)
        except Exception, e:
            print e.message

    def _create_retention_policy(self):
        try:
            self._client.create_retention_policy(self._retention_name,
                                                 self._retention_days,
                                                 self._retention_replica,
                                                 default=True)
        except Exception, e:
            print e.message

    def _switch_user(self):
        try:
            self._client.switch_user(self._user, self._pass)
        except Exception, e:
            print e.message

    def write_points(self, data):
        self._create_database()
        self._create_retention_policy()
        if self._client.write_points(data):
            return True
        else:
            return False

    def query(self, qry):
        try:
            result = self._client.query(qry)
            return result
        except Exception, e:
            return e.message

连接influxdb的配置从项目的配置文件里读取，自己写也行。

Controller模块InfluxController

class InfluxRestController(tornado.web.RequestHandler):
    '''
    "GET"
        op=query&qry=select+used+from+hdfs+where+hdfs=adh
    '''
    查询方法，使用HTTP GET
    def get(self, *args, **kwargs):
        op = self.get_argument('op')
        #自己实现的python switch case，网上一大堆
        for case in switch(op):
            if case('query'):
                #查询语句从url参数获取
                qry = self.get_argument('qry')
                #实例化Models里面的class
                influx = InfluxClient()
                result = influx.query(qry)
                #返回结果为对象，通过raw属性获取对象中的字典。
                self.write(json.dumps(result.raw, ensure_ascii=False))
                break

            if case():
                self.write('No argument found')

    #写入数据，使用HTTP PUT
    def put(self):
        op = self.get_argument('op')
        for case in switch(op):
            if case('write'):
                #data should urldecode first and then turn into json
                data = json.loads(urllib.unquote(self.get_argument('data')))
                influx = InfluxClient()
                #写入成功或失败判断
                if influx.write_points(data):
                    self.write('{"result":true}')
                else:
                    self.write('{"result":false}')
                break
            if case():
                self.write('No argument found')

Tornado配置路由

applications = tornado.web.Application(
    [
        (r'/', IndexController),
        (r'/ws/api/influx', InfluxRestController)
    ],
    **settings
)

JSON项目配置文件

{
  "http_port": 19998,
  "influxdb":{
    "server": "47.88.6.247",
    "port": "8086",
    "username": "root",
    "password": "root",
    "db": "hadoop",
    "retention": {
      "days": "365d",
      "replica": 3,
      "name": "hound_policy"
    },
    "replica": 3
  },
  "copyright": "CopyLeft 2017 Xianglei"
}

插入测试

def test_write():
    base_url = 'http://localhost:19998/ws/api/influx'
    #data = '[{"measurement": "hdfs"},"tags":{"hdfs": "adh","path":"/user"},"fields":{"used": 234123412343423423,"free": 425234523462546546,"nonhdfs": 1341453452345}]'
    #构造插入数据
    body = dict()
    body['measurement'] = 'hdfs'
    body['tags'] = dict()
    body['tags']['hdfs'] = 'adh'
    body['tags']['path'] = '/'
    body['fields'] = dict()
    body['fields']['used'] = 234123
    body['fields']['free'] = 425234
    body['fields']['nonhdfs'] = 13414
    tmp = list()
    tmp.append(body)

    op = 'write'
    # dict data to json and urlencode
    data = urllib.urlencode({'op': op, 'data': json.dumps(tmp)})
    headers = {'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8'}
    try:
        http = tornado.httpclient.HTTPClient()
        response = http.fetch(
            tornado.httpclient.HTTPRequest(
                url=base_url,
                method='PUT',
                headers=headers,
                body=data
            )
        )
        print response.body
    except tornado.httpclient.HTTPError, e:
        print e

test_write()

插入数据后通过访问http连接获取插入结果

curl -i "http://localhost:19998/ws/api/influx?op=query&qry=select%20*%20from%20hdfs"
HTTP/1.1 200 OK
Date: Tue, 24 Jan 2017 15:47:42 GMT
Content-Length: 1055
Etag: "7a2b1af6edd4f6d11f8b000de64050a729e8621e"
Content-Type: text/html; charset=UTF-8
Server: TornadoServer/4.4.2

{"values": [["2017-01-24T09:54:16.036494252Z", 425234, "adh", 13414, "/", 234123]], "name": "hdfs", "columns": ["time", "free", "hdfs", "nonhdfs", "path", "used"]}

收工，明天用React写监控前端