本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Canvas
本文档主题专为支持 Grafana 版本 12.x 的 Grafana 工作空间而设计。
对于支持 Grafana 10.x 版本的 Grafana 工作区,请参阅使用 Grafana 版本 10。
对于支持 Grafana 9.x 版本的 Grafana 工作区,请参阅使用 Grafana 版本 9。
对于支持 Grafana 8.x 版本的 Grafana 工作区,请参阅使用 Grafana 版本 8。
画布将 Grafana 的强大功能与自定义元素的灵活性相结合。画布是可扩展的表单构建面板,允许在静态和动态布局中显式放置元素。这使您能够以标准 Grafana 面板无法实现的方式设计自定义可视化和叠加数据,所有这些都在 Grafana 的 UI 中完成。如果您使用过流行的 UI 和 Web 设计工具,那么设计画布面板会感觉非常熟悉。
画布面板支持一键式数据链接和操作、动态连接方向、禁用工具提示以及平移和缩放控件。
元素
您可以在画布上添加这些元素。通过添加多种不同类型的元素,您可以以任何其他可视化无法实现的方式自定义可视化。
指标值
指标值元素让您可以轻松选择要在画布上显示的数据。此元素具有独特的编辑模式,可通过上下文菜单编辑选项或双击面板来触发。在编辑模式下,您可以选择要显示的字段数据。
文本
文本元素使您能够轻松地向画布添加文本。该元素还支持编辑模式,可通过双击或上下文菜单中的编辑菜单选项触发。
椭圆
椭圆元素允许您在画布上添加一个基本的椭圆。椭圆元素可以显示文本(固定数据和字段数据),其背景颜色可以根据数据阈值进行更改。
矩形
通过矩形元素,您可以在画布上添加基本的矩形。矩形元素可以显示文本(固定数据和字段数据),其背景颜色可以根据数据阈值进行更改。
图标
通过图标元素,您可以将支持的图标添加到画布。可根据阈值或值映射来设置图标的颜色。
服务器
服务器元素让您可以轻松表示单个服务器、服务器堆栈、数据库或终端。服务器元素支持状态颜色、灯泡颜色和灯泡闪烁率,所有这些都可通过固定值或字段值来配置。
Button
您可以通过按钮元素在画布上添加基本按钮。按钮元素支持触发未经验证的基本 API 调用。API 设置可在按钮元素编辑器中找到。您也可以在 API 编辑器中传递模板变量。
注意
只有在禁用内联编辑时,选择按钮才会触发 API 调用。请参阅画布编辑。
Connections
在构建画布时,您可以将元素连接在一起,以创建更复杂的可视化效果。您可以通过从一个元素的连接锚点拖动到另一个元素的连接锚点,来创建连接。您也可以创建与画布背景的连接。当您将鼠标悬停在元素上并打开内联编辑时,会显示连接锚点。要删除连接,请选择该连接,然后按 Delete 或 Backspace。
您可以根据固定值或字段值设置连接的大小和颜色。为此,请进入面板编辑模式,选择连接,然后在面板编辑器中修改连接的属性。
画布编辑
内联编辑器
您可以在控制面板模式的上下文中内联编辑画布。
平移和缩放
您可以在画布上打开平移和缩放功能。这让您可以创建和浏览更复杂的设计。
注意
Grafana Labs 目前提供平移和缩放预览版。支持有限,并且在正式发布之前可能会发生重大更改。
上下文菜单
通过上下文菜单,您可以快速高效地执行常见任务。支持的功能包括打开和关闭内联编辑器、复制元素、删除元素等。
右键单击面板(或等效操作)或给定画布元素会触发上下文菜单。
右键单击面板时,您可以设置背景图像,轻松地向画布添加元素。
右键单击元素时,您可以编辑、删除和复制该元素,或者修改元素的图层位置。
画布选项
内联编辑
内联编辑开关让您可以锁定或解锁画布面板。关闭后,画布面板将处于锁定状态,将元素冻结在原位并防止意外修改。
数据链接
画布支持数据链接。您可以按照以下步骤为指标值元素创建数据链接,并在使用该字段名称的所有元素中显示。
为元素创建数据链接
-
设置要绑定到字段值的元素。
-
关闭内联编辑开关。
-
为带有名称的字段创建覆盖,然后从列表中选择元素字段名称。
-
选择 + 添加覆盖属性按钮。
-
从列表中选择数据链接 > 数据链接。
-
选择 + 添加链接,为数据链接添加标题和 URL。
-
将鼠标悬停在元素上可显示数据链接工具提示。
-
选择能够打开数据链接的元素。
如果多个元素使用相同的字段名称,而您又想控制哪些元素显示数据链接,可使用 从计算添加字段 转换创建唯一字段名称。您在转换中创建的别名将显示为可与元素一起使用的字段。