插件 〉动态图像面板


开发者

Dalvany


注册以接收偶尔的产品新闻和更新



面板
社区

动态图像面板

  • 概述
  • 安装
  • 变更日志
  • 相关内容

Grafana 图像面板

Marketplace Downloads CI CodeQL

通过 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

configuration panel

构建图像 URL 的选项

  • 基础 URL(可选):获取图像的 URL 的起始部分。如果 icon field 已经包含基础 URL,则可以留空。此选项支持变量。
  • 图标字段:包含图像名称的字段。特殊值 第一个非时间字段 将使用它找到的第一个非时间字段。这是默认值。
  • 后缀(可选):要添加到末尾的字符串。此选项支持变量。
  • 回退 URL(可选):如果加载“指标”图像出错时显示的图像。

图像选项

configuration panel

允许选择图像如何显示的选项

  • 自动调整大小:计算图像的宽度和高度,以便系列适合整个面板。启用此选项将禁用 Image widthImage height
  • 图像宽度:图像的宽度。此选项支持变量(请注意,它需要是一个数字)
  • 图片高度:图片的高度。此选项支持变量(请注意,它需要是一个数字)
  • 单次填充:如果查询有唯一结果,允许填充面板而不是使用上面的宽度和高度
  • Alt字段:用作alt的字段。特殊值使用图标字段将使用与图标字段相同的字段。这是默认值。如果加载图片出现问题且未设置回退或回退本身有问题,将使用Alt字段

共享十字准线选项

configuration panel

这些选项允许在鼠标悬停在图像上时设置背景和边框。如果仪表板中启用了共享十字准线共享工具提示,它也用于突出显示图像。

  • 背景高亮颜色:作为共享十字准线背景图像使用的颜色(默认为带有透明度的白色)
  • 边框高亮颜色:共享十字准线使用的边框颜色。

说明

  • 您必须在插件配置中启用工具提示才能使共享工具提示实际显示工具提示
  • 共享工具提示在幻灯片模式下不起作用(尽管共享十字准线确实起作用),这意味着当鼠标悬停在另一个面板上时,工具提示不会显示
  • 它与时间相关联,并与timeseriescandlestick面板一起工作。

幻灯片选项

configuration panel

幻灯片选项

  • 启用幻灯片:启用幻灯片。
  • 持续时间:配置图像显示多长时间(以毫秒为单位)。不能为0
  • 过渡:使用哪种过渡动画。
  • 过渡持续时间:过渡将持续多长时间(以毫秒为单位)。不能为0
  • 鼠标悬停时暂停:启用时,如果鼠标悬停在图像上,幻灯片将暂停。
  • 无限循环:启用时,幻灯片在结束时从开始处继续。

图像工具提示选项

configuration panel

添加和自定义工具提示的选项

  • 包含工具提示:当鼠标悬停在图像上时显示工具提示。
  • 包含字段:在工具提示文本中包含字段值。
  • 工具提示字段:选择在工具提示中显示的字段值。特殊值使用图标字段将使用与图标字段相同的字段。这是默认值。
  • 包含日期:工具提示将包含日期和时间。
  • 作为已过时间:日期将显示为已过时间(即4小时前)。

图像链接选项

configuration panel

它允许在新标签页中打开链接。它像图像URL一样工作:它连接3个元素(基本URL、度量值和后缀)。

  • 点击打开:启用链接支持。
  • 在新标签页中打开:允许在新的标签页中打开链接。默认为启用。
  • 基础 URL(可选):获取图像的 URL 的起始部分。如果 icon field 已经包含基础 URL,则可以留空。此选项支持变量。
  • 链接字段:包含值的字段。特殊值不使用字段允许不使用任何字段,结果将是所有图像相同的链接。这是默认值。
  • 后缀(可选):要添加到末尾的字符串。此选项支持变量。

叠加选项

configuration panel

允许在每个图像的角落添加彩色正方形作为叠加。颜色与值绑定。默认情况下,颜色为浅透明灰色。
绑定行为如下

  • 如果声明的所有值都是数字,并且从数据中猜测的值类型也是数字,则它类似于Grafana的阈值。
  • 否则,它是一个简单的映射。

注意:当离开输入字段时,值将被排序,空输入将被删除,因此请注意,在选择颜色绑定时不要重新排序。

绑定选项

  • 叠加字段:选择用于绑定的数据字段(将删除时间字段)。如果选择无叠加,则不会显示叠加。
  • 位置:选择叠加的位置。
  • 宽度:允许选择覆盖层的宽度(像素或图像大小的百分比)。
  • 高度:允许选择覆盖层的高度(像素或图像大小的百分比)。
  • 绑定:允许为每个值选择颜色。还可以选择未映射值的颜色。

注意:当离开输入字段时,值将被排序,空输入将被删除,因此请注意,在选择颜色绑定时不要重新排序。

下划线选项

configuration panel

将字段值添加为下划线。如果文本宽度大于图像,则文本将被截断。

  • 下划线字段:用作下划线的字段。如果选择“无下划线”,则不会显示下划线。
  • 文本大小:文本的大小。
  • 文本对齐:水平下划线对齐。默认为左对齐
  • 绑定字段:允许使用字段绑定文本颜色。
  • 绑定:如果“下划线”的“绑定字段”设置为字段,则此配置将显示。它允许将值映射到颜色。

注意:当离开输入字段时,值将被排序,空输入将被删除,因此请注意,在选择颜色绑定时不要重新排序。

屏幕截图

多个结果

screenshot

"单色填充"

screenshot

一个禁用了“单色填充”的结果

screenshot

覆盖层

screenshot

下划线

screenshot

共享十字线支持

screenshot

共享工具提示支持

screenshot

安装

请遵循Grafana插件网页上的说明进行安装。

许可证

  • 颜色绑定组件是Grafana的ThresholdsEditor的修改版,因此受Apache 2.0许可证的约束。

致谢

插件标志可在此处找到,并受MIT许可证的约束。
Slideshow受Apache 2.0许可证的约束。

GitHub的工作流程来自Grafana,并受Apache 2.0许可证的约束。

插件开发:资源

在Grafana Cloud上安装动态图像面板

有关更多信息,请访问插件安装文档。

更新日志

下一个版本

  • 修复许可证链接,使其指向主分支而不是旧主分支
  • 将最低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

  • 允许选择下划线水平对齐(见#46)。
  • 允许根据指标值映射下划线文本颜色(见#46)。

2.4.0

  • 现在可以通过单击图像来打开URL(见#33)。
  • 现在可以幻灯片放映显示多个图像(见#35)。

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图像属性。
  • 添加可配置的提示信息。