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.rpm
yum localinstall influxdb-1.1..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/influxdb
cd $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

欢迎补充