安装

这篇将会介绍怎么安装、运行和配置InfluxDB。

准备

安装InfluxDB包需要root或是有管理员权限才可以。

网络

InfluxDB默认使用下面的网络端口:

  • TCP端口8086用作InfluxDB的客户端和服务端的http api通信
  • TCP端口8088给备份和恢复数据的RPC服务使用

另外,InfluxDB也提供了多个可能需要自定义端口的插件,所以的端口映射都可以通过配置文件修改,对于默认安装的InfluxDB,这个配置文件位于/etc/influxdb/influxdb.conf

NTP

InfluxDB使用服务器本地时间给数据加时间戳,而且是UTC时区的。并使用NTP来同步服务器之间的时间,如果服务器的时钟没有通过NTP同步,那么写入InfluxDB的数据的时间戳就可能不准确。

安装

对于不想安装的用户,可以使用inluxdata公司提供的云产品(帮忙给他们打个广告吧,毕竟开源不易)。

Debain & Ubuntu

Debian和Ubuntu用户可以直接用apt-get包管理来安装最新版本的InfluxDB。

对于Ubuntu用户,可以用下面的命令添加InfluxDB的仓库

  1. curl -sL https://repos.influxdata.com/influxdb.key | sudo apt-key add -
  2. source /etc/lsb-release
  3. echo "deb https://repos.influxdata.com/${DISTRIB_ID,,} ${DISTRIB_CODENAME} stable" | sudo tee /etc/apt/sources.list.d/influxdb.list

Debian用户用下面的命令:

  1. curl -sL https://repos.influxdata.com/influxdb.key | sudo apt-key add -
  2. source /etc/os-release
  3. test $VERSION_ID = "7" && echo "deb https://repos.influxdata.com/debian wheezy stable" | sudo tee /etc/apt/sources.list.d/influxdb.list
  4. test $VERSION_ID = "8" && echo "deb https://repos.influxdata.com/debian jessie stable" | sudo tee /etc/apt/sources.list.d/influxdb.list

然后安装、运行InfluxDB服务:

  1. sudo apt-get update && sudo apt-get install influxdb
  2. sudo service influxdb start

如果你的系统可以使用Systemd(比如Ubuntu 15.04+, Debian 8+),也可以这样启动:

  1. sudo apt-get update && sudo apt-get install influxdb
  2. sudo systemctl start influxdb

RedHat & CentOS

RedHat和CentOS用户可以直接用yum包管理来安装最新版本的InfluxDB。

  1. cat <<EOF | sudo tee /etc/yum.repos.d/influxdb.repo
  2. [influxdb]
  3. name = InfluxDB Repository - RHEL \$releasever
  4. baseurl = https://repos.influxdata.com/rhel/\$releasever/\$basearch/stable
  5. enabled = 1
  6. gpgcheck = 1
  7. gpgkey = https://repos.influxdata.com/influxdb.key
  8. EOF

一旦加到了yum源里面,就可以运行下面的命令来安装和启动InfluxDB服务:

  1. sudo yum install influxdb
  2. sudo service influxdb start

如果你的系统可以使用Systemd(比如CentOS 7+, RHEL 7+),也可以这样启动:

  1. sudo yum install influxdb
  2. sudo systemctl start influxdb

MAC OS X

OS X 10.8或者更高版本的用户,可以使用Homebrew来安装InfluxDB; 一旦brew安装了,可以用下面的命令来安装InfluxDB:

  1. brew update
  2. brew install influxdb

登陆后在用launchd开始运行InfluxDB之前,先跑:

  1. ln -sfv /usr/local/opt/influxdb/*.plist ~/Library/LaunchAgents

然后运行InfluxDB:

  1. launchctl load ~/Library/LaunchAgents/homebrew.mxcl.influxdb.plist

如果你不想用或是不需要launchctl,你可以直接在terminal里运行下面命令来启动InfluxDB:

  1. influxd -config /usr/local/etc/influxdb.conf

配置

安装好之后,每个配置文件都有了默认的配置,你可以通过命令influxd config来查看这些默认配置。

在配置文件/etc/influxdb/influxdb.conf之中的大部分配置都被注释掉了,所有这些被注释掉的配置都是由内部默认值决定的。配置文件里任意没有注释的配置都可以用来覆盖内部默认值,需要注意的是,本地配置文件不需要包括每一项配置。

有两种方法可以用自定义的配置文件来运行InfluxDB:

  • 运行的时候通过可选参数-config来指定:
  1. influxd -config /etc/influxdb/influxdb.conf
  • 设置环境变量INFLUXDB_CONFIG_PATH来指定,例如:
  1. echo $INFLUXDB_CONFIG_PATH
  2. /etc/influxdb/influxdb.conf
  3. influxd

其中-config的优先级高于环境变量。

想看更详细的配置解释,请移步配置文档。

托管在AWS上

硬件

我们建议使用两块SSD卷,一个是为了influxdb/wal,一个是为了influxdb/data;根据您的负载量,每个卷应具有大约1k-3k的IOPS。influxdb/data卷应该有更多的磁盘空间和较低的IOPS,而influxdb/wal卷则相反有较少的磁盘空间但是较高的IOPS。

每台机器应该有不少于8G的内存。

在AWS上的R4型号的机器上的我们看到了最好的性能,因为这种型号的机器提供的内存比C3/C4和M4型号机器大得多。

配置aws实例

这个例子假定你正在使用两个SSD卷,并且已正确安装它们。此示例还假定每个卷都安装在/mnt/influx/mnt/db上。如何安装请看亚马逊提供的文档给你的aws实例添加卷

配置文件

你需要修改每一个InfluxDB实例的配置文件:

  1. ...
  2. [meta]
  3. dir = "/mnt/db/meta"
  4. ...
  5. ...
  6. [data]
  7. dir = "/mnt/db/data"
  8. ...
  9. wal-dir = "/mnt/influx/wal"
  10. ...
  11. ...
  12. [hinted-handoff]
  13. ...
  14. dir = "/mnt/db/hh"
  15. ...

权限

如果InfluxDB没有使用标准的数据和配置文件的文件夹的话,你需要确定文件系统的权限是正确的:

  1. chown influxdb:influxdb /mnt/influx
  2. chown influxdb:influxdb /mnt/db