开始使用InfluxDB 2.0:抓取指标、运行Telegraf、查询数据和写入数据

导航到

现在我们已经发布了InfluxDB 2.0 Alpha版,您可能想尝试它,但可能不知道从何开始。本篇将指导您如何在您的机器上本地运行它。到本篇结束时,您将了解一些区分2.0和1.x的新特性,并能够轻松地加载数据和浏览用户界面。

使用InfluxDB 2.0抓取指标

首先,访问入门文档,按照说明下载Alpha版本或运行带有Alpha的Docker容器。您可以在Linux或Mac上本地运行2.0,但如果您在使用Windows,则需要使用Docker容器。要运行Docker容器,您需要在您的机器上安装Docker。在本教程中,我选择了下载Alpha版本并本地运行。

一旦InfluxDB运行起来,无论是通过运行influxd命令还是运行Docker容器,请访问https://127.0.0.1:9999 应该会看到以下页面

点击“开始”将带您到这个页面

InfluxDB 2.0 - Setup initial user

我建议将您的组织命名为“InfluxData”,这样您就可以跟随我接下来要展示的内容。组织是2.0中组织和查询数据的总称。桶相当于数据库。您可以选择任何您喜欢的桶名、用户名和密码。点击“继续”将带您到这个页面

InfluxDB 2.0 - collecting data

“快速开始”选项配置数据抓取器。数据抓取器将从您的本地InfluxDB 2.0实例中拉取指标。这是开始使用一些数据的最快方式。“高级”将带您进入Telegraf代理配置区域。“稍后配置”将带您进入主页,没有任何创建内容。点击“快速开始”,您将被带到以下页面

这是您可以从这里访问InfluxDB 2.0实例所有部分的首页。您可以从这里访问您的组织、仪表板和文档。

在左侧侧边栏中点击“数据探索器”,您将被带到这个视图

InfluxDB 2.0 Data Explorer

您在下半部分的第二列中看到的是在您点击“快速开始”时自动初始化的抓取器收集的数据的度量。该抓取器通过从localhost:9999/metrics拉取指标来收集关于InfluxDB 2.0实例的数据,您可以访问它以查看这些指标的Prometheus数据格式。

我们只是随机选择一个数据系列。点击“boltdb_reads_total”,这将打开与该度量相关的字段块。在“_field”标题下,点击“counter”,然后点击“提交:”

InfluxDB 2.0 - data series - query builder

恭喜!您刚刚使用查询构建器构建了第一个查询,您现在看到的是该查询结果的可视化。

但如果您想看到更好的可视化系列,请在侧边栏中点击“仪表板”,您将看到“本地指标”,这是一个由抓取器收集的指标创建的预定义仪表板。点击它,您应该看到类似这样的内容

InfluxDB 2.0 - predefined dashboard example

在InfluxDB 2.0中运行Telegraf

现在我们将创建一个桶,设置Telegraf代理,并查看代理收集的数据的仪表板。在左侧侧边栏中点击“设置”,然后点击“桶”。然后点击“创建桶”,创建一个新的桶,该桶将存储Telegraf代理收集的所有时间序列数据

Running Telegraf with InfluxDB 2.0

现在点击左侧侧边栏中的“admin”,然后点击“配置数据收集器”,这将带您到这个页面

InfluxDB 2.0 Telegraf configuration

点击“创建配置”,您将被带到这个页面,您将看到在2.0中当前可用的许多插件集合。随着2.0的进一步开发,还将添加更多集合。选择“系统”插件集合(确保您点击左侧的“桶”下拉菜单并选择您刚刚创建的桶)

InfluxDB 2.0- create a Telegraf config

“系统”插件集合从您的Linux机器收集指标,是开始与数据玩耍的最好方法之一,这样您就可以看到InfluxDB 2.0是如何工作的。点击“继续”,您将被带到这个页面

InfluxDB 2.0 - configure plugins

继续并命名您的配置为“系统”,这样您就可以跟随这个教程。您可以保留描述为空白。点击“创建并验证”,您将被带到这个页面

Telegraf config - test your configuration

如果您尚未安装Telegraf,现在是安装的时候了。您可以点击链接访问下载页面,并根据您的系统和是否要使用Docker按照那里的说明安装Telegraf。

一旦您安装了Telegraf,您将想要设置一个环境变量,包含您的telegraf导出令牌,如步骤2中解释的那样。导出令牌是一种安全地向另一个应用程序提供访问权限,以便将数据写入您的实例的方式。打开一个新的终端标签页,然后将步骤2中的命令复制并粘贴到该标签页的提示中。

在同一个标签页中(你现在应该有两个标签页打开,第一个标签页是Alpha运行的地方,无论是从你的下载还是Docker容器中)你将运行步骤3中的命令。

Start Telegraf agent - collect metrics

这将启动Telegraf代理,它将使用我们之前选择的“系统”收集输入插件从你的电脑收集指标。

点击“监听数据”,如果一切连接正确,你将收到“找到连接!”通知并看到这个页面

Telegraf - listen for data

点击“完成”,你将被带到这个页面

Telegraf configuration - input plugins

在这里你可以看到你刚刚制作的Telegraf配置。点击配置名称(“系统”)将显示配置文件

Telegraf configuration system

如果你将配置文件滚动到最底部,你将看到我们添加到配置文件中的输入插件集合,其中之一是[[inputs.cpu]]。你还可以在这里下载配置,对其进行修改并手动添加其他输入和输出插件。然后你可以通过下载的配置文件而不是通过API运行Telegraf。你可以通过点击弹出窗口右上角的“x”来关闭配置。

现在让我们来点有趣的!“系统”插件集合包括一个预定义的仪表板,你现在可以通过点击“仪表板”来查看它

Telegraf plugins - predefined dashboard

点击“系统”,你将被带到类似这样的页面

Telegraf - system collection of plugins

在这里你可以看到“系统”插件集合收集了关于你的机器的各种指标的结果。

使用InfluxDB 2.0查询数据

接下来,点击左侧侧边栏中的“数据探索器”

querying data - InfluxDB

你现在在查询构建器中。在“_measurement”下选择“cpu。”这将弹出另一个包含与该度量相关字段的新块,如下所示

InfluxDB 2.0 - query builder

点击“usage_idle”,另一个包含标签键“cpu”及其所有可能值的块将弹出

InfluxDB 2.0 - Telegraf query

在构建查询的过程中,你可以随时点击“提交”并查看你构建的查询结果

InfluxDB 2.0 - query results

那么我们实际上构建的查询是什么?我们可以通过点击“脚本编辑器”来查看。

InfluxDB 2.0 - script editor

这样做将带我们到这个视图

 

InfluxDB 2.0 - Flux query

你在这里看到的是查询构建器中构建的底层Flux查询,以及你在点击“提交”时运行的查询。

使用InfluxDB 2.0写入数据

现在我们可以尝试手动将一些数据写入数据库(而不是通过爬虫或Telegraf代理收集),并使用UI查询这些数据。

在侧边栏的“配置”下,点击“桶”。你应该能看到这个视图,包括我们之前创建的桶。

InfluxDB 2.0 - create bucket

在右上角点击“创建桶”。

将桶命名为“trains”,保留保留策略不变(将“何时清除数据?”设置为“永不”)。现在为你的“trains”桶点击“添加数据”。

InfluxDB 2.0 - add data to bucket

从下拉菜单中选择“行协议”,你将看到这个视图

InfluxDB 2.0 - add data via line protocol

选择“手动输入”,并将以下行粘贴到窗口中

passengers_in_car,train=a,car=one,driver=gupta count=125

现在点击“继续”。你刚刚已经将第一个数据点写入数据库了!

让我们查询数据库以检索该数据点。点击左侧侧边栏中的“数据探索器”。从“桶”下拉菜单中选择“trains”。

InfluxDB 2.0 - query database

你现在应该能够看到“passengers_in_car”作为度量。点击它,另一个块将弹出,如下所示

InfluxDB 2.0 - data explorer

此时您可以点击“提交”,您将看到我们刚才写入的单个数据点的图形。如果您点击右上角的“图形”下拉菜单,您将找到将数据以表格形式显示的选项。选择该选项。现在您应该看到这个视图

InfluxDB 2.0 - data table

您现在可以通过点击“脚本编辑器:”来查看底层查询

InfluxDB 2.0 - script editor query

这显示了在查询构建器中创建查询时为您构建的Flux查询。您可以从这个视图修改查询。

本教程到此结束,因此如果您想关闭influxd 守护程序和Telegraf代理,您可以使用Mac上的ctrl + c退出它们。

InfluxDB 2.0 演示总结

您现在已经看到了InfluxDB 2.0的一些主要功能,包括抓取度量、运行Telegraf、查询数据和写入数据。这里还没有涉及许多其他功能,因此您可以期待未来看到更多关于这些功能的帖子。请注意,InfluxDB 2.0 尚未准备好投入生产,但我们欢迎您的反馈,并鼓励您在发布新版本时尝试Alpha版本。祝您玩得开心!