首页 > 代码库 > InfluxDB安装及配置

InfluxDB安装及配置

这是我之前整理的InfluxDB安装及配置的笔记,这里记录下,也方便我以后查阅。 

环境: CentOS6.5_x64

InfluxDB版本:1.1.0

一、安装

1、二进制安装

这里以centos6.5为例进行安装:

wget  https://dl.influxdata.com/influxdb/releases/influxdb-1.1.0.x86_64.rpmyum localinstall influxdb-1.1.0.x86_64.rpm

其它环境可以参考influxdb官方文档:

https://www.influxdata.com/downloads/#influxdb

 

安装后,在/usr/bin下面有如下文件:

influxd          influxdb服务器influx           influxdb命令行客户端influx_inspect   查看工具influx_stress    压力测试工具influx_tsm       数据库转换工具(将数据库从b1或bz1格式转换为tsm1格式)

在/var/lib/influxdb/下面会有如下文件夹:

data            存放最终存储的数据,文件以.tsm结尾meta            存放数据库元数据wal             存放预写日志文件

2、源码编译安装

go get github.com/influxdata/influxdbcd $GOPATH/src/github.com/influxdata/go get ./...go install ./...

具体可参考这里:https://anomaly.io/compile-influxdb/

二、启动

1、以服务方式启动

service influxdb start

2、以非服务方式启动

influxd

需要指定配置文件的话,可以使用 --config 选项,具体可以help下看看。

三、配置

配置文件路径 :/etc/influxdb/influxdb.conf

可以通过以下命令生成默认配置文件:

influxd config > default.conf

reporting-disabled

该选项用于上报influxdb的使用信息给InfluxData公司,默认值为false

对应源码文件:

influxdb-1.1.0/cmd/influxd/run/config.go

Config中的ReportingDisabled配置项

bind-address

备份恢复时使用,默认值为8088

对应源码文件:

influxdb-1.1.0/cmd/influxd/run/config.go

Config中的BindAddress配置项

[meta]

meta相关配置

对应源码文件:

influxdb-1.1.0/services/meta/config.go

dir

meta数据存放目录,默认值:/var/lib/influxdb/meta

retention-autocreate

用于控制默认存储策略,数据库创建时,会自动生成autogen的存储策略,默认值:true

logging-enabled

是否开启meta日志,默认值:true

[data]

tsm1引擎配置

对应源码文件:

influxdb-1.1.0/tsdb/config.go

dir

最终数据(TSM文件)存储目录,默认值:/var/lib/influxdb/data

wal-dir

预写日志存储目录,默认值:/var/lib/influxdb/wal

query-log-enabled

是否开启tsm引擎查询日志,默认值: true

cache-max-memory-size

用于限定shard最大值,大于该值时会拒绝写入,默认值:

DefaultCacheMaxMemorySize = 1024 * 1024 * 1024 // 1GB

cache-snapshot-memory-size

用于设置快照大小,大于该值时数据会刷新到tsm文件,默认值:

DefaultCacheSnapshotMemorySize = 25 * 1024 * 1024 // 25MB

cache-snapshot-write-cold-duration

tsm1引擎 snapshot写盘延迟,默认值:

DefaultCacheSnapshotWriteColdDuration = time.Duration(10 * time.Minute)

compact-full-write-cold-duration

tsm文件在压缩前可以存储的最大时间,默认值:

DefaultCompactFullWriteColdDuration = time.Duration(4 * time.Hour)

max-series-per-database

限制数据库的级数,该值为0时取消限制,默认值:

DefaultMaxSeriesPerDatabase = 1000000

measurement, tag set, retention policy 相同的数据集合算做一个serie,级数算法示例如下:

假设monitor1这个measurement有两个tags:id 和 name id 的数量为10,name的数量为 100,则 series 基数为 10 * 100 = 1000

max-values-per-tag

一个tag最大的value数,0取消限制,默认值:

DefaultMaxValuesPerTag = 100000

trace-logging-enabled

是否开启trace日志,默认值: false

[coordinator]

查询管理的配置选项

对应源码文件:

influxdb-1.1.0/coordinator/config.go

write-timeout

写操作超时时间,默认值: 10s

max-concurrent-queries

最大并发查询数,0无限制,默认值: 0

query-timeout

查询操作超时时间,0无限制,默认值:0s

log-queries-after

慢查询超时时间,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

[retention]

旧数据的保留策略

对应源码文件:

influxdb-1.1.0/services/retention/config.go

enabled

是否启用该模块,默认值 : true

check-interval

检查时间间隔,默认值 :"30m0s"

[shard-precreation]

分区预创建

对应源码文件:

influxdb-1.1.0/services/precreator/config.go

enabled

是否启用该模块,默认值 : true

check-interval

检查时间间隔,默认值 :"10m0s"

advance-period

预创建分区的最大提前时间,默认值 :"30m0s"

[admin]

influxdb提供的简单web管理页面

对应源码文件:

influxdb-1.1.0/services/admin/config.go

enabled

是否启用该模块,默认值 : false

bind-address

绑定地址,默认值 :":8083"

https-enabled

是否开启https ,默认值 :false

https-certificate

https证书路径,默认值:"/etc/ssl/influxdb.pem"

[monitor]

这一部分控制InfluxDB自有的监控系统。 默认情况下,InfluxDB把这些数据写入_internal 数据库,如果这个库不存在则自动创建。 _internal 库默认的retention策略是7天,如果你想使用一个自己的retention策略,需要自己创建。

对应源码文件:

influxdb-1.1.0/monitor/config.go

store-enabled

是否启用该模块,默认值 :true

store-database

默认数据库:"_internal"

store-interval

统计间隔,默认值:"10s"

[subscriber]

控制Kapacitor接受数据的配置

对应源码文件:

influxdb-1.1.0/services/subscriber/config.go

enabled

是否启用该模块,默认值 :true

http-timeout

http超时时间,默认值:"30s"

insecure-skip-verify

是否允许不安全的证书,当测试自己签发的证书时比较有用。默认值: false

ca-certs

设置CA证书,无默认值

write-concurrency

设置并发数目,默认值:40

write-buffer-size

设置buffer大小,默认值:1000

[http]

influxdb的http接口配置

对应源码文件:

influxdb-1.1.0/services/httpd/config.go

enabled

是否启用该模块,默认值 :true

bind-address

绑定地址,默认值:":8086"

auth-enabled

是否开启认证,默认值:false

log-enabled

是否开启日志,默认值:true

write-tracing

是否开启写操作日志,如果置成true,每一次写操作都会打日志,默认值:false

pprof-enabled

是否开启pprof,默认值:true

https-enabled

是否开启https,默认值:false

https-certificate

设置https证书路径,默认值:"/etc/ssl/influxdb.pem"

https-private-key

设置https私钥,无默认值

max-row-limit

配置查询返回最大行数,默认值:10000

max-connection-limit

配置最大连接数,0无限制,默认值:0

shared-secret

用于JWT签名的共享密钥,无默认值

realm

配置JWT realm,默认值: "InfluxDB"

unix-socket-enabled

是否使用unix-socket,默认值:false

bind-socket

unix-socket路径,默认值:"/var/run/influxdb.sock"

[[graphite]]

graphite相关配置

具体参考:https://github.com/influxdata/influxdb/blob/master/services/graphite/README.md

对应源码文件:

influxdb-1.1.0/services/graphite/config.go

enabled

是否启用该模块,默认值 :false

bind-address

绑定地址,默认值:":2003"

database

数据库名称,默认值:"graphite"

retention-policy

存储策略,无默认值

protocol

协议,默认值:"tcp"

batch-size

批量size,默认值:5000

batch-pending

配置在内存中等待的batch数,默认值:10

batch-timeout

超时时间,默认值:"1s"

consistency-level

一致性级别,默认值:"one"

separator

多个measurement间的连接符,默认值: "."

udp-read-buffer = 0

udp读取buffer的大小,0表示使用操作系统提供的值,如果超过操作系统的默认配置则会出错。 该配置的默认值:0

[[collectd]]

具体参考:https://github.com/influxdata/influxdb/tree/master/services/collectd

对应源码文件:

influxdb-1.1.0/services/collectd/config.go

enabled

是否启用该模块,默认值 :false

bind-address

绑定地址,默认值: ":25826"

database

数据库名称,默认值:"collectd"

retention-policy = ""

存储策略,无默认值

batch-size

默认值:5000

batch-pending

默认值:10

batch-timeout

默认值:"10s"

read-buffer

udp读取buffer的大小,0表示使用操作系统提供的值,如果超过操作系统的默认配置则会出错。默认值:0

typesdb

路径,默认值:"/usr/share/collectd/types.db"

[[opentsdb]]

opentsdb配置

对应源码文件:

influxdb-1.1.0/services/opentsdb/config.go

enabled

是否启用该模块,默认值:false

bind-address

绑定地址,默认值:":4242"

database

默认数据库:"opentsdb"

retention-policy

存储策略,无默认值

consistency-level

一致性级别,默认值:"one"

tls-enabled = false

是否开启tls,默认值:false

certificate

证书路径,默认值:"/etc/ssl/influxdb.pem"

batch-size

默认值:1000

batch-pending

默认值:5

batch-timeout

超时时间,默认值:"1s"

log-point-errors

出错时是否记录日志,默认值:true

[[udp]]

udp配置,具体参考:

https://github.com/influxdata/influxdb/blob/master/services/udp/README.md

对应源码文件:

influxdb-1.1.0/services/udp/config.go

enabled

是否启用该模块,默认值:false

bind-address

绑定地址,默认值:":8089"

database

数据库名称,默认值:"udp"

retention-policy

存储策略,无默认值

batch-size

默认值:5000

batch-pending

默认值:10

read-buffer

udp读取buffer的大小,0表示使用操作系统提供的值,如果超过操作系统的默认配置则会出错。 该配置的默认值:0

batch-timeout

超时时间,默认值:"1s"

precision

时间精度,无默认值

[continuous_queries]

CQs配置

对应源码文件:

influxdb-1.1.0/services/continuous_querier/config.go

log-enabled

是否开启日志,默认值:true

enabled 是否开启CQs,默认值:true

run-interval

时间间隔,默认值:"1s"

 

本文github地址:

https://github.com/mike-zhang/mikeBlogEssays/blob/master/2017/20170206_InfluxDB安装及配置.md

欢迎补充 

InfluxDB安装及配置