介绍社区 InfluxDB 模板

作者：Michael Hall / 产品，用例，开发者
2020年2月19日

导航到

在 InfluxDB 2.0 中，我们增加了导出整个堆栈配置的能力，并将其再次导入到 InfluxDB 的另一个实例中。这包括您的 InfluxDB 存储桶、仪表板、查询、警报，甚至 Telegraf 配置。

由于许多人有相同或类似的使用案例，我们希望提供一个途径，让您与其他用户共享配置，并随着时间的推移共同改进它们，就像您对任何其他开源项目所做的那样。因此，我们启动了一个社区 InfluxDB 模板项目，您可以在其中发布模板，查看其他 InfluxDB 用户所构建的内容，并尝试他们的模板！

我们将使用模板的过程简化到极致，只需几个命令，您就可以拥有所需的一切并启动运行。您现在可以在InfluxDB Cloud上试用，或者下载并自行运行 InfluxDB 2.0。

设置您的环境

在这篇文章中，我将使用InfluxDB Cloud 免费套餐来演示如何使用模板。使用这项托管服务与使用自托管的 InfluxDB 2.0 实例相同，只有几个例外。首先，托管服务为您提供了一个默认的组织名称，这将是在注册时使用的电子邮件地址。其次，托管服务在开始时不会为您创建一个 所有访问 令牌，您将需要它来应用和使用模板。

要创建令牌，请登录您的 InfluxDB Cloud 实例，转到“加载数据”部分，然后点击“令牌”标签。从那里您可以创建一个新的 所有访问 令牌。请确保不要将此令牌与任何您不希望拥有完整访问权限的人共享！本文中展示的令牌仅为此演示创建，并已被删除，因此无法再使用。

influxdb load data

export INFLUX_HOST=https://us-west-2-1.aws.cloud2.influxdata.com 
export [email protected] 
export INFLUX_TOKEN=MEMHwunGerdCRFG1_9Yi_GLpvGC3sr03DV1lUuvevhHJ88mqS5I7JmkyjlpMVpCDFv8Lf7rNq6MhUiavNw7Ceg==

请注意，我的 INFLUX_HOST 是亚马逊 AWS 的 us-west-2 区域。当你注册 InfluxDB Cloud 时，你需要选择运行它的位置。你可以使用任何可用的选项，并且可以在用户界面的 加载数据 > 客户端库 部分找到这个变量的正确值。

InfluxDB load data client libraries

选择你的模板

社区 InfluxDB 模板存储库提供了可用的模板列表。最简单的开始之一是 Linux 系统监控 模板，它将从 Linux 机器收集一系列系统资源指标，并将它们全部显示在一个漂亮的仪表板上。

community influx templates example

应用模板

由于我们已经设置了环境变量，我们只需要在命令行中指定模板文件的路径。如果你已经克隆了包含所有模板的 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 设置进行的更改列表。这让你有机会在它进行任何更改之前审查模板将要做什么。

community influx templates

一旦你确认要做出这些更改，它将为你创建所有指定的资源。这就全部了！

运行 Telegraf 配置

上面的说明创建了你仪表板和相关的资源，但你可能会注意到那里还没有数据。这是因为 Linux 系统监控模板，就像大多数模板一样，使用 Telegraf 从某些来源读取数据并将其写入 InfluxDB。但运行模板中的 Telegraf 也很容易，因为配置是它的一部分！

running Telegraf configurations

到目前为止，你可以在任何你喜欢的机器上运行这些说明。但你需要在你想要监控的 Linux 主机上安装并运行 Telegraf。

每个模板都将提供如何设置和运行任何额外资源（如 Telegraf）的说明。例如，Linux 系统监控模板首先会告诉你设置环境变量（与上面设置的一样，但这次是在我们将要监控的 Linux 主机上），然后告诉你如何从 加载数据 > Telegraf 获取 Telegraf 配置，如下所示

Linux system Telegraf

因为 Telegraf 配置已经存在于你的 InfluxDB 实例中，所以使用它只需要将 Telegraf 指向它。这个命令将使用你的环境变量中的凭证连接到你的 InfluxDB 实例，下载 Linux 系统监控配置，并使用它启动 Telegraf。

telegraf --config https://us-west-2-1.aws.cloud2.influxdata.com/api/v2/telegrafs/05423ced3db76000

现在，当你查看你的 Linux 系统仪表板时，你会在图表中开始看到数据！务必检查你顶部的过滤器是否使用正确的 桶 (telegraf) 和 linux_host （这将来自主机本身）。因为仪表板允许你按主机进行过滤，所以你可以在多个 Linux 机器上运行相同的 Telegraf 命令，并通过同一个仪表板监控它们！

Linux system dashboard Telegraf

加入 InfluxDB 社区

想了解更多关于InfluxDB模板和其他社区项目的信息，请加入InfluxDB社区Slack和论坛。在那里，您可以找到InfluxData工程师和InfluxDB用户共同工作，分享想法，互相支持。