用于 Grafana 的 Hetzner Cloud 数据源

介绍

使用此插件，您可以在 Grafana 仪表盘中显示您的 Hetzner Cloud 服务器和负载均衡器的指标数据。它直接与 Hetzner Cloud API 集成，无需 Prometheus 或任何其他额外软件。

要求

• Grafana 10+

开始使用

安装数据源插件后，您需要在 Grafana 中添加新的数据源。为项目创建一个新的 read API 令牌，并在数据源设置中进行配置。

为了快速开始使用，您可以导入随附的仪表盘，它显示了服务器和负载均衡器的所有可用指标。该仪表盘在数据源设置页面的一个标签页中提供。或者，您也可以从仓库中获取 JSON 文件。

文档

查询编辑器

查询编辑器起初可能不太容易理解，这里提供了可用选项的概述。

选择资源

在查询编辑器中，您可以选择想要获取指标的资源类型：服务器或负载均衡器。

要定义您想要在图表中查看哪些服务器/负载均衡器，您可以选择以下选项

• ID：项目内所有可用服务器/负载均衡器的下拉列表。您可以选择多个 ID。
• 标签：您可以设置标签选择器来过滤资源。如果您的资源列表是动态的，这将非常有用。
• 变量：此选项用于支持使用仪表盘范围的变量来选择资源。应包含变量的 $ 前缀，例如 $servers。更多详细信息请参阅使用变量。

图例格式

您可以使用查询编辑器中的“图例格式”字段来重命名返回的序列名称。这与 Prometheus 数据源的工作方式类似。

在指定的格式中，您可以在 {{ }} 括号中包含标签名称，它们将被替换为实际的标签值。

目前，以下标签可用

• name：资源的名称（服务器或负载均衡器）
• id：资源的 ID
• series_name：来自 API 的序列名称（例如 disk.0.iops.read）
• series_display_name：序列的人类可读名称（例如 Read）

如果未指定，默认格式为：{{ series_display_name }} {{ name }}。

查询类型

默认情况下，查询返回指标。也可以选择查询类型“列出资源”。这将返回一个包含匹配资源的表格，其中包含一些有趣的字段，例如服务器类型和标签。

返回的字段 var 对于使用变量是必需的。

使用变量

如果您想在仪表盘中有一个服务器或负载均衡器的下拉列表，您可以使用“列出资源”查询类型来获取资源列表。

返回的值将类似于 $resource_name : $resource_id。添加正则表达式 (?.*) : (?.*) 以将资源名称作为选项。此正则表达式也是必需的，以便您可以在后续查询中使用该变量，因为当选项被选中时，它会将 ID 作为值。

假设您使用上述正则表达式创建了变量 $servers，您现在可以使用“指标”查询类型创建一个新面板，点击“按变量选择”，并将变量名称字段设置为 $servers。

然后，当您在下拉列表中选择不同的服务器时，面板应自动更新。

您也可以查看随附的仪表盘，以实际了解如何进行设置。

多个项目

如果您想访问多个 Hetzner Cloud 项目的指标，您需要为每个项目创建一个新的数据源，并使用独立的 API 令牌。默认仪表盘有一个变量用于选择当前项目。

贡献

如果您有任何问题、反馈或想法，请随时提交问题或拉取请求。

支持免责声明

这绝非 Hetzner Cloud 的官方产品，Hetzner Cloud 也不为此提供支持。