菜单
文档breadcrumb arrow Grafana 文档breadcrumb arrow 仪表盘breadcrumb arrow 构建仪表盘breadcrumb arrow 创建动态仪表盘
Grafana Cloud Enterprise 开源

创建和编辑动态仪表盘

注意

动态仪表盘是一个实验性功能。工程和随叫随到支持不可用。文档有限，或者仅在代码注释中提供。不提供 SLA。请在 Grafana 中启用 dashboardNewLayouts 功能开关以使用此功能。请联系 Grafana 支持以在 Grafana Cloud 中启用此功能。

仪表盘和面板允许您以可视化形式显示数据。每个面板至少需要一个查询来显示一个可视化。

开始之前

  • 确保您具有适当的权限。有关权限的更多信息，请参阅关于用户和权限。
  • 确定您要添加面板的仪表盘。
  • 了解目标数据源的查询语言。
  • 确保您正在为其编写查询的数据源已经添加。有关添加数据源的更多信息，如果您需要说明，请参阅添加数据源。

创建仪表盘

要创建仪表盘，请按照以下步骤操作

  1. 在主菜单中点击 Dashboards。

  2. 点击 New 并选择 New Dashboard。

  3. 在编辑窗格中，输入仪表盘标题和描述。

    New dashboard

  4. 在 Panel layout 下，选择以下选项之一

    • Custom - 手动定位和调整面板大小。默认选择。
    • Auto grid - 面板会根据列和行设置自动调整大小，以创建统一的网格。

  5. 点击 + Add visualization。

  6. 在打开的对话框中，执行以下操作之一

    • 选择您现有的数据源之一。
    • 选择 Grafana 内置的特殊数据源之一。
    • 点击 Configure a new data source 设置一个新的数据源（仅管理员）。
    Select data source modal

    Edit panel 视图打开，并已选择您的数据源。如果需要，您稍后可以使用面板编辑器的 Query 选项卡中的下拉菜单更改面板数据源。

    有关数据源的更多信息，请参阅数据源获取具体指南。

  7. 使用您的数据源的查询语言编写或构建查询。

  8. 点击 Refresh 查询数据源。

  9. 在可视化列表中，选择一个可视化类型。

    Visualization selector

    Grafana 会显示应用了可视化后的查询结果预览。

    有关配置单个可视化的更多信息，请参阅可视化选项。

  10. 在 Panel options 下，输入面板的标题和描述，或让 Grafana 使用生成式 AI 功能创建它们。

  11. 请参阅以下文档，了解如何调整面板设置。

    虽然不是必需的，但大多数可视化在正确显示您需要的信息之前需要进行一些调整。

  12. 完成面板编辑后，点击 Save。

    或者，如果您想先查看更改应用到仪表盘的效果，请点击 Back to dashboard。准备好后，再点击 Save。

  13. 如果尚未输入，请为您的仪表盘输入标题和描述，或让 Grafana 使用生成式 AI 功能创建它们。

  14. 如果适用，选择一个文件夹。

  15. (可选) 输入您所做更改的描述。

  16. 点击 Save。

  17. 要向仪表盘添加更多面板，请点击 Back to dashboard，然后在仪表盘左下角点击 + Add panel。

    Add panel button

  18. (可选) 在编辑窗格中，为面板输入标题和描述，并设置面板透明度和重复选项（如果适用）。

  19. 点击编辑窗格中或面板上的 Configure 进入配置流程。

  20. 完成对仪表盘的所有更改并保存后，点击 Back to dashboard。

  21. 关闭编辑模式开关。

分组面板

为了帮助在仪表盘中创建有意义的分区，您可以将面板分组到行或标签页中。行和标签页允许您拆分大型仪表盘或将多个较小的仪表盘组合成一个。您可以在彼此或自身内部嵌套标签页和行。此外，标签页会包含在仪表盘 URL 中。

以下章节描述了添加标签页和行的配置选项。虽然分组适用于多个面板，但您也可以从一个面板开始分组。

  1. 在主菜单中点击 Dashboards。

  2. 导航到您要更新的仪表盘。

  3. 打开编辑模式开关。

  4. 在仪表盘左下角，点击 Group panels。

  5. 选择 Group into row 或 Group into tab。

    面板周围会出现虚线框，并且 Row 或 Tab 编辑窗格会显示在仪表盘右侧。

  6. 设置分组配置选项。

  7. 完成后，点击仪表盘右上角的 Save。

  8. (可选) 输入您所做更改的描述。

  9. 点击 Save。

分组配置选项

下表描述了您可以为行设置的选项。

选项描述
标题行或标签页的标题。
填充屏幕打开开关使行填充屏幕。仅适用于行。
隐藏行头部打开开关隐藏头部。在编辑模式下，行头部可见，但旁边带有隐藏图标并被划掉。仅适用于行。
分组布局选择分组选项，可在 Rows 和 Tabs 之间切换。仅当存在嵌套分组时可用，并适用于嵌套分组。
面板布局选择面板是 手动 调整大小和位置 (Custom)，还是 自动 调整 (Auto grid)。仅当分组包含面板时可用。
重复选项 > 按变量重复配置仪表盘根据变量的值动态添加行或标签页。
显示/隐藏规则 > 行/标签页可见性控制行或标签页是否根据变量或时间范围显示。

配置重复选项

您可以将 Grafana 配置为根据变量的值动态地向仪表盘添加面板、行或标签页。变量会动态改变仪表盘所有行中的查询。

这仅适用于包含多值变量的查询。

要配置重复，请按照以下步骤操作

  1. 在主菜单中点击 Dashboards。

  2. 导航到您要更新的仪表盘。

  3. 打开编辑模式开关。

    Dashboard 编辑窗格在仪表盘右侧打开。

  4. 点击您要操作的面板、行或标签页，使其获得焦点，并在编辑窗格中显示相关选项。

  5. 展开 Repeat options 部分。

  6. 选择 Repeat by variable。

  7. 仅对于面板，设置以下选项

    • 在 Repeat direction 下，选择以下选项之一

      • Horizontal - 水平排列面板。Grafana 会调整重复面板的宽度。在同一行中不能将其他面板与重复面板混用。
      • Vertical - 垂直排列面板。重复面板的宽度与原始的重复面板相同。

    • 如果您选择了 Horizontal，请在 Max per row 下拉列表中选择一个值，以控制一行中可以有的最大面板数量。

  8. (可选) 为了向仪表盘用户提供上下文，将变量名称添加到面板、行或标签页标题中。

  9. 完成重复选项设置后，点击 Save。

  10. (可选) 输入您所做更改的描述。

  11. 点击 Save。

  12. 关闭编辑模式开关。

重复行和仪表盘特殊数据源

如果一行包含使用特殊仪表盘数据源的面板——该数据源使用同一仪表盘中另一个面板的结果集——那么重复行中对应的面板将引用原始行中的面板，而不是重复行中的面板。

例如，在一个仪表盘中

  • Row 1 包含 Panel 1A 和 Panel 1B
  • Panel 1B 通过 -- Dashboard -- 数据源使用 Panel 1A 的结果
  • 重复行 Row 2 包含 Panel 2A 和 Panel 2B
  • Panel 2B 引用 Panel 1A，而不是 Panel 2A

配置显示/隐藏规则

您可以配置面板、行和标签页根据规则显示或隐藏。例如，您可能希望在查询没有返回数据时隐藏某个面板，或者仅当某个变量存在时显示某个标签页。

注意

只有当仪表盘使用 Auto grid 面板布局时，才能为面板配置显示/隐藏规则。

要配置显示/隐藏规则，请按照以下步骤操作

  1. 在主菜单中点击 Dashboards。

  2. 导航到您要更新的仪表盘。

  3. 打开编辑模式开关。

    Dashboard 编辑窗格在仪表盘右侧打开。

  4. 点击您要操作的面板、行或标签页，使其获得焦点，并在编辑窗格中显示相关选项。

  5. 展开 Show / hide rules 部分。

  6. 选择 Show 或 Hide 来设置面板、行或标签页是根据规则结果显示还是隐藏。

  7. 点击 + Add rule。

  8. 选择规则类型

    • Query result - 根据查询结果显示或隐藏面板。可选择 Has data (有数据) 和 No data (无数据)。仅适用于面板。
    • Template variable - 根据变量值动态显示或隐藏面板、行或标签页。选择一个变量和运算符，并输入一个值。
    • Time range less than - 如果仪表盘时间范围短于所选时间范围，则显示或隐藏面板、行或标签页。选择或输入一个时间范围。

  9. 配置规则。

  10. 在 Match rules 下，选择以下选项之一

    • Match all - 只有当 所有 规则都匹配时，面板、行或标签页才会显示或隐藏。
    • Match any - 如果 任何 规则匹配，面板、行或标签页就会显示或隐藏。

    此选项仅在添加多个规则时显示。

  11. 完成规则设置后，点击 Save。

  12. (可选) 输入您所做更改的描述。

  13. 点击 Save。

  14. 关闭编辑模式开关。

编辑仪表盘

当仪表盘处于编辑模式时，打开的编辑窗格会显示与获得焦点的仪表盘部分相关的选项。例如，如果您点击面板、行或标签页区域，该区域会获得焦点，并且编辑窗格会显示该区域的选项。

Dashboard with a panel in focus
  • 对于行和标签页，所有可用选项都在编辑窗格中。
  • 对于面板，高级选项在编辑窗格中，而进一步的配置选项在 Edit panel 视图中。
  • 对于仪表盘，高级选项在编辑窗格中，而进一步的配置选项在 Settings 页面中。

要编辑仪表盘，请按照以下步骤操作

  1. 在主菜单中点击 Dashboards。

  2. 导航到您要更新的仪表盘。

  3. 打开编辑模式开关。

    Dashboard 编辑窗格在仪表盘右侧打开。

  4. 点击您要操作的区域，使其获得焦点，并在编辑窗格中显示相关选项。

  5. 执行以下操作之一

    • 对于行或标签页，使用编辑窗格进行必要的更改。
    • 对于面板，在编辑窗格中更新面板标题、描述、重复选项或显示/隐藏规则。进行更多更改，请点击 Configure 并在 Edit panel 视图中继续。
    • 对于仪表盘，更新仪表盘标题、描述、分组或面板布局。进行更多更改，请点击右上角的设置（齿轮）图标。

  6. 完成更改后，点击 Save。

  7. (可选) 输入您所做更改的描述。

  8. 点击 Save。

  9. 关闭编辑模式开关。

移动或调整面板大小

当您的仪表盘使用 Custom 布局时，您可以调整面板大小或将其移动到仪表盘上的任意位置。

要移动或调整大小，请按照以下步骤操作

  1. 在主菜单中点击 Dashboards。

  2. 导航到您要更新的仪表盘。

  3. 打开编辑模式开关。

  4. 执行以下操作之一

    • 点击面板标题，并将面板拖动到新位置。
    • 点击并拖动面板的右下角来改变面板的大小。

  5. 点击 Save。

  6. (可选) 输入您所做更改的描述。

  7. 点击 Save。

  8. 关闭编辑模式开关。

仪表盘 Outline 提供了一个树状结构，显示仪表盘的所有部分及其相互关系，包括面板、行、标签页和变量。大纲还允许您快速导航仪表盘，这样您就不必花费时间寻找特定的元素进行操作。默认情况下，除了当前获得焦点的部分外，大纲是折叠的。

Dashboard with outline open showing panel in focus

要使用大纲导航仪表盘，请按照以下步骤操作

  1. 在主菜单中点击 Dashboards。

  2. 导航到您要更新的仪表盘。

  3. 打开编辑模式开关。

    Dashboard 编辑窗格在仪表盘右侧打开。

  4. 在编辑窗格中，展开 Outline 部分。

  5. 展开大纲，找到您要导航到的仪表盘部分。

  6. 点击树状项目以导航到仪表盘的该部分。

复制仪表盘

要复制仪表盘，请按照以下步骤操作

  1. 在主菜单中点击 Dashboards。

  2. 导航到您要更新的仪表盘。

  3. 打开编辑模式开关。

  4. 点击 Save 下拉菜单并选择 Save as copy。

  5. (可选) 指定复制仪表盘的名称、文件夹、描述，以及是否复制原始仪表盘的标签。

    默认情况下，复制的仪表盘名称与原始仪表盘相同，并在其后附加“Copy”字样，且位于同一文件夹中。

  6. 点击 Save。