InfluxDB：时间序列平台

概述

InfluxDB 是一个开源的时间序列平台。这包括用于存储和查询数据、为 ETL 或监控和警报目的在后台处理数据、用户仪表板以及可视化和探索数据等的 API。这个 repo 上的 master 分支现在代表最新的 InfluxDB，它现在包括 Kapacitor（后台处理）和 Chronograf（UI）的功能，所有这些都在一个二进制文件中。

安装

我们在InfluxData 下载页面提供了夜间和版本控制的 Docker 图像、Debian 包、RPM 包和 InfluxDB 的 tarball 。我们还在influx同一位置提供命令行界面 (CLI) 客户端作为单独的二进制文件。

[hidecontent type="logged" desc="隐藏内容：登录后可查看"]

如果您对从源代码构建感兴趣，请参阅贡献者的从源代码构建指南。

开始

如需完整的入门指南，请参阅完整在线文档站点。

要以任何方式写入和查询数据或使用 API，您需要先创建用户、凭据、组织和存储桶。InfluxDB 中的一切都是在组织的概念下组织的。API 被设计为多租户。桶代表您存储时间序列数据的位置。它们与之前 InfluxDB 1.xa 数据库和保留策略中的内容同义。

最简单的设置方法是将浏览器指向http://localhost:8086并按照提示进行操作。

您还可以使用以下命令从 CLI 进行设置influx setup：

$ bin/$(uname -s | tr '[:upper:]' '[:lower:]')/influx setup
Welcome to InfluxDB 2.0!
Please type your primary username: marty

Please type your password:

Please type your password again:

Please type your primary organization name.: InfluxData

Please type your primary bucket name.: telegraf

Please type your retention period in hours.
Or press ENTER for infinite.: 72


You have entered:
  Username:          marty
  Organization:      InfluxData
  Bucket:            telegraf
  Retention Period:  72 hrs
Confirm? (y/n): y

UserID                  Username        Organization    Bucket
033a3f2c5ccaa000        marty           InfluxData      Telegraf
Your token has been stored in /Users/marty/.influxdbv2/credentials

-f, --force如果您正在自动安装，则可以使用标志以非交互方式运行此命令。一些添加的标志可以提供帮助：

$ bin/$(uname -s | tr '[:upper:]' '[:lower:]')/influx setup \
--username marty \
--password F1uxKapacit0r85 \
--org InfluxData \
--bucket telegraf \
--retention 168 \
--token where-were-going-we-dont-need-roads \
--force

设置完成后，将创建一个配置文件，以允许您与本地 InfluxDB 交互，而无需每次都传递凭据。influx config您可以使用该命令列出和管理这些配置文件。

$ bin/$(uname -s | tr '[:upper:]' '[:lower:]')/influx config
Active	Name	URL			            Org
*	    default	http://localhost:8086	InfluxData

写数据

写入 measurement m，带有 tag ，在属于 organizationv=2的 bucket中：telegrafInfluxData

$ bin/$(uname -s | tr '[:upper:]' '[:lower:]')/influx write --bucket telegraf --precision s "m v=2 $(date +%s)"

由于您设置了默认配置文件，因此可以从命令中省略组织和令牌。

使用写相同的点curl：

curl --header "Authorization: Token $(bin/$(uname -s | tr '[:upper:]' '[:lower:]')/influx auth list --json | jq -r '.[0].token')" \
--data-raw "m v=2 $(date +%s)" \
"http://localhost:8086/api/v2/write?org=InfluxData&bucket=telegraf&precision=s"

用一个简单的 Flux 查询读回：

$ bin/$(uname -s | tr '[:upper:]' '[:lower:]')/influx query 'from(bucket:"telegraf") |> range(start:-1h)'
Result: _result
Table: keys: [_start, _stop, _field, _measurement]
                   _start:time                      _stop:time           _field:string     _measurement:string                      _time:time                  _value:float
------------------------------  ------------------------------  ----------------------  ----------------------  ------------------------------  ----------------------------
2019-12-30T22:19:39.043918000Z  2019-12-30T23:19:39.043918000Z                       v                       m  2019-12-30T23:17:02.000000000Z                             2

使用该-r, --raw选项从查询中返回原始通量响应。这对于将数据从一个实例移动到另一个实例很有用，因为该命令可以使用该选项influx write接受 Flux 响应。--format csv

[/hidecontent]