探索 - Amazon Managed Grafana

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

探索

本文档主题专为支持 Grafana 8.x 版本的 Grafana 工作空间而设计。

有关支持 Grafana 版本 10.x 的 Grafana 工作空间,请参阅。在 Grafana 版本 10 中工作

有关支持 Grafana 9.x 版本的 Grafana 工作空间,请参阅。在 Grafana 版本 9 中工作

在 Grafana 工作区中,仪表板用户界面提供了用于构建可视化仪表板的工具。E xplore 会删除所有仪表板和面板选项,这样您就可以专注于查询。迭代直到查询正常运行,然后规划和构建仪表板。

对于基础设施监控和事件响应,您不再需要切换到其他工具来调试出了什么问题。你可以使用 Explore 更深入地挖掘你的指标和日志,找出原因。

Explore 使您无需创建仪表板即可更轻松地查看数据。如果您的数据源支持图表和表格数据,则 “浏览” 会以图表和表格的形式显示结果。这可以帮助您同时查看数据趋势和更多细节。

开始探索

注意

默认情况下,具有 “查看者” 角色的用户无法编辑,也无权访问 “浏览”。

左侧菜单上的 “浏览” 图标会打开一个空的 “浏览” 选项卡。

要从面板中的现有查询开始,请从 “面板” 菜单中选择 “浏览” 选项。这将打开 “浏览” 选项卡,其中包含来自面板的查询。然后,你可以在仪表板之外调整或迭代查询。

从左上角的下拉列表中选择您的数据源。Prometheus 有一个自定义的 Explore 实现。其他数据源使用其标准查询编辑器。

在查询字段中,您可以编写查询并浏览数据。查询字段旁边有三个按钮,一个清除按钮 (X)、一个添加查询按钮 (+) 和删除查询按钮 (-)。与面板查询编辑器一样,您可以添加和删除多个查询。

拆分和比较

拆分视图功能是一种比较图表和表格, side-by-side 或者在一个页面上一起查看相关数据的方法。选择 “拆分” 可复制当前查询,并将页面拆分为两个 side-by-side 查询。您可以选择为新查询选择不同的数据源。这使您有机会比较两个不同服务器的相同查询,或者将暂存环境与生产环境进行比较。

在分屏视图中,通过选择附在时间选择器上的时间同步按钮之一,可以链接两个面板的时间选择器(如果您更改一个,另一个也会更改)。链接时间选择器有助于保持拆分视图查询的开始和结束时间同步,这样你就可以在两个拆分面板中看到相同的时间间隔。

您可以通过选择 “关闭拆分” 来关闭新创建的查询。

使用 “共享缩短链接” 功能创建更小、更简单的格式网址,/goto/:uid而不是共享包含复杂查询参数的较长 URL。您可以通过在 “浏览” 工具栏中选择 “共享” 选项来创建缩短的链接。任何从未使用过的缩短链接都会在 7 天后自动删除。

查询历史

查询历史记录是您在 “浏览” 中使用的查询列表。历史记录在您的浏览器中,不会共享。要打开您的历史记录并与之交互,请在 “浏览” 中选择 “查询历史记录”。

查看查询历史记录

在查询历史记录中,您可以执行以下操作:

  • 运行查询。

  • 创建或编辑评论。

  • 将查询复制到剪贴板。

  • 将包含查询的缩短链接复制到剪贴板。

  • 为查询加注星标。

管理收藏夹查询

所有已在 “查询历史记录” 选项卡中加星标的查询都显示在 “已加星标” 选项卡上。您可以更快地访问自己喜欢的查询并重复使用这些查询,而无需从中重新键入它们。

对查询历史记录进行排序

默认情况下,查询历史记录会显示最新的查询。您可以按日期或数据源名称按升序或降序对历史记录进行排序。

在查询历史记录右侧的下拉列表中,选择以下选项之一:字段。

  • 最新优先

  • 最旧的优先

  • 数据源 A-Z

  • 数据源 Z-A

注意

如果您在分屏视图中,则排序模式仅适用于活动面板。

筛选查询历史记录

在 “查询历史记录” 和 “已加星标” 选项卡上,您可以按数据源名称筛选查询历史记录。

  1. 选择筛选特定数据源的查询

  2. 选择要用于筛选历史记录的数据源。您可以选择多个数据源。

在 “查询历史记录” 选项卡上,您可以使用垂直滑块按日期筛选查询:

  • 拖动下方的手柄以调整开始日期。

  • 拖动上方的手柄以调整结束日期。

注意

如果您在分屏视图中,则过滤器仅应用于活动面板。

在查询历史中搜索

您可以在历史记录中按查询和评论进行搜索。可以在 “查询历史记录” 和 “已加星标” 选项卡中搜索查询。

  1. 选择 “搜索查询” 字段。

  2. 在搜索字段中,输入您的搜索词。

查询历史记录设置

您可以在 “设置” 选项卡中自定义查询历史记录。下表列出了可用选项。

设置 默认值
指定 Grafana 将保存您的查询历史记录多长时间。 1 周
更改默认的活动选项卡。 “查询历史记录” 选项卡
仅显示对当前在 “浏览” 中处于活动状态的数据源的查询。 True
清除查询历史记录。 (选择 “清除查询历史记录” 可永久删除所有存储的查询。)
注意

查询历史记录设置是全局的,它们在拆分模式下应用于两个面板。

普罗米修斯特有的功能

Explore 的第一个版本提供了 Prometheus 的自定义查询体验。当你运行查询时,Grafana 实际上会运行两个查询:对图表的普通 Prometheus 查询和对表的即时查询。即时查询返回每个时间序列的最后一个值,这显示了图表中显示的数据的良好摘要。

指标浏览器

在查询字段的左侧,选择 “指标” 以打开 “指标浏览器”。这将显示一个分层菜单,其中包含按其前缀分组的指标。例如,所有 Alertmanager 指标都分组在前缀下。alertmanager这是探索哪些指标可用的良好起点。

查询字段

“查询” 字段支持自动完成指标名称和函数,其工作方式与标准 Prometheus 查询编辑器基本相同。按 Enter 键运行查询。

Ctrl+ Space 可以访问 “自动完成” 菜单。“自动完成” 菜单包含一个新的 “历史记录” 部分,其中包含最近运行的查询列表。

建议可以显示在 “查询” 字段下。选择一个建议,使用建议的更改更新您的查询。

  • 对于计数器(单调递增的指标),建议使用比率函数。

  • 对于存储桶,建议使用直方图函数。

  • 对于录制规则,可以扩展规则。

表格筛选器

在表格面板的标签列中选择 “筛选器” 按钮,向查询表达式添加筛选器。您也可以为多个查询添加过滤器。将为所有查询添加过滤器。

日志集成

您还可以使用 Explore 来调查包含以下数据源的日志:

  • InfluxDB

  • Elasticsearch

日志可视化

日志查询的结果以直方图的形式显示在图表中,各个日志显示在下面。如果数据源未发送请求的时间范围内的直方图数据,则日志模型将根据按自动计算的时间间隔划分的日志行计数计算时间序列。然后,直方图的开头以结果中第一行日志的时间戳为锚定。时间序列的结尾锚定在时间选择器的 To 范围上。

日志级别

对于指定了级别标签的日志,Grafana 使用标签的值来确定日志级别并相应地更新颜色。如果日志没有指定级别标签,Grafana 会解析日志以确定其内容是否与任何支持的表达式匹配。日志级别始终由第一个匹配项决定。如果 Grafana 无法确定日志级别,则会使用未知的日志级别对其进行可视化。下表列出了日志级别以及日志级别缩写和表达式的映射。

支持的表达式 日志级别 颜色
出现 关键的 紫色
致命 关键的 紫色
警报 关键的 紫色
暴击 关键的 紫色
关键的 关键的 紫色
error red
错误 error red
error error red
警告 warning yellow
warning warning yellow
info info 绿色
信息 info 绿色
注意 info 绿色
dbug 调试 蓝色
调试 调试 蓝色
跟踪 跟踪 浅蓝色
* 未知 灰色

可视化选项

您可以自定义日志的显示方式并选择显示哪些列。

时间

此选项显示或隐藏时间列。这是与数据源报告的日志行关联的时间戳。

独特的标签

此选项显示或隐藏 “唯一标签” 列,该列仅包含非常见标签。上面显示了所有常用标签。

换行

要在显示屏中使用换行,请将其设置为 True。将此选项设置为 False 会导致水平滚动。

删除重复数据

日志数据可能非常重复。Explore 可以通过隐藏重复的日志行来提供帮助。您可以从不同的重复数据删除算法中进行选择:

  • 精确 — 除日期字段外,对整行进行精确匹配。

  • 数字 — 匹配是在去掉持续时间、IP 地址等数字之后在线上完成的。

  • 签名 — 最激进的重复数据删除,它会删除所有字母和数字。对剩余的空格和标点符号进行匹配。

翻转结果顺序

您可以将收到的日志的顺序从默认降序(最新在前)更改为升序(最旧的在前)。

标签和检测到的字段

每个日志行都有一个带有标签和检测到字段的可扩展区域,以实现更强大的交互。对于所有标签,您可以筛选(正滤波器)和过滤掉(负滤波器)所选标签。每个字段或标签还有一个统计图标,用于显示与所有显示的日志相关的一次性统计信息。

切换检测到的字段

如果您的日志采用 JSON 或 logfmt 结构,则可以显示或隐藏检测到的字段。展开日志行,然后选择眼睛图标以显示或隐藏字段。

{{< docs-imagebox img=” /img/docs/explore/parsed-fields-7-2.gif “max-width= “800px” caption= “在 Explore 中切换检测到的字段” >}}

追踪集成

您可以在 Explore 中可视化来自追踪数据源的跟踪。目前支持的数据源:

有关使用查询编辑器的信息,请参阅特定数据源的文档。

标题

标题包括以下项目:

  • 标题标题,显示根跨度的名称和跟踪 ID

  • 搜索,突出显示包含搜索文本的跨度

  • 关于追踪的元数据

迷你地图

Minimap 显示精简视图或跟踪时间轴。将鼠标拖到小地图上方可放大到较小的时间范围。缩放还会更新主时间轴,因此很容易看到较短的跨度。如果你在小地图上停下来,当缩放时,你可以看到 “重置选择” 按钮,它会重置缩放。

时间轴

时间轴显示了轨迹内的跨度列表。每个跨度行由以下组件组成:

  • 展开子项” 按钮:展开或折叠所选跨度的所有子跨度

  • 服务名称:记录跨度的服务的名称

  • 操作名称:此跨度所代表的操作的名称

  • 跨度持续时间栏:轨迹中操作持续时间的直观表示

选择跨度行的任意位置即可显示跨度详细信息。

跨度详情

跨度详细信息包括以下项目:

  • 操作名称

  • 跨度元数据

  • 标签(与该跨度关联的任何标签)

  • 流程元数据(有关记录此跨度的进程的元数据)

  • 日志:按此跨度记录的日志列表和关联的键值。如果是 Zipkin 日志,则会显示 Zipkin 注释。

为了帮助加快涉及定期从 “探索” 切换到仪表板的工作流程,反之亦然,我们增加了从面板下拉列表导航到 “浏览” 后返回原始仪表板的功能。

导航到 “浏览” 后,您应该会注意到 “浏览” 工具栏上有一个 “返回” 按钮。

只需选择该按钮即可返回到 Origin 仪表板,或者,如果您想将在 Explore 中所做的更改带回仪表板,只需选择按钮旁边的箭头即可显示 “使用更改返回面板” 菜单项。

查询检查器

为了帮助调试查询,Explore 允许您通过查询检查器调查查询请求和响应以及查询统计信息。此功能类似于面板检查器的 “统计” 选项卡和 “查询” 选项卡。有关更多信息,请参阅 检查查询性能查看原始请求和对数据源的响应