influxDB快速入门

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）。

数据格式

<measurement>[,<tag-key>=<tag-value>...] <field-key>=<field-value>[,<field2-key>=<field2-value>...] [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`