Grafana 的 Wavefront 数据源
Grafana Wavefront 数据源插件允许 Grafana 用户直接从 Wavefront 查询和可视化他们收集的数据,并轻松地将其与其他任何指标、日志、追踪或其他数据源一起可视化。这种灵活的单窗格视图使得跟踪系统健康状况和调试问题更加容易。
通过 Wavefront 和 Grafana 最大化您的技术栈
虽然从表面上看,Grafana 和 Wavefront 可能听起来类似,但许多组织都将 Wavefront 和 Grafana 作为其可观测性工作流程的关键部分来使用。
无需移动数据源即可可视化: Grafana 独特的架构直接查询数据所在的位置,而无需移动数据并支付冗余存储和摄入费用。
组合来自不同源的面板 借助预构建和自定义仪表盘,将来自许多不同数据源的数据汇集到同一个视图中。
在用户级别进行转换和计算: 用户可以转换数据并对其看到的数据运行各种计算,从而减少数据准备工作。
在面板内组合、计算和可视化: 创建混合数据源面板,显示来自 Wavefront 和其他源(如 Prometheus 和 InfluxDB)的相关数据。
要求
此插件有以下要求
- 可以生成 API 密钥的 Wavefront 用户
- 以下帐户类型之一
- 适用于拥有 Grafana Cloud 免费、高级或试用帐户或已激活 Grafana Enterprise 许可证的用户。
已知限制
Wavefront 插件目前不支持带有 Multi-value
和 Include All option
的模板变量。
安装 Wavefront 数据源插件
要安装数据源,请参阅安装
配置 Wavefront
您需要 Wavefront API 令牌才能使用此插件。该令牌可以从用户帐户或服务帐户生成。
从用户帐户
- 登录您的 Wavefront 环境。
- 点击页面右上角的齿轮图标,然后选择您的用户名(例如
me@grafana.com
)。 - 选择用户页面顶部的
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 秒 |
通过 provisioning 配置数据源
可以使用配置文件通过 Grafana 的 provisioning 系统配置数据源。您可以在provisioning 文档页面上阅读更多关于其工作原理以及您可以为数据源设置的所有设置的信息
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 查询编辑器有两种模式:Query Builder
和 Raw Query
。要在这两种模式之间切换,请使用查询表单右上角的选择器。
查询构建器
- 指标
- 指标选择器是一个分类层级结构。选择一个类别,然后再次点击以深入查看子类别。重复此过程直到找到所需的指标。
- 选择指标后,可用的过滤器和过滤器值将自动为您填充。
- 聚合
- 选择要在此指标查询上执行的聚合方法。
- 过滤器
- 过滤此指标查询的结果。
- Wavefront 插件将动态查询每个指标的相应过滤器。
- 点击
+
按钮添加过滤器。点击垃圾桶按钮删除过滤器。 - 创建过滤器后,从相应的下拉列表中选择一个键和值。
- 如果应用了多个过滤器,您可以通过点击连接词并从下拉列表中选择来更改连接词。
- 函数
- 函数提供了另一种方式来聚合、操作和计算指标响应数据。要查看可用函数,请点击
Query Builder
上函数标签旁边的下拉列表。 - 根据您选择的函数,您可以执行更多操作,例如设置 group by 字段或应用阈值。多个函数可以串联起来执行高级计算或数据操作。
原始查询
在 Raw Query
模式下,您将看到一个标签为 Query
的字段。这允许您运行任何您想要的 WQL 查询。
活动
列出仪表盘时间范围内的所有事件。最多可获取 100 个事件。
模板和变量
要添加新的 Wavefront 查询变量,请参阅添加查询变量。使用您的 Wavefront 数据源作为数据源进行以下可用查询
查询类型 | 描述 | 示例 |
---|---|---|
metrics | 指标列表 | 查询: ~sample.cpu.\* |
sources | 源列表 | 查询: ~sample.cpu.\* |
sourceTags | 源标签列表 | 查询: ~sample.cpu.\* |
matchingSourceTags | 匹配的源标签列表 | 查询: ~sample.cpu.\* |
tagNames | 标签名称列表 | 查询: ~sample.cpu.\* |
tagValues | 标签值列表 | 查询: ~sample.cpu.\* 标签: env |
警告: Wavefront 插件目前不支持带有 Multi-value
和 Include All option
的模板变量。
创建变量后,您可以使用变量语法在 Wavefront 查询中使用它。有关变量的更多信息,请参阅模板和变量。
导入 Wavefront 仪表盘
按照这些说明导入仪表盘。导入的仪表盘可以在 Configuration > Data Sources > 选择您的 Wavefront 数据源 > 选择 Dashboards 选项卡中找到,以查看可用的预制仪表盘。
充分利用插件
使用显示名称
此插件使用“选项”面板(Grafana v7.0+ 可用)“字段”选项卡中的“显示名称”字段,根据其名称、标签或值来缩短或修改图例键。其他数据源使用自定义的 alias
功能来修改图例键,但“显示名称”功能是更一致的方式。有关“显示名称”字段选项的文档可在Grafana 文档中找到。
使用即席过滤器
要使用即席过滤器,我们必须创建两个模板变量。第一个是辅助变量,用于选择一个指标,以便为该指标名称填充即席过滤器。另一个将是实际的即席过滤器变量。
注意: 所需的辅助变量必须命名为 metriclink
。这可以是一个包含您想要使用的指标列表的自定义变量,或者是一个使用模板变量查询结构的基于查询的变量。如果您只想用单个指标的值填充即席过滤器字段,可以隐藏 metriclink
模板变量。
创建 metriclink
变量后,您可以按照添加查询模板变量中详述的相同步骤添加即席过滤器。区别在于您将选择 Ad Hoc Filters
作为 Type
,并且查询不需要输入。
如果按照步骤正确操作,您的仪表盘应如下所示: