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

# 连接到 Wavefront 数据来源（VMware Tanzu Observability by Wavefront）
<a name="wavefront-datasource-for-AMG"></a>

 Wavefront（VMware Tanzu Observability by Wavefront）数据来源使 Amazon Managed Grafana 用户能够查询和可视化直接从 Wavefront 收集的数据，并轻松地将其与任何其他指标、日志、跟踪或其他数据来源一起可视化。这种灵活的单一窗格视图使跟踪系统运行状况和调试问题变得更加容易。

**注意**  
此数据来源仅适用于 Grafana Enterprise。有关更多信息，请参阅 [管理对 Enterprise 插件的访问](upgrade-to-enterprise-plugins.md)。  
此外，在支持版本 9 或更高版本的工作区中，此数据来源可能需要您安装相应的插件。有关更多信息，请参阅 [使用插件扩展您的工作区](grafana-plugins.md)。

## 什么是 Wavefront？
<a name="what-is-wavefront"></a>

 [Wavefront](https://www.wavefront.com) 是一款由 VMware 开发的云监控和分析工具。Wavefront 是一项云托管服务，你可以在其中发送来自 CollectD、Statsd、JMX、Ruby 的记录器或其他工具的时间序列（指标）数据。 AWS借助 Wavefront，用户可以对这些序列执行数学运算、渲染图表以查看异常情况、跟踪 KPI 并创建警报。

## 利用 Wavefront 和 Grafana 最大限度利用您的技术堆栈
<a name="maximizing-your-tech-stack-with-wavefront-and-AMG"></a>

 虽然从表面上看，Grafana 和 Wavefront 听起来很相似，但许多组织同时使用 Wavefront 和 Grafana 作为其可观测性工作流的关键部分。

 **无需移动数据来源即可实现可视化：**Grafana 的独特架构可直接查询数据所在的位置，而不是移动数据并为冗余存储和摄取付费。

 **编写来自不同来源的面板：**使用预构建和自定义的控制面板，将来自许多不同数据来源的数据整合到一个窗格中。

 **在用户级别转换和计算：**用户可以转换数据，并对他们看到的数据执行各种计算，从而减少数据准备工作。

 **在面板中合并、计算和可视化：**创建混合数据来源面板，显示来自 Waveferont 和其他来源（例如 Prometheus 和 InfluxDB）的相关数据。

## 文档
<a name="wavefront-documentation"></a>

### 功能
<a name="wavefront-features-3"></a>
+  时间序列可视化 
+  表可视化 
+  热图可视化 
+  单一统计可视化 
+  引导式查询编辑器 
+  原始 WQL 查询编辑器 
+  事件数据注释 
+  模板变量 
+  Ad-Hoc 筛选器 
+  警报 

### 配置
<a name="wavefront-configuration-4"></a>

 配置 Wavefront 数据来源相对简单。完成配置只需要两个字段：`API URL` 和 `Token`。
+  `API URL` 是用于访问 wavefront 环境的 URL。示例：`https://myenvironment.wavefront.com`。
+  `Token` 必须由用户账户或服务账户生成。

  1.  要创建基于用户账户的令牌，请登录 Wavefront 环境，选择页面右上角的齿轮，选择您的用户名（例如 `me@grafana.com`），选择用户页面顶部的 **API 访问**选项卡，然后复制现有密钥或选择**生成**。

  1. 要创建基于服务账户的令牌，请登录 Wavefront 环境，选择页面右上角的齿轮，然后选择账户管理。在左侧导航栏中，选择**账户、组和角色**，选择顶部的**服务账户**选项卡，然后选择**创建新账户**。输入服务账户的名称。可根据个人喜好输入。复制**令牌**部分下提供的令牌。

  1. 最后一步是确保在**权限**下选中**账户、组和角色**复选框。

 获得令牌后，将其添加到 `Token` 配置字段，这样就设置完成！

 最终的配置页面应如下所示：

### 用法
<a name="wavefront-usage-6"></a>

#### 使用 查询编辑器
<a name="wavefront-using-the-query-editor"></a>

 Wavefront 查询编辑器有两种模式：**查询生成器**和**原始查询**。要切换两种模式，请使用查询表单右上角的选择器：

 在**查询生成器**模式下，有四个选项可供选择：

1.  您要查询哪些指标？ 

1.  您想对该指标执行哪种聚合？ 

1.  您想如何筛选指标查询结果？ 

1.  是否要对结果应用其他函数？ 

 指标选择器是一个分类层次结构。选择一个类别，然后再次选择以深入查看子类别。重复此过程，直到达到所需的指标。

 选择指标后，将自动为您填充可用的筛选条件和筛选条件值。

 在**原始查询**模式下，您将看到一个标有**查询**的字段。这让您可以执行任何 [WQL](#wavefront-references) 查询。

#### 使用筛选条件
<a name="wavefront-using-filters-1"></a>

 Wavefront 插件将动态查询每个指标的相应筛选条件。

 要添加筛选条件，请在 Wavefront 查询编辑器上选择**筛选条件**标签旁边的 **\+**，选择要筛选的字段，然后选择要作为筛选依据的值。

#### 使用函数
<a name="wavefront-using-functions"></a>

 函数提供了另一种聚合、操作和计算指标响应数据的方法。要查看可用函数，请选择**查询生成器**上函数标签旁边的下拉列表。根据您选择的函数，您将能够执行进一步的操作，例如按字段设置分组或应用阈值。用户能够将多个函数链接在一起，以执行高级计算或数据操作。

#### 添加查询模板变量
<a name="wavefront-adding-a-query-template-variable-1"></a>

1.  要为控制面板创建新的 Wavefront 模板变量，请选择控制面板右上角的设置齿轮。

1.  在左侧窗格中，选择**变量**。

1.  在变量页面的右上角，选择**新建**。

1.  为要创建的模板变量输入**名称**和**标签**。**名称**是您将在查询中用来引用模板变量的值。**标签**是一个人性化名称，用于在控制面板选择面板上显示模板变量。

1.  为类型字段选择**查询**类型（默认为选中）。

1.  在**查询选项**标题下，在**数据来源**下拉列表中选择 **Wavefront**。

1.  有关应在**查询**字段中输入的内容的详细信息，请参阅[模板变量查询结构](#template-variable-query-structure)。

1.  如果要从查询中筛选任何返回值，请在**正则表达式**输入字段中输入正则表达式。

1.  通过在**排序**下拉列表中选择排序类型，应用您可能有的任何排序首选项。

1.  验证配置后，选择**添加**以添加模板变量，然后选择左侧导航面板上的**保存控制面板**以保存更改。

#### 模板变量查询结构
<a name="template-variable-query-structure"></a>

 metric lists: metrics: ts(…) 

 source lists: sources: ts(…) 

 source tag lists: sourceTags: ts(…) 

 匹配的源标签列表：匹配SourceTags：ts (...) 

 tag name lists: tagNames: ts(…) 

 tag value lists: tagValues(<tag>): ts(…) 

 **备注** 
+  每个查询类型末尾的 s 是可选的 
+  支持全部小写。您可以使用 tagnames 或 tagNames，但不能使用 TAGNAMES。
+  : 两边的空格是可选的 

   **WARNING** 

   Wavefront 插件目前不支持 `Multi-value` 和 `Include All option`。

#### 使用模板变量
<a name="wavefront-using-template-variables-2"></a>

 完成[添加新模板变量](#wavefront-adding-a-query-template-variable-1)的步骤后，您现在可以在控制面板中使用模板变量来创建动态可视化。

1.  使用控制面板右上角的面板 \+ 图标，添加新的控制面板面板。

1.  选择要用于查询的聚合。

1.  选择**筛选条件**标签旁边的 \+ 图标，然后选择与您的模板变量匹配的键类型。例如，`host=` 表示主机筛选条件。

1.  在筛选条件的**值**输入字段中输入您创建的模板变量的名称。

1.  保存控制面板。

 现在，您应该能够循环浏览模板变量的不同值，并动态更新面板！

#### 使用 Ad-Hoc 过滤器
<a name="wavefront-using-ad-hoc-filters"></a>

 要使用临时筛选条件，必须创建两个模板变量。第一个是辅助变量，用于选择指标，以便为该指标名称填充临时筛选条件。另一个是实际的临时筛选条件变量。

**重要**  
 所需的辅助变量必须命名为 `metriclink`。该变量可以是包含您要使用的指标列表的自定义变量，也可以是使用[模板变量查询结构](#template-variable-query-structure)的基于查询的变量。如果只想用单个指标中的值填充临时筛选条件字段，可以隐藏 `metriclink` 模板变量。

 创建 `metriclink` 变量后，您现在可以按照[添加查询模板变量](#wavefront-adding-a-query-template-variable-1)中详述的相同步骤添加临时筛选条件。不同之处在于，您将选择**临时筛选条件**作为**类型**，并且查询不需要输入。

#### 添加注释
<a name="wavefront-adding-annotations"></a>

1.  要为控制面板创建新的 Wavefront 注释，请选择控制面板右上角的设置齿轮。

1.  在左侧面板中，选择**注释**。

1.  在注释页面的右上角，选择**新建**。

1.  输入注释的名称（这将用作控制面板上切换开关的名称）。

1.  选择 Wavefront 的**数据来源**。

1.  默认情况下，注释最多可返回 100 个警报事件。若要更改，请将**限制**字段设置为所需的值。

1.  选择**添加**。

#### 使用注释
<a name="using-annotations"></a>

 打开注释后，您现在应该会看到与给定时间段相关的警报事件和问题。

 如果您将鼠标悬停在可视化的注释部分底部，将显示一个弹出窗口，其中显示警报名称，并提供指向 Wavefront 中警报的直接链接。

#### 使用“显示名称”字段
<a name="wavefront-using-display-name-1"></a>

 此数据来源使用“选项”面板的“字段”选项卡中的“显示名称”字段，根据其名称、标签或值来缩短或更改图例键。其他数据来源使用自定义 `alias` 功能来修改图例键，但是 Display Name 函数是更一致的操作方式。

### 参考
<a name="wavefront-references"></a>
+  [WQL（Wavefront 查询语言）](https://docs.wavefront.com/query_language_reference.html)