InfluxDB是一款开源的时序数据库,使用GO语言编写,无需外部依赖,其设计目标是实现分布式和水平伸缩扩展。主要用于监控基础设施,IoT监控(公路摄像头、手机、微波炉、冰箱)等场景。这里使用的是1.8.1版本。
第一步,InfluxDB的安装;
第二步,修改配置文件;
来到解压好的目录下,有六个文件:
influx.exe 是命令行工具;
influxd.exe 是服务端程序;
influx_inspect.exe 是数据检查工具;
influx_stress.exe 是压力测试工具;
influx_tsm是数据库个啥转换工具(将数据库从 b1 或 bz1 格式转换为 tsm1 格式);
influxdb.conf 是配置文件,不修改,则使用默认的配置文件;
启动influxd.exe后,会生成三个文件夹:meta、wal、data,它们是数据库文件存放的目录,使用默认的配置时,会在C盘用户下的influxdb下生成;
meta 用于存储数据库的一些元数据,meta 目录下有一个 meta.db 文件;
wal 目录存放预写日志文件,以 .wal 结尾;
data 目录存放实际存储的数据文件,以 .tsm 结尾。
这里修改下数据库文件存放的路径,然后启动;
[meta]
dir = "D:/database/influxdb-1.8.1-1/meta"
[data]
dir = "D:/database/influxdb-1.8.1-1/data"
wal-dir = "D:/database/influxdb-1.8.1-1/wal"
第三步,启动服务端,客户端(命令行工具);
1.启动服务端influxd.exe;
建立一个批处理文件,指定启动指向配置文件,启动服务端influxd.exe;
start.bat文件内容如下:
set HOME=D:\database\influxdb-1.8.1-1
influxd.exe -config influxdb.conf
2.启动命令行工具influx.exe;
再建立一个批处理文件,用于启动influx.exe;
bat文件内容如下,其中端口号指向服务器的端口:
set HOME=D:\database\influxdb-1.8.1-1
influx -port 6086
第四步,在客户端窗口里操作命令;
show databases //展示所有的数据库
create database [databaseName] //创建数据库
use [databaseName] //使用其中的一个数据库,表名有点号时,用双引号包起来
show measurements //展示选中数据库中所有的数据表,没有表则无返回
insert , [timestamp] //新增一条数据,表不存在时,创建表;
drop measurement //删除表
delete from //删除表中所有的数据
precision rfc3339 //可以设置一下时间显示格式
show users //展示所有的用户
create user "user" with password 'user' //新增用户
create user "admin" with password 'admin' with all privileges //创建管理员用户并授权管理员
drop user "user" //删除用户
tbname : 数据表名称
tags : 表的tag域
values : 表的value域
timestamp :当前数据的时间戳(可选,没有提供的话系统会自带添加)
查询语句格式:
select from [ into_clause ] [ where_clause ]
[ group_by_clause ] [ order_by_clause ] [ limit_clause ]
[ offset_clause ] [ slimit_clause ] [ soffset_clause ]
说明
fields : 要查询的字段,查询全部可以用*代替,必填;
tbname : 数据表名称,必填;
into_clause : select ... into (可选);
where_clause : where条件域(可选);
group_by_clause : group by相关(可选);
order_by_clause : order by相关(可选);
limit_clause : limit相关(可选);
offset_clause : offset相关(可选);
slimit_clause : slimit相关(可选);
soffset_clause : soffset相关(可选);
第五,详细配置;
1.全局配置
reporting-disabled = false # 该选项用于上报influxdb的使用信息给InfluxData公司,默认值为false
bind-address = ":8088" # 备份恢复时使用,默认值为8088
2.meta相关配置
[meta]
dir = "/var/lib/influxdb/meta" # meta数据存放目录
retention-autocreate = true # 用于控制默认存储策略,数据库创建时,会自动生成autogen的存储策略,默认值:true
logging-enabled = true # 是否开启meta日志,默认值:true
3.data相关配置
[data]
dir = "/var/lib/influxdb/data" # 最终数据(TSM文件)存储目录
wal-dir = "/var/lib/influxdb/wal" # 预写日志存储目录
query-log-enabled = true # 是否开启tsm引擎查询日志,默认值: true
cache-max-memory-size = 1048576000 # 用于限定shard最大值,大于该值时会拒绝写入,默认值:1000MB,单位:byte
cache-snapshot-memory-size = 26214400 # 用于设置快照大小,大于该值时数据会刷新到tsm文件,默认值:25MB,单位:byte
cache-snapshot-write-cold-duration = "10m" # tsm引擎 snapshot写盘延迟,默认值:10Minute
compact-full-write-cold-duration = "4h" # tsm文件在压缩前可以存储的最大时间,默认值:4Hour
max-series-per-database = 1000000 # 限制数据库的级数,该值为0时取消限制,默认值:1000000
max-values-per-tag = 100000 # 一个tag最大的value数,0取消限制,默认值:100000
3.coordinator查询管理的配置选项
[coordinator]
write-timeout = "10s" # 写操作超时时间,默认值: 10s
max-concurrent-queries = 0 # 最大并发查询数,0无限制,默认值: 0
query-timeout = "0s # 查询操作超时时间,0无限制,默认值:0s
log-queries-after = "0s" # 慢查询超时时间,0无限制,默认值:0s
max-select-point = 0 # SELECT语句可以处理的最大点数(points),0无限制,默认值:0
max-select-series = 0 # SELECT语句可以处理的最大级数(series),0无限制,默认值:0
max-select-buckets = 0 # SELECT语句可以处理的最大"GROUP BY time()"的时间周期,0无限制,默认值:0
4.retention旧数据的保留策略
[retention]
enabled = true # 是否启用该模块,默认值 : true
check-interval = "30m" # 检查时间间隔,默认值 :"30m"
5、shard-precreation分区预创建
[shard-precreation]
enabled = true # 是否启用该模块,默认值 : true
check-interval = "10m" # 检查时间间隔,默认值 :"10m"
advance-period = "30m" # 预创建分区的最大提前时间,默认值 :"30m"
- monitor 控制InfluxDB自有的监控系统。 默认情况下,InfluxDB把这些数据写入_internal 数据库,如果这个库不存在则自动创建。 _internal 库默认的retention策略是7天,如果你想使用一个自己的retention策略,需要自己创建。
[monitor]
store-enabled = true # 是否启用该模块,默认值 :true
store-database = "_internal" # 默认数据库:"_internal"
store-interval = "10s # 统计间隔,默认值:"10s"
7.admin web管理页面
[admin]
enabled = true # 是否启用该模块,默认值 : false
bind-address = ":8083" # 绑定地址,默认值 :":8083"
https-enabled = false # 是否开启https ,默认值 :false
https-certificate = "/etc/ssl/influxdb.pem" # https证书路径,默认值:"/etc/ssl/influxdb.pem"
8.http API
[http]
enabled = true # 是否启用该模块,默认值 :true
bind-address = ":8086" # 绑定地址,默认值:":8086"
auth-enabled = false # 是否开启认证,默认值:false
realm = "InfluxDB" # 配置JWT realm,默认值: "InfluxDB"
log-enabled = true # 是否开启日志,默认值:true
write-tracing = false # 是否开启写操作日志,如果置成true,每一次写操作都会打日志,默认值:false
pprof-enabled = true # 是否开启pprof,默认值:true
https-enabled = false # 是否开启https,默认值:false
https-certificate = "/etc/ssl/influxdb.pem" # 设置https证书路径,默认值:"/etc/ssl/influxdb.pem"
https-private-key = "" # 设置https私钥,无默认值
shared-secret = "" # 用于JWT签名的共享密钥,无默认值
max-row-limit = 0 # 配置查询返回最大行数,0无限制,默认值:0
max-connection-limit = 0 # 配置最大连接数,0无限制,默认值:0
unix-socket-enabled = false # 是否使用unix-socket,默认值:false
bind-socket = "/var/run/influxdb.sock" # unix-socket路径,默认值:"/var/run/influxdb.sock"
9.subscriber 控制Kapacitor接受数据的配置;
[subscriber]
enabled = true # 是否启用该模块,默认值 :true
http-timeout = "30s" # http超时时间,默认值:"30s"
insecure-skip-verify = false # 是否允许不安全的证书
ca-certs = "" # 设置CA证书
write-concurrency = 40 # 设置并发数目,默认值:40
write-buffer-size = 1000 # 设置buffer大小,默认值:1000
10.graphite 相关配置
[[graphite]]
enabled = false # 是否启用该模块,默认值 :false
database = "graphite" # 数据库名称,默认值:"graphite"
retention-policy = "" # 存储策略,无默认值
bind-address = ":2003" # 绑定地址,默认值:":2003"
protocol = "tcp" # 协议,默认值:"tcp"
consistency-level = "one" # 一致性级别,默认值:"one
batch-size = 5000 # 批量size,默认值:5000
batch-pending = 10 # 配置在内存中等待的batch数,默认值:10
batch-timeout = "1s" # 超时时间,默认值:"1s"
udp-read-buffer = 0 # udp读取buffer的大小,0表示使用操作系统提供的值,如果超过操作系统的默认配置则会出错。 该配置的默认值:0
separator = "." # 多个measurement间的连接符,默认值: "."
11.collectd
[[collectd]]
enabled = false # 是否启用该模块,默认值 :false
bind-address = ":25826" # 绑定地址,默认值: ":25826"
database = "collectd" # 数据库名称,默认值:"collectd"
retention-policy = "" # 存储策略,无默认值
typesdb = "/usr/local/share/collectd" # 路径,默认值:"/usr/share/collectd/types.db"
auth-file = "/etc/collectd/auth_file"
batch-size = 5000
batch-pending = 10
batch-timeout = "10s"
read-buffer = 0 # udp读取buffer的大小,0表示使用操作系统提供的值,如果超过操作系统的默认配置则会出错。默认值:0
12.opentsdb
[[opentsdb]]
enabled = false # 是否启用该模块,默认值:false
bind-address = ":4242" # 绑定地址,默认值:":4242"
database = "opentsdb" # 默认数据库:"opentsdb"
retention-policy = "" # 存储策略,无默认值
consistency-level = "one" # 一致性级别,默认值:"one"
tls-enabled = false # 是否开启tls,默认值:false
certificate= "/etc/ssl/influxdb.pem" # 证书路径,默认值:"/etc/ssl/influxdb.pem"
log-point-errors = true # 出错时是否记录日志,默认值:true
batch-size = 1000
batch-pending = 5
batch-timeout = "1s"
13.udp
[[udp]]
enabled = false # 是否启用该模块,默认值:false
bind-address = ":8089" # 绑定地址,默认值:":8089"
database = "udp" # 数据库名称,默认值:"udp"
retention-policy = "" # 存储策略,无默认值
batch-size = 5000
batch-pending = 10
batch-timeout = "1s"
read-buffer = 0 # udp读取buffer的大小,0表示使用操作系统提供的值,如果超过操作系统的默认配置则会出错。 该配置的默认值:0
14、continuous_queries
[continuous_queries]
enabled = true # enabled 是否开启CQs,默认值:true
log-enabled = true # 是否开启日志,默认值:true
run-interval = "1s" # 时间间隔,默认值:"1s"
参考文档:
https://www.cnblogs.com/byron-123/p/10432241.html
https://www.jianshu.com/p/f0905f36e9c3
https://www.cnblogs.com/byron-123/p/10432241.html
https://www.cnblogs.com/badboy200800/p/10981052.html
https://jasper-zhang1.gitbooks.io/influxdb/content/
https://influxdata.com/
https://v2.docs.influxdata.com/v2.0/