这是我之前整理的 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.0.x86_64.rpm
其它环境可以参考 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 配置,具体参考:
对应源码文件:
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 地址:
欢迎补充