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

# 连接到 OpenTSDB 数据来源
<a name="using-opentsdb-in-AMG"></a>

 Amazon Managed Grafana 提供对 OpenTSDB 的高级支持。

## 添加数据来源
<a name="opentsdb-adding-the-data-source"></a>

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

1.  在侧边菜单的**控制面板**链接下，您应该可以找到名为**数据来源**的链接。

1.  选择顶部标题中的 **\+ 添加数据来源**按钮。

1.  从**类型**下拉列表中选择 **OpenTSDB**。

**注意**  
 如果您在侧边菜单中看不到**数据来源**链接，则表示您当前的用户没有 `Admin` 角色。


|  Name  |  说明  | 
| --- | --- | 
|  Name  |  数据来源名称。您将在面板和查询中通过其名称查看数据来源。 | 
|  Default  |  默认数据来源意味着将为新面板预先选择该数据来源。 | 
|  Url  |  OpenTSDB 服务器的 HTTP 协议、ip 和端口（默认端口通常为 4242）。 | 
|  Access  |  服务器（默认）= 必须可以从 Grafana backend/server 访问网址。 | 
|  Version  |  版本 = OpenTSDB 版本，<=2.1 或 2.2。 | 
|  Resolution  |  OpenTSDB 中的指标可以具有秒级或毫秒级分辨率的数据点。 | 

## 查询编辑器
<a name="opentsdb-query-editor"></a>

 选择标题，在编辑模式下打开图形。如果数据来源的版本为 <=2.1 或 =2.2，则查询编辑器会有所不同。在早期版本中，只能使用标签来查询 OpenTSDB。但在新版本中，可使用筛选条件和标签来查询 OpenTSDB。OpenTSDB 2.2 中还引入了填充策略。

**注意**  
 使用 OpenTSDB 2.2 数据来源来时，务必使用筛选条件或标签，因为二者是互斥的。如果同时使用，可能会产生奇怪的结果。

### 使用自动完成建议
<a name="auto-complete-suggestions"></a>

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

## 模板化查询
<a name="opentsdb-templating-queries"></a>

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

 有关模板化和模板变量的更多信息，请参阅 [模板和变量](templates-and-variables.md)。

### 查询变量
<a name="opentsdb-query-variable"></a>

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

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


|  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`。

### 嵌套模板
<a name="nested-templating"></a>

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


|  Query  |  说明  | 
| --- | --- | 
|  tag\_values(cpu, hostname, env=$env)  |  返回 cpu 指标的标签值、选定环境标签值和标签键主机名。 | 
|  tag\_values(cpu, hostname, env=$env, region=$region)  |  返回 cpu 指标的标签值、选定环境标签值、选定区域标签值和标签键主机名。 | 

 有关 OpenTSDB 指标查询的更多信息，请参阅 [OpenTSDB 文档](https://opentsdb.net/docs/build/html/index.html)