InfluxDB(官方使用说明)

Posted *(00)*

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了InfluxDB(官方使用说明)相关的知识,希望对你有一定的参考价值。

安装InfluxDB OSS

此页面提供有关安装,启动和配置InfluxDB的说明。

InfluxDB OSS安装要求

root为了成功完成,需要安装InfluxDB软件包或具有管理员权限。

InfluxDB OSS网络端口

InfluxDB默认使用以下网络端口:

  • TCP端口8086用于通过InfluxDB的HTTP API进行客户端 - 服务器通信
  • TCP端口8088用于RPC服务以进行备份和还原

除了上面的端口,InfluxDB还提供了多个可能需要自定义端口的插件可以通过配置文件修改所有端口映射,配置文件位于/etc/influxdb/influxdb.conf默认安装位置。

网络时间协议(NTP)

InfluxDB使用主机的UTC本地时间为数据分配时间戳并用于协调目的。使用网络时间协议(NTP)同步主机之间的时间; 如果主机的时钟与NTP不同步,写入InfluxDB的数据的时间戳可能不准确。

安装InfluxDB OSS

对于不想安装任何软件并准备使用InfluxDB的用户,您可能需要查看我们的 托管主机InfluxDB产品

有关如何从文件安装Debian软件包的说明,请参阅 下载页面

Debian和Ubuntu用户可以使用apt-get包管理器安装最新的稳定版本的InfluxDB 

对于Ubuntu用户,使用以下命令添加InfluxData存储库:

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

对于Debian用户,添加InfluxData存储库:

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

然后,安装并启动InfluxDB服务:

sudo apt-get update && sudo apt-get install influxdb
sudo service influxdb start

或者,如果您的操作系统使用的是systemd(Ubuntu 15.04 +,Debian 8+):

sudo apt-get update && sudo apt-get install influxdb
sudo systemctl unmask influxdb.service
sudo systemctl start influxdb

配置InfluxDB OSS

系统具有每个配置文件设置的内部默认值。使用该influxd config命令查看默认配置设置

本地配置文件(/etc/influxdb/influxdb.conf)中的大多数设置都被注释掉了; 所有注释掉的设置将由内部默认值确定。本地配置文件中的任何未注释的设置都会覆盖内部默认值。请注意,本地配置文件不需要包含每个配置设置。

有两种方法可以使用您的配置文件启动InfluxDB:

  • 使用以下-config 选项将进程指向正确的配置文件

    influxd -config /etc/influxdb/influxdb.conf
  • 将环境变量设置为INFLUXDB_CONFIG_PATH配置文件的路径并启动该过程。例如:

    echo $INFLUXDB_CONFIG_PATH
    /etc/influxdb/influxdb.conf
    
    influxd
    

InfluxDB首先检查-config选项,然后检查环境变量。

有关更多信息,请参阅配置文档。

数据和WAL目录权限

确保存储数据和写日志(WAL)的目录对于运行该influxd服务的用户是可写的

注意:如果数据和WAL目录不可写,则influxd服务将无法启动。

有关datawal目录路径的信息,请参阅配置InfluxDB文档数据设置部分

在AWS上托管InfluxDB OSS

InfluxDB的硬件要求

我们建议使用两个SSD卷,一个用于influxdb/wal另一个用于influxdb/data根据您的负载,每个卷应具有大约1k-3k的预配置IOPS。influxdb/data卷应该有更多的磁盘空间低IOPS和influxdb/wal容量应该有更少的磁盘空间,具有较高的IOPS。

每台机器应至少有8G RAM。

我们已经看到了R4类机器的最佳性能,因为它们提供的内存比C3 / C4类和M4类都要多。

配置InfluxDB OSS实例

此示例假定您使用的是两个SSD卷并且已正确装入它们。此示例还假定每个卷都安装在/mnt/influx/mnt/db有关如何执行此操作的详细信息,请参阅有关如何向您的实例添加卷的Amazon文档

配置文件

您必须为每个InfluxDB实例更新配置文件。

...

[meta]
  dir = "/mnt/db/meta"
  ...

...

[data]
  dir = "/mnt/db/data"
  ...
wal-dir = "/mnt/influx/wal"
  ...

...

[hinted-handoff]
    ...
dir = "/mnt/db/hh"
    ...

InfluxDB OSS权限

在InfluxDB数据和配置中使用非标准目录时,还要确保正确设置文件系统权限:

chown influxdb:influxdb /mnt/influx
chown influxdb:influxdb /mnt/db


----------------------------------------------------------
----------------------------------------------------------
----------------------------------------------------------
----------------------------------------------------------
----------------------------------------------------------
----------------------------------------------------------



InfluxDB OSS入门

安装 InfluxDB后,您就可以开始做一些很棒的事了。在本节中,我们将使用influx 命令行界面(CLI),它包含在所有InfluxDB包中,是一种轻量级且简单的与数据库交互的方式。CLI 8086默认通过端口向InfluxDB HTTP API发出请求,直接与InfluxDB通信

注意:也可以通过生成原始HTTP请求来使用数据库。有关应用程序的 示例,请参阅编写数据查询数据curl

创建数据库

如果您已在本地安装InfluxDB,则该influx命令应通过命令行提供。执行influx将启动CLI并自动连接到本地InfluxDB实例(假设您已经启动了服务器service influxdb startinfluxd直接运行)。输出应如下所示:

$ influx -precision rfc3339
Connected to http://localhost:8086 version 1.4.x
InfluxDB shell 1.4.x
>

笔记:

  • InfluxDB HTTP API 8086默认在端口上运行因此,influx将连接到端口8086localhost默认。如果您需要更改这些默认值,请运行influx --help
  • -precision参数指定任何返回的时间戳的格式/精度。在上面的示例中,rfc3339告诉InfluxDB以RFC3339格式YYYY-MM-DDTHH:MM:SS.nnnnnnnnnZ返回时间戳

现在,命令行已准备好以Influx查询语言(又称InfluxQL)语句的形式获取输入。要退出InfluxQL shell,请键入exit并单击return。

全新安装的InfluxDB没有数据库(除了系统_internal),因此创建一个是我们的首要任务。您可以使用CREATE DATABASE <db-name>InfluxQL语句创建数据库,其中<db-name>是您要创建的数据库的名称。只要字符串是双引号,数据库的名称就可以包含任何unicode字符。如果名称包含ASCII字母,数字或下划线且不以数字开头,则也可以不加引号

在本指南中,我们将使用数据库名称mydb

> CREATE DATABASE mydb
>

注意:按 Enter键后,将出现一个新提示,并且不显示任何其他提示。在CLI中,这意味着语句已执行且没有要显示的错误。如果出现问题,将始终显示错误。没有消息就是好消息!

现在mydb已经创建数据库,我们将使用该SHOW DATABASES语句显示所有现有数据库:

> SHOW DATABASES
name: databases
---------------
name
_internal
mydb

>

注:_internal数据库中创建和使用InfluxDB存储内部运行指标。稍后再查看以了解InfluxDB如何在幕后执行。

SHOW DATABASES与之不同,大多数InfluxQL语句必须针对特定数据库运行。您可以使用每个查询显式命名数据库,但CLI提供了一个便捷语句,USE <db-name>它将自动为将来的所有请求设置数据库。例如:

> USE mydb
Using database mydb
>

现在,将来的命令只会针对mydb数据库运行

编写和探索数据

现在我们有了一个数据库,InfluxDB已准备好接受查询和写入。

首先,在数据存储区上的简短入门。InfluxDB中的数据按“时间序列”进行组织,其中包含测量值,如“cpu_load”或“temperature”。时间序列为零到多points,每个离散的度量样本一个。点由time(时间戳),a measurement(例如“cpu_load”),至少一个键值field(测量值本身,例如“值= 0.64”或“温度= 21.2”)和零到多键组成-value tags包含有关该值的任何元数据(例如“host = server01”,“region = EMEA”,“dc = Frankfurt”)。

从概念上讲,您可以将a measurement视为一个SQL表,其中主索引始终是时间。 tags并且fields是表中的有效列。 tags被索引,而fields不是。不同之处在于,使用InfluxDB,您可以进行数百万次测量,您不必预先定义模式,也不会存储空值。

使用线路协议将点写入InfluxDB,其遵循以下格式:

<measurement>[,<tag-key>=<tag-value>...] <field-key>=<field-value>[,<field2-key>=<field2-value>...] [unix-nano-timestamp]

以下几行都是可以写入InfluxDB的点的示例:

cpu,host=serverA,region=us_west value=0.64
payment,device=mobile,product=Notepad,method=credit billed=33,licenses=3i 1434067467100293230
stock,symbol=AAPL bid=127.46,ask=127.48
temperature,machine=unit42,type=assembly external=25,internal=37 1434067467000000000

注意:有关线路协议的更多信息,参见“ 语法”页面。

要使用CLI将单个时间序列数据点插入InfluxDB,请输入INSERT后跟一个点:

> INSERT cpu,host=serverA,region=us_west value=0.64
>

测量名称为cpu和标记的点hostregion现在已经写入数据库,测量value值为0.64

现在我们将查询刚才写的数据:

> SELECT "host", "region", "value" FROM "cpu"
name: cpu
---------
time		    	                     host     	region   value
2015-10-21T19:28:07.580664347Z  serverA	  us_west	 0.64

>

注意:在编写我们的观点时,我们没有提供时间戳。如果没有为某个点提供时间戳,InfluxDB会在获取该点时分配本地当前时间戳。这意味着您的时间戳会有所不同。

让我们尝试存储另一种类型的数据,在同一测量中有两个字段:

> INSERT temperature,machine=unit42,type=assembly external=25,internal=37
>

要使用查询返回所有字段和标记,您可以使用*运算符:

> SELECT * FROM "temperature"
name: temperature
-----------------
time		                        	 external	  internal	 machine	type
2015-10-21T19:28:08.385013942Z  25	        	37     		unit42  assembly

>

警告:在大型数据库上使用*不带LIMIT子句可能会导致性能问题。您可以使用Ctrl+C取消响应时间过长的查询。

InfluxQL有许多功能和关键字,这里没有涉及,包括对Go风格的正则表达式的支持。例如:

> SELECT * FROM /.*/ LIMIT 1
--
> SELECT * FROM "cpu_load_short"
--
> SELECT * FROM "cpu_load_short" WHERE "value" > 0.9

这就是将数据写入InfluxDB并进行查询所需要知道的全部内容。要了解有关InfluxDB写入协议的更多信息,请查看写入数据指南要进一步探索查询语言,请查看查询数据指南有关InfluxDB概念的更多信息,请查看“ 关键概念”页面。

 

 

以上是关于InfluxDB(官方使用说明)的主要内容,如果未能解决你的问题,请参考以下文章

使用influx控制台工具操作InfluxDB

windows版influxDB安装与配置

windows版influxDB安装与配置

python influxDB 基本操作

python influxDB 基本操作

Centos 7.8下使用 Docker 安装 influxdb 1.8