OpenTSDB 数据源

Grafana 提供了对 OpenTSDB 的高级支持。本主题解释了 OpenTSDB 数据源的配置、变量、查询以及其他特定功能。

有关如何向 Grafana 添加数据源的说明，请参阅管理文档。只有具有组织管理员角色的用户才能添加数据源。管理员还可以使用 Grafana 的供应系统通过 YAML 配置数据源。

OpenTSDB 设置

要配置数据源的基本设置，请完成以下步骤

点击左侧菜单中的连接。
在您的连接下，点击 数据源。
在搜索栏中输入 OpenTSDB。
选择 OpenTSDB。
将显示数据源的设置选项卡。
设置数据源的基本配置选项

名称	描述
名称	数据源名称。这是您在面板和查询中引用数据源的方式。
默认	新创建面板默认预选的数据源。
URL	您的 OpenTSDB 服务器的 HTTP 协议、IP 和端口（默认端口通常为 4242）。
允许的 Cookie	要转发到数据源的 Cookie 列表。
版本	OpenTSDB 版本（支持的版本有：2.4、2.3、2.2 和低于 2.1 的版本）。
分辨率	OpenTSDB 的指标可能具有秒或毫秒分辨率的数据点。
查询限制	默认值为 1000。

供应数据源

您可以在 YAML 文件中定义和配置数据源，作为 Grafana 供应系统的一部分。有关供应的更多信息以及可用的配置选项，请参阅供应 Grafana。

供应示例

apiVersion: 1

datasources:
  - name: OpenTSDB
    type: opentsdb
    access: proxy
    url: https://:4242
    jsonData:
      tsdbResolution: 1
      tsdbVersion: 1

查询编辑器

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

注意
使用 OpenTSDB 2.2 数据源时，请确保仅使用 Filters 或 Tags，因为它们是互斥的。如果同时使用，可能会得到奇怪的结果。

注意
在 OpenTSDB 2.4 中使用告警时，查询会使用参数 arrays=true 执行。这会导致 OpenTSDB 将数据点返回为数组的数组，而不是键值对的映射。然后 Grafana 会将此数据转换为适当的数据帧格式。

自动完成建议

当您开始输入指标名称、标签名称或标签值时，会出现高亮显示的自动完成建议。自动完成仅在启用 OpenTSDB suggest API 时有效。

模板化查询

在指标查询中，您可以使用变量代替硬编码的服务器、应用程序和传感器名称等信息。变量会显示为面板顶部的下拉选择框。这些下拉框可以轻松更改面板中显示的数据。

请查阅模板化文档，了解模板化功能和不同类型的模板变量介绍。

查询变量

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

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

查询	描述
`metrics(prefix)`	返回具有特定前缀（可为空）的指标名称
`tag_names(cpu)`	返回特定 cpu 指标的标签名称（即键）
`tag_values(cpu, hostname)`	返回指标 cpu 和标签键 hostname 的标签值
`suggest_tagk(prefix)`	返回具有特定前缀（可为空）的所有指标的标签名称（即键）
`suggest_tagv(prefix)`	返回具有特定前缀（可为空）的所有指标的标签值

如果您在 值预览 部分看不到模板变量被填充，则需要在 OpenTSDB 服务器设置中启用 tsd.core.meta.enable_realtime_ts。此外，要填充 OpenTSDB 中现有时间序列数据的元数据，您需要在 OpenTSDB 服务器上运行 tsdb uid metasync。

嵌套模板化

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

查询	描述
`tag_values(cpu, hostname, env=$env)`	返回 cpu 指标、选定的 env 标签值和标签键 hostname 的标签值
`tag_values(cpu, hostname, env=$env, region=$region)`	返回 cpu 指标、选定的 env 标签值、选定的 region 标签值和标签键 hostname 的标签值

有关 OpenTSDB 指标查询的详细信息，请查阅官方OpenTSDB 文档