首页 > 代码库 > 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安装及配置