菜单
文档breadcrumb arrow Grafana 文档breadcrumb arrow 仪表盘breadcrumb arrow 使用仪表盘
Grafana Cloud Enterprise 开源

使用仪表盘

注意：正在寻找预构建的 Grafana 仪表盘？请查看我们的完整仪表盘库及更多内容 →

本主题概述了仪表盘功能和快捷键，并介绍了如何使用仪表盘搜索。

仪表盘功能概览

仪表盘用户界面提供了许多功能，可用于自定义数据的展示方式。

下图和描述重点介绍了所有仪表盘功能。

An annotated image of a dashboard

  1. 仪表盘文件夹 - 点击仪表盘文件夹名称时，您可以搜索文件夹中包含的其他仪表盘并执行其他文件夹管理任务。
  2. 仪表盘标题 - 您可以创建自己的仪表盘标题，或使用生成式 AI 功能让 Grafana 为您创建。
  3. 信息亭模式 - 点击可在电视或信息亭等大屏幕上显示仪表盘。信息亭模式会隐藏主菜单、导航栏和仪表盘控件。在我们的《如何在电视上创建信息亭以显示仪表盘》博客文章中了解有关信息亭模式的更多信息。按 Esc 键退出信息亭模式。
  4. 标记为收藏 - 将仪表盘标记为您收藏的仪表盘之一，以便将其包含在主菜单的已加星标仪表盘列表中。
  5. 公共标签 - 当您外部共享仪表盘时，它会被标记为公共标签。
  6. 仪表盘洞察 - 点击查看关于您的仪表盘的分析信息，包括用户、活动、查询计数等信息。了解更多关于仪表盘分析的信息。
  7. 编辑 - 点击退出只读模式并进入编辑模式，在此模式下您可以直接更改仪表盘并访问仪表盘设置，以及多个面板编辑功能。
  8. 导出 - 访问仪表盘导出选项。
  9. 共享仪表盘 - 访问多种仪表盘共享选项。
  10. 变量 - 使用变量（包括临时过滤器）创建更具交互性和动态性的仪表盘。
  11. 仪表盘链接 - 链接到其他仪表盘、面板和外部网站。了解更多关于仪表盘链接的信息。
  12. 当前仪表盘时间范围和时间选择器 - 点击选择相对时间范围选项并设置自定义绝对时间范围。
    • 您可以通过点击“更改时间设置”按钮，在时间范围控件中更改时区和会计年度设置。
    • 时间设置以仪表盘为单位保存。
  13. 时间范围缩小 - 点击可缩小时间范围。了解更多关于如何使用常用时间范围控件的信息。
  14. 刷新仪表盘 - 点击可立即触发查询并刷新仪表盘数据。触发刷新时，Grafana 会取消所有待处理的请求。
  15. 自动刷新控件 - 点击选择仪表盘自动刷新时间间隔。
  16. 仪表盘行 - 仪表盘行是仪表盘中的一个逻辑分隔符，用于将面板分组。
    • 行可以折叠或展开，以便您隐藏仪表盘的部分内容。
    • 折叠行内的面板不会发出查询。
    • 使用重复行根据模板变量动态创建行。
  17. 仪表盘面板 - 面板是仪表盘的主要组成部分。
  18. 面板图例 - 直接从图例更改系列颜色以及 Y 轴和系列可见性。

键盘快捷键

Grafana 提供了许多可用的键盘快捷键。按下键盘上的 ? 可显示您当前版本 Grafana 中的所有键盘快捷键。

  • Ctrl+S: 保存当前仪表盘。
  • f: 打开仪表盘查找器/搜索。
  • d+k: 切换信息亭模式（隐藏菜单）。
  • d+e: 展开所有行。
  • d+s: 仪表盘设置。
  • Ctrl+K: 打开命令面板。
  • Esc: 在全屏视图或编辑模式下退出面板。也用于从仪表盘设置返回仪表盘。

聚焦面板

将鼠标悬停在面板上，您可以使用一些针对该面板的快捷键。

  • e: 切换面板编辑视图
  • v: 切换面板全屏视图
  • pu: 打开共享面板链接配置
  • pe: 打开共享面板嵌入配置
  • ps: 打开共享面板快照配置
  • pd: 复制面板
  • pr: 移除面板

设置仪表盘时间范围

Grafana 提供了多种方式来管理用于可视化、仪表盘、面板以及告警的数据时间范围。

本节介绍了支持的时间单位和相对范围、常用时间控件、仪表盘范围的时间设置以及面板特定的时间设置。

时间单位和相对范围

Grafana 支持以下时间单位：s（秒）、m（分钟）、h（小时）、d（天）、w（周）、M（月）、Q（季度）和 y（年）。

减号运算符允许您相对于当前日期和时间（即 now）回溯时间。如果要显示该单位的完整周期（天、周、月等），请在末尾附加 /。要查看会计期间，请使用 fQ（会计季度）和 fy（会计年度）时间单位。

加号运算符允许您相对于 now 向前步进时间。例如，您可以使用此功能查看未来的预测数据。

下表提供了一些相对范围示例

相对范围示例从到
过去 5 分钟now-5mnow
当天至今now/dnow
本周now/wnow/w
本周至今now/wnow
本月now/Mnow/M
本月至今now/Mnow
上月now-1M/Mnow-1M/M
今年至今now/Ynow
本年now/Ynow/Y
上个会计年度now-1y/fynow-1y/fy

注意

Grafana 告警目前不支持以下语法

  • now+n 用于未来时间戳。
  • now-1n/n 用于“n 的开始到 n 的结束”，因为这是一个绝对时间戳。

常用时间范围控件

仪表盘和面板的时间控件具有通用的用户界面。

Common time controls

以下部分定义了常用时间范围控件。

当前时间范围

当前时间范围，也称为时间选择器，显示您正在查看的仪表盘或面板中当前显示的时间范围。

将光标悬停在该字段上，可查看该范围内的精确时间戳及其来源（例如本地浏览器）。

Time picker

点击当前时间范围即可更改。您可以使用相对时间范围（例如过去 15 分钟）或绝对时间范围（例如 2020-05-14 00:00:00 to 2020-05-15 23:59:59）来更改当前时间。

Current time range

相对时间范围

从相对时间范围列表中选择相对时间范围。您可以使用顶部的输入字段过滤列表。时间范围的一些示例包括

  • 过去 30 分钟
  • 过去 12 小时
  • 过去 7 天
  • 过去 2 年
  • 昨天
  • 前天
  • 上周的今天
  • 今天至今
  • 本周至今
  • 本月至今

绝对时间范围

您可以通过以下方式设置绝对时间范围

  • 在从和到字段中输入值。您可以输入精确的时间值或相对值（例如 now-24h），然后点击应用时间范围。
  • 点击从或到字段。Grafana 将显示一个日历。点击您想要作为当前时间范围的一天或多天，然后点击应用时间范围。

本节还显示最近使用的绝对范围。

半相对时间范围

注意

Grafana 告警不支持半相对时间范围。

您也可以使用绝对时间范围设置来设置半相对时间范围。当您需要监控某事物随时间的进展，但又想查看从起点开始的整个历史记录时，半相对时间范围仪表盘会非常有用。

通过将开始时间设置为绝对时间戳，并将结束时间设置为相对于当前时间的“now”，可以设置半相对时间范围。例如

开始时间： 2023-05-01 00:00:00

结束时间： now

如果您想跟踪某事物在工作时间内的进展，可以设置一个涵盖当天但从早上 8 点开始的时间范围，如下所示

开始时间： now/d+8h

结束时间： now

这相当于“今天至今”时间范围预设，但通过在周期性开始时间后附加 +8h，使其从早上 8:00 开始，而不是凌晨 12:00。

使用半相对时间范围，随着时间的推移，您的仪表盘将自动逐步缩小，显示更多历史记录和更少细节。同时，随着数据高分辨率降低，整个时间段的历史趋势将变得更加清晰。

复制和粘贴时间范围

您可以将时间范围从仪表盘复制并粘贴到探索功能，反之亦然，或在不同仪表盘之间进行复制粘贴。点击将时间范围复制到剪贴板图标，将当前时间范围复制到剪贴板。然后将时间范围粘贴到探索功能或其他仪表盘中。

您也可以使用键盘快捷键 t+c 和 t+v 分别进行时间范围的复制和粘贴。

缩小 (Cmd+Z 或 Ctrl+Z)

点击缩小图标，可在仪表盘或面板可视化中查看更大的时间范围。

放大（仅适用于图表可视化）

点击并拖动以选择您希望在可视化中查看的时间范围。

刷新仪表盘

点击刷新仪表盘图标可立即运行仪表盘上的所有查询并刷新可视化。触发刷新时，Grafana 会取消所有待处理的请求。

默认情况下，Grafana 不会自动刷新仪表盘。查询根据面板设置按自己的计划运行。但是，如果您希望定期刷新仪表盘，请点击“刷新仪表盘”图标旁边的向下箭头，然后选择刷新间隔。

选择自动间隔将根据查询时间范围和浏览器窗口宽度安排刷新。短时间范围频繁更新，长时间范围不频繁更新。刷新频率无需高于用于绘制任何更新的可用像素。

使用 URL 控制时间范围

您可以通过在仪表盘 URL 中提供以下查询参数来控制仪表盘的时间范围

  • from - 定义时间范围的下限，以毫秒 (ms)、Unix 时间戳 (epoch) 或相对时间指定。
  • to - 定义时间范围的上限，以毫秒 (ms)、Unix 时间戳 (epoch) 或相对时间指定。
  • time 和 time.window - 定义从 time-time.window/2 到 time+time.window/2 的时间范围。这两个参数都应以 ms 为单位指定。例如 ?time=1500000000000&time.window=10000 会生成一个从 1499999995000 到 1500000005000 的 10 秒时间范围。
  • timezone - 定义时区。例如 timezone=Europe/Madrid。

由于这些不是变量，因此它们不需要 var- 前缀。

以下示例显示了过去五分钟时间范围内的仪表盘

https://${your-domain}/path/to/your/dashboard?from=now-5m&to=now

过滤仪表盘数据

在仪表盘设置中添加临时过滤器后，您可以在仪表盘上创建标签/值过滤器对。这些过滤器应用于使用指定数据源的所有指标查询以及仪表盘上的所有面板。

要过滤仪表盘数据，请按照以下步骤操作

  1. 在仪表盘上，点击过滤器字段。

  2. 选择标签、运算符和值。

    要为一个标签添加多个值，请选择多选运算符之一：是其中之一 (=|) 或不是其中之一 (!=|)。这些运算符仅在过滤器数据源支持时才会显示。

  3. 根据需要重复此过程，直到获得所需的所有过滤器。

    Ad hoc filters

编辑或删除过滤器

要编辑或删除过滤器，请按照以下步骤操作

  1. 在仪表盘上，点击您要更改的过滤器任意位置。

  2. 执行以下操作之一

    • 要编辑过滤器的运算符或值，请点击过滤器任意位置并进行更新。

      Editing an ad hoc filter

    • 要更改过滤器标签，您必须删除该过滤器并创建一个新的。

    • 要删除过滤器，点击其旁边的 X。