Wavefront 数据源用于 Grafana
Wavefront数据源插件允许Grafana用户直接从Wavefront查询和可视化他们收集的数据,并轻松地将数据与其他任何指标、日志、跟踪或其他数据源一起可视化。这种灵活的单窗口视图使得跟踪系统健康和调试问题更加容易。
利用Wavefront和Grafana最大化您的技术堆栈
虽然从表面上看,Grafana和Wavefront可能听起来很相似,但许多组织将Wavefront和Grafana用作其可观察性工作流程的关键部分。
无需移动数据源即可可视化: Grafana独特的架构直接查询数据所在位置的数据,而不是移动数据,从而避免了冗余存储和摄取的付费。
从不同的数据源组合面板: 使用预构建和自定义仪表板,将来自许多不同数据源的数据汇集到一个统一的视图中。
在用户级别进行转换和计算: 用户可以对看到的数据进行转换和运行各种计算,从而减少数据准备。
在面板内进行组合、计算和可视化: 创建混合数据源面板,显示来自Wavefront和其他来源(如Prometheus和InfluxDB)的相关数据。
要求
此插件有以下要求
- 可以生成API密钥的Wavefront用户
- 以下帐户类型之一
- 适用于拥有Grafana Cloud免费、高级或试用帐户的用户,或拥有已激活的Grafana企业许可证。
已知限制
当前Wavefront插件不支持具有“多值”和“包含所有选项”的模板变量。
安装Wavefront数据源插件
要安装数据源,请参阅安装
配置Wavefront
您将需要您的Wavefront API令牌才能使用此插件。该令牌可以来自用户帐户的API令牌或服务帐户。
从用户帐户
- 登录您的Wavefront环境。
- 点击页面右上角的齿轮,并选择您的用户名(例如
[email protected]
)。 - 在用户页面顶部选择
API访问
选项卡。 - 复制现有密钥或点击
生成
。在Grafana配置数据源时粘贴此令牌。
从服务帐户
- 登录您的Wavefront环境。
- 点击页面右上角的齿轮,并选择帐户管理。
- 在左侧导航中选择
帐户、组、角色
- 在顶部选择
服务帐户
并点击创建新帐户
。 - 为服务帐户输入一个名称。
- 复制在
令牌
部分提供的令牌,以在Grafana配置数据源时粘贴。 - 确保在
权限
下选中了帐户、组、角色
复选框
在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数据源作为以下可用查询的数据源
查询类型 | 描述 | 示例 |
---|---|---|
metrics | 指标列表 | 查询: ~sample.cpu.\* |
sources | 源列表 | 查询: ~sample.cpu.\* |
sourceTags | 源标签列表 | 查询: ~sample.cpu.\* |
matchingSourceTags | 匹配源标签列表 | 查询: ~sample.cpu.\* |
tagNames | 标签名称列表 | 查询: ~sample.cpu.\* |
tagValues | 标签值列表 | 查询: ~sample.cpu.\* 标签: env |
警告: 多值
和包含所有选项
目前不支持Wavefront插件。
创建变量后,您可以使用变量语法在Wavefront查询中使用它。有关变量的更多信息,请参阅模板和变量。
导入Wavefront仪表板
按照这些说明导入仪表板。导入的仪表板可以在配置 > 数据源 > 选择您的Wavefront数据源 > 选择仪表板选项卡中找到可用的预制仪表板。
充分利用插件
使用显示名称
此插件使用选项面板中的字段标签页中的显示名称字段(Grafana v7.0+版本中可用)来根据名称、标签或值缩短或修改图例键。其他数据源使用自定义 别名
功能来修改图例键,但显示名称功能是一种更一致的方式来执行此操作。有关显示名称字段选项的文档在 Grafana 文档 中。
使用临时过滤
要使用临时过滤,我们必须创建两个模板变量。第一个是一个辅助变量,它将用于选择一个度量,以便可以为该度量名称填充临时过滤。另一个将是实际的临时过滤变量。
注意 必须要求的辅助变量名称必须是 metriclink
。这可以是一个包含您想要使用的度量列表的自定义变量,或者是一个基于 模板变量查询结构 的查询变量。如果您只想使用单个度量的值填充临时过滤字段,可以隐藏 metriclink
模板变量。
创建 metriclink
变量后,现在可以按照在 添加查询模板变量 中详细说明的步骤添加临时过滤。区别在于您将选择 临时过滤
作为 类型
,并且查询不需要任何输入。
如果您正确地遵循了这些步骤,您的仪表板应该看起来像这样: