社区 InfluxDB 模板介绍
作者:Michael Hall / 产品, 用例, 开发者
2020 年 2 月 19 日
导航至
在 InfluxDB 2.0 中,我们添加了导出整个堆栈配置并在另一个 InfluxDB 实例中重新导入它的功能。这包括您的 InfluxDB bucket、仪表板、查询、警报,甚至 Telegraf 配置。
由于许多人有相同或相似的用例,我们希望提供一种方法,让您可以与其他用户分享您的配置,并像任何其他开源项目一样,共同增强和改进它们。因此,我们启动了一个 社区 InfluxDB 模板 项目,您可以在其中发布您的模板,查看其他 InfluxDB 用户构建的内容,并亲自尝试他们的模板!
我们已尽可能简化模板的使用,只需几个命令,您就可以启动并运行所需的一切。您现在可以在 InfluxDB Cloud 或通过下载并自行运行 InfluxDB 2.0 来尝试它。
设置您的环境
在本文中,我将使用 InfluxDB Cloud 免费层级 来演示如何使用模板。使用此托管服务与使用自托管 InfluxDB 2.0 实例相同,只有几个例外。首先,托管服务为您提供一个默认的组织名称,这将是您注册时使用的电子邮件地址。其次,托管服务在开始时不会为您创建 All Access 令牌,您需要一个令牌才能应用和使用模板。
要创建令牌,请登录您的 InfluxDB Cloud 实例,转到加载数据部分,然后单击 令牌 选项卡。从那里您可以创建一个新的 All Access 令牌。请务必不要与您不希望拥有完全访问您帐户权限的任何人共享此令牌!我在本文中展示的令牌是专门为本次演示创建的,并且已被删除,因此无法再使用。
接下来,您需要创建一些环境变量。这并非绝对必要,因为您可以将相同的信息作为参数传递给稍后我们将使用的 influx 命令行,但如果我们将它们设置为环境变量,则可以节省一些打字时间,并使其更易于理解。以下是我的环境变量:
export INFLUX_HOST=https://us-west-2-1.aws.cloud2.influxdata.com
export [email protected]
export INFLUX_TOKEN=MEMHwunGerdCRFG1_9Yi_GLpvGC3sr03DV1lUuvevhHJ88mqS5I7JmkyjlpMVpCDFv8Lf7rNq6MhUiavNw7Ceg==
请注意,我的 INFLUX_HOST 是 Amazon AWS 上的 us-west-2 区域。当您注册 InfluxDB Cloud 时,系统会要求您选择要运行它的位置。您可以使用任何可用选项,并且可以在 UI 的 加载数据 > 客户端库 部分下找到此变量的正确值。
选择您的模板
社区 InfluxDB 模板存储库提供了可用模板的列表。最简单的入门模板之一是 Linux 系统监控 模板,它将从 Linux 机器收集许多系统资源指标,并在一个漂亮的仪表板中全部显示给您。
应用模板
由于我们已经设置了环境变量,因此我们需要在命令行上指定的唯一内容是模板文件的位置。如果您已克隆包含所有模板的 Git 存储库,则可以像这样指向清单文件
influx pkg --file ~/Projects/community-templates/linux_system/linux_system.yml
但更简单的方法是跳过克隆,只需使用 –url 参数直接指向 Github 上的清单文件,如下所示
influx pkg --url https://raw.githubusercontent.com/influxdata/community-templates/master/linux_system/linux_system.yml
这将读取模板文件,并在应用之前向您显示它将对您的 InfluxDB 设置进行的更改列表。这使您有机会在模板进行任何更改之前查看它将执行的操作。
一旦您确认要进行这些更改,它将为您创建所有指定的资源。这就是您需要做的全部!
运行 Telegraf 配置
虽然上述说明创建了您的仪表板和支持资源,但您会注意到那里还没有数据。这是因为 Linux 系统监控模板与大多数模板一样,使用 Telegraf 从某个来源读取数据并将其写入 InfluxDB。但是从模板运行 Telegraf 也很容易,因为配置是其中的一部分!
到目前为止,您可以在您喜欢的任何机器上运行这些说明。但是您需要在您要监控的 Linux 主机上安装并运行 Telegraf。
每个模板都将提供有关如何设置和运行任何其他资源(例如 Telegraf)的说明。例如,Linux 系统监控器首先告诉您设置您的环境变量(与我们上面设置的相同,但这次是在我们将要监控的 Linux 主机上),然后告诉您从 加载数据 > Telegraf 获取 Telegraf 配置,如下所示
由于 Telegraf 配置已在您的 InfluxDB 实例中,因此使用它们只需将 Telegraf 指向它即可。此命令将使用环境变量中的凭据连接到您的 InfluxDB 实例,下载 Linux 系统监控配置,并启动 Telegraf 运行它。
telegraf --config https://us-west-2-1.aws.cloud2.influxdata.com/api/v2/telegrafs/05423ced3db76000
现在,当您查看您的 Linux 系统仪表板时,您将开始看到数据出现在您的图表中!请务必检查顶部的过滤器是否使用了正确的 bucket (telegraf) 和 linux_host (这将来自主机本身)。由于仪表板允许您按主机进行过滤,因此您可以在多台 Linux 机器上运行相同的 Telegraf 命令,并通过同一仪表板监控所有这些机器!
加入 InfluxDB 社区
要了解有关 InfluxDB 模板和其他社区项目的更多信息,请加入 InfluxDB 社区 Slack 和 论坛。在那里,您将找到 InfluxData 工程师和 InfluxDB 用户一起工作、分享想法和互相支持。