Grafana 的 Wavefront 数据源

Grafana Wavefront 数据源插件允许 Grafana 用户直接查询和可视化从 Wavefront 收集的数据，并轻松将其与任何其他指标、日志、跟踪或其他数据源可视化。这种灵活的单窗格视图使跟踪系统运行状况和调试问题变得更容易。

使用 Wavefront 和 Grafana 最大化您的技术堆栈

虽然从表面上看，Grafana 和 Wavefront 可能听起来很相似，但许多组织都将 Wavefront 和 Grafana 作为其可观察性工作流程的关键部分。

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

从各种来源组合面板使用预构建和自定义仪表盘，将来自许多不同数据源的数据整合到一个单窗格视图中。

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

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

要求

此插件具有以下要求

可以生成 API 密钥的 Wavefront 用户
以下帐户类型之一
- 适用于具有 Grafana Cloud 免费版、高级版或试用版帐户的用户，或具有已激活的 Grafana 企业版许可证的用户。

已知限制

Wavefront 插件目前不支持具有 Multi-value 和 Include All option 的模板变量。

安装 Wavefront 数据源插件

要安装数据源，请参阅安装

配置 Wavefront

您将需要您的 Wavefront API 令牌才能使用此插件。可以从用户帐户或服务帐户生成的 API 令牌生成。

从用户帐户

登录您的 Wavefront 环境。
单击页面右上角的齿轮，然后选择您的用户名（例如 [email protected]）。
选择用户页面顶部的 API Access 选项卡。
复制现有密钥或单击 generate。在 Grafana 中配置数据源时粘贴此令牌。

从服务帐户

登录您的 Wavefront 环境。
单击页面右上角的齿轮，然后选择帐户管理。
在左侧导航栏中选择 Accounts, Groups, & Roles
在顶部选择 Service Accounts，然后单击 Create New Account。
输入服务帐户的名称。
复制 Tokens 部分下提供的令牌，并在 Grafana 中配置数据源时粘贴。
确保您在 Permissions 下选中了 Accounts, Groups, & Roles 复选框

在 Grafana 中配置数据源

添加数据源，方法是填写以下字段

字段	描述
API URL	您用于访问 Wavefront 环境的 URL。例如 `https://myenvironment.wavefront.com`。
令牌	您从 Wavefront 获取的 API 令牌。要了解更多信息，请参阅配置 Wavefront
请求超时	Wavefront 查询超时持续时间（以秒为单位）。如果留空，将默认设置为 30 秒

使用配置进行数据源配置

可以使用 Grafana 的配置系统通过配置文件来配置数据源。您可以在配置文档页面上了解有关其工作原理以及可以为数据源设置的所有设置的更多信息。

apiVersion: 1
datasources:
  - name: Wavefront
    type: grafana-wavefront-datasource
    access: proxy
    basicAuth: false
    editable: true
    enabled: true
    jsonData:
      url: Wavefront environment URL
      requestTimeout: 30
    secureJsonData:
      token: Wavefront API token

查询数据源

Wavefront 查询编辑器有两种模式：查询构建器 和 原始查询。要在这两种模式之间切换，请使用查询表单右上角的选择器。

查询构建器

指标: 指标选择器是一个分类层次结构。选择一个类别，然后再次单击以深入了解子类别。重复此过程，直到找到所需的指标。; 选择指标后，将自动为您填充可用的过滤器和过滤器值。
聚合: 选择要对该指标查询执行的聚合方法。
过滤器: 过滤来自该指标查询的结果。; Wavefront 插件将动态查询每个指标的适当过滤器。; 单击 + 按钮添加过滤器。单击垃圾桶按钮删除过滤器。; 创建过滤器后，从各自的下拉菜单中选择键和值。; 如果应用了多个过滤器，您可以通过单击连接词并从下拉菜单中选择来更改连接词。
函数: 函数提供了一种额外的聚合、操作和对指标响应数据执行计算的方法。要查看可用的函数，请单击 查询构建器 上函数标签旁边的下拉菜单。; 根据您选择的函数，您将能够执行其他操作，例如设置分组字段或应用阈值。多个函数可以链接在一起以执行高级计算或数据操作。

原始查询

在 原始查询 模式下，您将看到一个名为 查询 的单一字段。这允许您运行任何您想要的 WQL 查询。

活动

列出仪表盘时间范围内的所有事件。最多可以获取 100 个事件。

模板和变量

要添加新的 Wavefront 查询变量，请参阅添加查询变量。将 Wavefront 数据源用作以下可用查询的数据源

查询类型	描述	示例
指标	指标列表	查询： `~sample.cpu.\*`
来源	来源列表	查询： `~sample.cpu.\*`
sourceTags	来源标签列表	查询： `~sample.cpu.\*`
matchingSourceTags	匹配的来源标签列表	查询： `~sample.cpu.\*`
tagNames	标签名称列表	查询： `~sample.cpu.\*`
tagValues	标签值列表	查询： `~sample.cpu.\` 标签：* `env`

警告 多值 和 包含所有选项 当前不受 Wavefront 插件支持。

创建变量后，可以使用变量语法在 Wavefront 查询中使用它。有关变量的更多信息，请参阅模板和变量。

导入 Wavefront 的仪表盘

按照这些说明导入仪表盘。导入的仪表盘可以在配置 > 数据源 > 选择您的 Wavefront 数据源 > 选择仪表盘选项卡中找到，以查看可用的预制仪表盘。

充分利用插件

添加注释。
配置和使用模板和变量。
添加转换。
设置警报；请参阅警报概述。

使用显示名称

此插件使用选项面板字段选项卡（在 Grafana v7.0+ 中可用）中的显示名称字段来缩短或更改图例键，具体取决于其名称、标签或值。其他数据源使用自定义 别名 功能来修改图例键，但显示名称函数是更一致的方法。显示名称字段选项的文档在 Grafana 文档中。

使用 Ad-Hoc 过滤器

要使用 Ad-Hoc 过滤器，我们必须创建两个模板变量。第一个是用于选择指标的辅助变量，以便可以为该指标名称填充 Ad-Hoc 过滤器。另一个将是实际的 Ad-Hoc 过滤器变量。

注意所需的辅助变量必须命名为 metriclink。这可以是包含您要使用的指标列表的自定义变量，也可以是使用模板变量查询结构的基于查询的变量。如果您只想使用单个指标中的值来填充 Ad-Hoc 过滤器字段，可以隐藏 metriclink 模板变量。

创建 metriclink 变量后，您现在可以按照添加查询模板变量中详细介绍的相同步骤添加 Ad-Hoc 过滤器。不同之处在于您将选择 Ad Hoc 过滤器 作为 类型，并且不需要任何查询输入。

如果您正确地执行了这些步骤，您的仪表盘应该如下所示：

反馈

相关来源

反馈

使用 Wavefront 和 Grafana 最大化您的技术堆栈

要求

已知限制

安装 Wavefront 数据源插件