菜单
文档面包屑箭头 Grafana 文档面包屑箭头 面板和可视化面包屑箭头 可视化面包屑箭头 表格
Grafana Cloud 企业版 开源

表格

表格是一种高度灵活的可视化，旨在按列和行显示数据。表格可视化可以处理多个数据集，并提供在数据集之间切换的选项。凭借这种多功能性，它是查看多种数据类型的首选可视化，有助于满足您进行数据分析的需求。

Basic table visualization

您可以使用表格可视化显示数据集，例如

  • 常见数据库查询，如日志、追踪、指标
  • 财务报告
  • 客户列表
  • 产品目录

任何您可能想放入电子表格中的信息，通常最好通过表格进行可视化。

表格还提供不同的样式来可视化表格单元格内的数据，例如彩色文本和单元格背景、计量表、迷你图、数据链接、JSON 代码和图像。

注意

表格目前不支持标注和告警。

配置表格可视化

以下视频提供了表格可视化中可设置选项的视觉导览。如果您想查看实际配置，请观看此视频

Give it a try using Grafana Play
使用 Grafana Play 试一试

通过 Grafana Play，您可以探索并了解其工作原理，通过实际示例加速您的开发。此功能可在Grafana 中的表格可视化中查看。

尝试一下

支持的数据格式

表格可视化支持任何具有列行结构的数据。

注意

如果您使用迷你图或 JSON 等单元格类型，数据要求可能会有所不同，具体取决于该类型。有关更多信息，请参阅单元格类型。

示例

此示例显示了一个基本数据集，其中每个表格单元格都有数据

csv 
Column1, Column2, Column3
value1 , value2 , value3
value4 , value5 , value6
value7 , value8 , value9

如果单元格缺失或表格的列行结构不完整，如下例所示，表格可视化将不会显示任何数据

csv 
Column1, Column2, Column3
value1 , value2 , value3
gap1   , gap2
value4 , value5 , value6

如果您需要隐藏列，可以使用数据转换、字段覆盖或通过构建仅返回所需列的查询来完成。

列过滤

您可以使用列过滤暂时更改列数据的显示方式。例如，您可以显示或隐藏特定值。

开启列过滤

要开启列过滤，请按照以下步骤操作

  1. 在 Grafana 中，导航到包含您要过滤列的表格的仪表盘。
  2. 将鼠标悬停在要添加链接的面板的任何部分，以显示右上角的动作菜单。
  3. 点击菜单并选择编辑。
  4. 在面板编辑器窗格中，展开表格选项部分。
  5. 开启列过滤器开关。

每个列标题旁边会出现一个过滤图标（漏斗）。

Column filtering turned on

过滤列值

要过滤列值，请按照以下步骤操作

  1. 点击列标题旁边的过滤图标（漏斗）。

    Grafana 会显示该列的过滤选项。

    Filter column values

  2. 点击要显示的数值旁边的复选框，或点击全选。

  3. 在顶部的搜索字段中输入文本以在显示中显示这些数值，以便您可以选择它们而不是滚动查找它们。

  4. 从多个运算符中选择以显示列值

    • 包含 - 匹配正则表达式模式（默认运算符）。
    • 表达式 - 评估布尔表达式。字符$表示表达式中的列值（例如，“$ >= 10 && $ <= 12”）。
    • 常见的比较运算符：=, !=, <, <=, >, >=。

  5. 点击确定和取消按钮上方的复选框，将所有显示的值添加到或从过滤器中移除。

清除列过滤器

应用了过滤器的列在标题旁边会显示一个蓝色过滤器图标。

Filtered column

要移除过滤器，请点击蓝色过滤器图标，然后点击清除过滤器。

列排序

点击列标题可以将排序顺序从默认切换到降序再到升序。每次点击时，排序顺序会切换到循环中的下一个选项。您可以通过按住Shift键并点击列名来对多个列进行排序。

Sort descending

数据集选择器

如果查询的数据包含多个数据集，表格底部会显示一个下拉列表，您可以从中选择要可视化的数据集。此选项仅在编辑面板时可用。

Table visualization with multiple datasets

配置选项

面板选项

在面板编辑器窗格的面板选项部分，设置面板标题和描述等基本选项，以及面板链接。要了解更多信息，请参阅配置面板选项。

表格选项

选项描述
显示表格头部显示或隐藏从数据源导入的列名。
单元格高度设置单元格的高度。选择小、中或大。
启用分页切换开关来控制一次显示多少行表格数据。开启时，页面大小会自动调整以适应表格高度。此选项不影响查询。
最小列宽定义列宽的下限（以像素为单位）。默认情况下，表格列的最小宽度为 150 像素。对于小屏幕设备，如手机或平板电脑，将值减小到50以允许基于表格的面板在仪表盘中正确渲染。
列宽定义列宽（以像素为单位），而不是允许自动设置宽度。默认情况下，Grafana 会根据表格大小和最小列宽计算列宽。
列对齐设置 Grafana 如何对齐单元格内容。选择：自动（默认）、左对齐、居中或右对齐。
列过滤临时更改列数据的显示方式。例如，显示或隐藏特定值。有关更多信息，请参阅列过滤。

切换显示表格页脚开关来控制页脚的显示。开启时，您可以使用表格页脚显示字段上的计算结果。

激活表格页脚后，请选择以下选项

  • 计算 - 您要应用的计算。
  • 计数行 - 如果您选择了计数计算，则会显示此选项。如果您想显示数据集中的行数而不是所选字段中的值数，请开启计数行开关。
  • 字段 - 您要对其应用计算的字段。如果您未选择字段，Grafana 会将计算应用于所有数值字段。

单元格选项

单元格选项允许您控制数据在表格中的显示方式。选项包括

单元格类型

默认情况下，Grafana 会自动选择显示设置。您可以通过选择以下单元格类型之一来覆盖这些设置，以控制所有字段的默认显示。某些单元格类型提供额外的配置。

如果您只想将单元格类型应用于某些字段而不是所有字段，可以使用单元格选项 > 单元格类型字段覆盖来实现。

单元格类型描述
自动自动显示应用了合理默认值的数值。
迷你图显示渲染为迷你图的值。
彩色文本如果设置了阈值，则字段文本将以相应的阈值颜色显示。
彩色背景如果设置了阈值，则字段背景将以相应的阈值颜色显示。
计量表单元格可以显示为图形计量表，有几种不同的呈现类型，通过计量表显示模式和值显示进行控制。
计量表的最大值和最小值会自动从整个数据集中的最小值和最大值进行配置。如果您不想从整个数据集中获取最大值/最小值，可以使用字段覆盖为每列进行配置。数据链接
如果您配置了数据链接，当单元格类型为自动时，单元格文本将变为可点击。如果您将单元格类型更改为数据链接，单元格文本将反映配置的数据链接的标题。要更精细地控制数据链接文本的应用，请使用单元格选项 > 单元格类型 > 数据链接字段覆盖。JSON 视图
显示格式化为代码的值。图像
如果字段值是图像 URL 或 base64 编码的图像，表格会显示该图像。操作
迷你图

单元格显示一个按钮，点击时会触发一个基本的、未经验证的 API 调用。

Table using sparkline cell type

此单元格类型显示渲染为迷你图的值。要在包含多个时间序列的数据上显示迷你图，请使用时间序列到表格转换将其处理为表格可以显示的格式。

彩色文本

您可以使用与时间序列可视化相同的许多选项来自定义迷你图，包括线条样式和宽度、填充不透明度、渐变模式等。您还可以通过更新面板配置标准选项部分中的配色方案来更改迷你图的颜色。

Table with colored text cell type

注意

如果设置了阈值，使用此单元格类型，字段文本将以相应的阈值颜色显示。

彩色背景

这是一个实验性功能。

Table with colored background cell type

  • 如果设置了阈值，使用此单元格类型，字段背景将以相应的阈值颜色显示。
  • 背景显示模式 - 在基本和渐变之间选择。

Table with background cell color applied to row

计量表

应用于整行 - 开启开关，将为单元格配置的背景颜色应用于整行。

注意

使用此单元格类型，单元格可以显示为图形计量表，有几种不同的呈现类型，通过计量表显示模式和值显示进行控制。

计量表的最大值和最小值会自动从整个数据集中的最小值和最大值进行配置。如果您不想从整个数据集中获取最大值/最小值，可以使用字段覆盖为每列进行配置。

计量表显示模式

选项描述
您可以设置三种计量表显示模式。基本
Table cell with basic gauge mode
显示一个简单的计量表，阈值水平定义了计量表的颜色。渐变
Table cell with gradient gauge mode
阈值水平定义了渐变。复古 LCD
Table cell with retro LCD gauge mode
计量表被分成小单元格，可以点亮或熄灭。

值显示

选项描述
显示在计量表旁边的标签可以设置为按值着色、与主题文本颜色匹配或隐藏。值颜色
Table with labels in value color
标签按值着色。文本颜色
Table with labels in theme color
标签与主题文本颜色匹配。隐藏
Table with labels hidden
如果您配置了数据链接，当单元格类型为自动时，单元格文本将变为可点击。如果您将单元格类型更改为数据链接，单元格文本将反映配置的数据链接的标题。要更精细地控制数据链接文本的应用，请使用单元格选项 > 单元格类型 > 数据链接字段覆盖。

标签被隐藏。

JSON view
显示格式化为代码的值。

此单元格类型显示格式化为代码的值。如果值是一个对象，则鼠标悬停时会出现允许浏览 JSON 对象的 JSON 视图。

Table with image cell type

如果您的字段值是图像 URL 或 base64 编码的图像，此单元格类型会将其显示为图像。

  • 设置以下选项
  • 替代文本 - 设置图像的替代文本。该文本将可用于屏幕阅读器以及图像无法加载的情况。
如果字段值是图像 URL 或 base64 编码的图像，表格会显示该图像。

标题文本 - 设置将鼠标悬停在图像上时显示的文本。

选项描述
单元格显示一个按钮，点击时会触发一个基本的、未经验证的 API 调用。使用以下选项配置 API 调用端点
输入端点 URL。方法
选择 GET、POST 和 PUT。Content-Type
在下拉列表中选择一个选项。选择：JSON, Text, JavaScript, HTML, XML, 和 x-www-form-urlencoded。查询参数
根据需要输入任意数量的键、值对。查询参数
Header 参数Payload

输入 API 调用的主体。

注意

文本换行

文本换行处于公共预览阶段，但默认情况下可以使用。我们非常乐意听到您对这项新功能的反馈。要提供反馈，您可以在Grafana GitHub 仓库中提交问题。

切换文本换行开关，对表格中包含最长内容的单元格中的文本进行换行。

要仅对特定列中的文本进行换行，请使用按名称查找字段字段覆盖，选择单元格选项 > 单元格类型覆盖属性，并开启文本换行开关。

此选项适用于以下单元格类型：自动、彩色文本和彩色背景。

单元格值检查

允许从表格单元格检查值。开启单元格值检查开关后，点击单元格中的检查图标会打开检查值抽屉。

检查值抽屉有两个选项卡：纯文本和代码编辑器。Grafana 会尝试自动检测单元格中的数据类型，并打开显示相关选项卡的抽屉。但是，您可以在选项卡之间来回切换。

此选项适用于以下单元格类型：自动、彩色文本、彩色背景和JSON 视图。

如果您只想将此设置应用于某些字段而不是所有字段，可以使用单元格选项 > 单元格值检查字段覆盖来实现。

标准选项

选项描述
面板编辑器窗格中的标准选项允许您更改字段数据在可视化中的显示方式。设置标准选项时，更改会应用于所有字段或序列。要更精细地控制字段的显示，请参阅配置覆盖。单位
选择字段应使用的单位。最小值/最大值
设置百分比阈值计算中使用的最小值和最大值，或将这些字段留空以自动计算。字段最小值/最大值
开启字段最小值/最大值，让 Grafana 根据字段的最小值或最大值单独计算每个字段的最小值或最大值。小数位数
指定 Grafana 在渲染值中包含的小数位数。显示名称
设置所有字段的显示标题。您可以在字段标题中使用变量。配色方案
为整个可视化设置单色或多种颜色。无值

输入当字段值为空或 null 时 Grafana 应显示的内容。默认值为一个连字符 (-)。

数据链接和操作

数据链接允许您链接到其他面板、仪表盘和外部资源，而操作则允许您触发基本的、未经验证的 API 调用。在这两种情况下，您都可以在保持源面板上下文的同时执行这些任务。

  • 对于每个数据链接，设置以下选项
  • 标题
  • URL

在新标签页中打开

此可视化中的数据链接不包含一键点击开关，但是，如果只配置了一个数据链接，则该数据链接具有单次点击功能。如果配置了多个数据链接，则点击可视化会打开一个菜单，显示所有数据链接。

选项描述
对于每个数据链接，设置以下选项在 UI 中显示的操作的人类可读标签。
确认消息确认或取消操作的描述性提示。
输入端点 URL。从 POST、PUT 或 GET 中选择。
标题请求 URL。

要添加变量，请单击 URL 字段并输入 $ 或按 Ctrl+Space 或 Cmd+Space 查看可用变量列表。

在下拉列表中选择一个选项。选择：JSON, Text, JavaScript, HTML, XML, 和 x-www-form-urlencoded。键和值对。单击 + 图标可根据需要添加任意数量的键/值对。
标头由键和值对以及内容类型 (Content-Type) 组成。

单击 + 图标可根据需要添加任意数量的键/值对。

选择 GET、POST 和 PUT。从以下项中选择：application/json、text/plain、application/XML 和 application/x-www-form-urlencoded。
主体请求的主体。

要了解更多信息，请参阅配置数据链接和操作。

值映射

值映射是一种可用于更改数据显示在可视化中的方式的技术。

对于每个值映射，设置以下选项

  • 条件 - 选择映射到显示文本和（可选）颜色的内容
    • 值 - 特定值
    • 范围 - 数字范围
    • Regex - 正则表达式
    • 特殊 - 特殊值，例如 Null、NaN（非数字）或布尔值，例如 true 和 false
  • 显示文本
  • 颜色（可选）
  • 图标（仅限 Canvas）

要了解更多信息，请参阅配置值映射。

阈值

阈值是您为指标设置的值或限制，当达到或超过该值或限制时，它会直观地反映出来。阈值是您可以根据查询结果有条件地设置可视化样式和颜色的方式之一。

对于每个阈值，设置以下选项

选项描述
值为每个阈值设置值。
阈值模式从 绝对值和百分比中选择。

要了解更多信息，请参阅配置阈值。

字段覆盖

覆盖允许您自定义特定字段或系列的视图设置。添加覆盖规则时，它会针对特定的字段集，并允许您为该字段的显示方式定义多个选项。

从以下覆盖选项中选择

选项描述
按名称筛选字段从所有可用字段列表中选择一个字段。
按与正则表达式匹配的名称筛选字段使用正则表达式指定要覆盖的字段。
按类型筛选字段按类型选择字段，例如字符串、数字或时间。
按查询返回筛选字段选择特定查询返回的所有字段，例如 A、B 或 C。
按值筛选字段选择由您定义的 reducer 条件返回的所有字段，例如 最小值、最大值、计数、总和。

要了解更多信息，请参阅配置字段覆盖。