influxDB简介
influxDB是近年流行的一种时序数据库,专用于时序数据的存储和查询, 从其功能介绍和适用场景看,可以说是专为监控系统而设计。
以下测试基于CentOS 7.5,使用influxDB 1.7.9。
安装
RPM本地安装
wget https://dl.influxdata.com/influxdb/releases/influxdb-1.7.9.x86_64.rpm
sudo yum localinstall influxdb-1.7.9.x86_64.rpm
docker安装
docker search influxdb
docker pull influxdb
sudo docker run -d -p 8083:8083 -p8086:8086 --expose 8090 --expose 8099 --name influxDbService influxdb
详见:https://docs.influxdata.com/influxdb/v1.7/introduction/installation/
服务管理
启动
安装后成为系统服务,如centos7.5系统下,使用systemctl start influxdb启动
查看服务状态:systemctl status influxdb
停止服务:systemctl stop influxdb
配置
配置文件路径:/etc/influxdb/influxdb.conf
典型配置项:
数据存储路径,默认为/var/lib/influxdb/data。
端口,默认为8086。
基本概念
- database
类比MySQL中的数据库
- measurements
类比MySQL中的表,对于监控系统,可对应一个指标。
- tag、field
tag和field可类比MySQL表中的字段,区别是tag可认为是加了索引的字段,而field则是未加索引的字段。
tag的值只能是string,field的值可以是string, float, integer, Boolean。
- point
类比MySQL表中的一行,都会带时间戳。
- retention policy
数据保持策略,指明数据多久失效、数据保存几个副本
- series
相同retention policy,相同measurement、tag key和value的一组数据(point)。
- 数据格式
[,=...] =[,=...] [unix-nano-timestamp]
如:cpu,host=serverA,region=us_west value=0.64
注意不要习惯性地多加空格,会报错。
详见:https://docs.influxdata.com/influxdb/v1.7/concepts/key_concepts/
使用
客户端CLI
influxDB支持的类sql名为influxQL,与SQL比较接近。
执行命令influx进入客户端。
- 查看数据库:
show databases;
- 创建数据库:
create database my_db;
- 查看measurements(类似MySQL表):
show measurements;
- 创建measurements:不需要提前创建,直接写数据即可。
- 写数据
按照上面的数据格式,注意不要多加空格。
insert cpu,host=serverA,region=us_west value=0.64
- 查询数据
select count(*) from "cpu";
select * from "cpu";
select value from "cpu";
select * from "cpu" limit 1;
//注意不支持limit 1,10这种写法。
select * from "cpu" order by time desc limit 1;
select * from cpu where host::tag='serverA';//条件查询,按tag查
select * from cpu where value::field > 0.5; //条件查询,按field查
select * from cpu where host::tag='serverA' and value::field > 0.5;//多条件查询
select max(value) from cpu where host::tag='serverA';//使用聚合函数
详见:https://docs.influxdata.com/influxdb/v1.7/query_language/spec/
http接口
CLI方式只适合调试和维护,程序调用需要用http接口。
使用方式与CLI类似,传入适当参数即可。
以curl命令为例:
创建数据库:
curl -i -XPOST http://localhost:8086/query --data-urlencode "q=CREATE DATABASE mydb"
写一条数据:
curl -i -XPOST 'http://localhost:8086/write?db=mydb' --data-binary 'cpu_load_short,host=server01,region=us-west value=0.64 1434055562000000000'
写多条数据:
curl -i -XPOST 'http://localhost:8086/write?db=mydb' --data-binary 'cpu_load_short,host=server02 value=0.67
cpu_load_short,host=server02,region=us-west value=0.55 1422568543702900257
cpu_load_short,direction=in,host=server01,region=us-west value=2.0 1422568543702900257'
从文件加载数据:
如文件cpu_data.txt中存储了数据:
cpu_load_short,host=server02 value=0.67
cpu_load_short,host=server02,region=us-west value=0.55 1422568543702900257
执行命令:
curl -i -XPOST 'http://localhost:8086/write?db=mydb' --data-binary @cpu_data.txt`