插件 〉Traffic Light


开发者

Jack Westbrook

注册接收不定期的产品新闻和更新



面板
社区

Traffic Light

  • 概览
  • 安装
  • 更新日志
  • 相关内容

Heywesty Traffic light 面板

CI  最新版本徽章

一个红绿灯,帮助您一目了然地解读复杂信息。

要求

Grafana >=9.5.3

功能

  • 可自定义的红绿灯宽度:设置每个红绿灯的最小宽度。
  • 网格/单行布局:能够在网格或单行中布置灯。
  • 可反转的灯颜色:反转红绿灯颜色的顺序。
  • 排序选项:根据值按升序、降序或序列(无)顺序对红绿灯进行排序。
  • 值显示:选择显示或隐藏与每个灯关联的值。
  • 图例显示:选择显示或隐藏与每个灯关联的图例(查询名称)。
  • 趋势显示:显示或隐藏趋势颜色,以提供额外的信息层。
  • 红绿灯样式:选择一种红绿灯样式。如果您想要自定义灯的数量,请使用动态样式。
  • 方向灵活性:选择红绿灯的垂直或水平布局。

安装

可以使用以下任一方法安装此插件

使用方法

红绿灯面板使用内置的 Grafana 阈值来为值分配灯颜色。

  1. 选择红绿灯样式:在面板设置中,选择一种灯样式。动态样式允许您根据阈值设置添加任意数量的灯。所有其他样式都需要设置 3 个阈值。

  2. 定义阈值:在面板设置中,定义对数据进行分类的阈值。红绿灯的基本阈值示例如下

  3. 分配颜色:为每个阈值范围分配颜色。这些颜色将用于在红绿灯中表示相应的数据值。

  4. 预览和调整:设置阈值后,在仪表盘上预览它们。根据需要调整阈值和颜色,以准确反映数据所示的状态。

  5. 数据链接:可选地添加数据链接,以便在单击红绿灯面板时导航到其他位置。

[!TIP] 如果您想为红绿灯设置不同的颜色方案,请使用阈值覆盖。如果您使用动态灯,您还可以设置不同数量的灯。

选项

入门就像将面板添加到仪表盘并调整一些设置一样简单

  1. 最小灯宽度:决定您的红绿灯应该有多大以便清晰可见。默认设置为 100 像素。
  2. 单行视图:默认情况下,每个灯都会自动以网格布局排列。这可以通过调整最小灯宽度来控制。如果您希望所有灯都在一行中,请启用此选项。
  3. 反转灯颜色:由于 Grafana 自动排序阈值,此选项适用于将“基本”阈值视为“前进”,而将最高阈值视为“停止”的情况。
  4. 显示值:选择是否在每个灯旁边显示数值。默认为 true。
  5. 显示图例:选择是否显示与每个灯关联的图例(查询名称)。默认为 true。
  6. 显示趋势:使用趋势颜色添加额外一层洞察。默认为 true。
  7. 红绿灯样式:选择以下样式之一:默认、圆形、侧边灯或动态。
  8. 灯排序:按照对您有意义的顺序组织您的红绿灯
    • 无:保持数据序列顺序。
    • 升序:按从最低到最高的值排列。
    • 降序:按从最高到最低的值排列。
  9. 方向:将灯设置为水平或保持默认的垂直布局。

故障排除 / 帮助

查询未返回数据。

检查数据源是否从查询返回数据。

不支持此数据格式。

此插件支持任何返回包含一个数字字段的数据帧的数据源。

阈值设置不正确。

需要设置阈值才能使插件正常工作。请参阅上面的使用方法部分。阈值必须包含 base 和另外两个值。每个灯一个值。

在 Grafana Cloud 上安装 Traffic Light

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

更新日志

0.5.2

  • 清理:将 @grafana/create-plugin 配置升级到 5.12.4

0.5.1

  • 功能:代码分割 svg 以减小初始包大小
  • 修复:数据链接导致应用崩溃
  • 清理:将 @grafana/create-plugin 配置升级到 5.10.0

0.5.0

  • 功能:新增动态灯样式,允许使用任意数量的灯
  • 修复:排序应按数值进行
  • 清理:将 @grafana/create-plugin 配置升级到 5.5.3
  • CI:将所有 GH 工作流更新到最新的 create-plugin

0.4.1

  • 清理:将 @grafana/create-plugin 配置升级到 5.3.9

0.4.0

  • 功能:支持表格数据
  • 清理:修复许可证文件
  • 清理:将 @grafana/create-plugin 配置升级到 4.16.2
  • 依赖项:将 ws 从 8.13.0 升级到 8.17.1

0.3.1

  • Bug:修复只有单个字段的查询问题
  • 清理:将 @grafana/create-plugin 配置升级到 4.12.0
  • CI:引入 cp 更新工作流

0.3.0

  • 新增选项以反转红绿灯颜色的顺序
  • 新增选项以仅在红绿灯下方显示图例(查询名称)
  • 使用测试 ID 常量清理 e2e 测试并将 plugin-e2e 升级到 1.x.x
  • 为 TrafficLightValue 组件引入 e2e 测试

0.2.0

  • 新增选项以选择不同的红绿灯样式(default, rounded, side-lights
  • 为 utils 添加一些基本测试
  • 添加带 playwright 的 plugin-e2e 包用于 e2e 测试
  • 修复 calculateRowsAndColumns 中的 bug,其中 itemcount 和 containerWidth 未被考虑,导致潜在的布局破坏
  • 修复使用 data.series.length 的 calculateRowsAndColumns 中的 bug,由于返回与 useDatas 值不同的长度,导致布局损坏,而 useDatas 值应被视为真相来源。

0.1.0

首次发布。