试用时间序列数据库InfluxDB

时间:2017-01-25 07:49:26   收藏:0   阅读:8580

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写监控前端

本文出自 “实践检验真理” 博客,转载请与作者联系!

评论(0
© 2014 mamicode.com 版权所有 京ICP备13008772号-2  联系我们:gaon5@hotmail.com
迷上了代码!