连接到 OpenTSDB 数据源 - Amazon Managed Grafana
添加数据源查询编辑器模板化查询

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

连接到 OpenTSDB 数据源

亚马逊 Managed Grafana 附带了对 OpenTSDB 的高级支持。

添加数据源

  1. 选择顶部标题中的 Grafana 图标，打开侧面菜单。

  2. 在仪表板链接下的侧面菜单中，您应该找到一个数据源链接。

  3. 选择顶部标题中的 “+ 添加数据源” 按钮。

  4. 从 “类型” 下拉列表中选择 OpenTSDB。

注意

如果您在侧面菜单中看不到数据源链接，则表示您当前的用户没有该Admin角色。

名称 描述
Name 数据源名称。这就是您在面板和查询中查看数据源的方式。
Default 默认数据源意味着将为新面板预先选择该数据源。
Url opentsdb 服务器的 HTTP 协议、IP 和端口（默认端口通常为 4242）。
Access 服务器（默认）= 必须可以从 Grafana 后端/服务器访问网址。
Version 版本 = opentsdb 版本，要么是 <=2.1，要么是 2.2。
Resolution 来自 opentsdb 的指标可以有分辨率为秒或毫秒的数据点。

查询编辑器

通过选择标题在编辑模式下打开图表。如果数据源的版本为 <=2.1 或 = 2.2，则查询编辑器会有所不同。在以前的版本中，只能使用标签来查询 OpenTSDB。但是在后一个版本中，可以使用过滤器和标签来查询 opentsdb。OpenTSDB 2.2 中还引入了填充策略。

注意

使用 OpenTSDB 2.2 数据源时，请务必使用过滤器或标签，因为它们是互斥的。如果一起使用，可能会给你带来奇怪的结果。

使用自动完成建议

开始键入指标名称、标签名称和标签值后，您应该会看到突出显示的自动完成建议。只有在启用 OpenTSDB 建议 API 的情况下，自动完成功能才会起作用。

模板化查询

不必在指标查询中对服务器、应用程序和传感器名称等内容进行硬编码，而可以使用变量代替它们。变量显示为仪表板顶部的下拉选择框。您可以使用这些下拉框来更改控制面板中显示的数据。

有关模板和模板变量的更多信息，请参阅模板和变量。

查询变量

OpenTSDB 数据源支持模板变量查询。这意味着你可以创建模板变量来从 OpenTSDB 获取值。例如，指标名称、标签名称或标签值。

将 OpenTSDB 与模板变量query类型一起使用时，可以使用以下语法进行查找。

查询 描述
metrics(prefix) 返回带有特定前缀的指标名称（可以为空）。
tag_names(cpu) 返回特定 cpu 指标的标签名称（即密钥）。
tag_values(cpu, hostname) 返回指标 cpu 和标签密钥主机名的标签值。
suggest_tagk(prefix) 返回带有特定前缀（可以为空）的所有指标的标签名称（即密钥）。
suggest_tagv(prefix) 返回带有特定前缀的所有指标的标签值（可以为空）。

如果未在Preview of values章节中看到模板变量已填充，则必须在 OpenTSDB 服务器设置tsd.core.meta.enable_realtime_ts中启用。此外，要在 OpenTSDB 中填充现有时间序列数据的元数据，必须在 OpenTSDB 服务器tsdb uid metasync上运行。

嵌套模板

一个模板变量可用于筛选另一个模板变量的标签值。第一个参数是指标名称，第二个参数是您需要查找标签值的标签键，之后是所有其他依赖模板变量。下面列举了一些使嵌套模板查询成功运行的示例。

查询 描述
tag_values(cpu, hostname, env=$env) 返回 CPU 指标的标签值、选定的环境标签值和标签密钥主机名。
tag_values(cpu, hostname, env=$env, region=$region) 返回 CPU 指标的标签值、选定的环境标签值、选定的区域标签值和标签密钥主机名。

有关 OpenTSDB 指标查询的更多信息，请参阅 OpenTSDB 文档