本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
连接到 Wavefront 数据源(Wavefront 的 VMware Tanzu 可观察性)
Wavefront(Wavefront 的 VMware Tanzu 可观察性)数据源使亚马逊托管的 Grafana 用户能够查询和可视化他们直接从 Wavefront 收集的数据,并轻松将其与任何其他指标、日志、跟踪或其他数据源一起可视化。这种灵活的单窗格视图可以更轻松地跟踪系统运行状况和调试问题。
注意
此数据源仅适用于 Grafana Enterprise。有关更多信息,请参阅 管理对企业插件的访问权限。
此外,在支持版本 9 或更高版本的工作空间中,此数据源可能需要您安装相应的插件。有关更多信息,请参阅 使用插件扩展您的工作空间。
什么是 Wavefront?
Wavefron
使用 Wavefront 和 Grafana 最大限度地利用你的技术堆栈
虽然从表面上看,Grafana和Wavefront听起来很相似,但许多组织都使用Wavefront和Grafana作为其可观测性工作流程的关键部分。
无需移动数据源即可实现可视化:Grafana 的独特架构可直接查询数据所在的位置,而不是将其移动并支付冗余存储和摄取费用。
来自不同来源的面板使用预先构建和自定义的仪表板,将来自许多不同数据源的数据汇总到一个窗格中。
在用户层面进行转换和计算:用户可以转换数据并对他们看到的数据进行各种计算,从而减少了数据准备工作。
在面板中合并、计算和可视化:创建混合数据源面板,显示来自 Waveferont 和其他来源(例如 Prometheus 和 InfluxDB)的相关数据。
文档
功能
-
时间序列可视化
-
表格可视化
-
热图可视化
-
单一统计数据可视化
-
引导式查询编辑器
-
原始 WQL 查询编辑器
-
事件数据的注释
-
模板变量
-
临时过滤器
-
提示
配置
配置 Wavefront 数据源相对简单。完成配置只需要两个字段:API
URL
和Token
。
-
API URL
将是您用于访问波前环境的 URL。示例:https://myenvironment.wavefront.com
。 -
Token
必须由用户帐户或服务帐号生成。-
要创建基于用户帐户的令牌,请登录您的 Wavefront 环境,选择页面右上角的齿轮,选择您的用户名(例如
me@grafana.com
),选择用户页面顶部的 “API 访问权限” 选项卡,然后复制现有密钥或选择 “生成”。 -
要创建基于服务帐号的令牌,请登录您的 Wavefront 环境,选择页面右上角的齿轮,选择账户管理。在左侧导航栏中,选择 “帐户”、“群组和角色”,选择顶部的 “服务帐户” 选项卡,然后选择 “创建新帐户”。输入服务帐号的名称。这可以是你想要的任何东西。复制 “代币” 部分下提供的代币。
-
最后一步是确保选中 “权限” 下的 “帐户、群组和角色” 复选框。
-
获得令牌后,将其添加到Token
配置字段中,您就应该设置好了!
最终完成的配置页面应如下所示:
使用量
使用 查询编辑器
Wavefront 查询编辑器有两种模式:查询生成器和原始查询。要在它们之间切换,请使用查询表单右上角的选择器:
在 Query Builder 模式下,您将有四个选项可供选择:
-
您要查询什么指标?
-
您想对该指标进行什么聚合?
-
您想如何筛选该指标查询的结果?
-
是否要对结果应用任何其他函数?
指标选择器是一个分类层次结构。选择一个类别,然后再次选择以深入了解子类别。重复此过程,直到达到所需的指标。
选择指标后,将自动为您填充可用的筛选条件和筛选器值。
在 Raw Query 模式下,您将看到一个标有 Query 的字段。这允许您运行所需的任何 WQL 查询。
使用筛选条件
Wavefront 插件将动态查询每个指标的相应过滤器。
要添加过滤器,请选择 Wavefront 查询编辑器上过滤器标签旁边的 +,选择要筛选的字段,然后选择要筛选的值。
使用函数
函数提供了另一种聚合、操作和计算指标响应数据的方式。要查看可用函数,请选择查询生成器上函数标签旁边的下拉列表。根据您选择的功能,您将能够执行进一步的操作,例如按字段设置分组或应用阈值。用户可以将多个函数链接在一起以执行高级计算或数据操作。
添加查询模板变量
-
要为仪表板创建新的 Wavefront 模板变量,请选择仪表板右上角的设置齿轮。
-
在左侧面板中,选择 “变量”。
-
在 “变量” 页面的右上角,选择 “新建”。
-
为要创建的模板变量输入名称和标签。名称是你将在查询中用来引用模板变量的值。Label 是一个人性化的名称,用于在仪表板选择面板上显示模板变量。
-
为类型字段选择 “查询” 类型(默认情况下应将其选中)。
-
在 “查询选项” 标题下,在 “数据源” 下拉列表中选择 Wavefron t。
-
如果要筛选出查询中的任何返回值,请在 Regex 输入字段中输入正则表达式。
-
通过在 “排序” 下拉列表中选择排序类型,应用您可能拥有的任何排序首选项。
-
验证配置后,选择添加以添加模板变量,然后在左侧导航面板上选择保存仪表板以保存更改。
模板变量查询结构
指标列表:指标:ts (...)
来源列表:来源:ts (...)
源标签列表:sourceTags:ts (...)
匹配的源标签列表: matchingSourceTags: ts (...)
标签名称列表:标签名称:ts (...)
标签值列表:tagValues (<tag>):ts (...)
备注
-
每种查询类型末尾的 s 是可选的
-
Support 支持所有小写字母。你可以使用标签名或标签名,但不能使用标签名。
-
在:周围使用空格是可选的
警告
Multi-value
并且Include All option
目前不受 Wavefront 插件的支持。
使用模板变量
完成添加新模板变量的步骤后,您现在可以在仪表板面板中使用模板变量来创建动态可视化效果了。
-
使用仪表板右上角的 panel+ 图标添加新的仪表板面板。
-
选择要用于查询的聚合。
-
选择 Fil ter s 标签旁边的 + 图标,然后选择与您的模板变量匹配的密钥类型。
host=
例如,用于主机筛选器。 -
在筛选器的值输入字段中输入您创建的模板变量的名称。
-
保存控制面板。
现在,您应该能够循环浏览模板变量的不同值,并动态更新面板!
使用即席过滤器
要使用临时过滤器,我们必须创建两个模板变量。第一个是辅助变量,用于选择指标,以便可以为该指标名称填充附加过滤器。另一个将是实际的临时过滤器变量。
重要
必须命名所需的辅助变量metriclink
。这可以是包含您要使用的指标列表的自定义变量,也可以是使用模板变量查询结构的基于查询的变量。如果您只想用单个指标的值填充临时筛选器字段,则可以隐藏模板变量。metriclink
创建metriclink
变量后,您现在可以按照添加查询模板变量中详述的相同步骤添加临时筛选器。不同之处在于,您将选择 Ad Hoc Filter s 作为类型,并且查询不需要任何输入。
添加注释
-
要为仪表板创建新的 Wavefront 注释,请选择仪表板右上角的设置齿轮。
-
在左侧面板中,选择 “注释”。
-
在 “批注” 页面的右上角,选择 “新建”。
-
输入注释的名称(该名称将用作仪表板上切换开关的名称)。
-
选择 Wavefront 的数据源。
-
默认情况下,注释最多只能返回 100 个警报事件。要更改该值,请将 “限制” 字段设置为所需的值。
-
选择添加。
使用注释
打开注释后,您现在应该会看到与给定时间段相关的警报事件和问题。
如果您停留在可视化中带注释的部分的底部,则会显示一个弹出窗口,其中显示警报名称并提供指向 Wavefront 中警报的直接链接。
使用 “显示名称” 字段
此数据源使用 “选项” 面板的 “字段” 选项卡中的 “显示名称” 字段,根据图例键的名称、标签或值缩短或更改图例键。其他数据源使用自定义alias
功能来修改图例键,但是 Display Name 函数是更一致的方式。