插件 〉动态图像面板
动态图像面板
Grafana 图像面板
通过 URL、指标和后缀的连接来显示图像。
结果将是:baseURL + icon 字段 + 后缀。
注意
- 版本 4.0.0 需要 Grafana 11.0.0 或更高版本
- 版本 3.0.0 需要 Grafana 10.0.3 或更高版本
- 版本 2.8.0 需要 Grafana 9.0.0 或更高版本
- 版本 2.6.0 需要 Grafana 8.5.0 或更高版本
- 如果新选项没有显示或者插件看起来像是旧版本,请卸载、重新安装,然后重启 Grafana(如果使用 Docker,请使用 GF_INSTALL_PLUGINS 环境变量运行最新版本的插件的新容器)
- 共享工具提示似乎与最新版本的 Grafana 不兼容
- 如果工具提示中的
elapsed
模式和实际日期之间存在差异,如果您正在使用 MySQL 数据库,请阅读此问题,因为它可能解决您的问题。
配置
如果查询选择多个字段,请使用外连接转换。
URL
构建图像 URL 的选项
- 基础 URL(可选):获取图像的 URL 的起始部分。如果
icon field
已经包含基础 URL,则可以留空。此选项支持变量。 - 图标字段:包含图像名称的字段。特殊值
第一个非时间字段
将使用它找到的第一个非时间字段。这是默认值。 - 后缀(可选):要添加到末尾的字符串。此选项支持变量。
- 回退 URL(可选):如果加载“指标”图像出错时显示的图像。
图像选项
允许选择图像如何显示的选项
- 自动调整大小:计算图像的宽度和高度,以便系列适合整个面板。启用此选项将禁用
Image width
和Image height
。 - 图像宽度:图像的宽度。此选项支持变量(请注意,它需要是一个数字)
- 图片高度:图片的高度。此选项支持变量(请注意,它需要是一个数字)
- 单次填充:如果查询有唯一结果,允许填充面板而不是使用上面的宽度和高度
- Alt字段:用作
alt
的字段。特殊值使用图标字段
将使用与图标字段
相同的字段。这是默认值。如果加载图片出现问题且未设置回退或回退本身有问题,将使用Alt字段
。
共享十字准线选项
这些选项允许在鼠标悬停在图像上时设置背景和边框。如果仪表板中启用了共享十字准线
或共享工具提示
,它也用于突出显示图像。
- 背景高亮颜色:作为共享十字准线背景图像使用的颜色(默认为带有透明度的白色)
- 边框高亮颜色:共享十字准线使用的边框颜色。
说明
- 您必须在插件配置中启用工具提示才能使
共享工具提示
实际显示工具提示 共享工具提示
在幻灯片模式下不起作用(尽管共享十字准线
确实起作用),这意味着当鼠标悬停在另一个面板上时,工具提示不会显示- 它与时间相关联,并与
timeseries
和candlestick
面板一起工作。
幻灯片选项
幻灯片选项
- 启用幻灯片:启用幻灯片。
- 持续时间:配置图像显示多长时间(以毫秒为单位)。不能为
0
。 - 过渡:使用哪种过渡动画。
- 过渡持续时间:过渡将持续多长时间(以毫秒为单位)。不能为
0
。 - 鼠标悬停时暂停:启用时,如果鼠标悬停在图像上,幻灯片将暂停。
- 无限循环:启用时,幻灯片在结束时从开始处继续。
图像工具提示选项
添加和自定义工具提示的选项
- 包含工具提示:当鼠标悬停在图像上时显示工具提示。
- 包含字段:在工具提示文本中包含字段值。
- 工具提示字段:选择在工具提示中显示的字段值。特殊值
使用图标字段
将使用与图标字段
相同的字段。这是默认值。 - 包含日期:工具提示将包含日期和时间。
- 作为已过时间:日期将显示为已过时间(即4小时前)。
图像链接选项
它允许在新标签页中打开链接。它像图像URL一样工作:它连接3个元素(基本URL、度量值和后缀)。
- 点击打开:启用链接支持。
- 在新标签页中打开:允许在新的标签页中打开链接。默认为启用。
- 基础 URL(可选):获取图像的 URL 的起始部分。如果
icon field
已经包含基础 URL,则可以留空。此选项支持变量。 - 链接字段:包含值的字段。特殊值
不使用字段
允许不使用任何字段,结果将是所有图像相同的链接。这是默认值。 - 后缀(可选):要添加到末尾的字符串。此选项支持变量。
叠加选项
允许在每个图像的角落添加彩色正方形作为叠加。颜色与值绑定。默认情况下,颜色为浅透明灰色。
绑定行为如下
- 如果声明的所有值都是数字,并且从数据中猜测的值类型也是数字,则它类似于Grafana的阈值。
- 否则,它是一个简单的映射。
注意:当离开输入字段时,值将被排序,空输入将被删除,因此请注意,在选择颜色绑定时不要重新排序。
绑定选项
- 叠加字段:选择用于绑定的数据字段(将删除时间字段)。如果选择
无叠加
,则不会显示叠加。 - 位置:选择叠加的位置。
- 宽度:允许选择覆盖层的宽度(像素或图像大小的百分比)。
- 高度:允许选择覆盖层的高度(像素或图像大小的百分比)。
- 绑定:允许为每个值选择颜色。还可以选择未映射值的颜色。
注意:当离开输入字段时,值将被排序,空输入将被删除,因此请注意,在选择颜色绑定时不要重新排序。
下划线选项
将字段值添加为下划线。如果文本宽度大于图像,则文本将被截断。
- 下划线字段:用作下划线的字段。如果选择“无下划线”,则不会显示下划线。
- 文本大小:文本的大小。
- 文本对齐:水平下划线对齐。默认为
左对齐
。 - 绑定字段:允许使用字段绑定文本颜色。
- 绑定:如果“下划线”的“绑定字段”设置为字段,则此配置将显示。它允许将值映射到颜色。
注意:当离开输入字段时,值将被排序,空输入将被删除,因此请注意,在选择颜色绑定时不要重新排序。
屏幕截图
多个结果
"单色填充"
一个禁用了“单色填充”的结果
覆盖层
下划线
共享十字线支持
共享工具提示支持
安装
请遵循Grafana插件网页上的说明进行安装。
许可证
- 颜色绑定组件是Grafana的ThresholdsEditor的修改版,因此受Apache 2.0许可证的约束。
致谢
插件标志可在此处找到,并受MIT许可证的约束。
Slideshow受Apache 2.0许可证的约束。
GitHub的工作流程来自Grafana,并受Apache 2.0许可证的约束。
插件开发:资源
在Grafana Cloud上安装动态图像面板
在Grafana Cloud实例上安装插件是单点击安装;更新也是如此。酷吧?
请注意,可能需要1分钟才能在您的Grafana中看到插件。
在Grafana Cloud实例上安装插件是单点击安装;更新也是如此。酷吧?
请注意,可能需要1分钟才能在您的Grafana中看到插件。
在Grafana Cloud实例上安装插件是单点击安装;更新也是如此。酷吧?
请注意,可能需要1分钟才能在您的Grafana中看到插件。
在Grafana Cloud实例上安装插件是单点击安装;更新也是如此。酷吧?
请注意,可能需要1分钟才能在您的Grafana中看到插件。
在Grafana Cloud实例上安装插件是单点击安装;更新也是如此。酷吧?
请注意,可能需要1分钟才能在您的Grafana中看到插件。
在Grafana Cloud实例上安装插件是单点击安装;更新也是如此。酷吧?
请注意,可能需要1分钟才能在您的Grafana中看到插件。
在Grafana Cloud实例上安装插件是单点击安装;更新也是如此。酷吧?
请注意,可能需要1分钟才能在您的Grafana中看到插件。
有关更多信息,请访问插件安装文档。
在本地Grafana上安装
对于本地实例,插件通过简单的CLI命令进行安装和更新。插件不会自动更新,但是当更新可用时,您将在Grafana中收到通知。
1. 安装面板
使用grafana-cli工具从命令行安装动态图像面板
grafana-cli plugins install
插件将安装到您的Grafana插件目录中;默认为/var/lib/grafana/plugins。有关cli工具的更多信息,请参阅cli工具信息。
2. 将面板添加到仪表板
已安装的面板在Grafana主菜单的仪表板部分立即可用,可以像添加任何其他核心面板一样添加。
要查看已安装面板的列表,请单击主菜单中的插件项。核心面板和已安装的面板都会显示出来。
更新日志
下一个版本
- 修复许可证链接,使其指向主分支而不是旧主分支
- 将最低Grafana版本升级到9.0.0
2.8.0
- 显示与其它面板相同的
无数据
,而不是警报(感谢@dazzatronic,见#68)。 - 将许可证更改为MIT。
2.7.0
- 添加一个开关以启用/禁用无限幻灯片放映(感谢@dpooley,见#65)。
2.6.0
- 支持“共享十字准线”。图像背景和边框将根据配置的颜色(默认为背景#FFFFFF10和边框#FFFFFF20)进行设置(见#16 和 #51)。
- 支持共享提示信息(见#52)。
- 当幻灯片放映被禁用时,使用Grafana提示信息而不是标题属性(以使共享提示信息正常工作)。
- 悬停在图像上现在将使用“共享十字准线”选项。
- 至少需要Grafana 8.5.0。
- 错误现在在面板中显示,而不是抛出错误,这避免了配置面板时的刷新(见#57)。
- 当添加新的绑定时,它将获得焦点(见#60)。
- 现在可以选择在新标签页中打开链接或不打开(见#62)。
2.5.0
2.4.0
2.3.0
- 在图像之间添加间隔。
- 添加下划线。
- 修复提示信息(见#15)。
- 当启用单色填充时,修复图像大小。
- 允许使用变量为
基础URL
、后缀
、图像宽度
和图像高度
赋值(见#14)。 - 现在,如果出现问题,将抛出错误而不是显示div。这将导致Grafana在面板的左上角显示错误。
- 当图像加载失败时,将记录一个警告,其中包含url(见#11)。
- 现在可以在图片上添加一个正方形作为覆盖层。颜色可以使用字段值的映射来选择(见#19)。
- 修复间隔(见#31)。
注意:如果新选项没有显示出来或者插件看起来像是旧版本,请卸载、重新安装,然后重启Grafana(如果使用Docker,请使用GF_INSTALL_PLUGINS环境变量运行最新的插件版本的新容器)。
2.2.0
- 基础URL和后缀是可选的。
2.1.1
- 更改提示信息和日期包含的默认值。
2.1.0
- 允许选择一个字段作为
alt
图像属性。 - 添加可配置的提示信息。