插件 〉Traffic Light
Traffic Light
Heywesty Traffic light 面板
一个红绿灯,帮助您一目了然地解读复杂信息。

要求
Grafana >=9.5.3
功能
- 可自定义的红绿灯宽度:设置每个红绿灯的最小宽度。
- 网格/单行布局:能够在网格或单行中布置灯。
- 可反转的灯颜色:反转红绿灯颜色的顺序。
- 排序选项:根据值按升序、降序或序列(无)顺序对红绿灯进行排序。
- 值显示:选择显示或隐藏与每个灯关联的值。
- 图例显示:选择显示或隐藏与每个灯关联的图例(查询名称)。
- 趋势显示:显示或隐藏趋势颜色,以提供额外的信息层。
- 红绿灯样式:选择一种红绿灯样式。如果您想要自定义灯的数量,请使用动态样式。
- 方向灵活性:选择红绿灯的垂直或水平布局。
安装
可以使用以下任一方法安装此插件
- Grafana 插件目录
- Grafana CLI:
grafana-cli plugins install heywesty-trafficlight-panel
- Github 发布页面
使用方法
红绿灯面板使用内置的 Grafana 阈值来为值分配灯颜色。
选择红绿灯样式:在面板设置中,选择一种灯样式。动态样式允许您根据阈值设置添加任意数量的灯。所有其他样式都需要设置 3 个阈值。
定义阈值:在面板设置中,定义对数据进行分类的阈值。红绿灯的基本阈值示例如下
分配颜色:为每个阈值范围分配颜色。这些颜色将用于在红绿灯中表示相应的数据值。
预览和调整:设置阈值后,在仪表盘上预览它们。根据需要调整阈值和颜色,以准确反映数据所示的状态。
数据链接:可选地添加数据链接,以便在单击红绿灯面板时导航到其他位置。
[!TIP] 如果您想为红绿灯设置不同的颜色方案,请使用阈值覆盖。如果您使用动态灯,您还可以设置不同数量的灯。
选项
入门就像将面板添加到仪表盘并调整一些设置一样简单
- 最小灯宽度:决定您的红绿灯应该有多大以便清晰可见。默认设置为 100 像素。
- 单行视图:默认情况下,每个灯都会自动以网格布局排列。这可以通过调整最小灯宽度来控制。如果您希望所有灯都在一行中,请启用此选项。
- 反转灯颜色:由于 Grafana 自动排序阈值,此选项适用于将“基本”阈值视为“前进”,而将最高阈值视为“停止”的情况。
- 显示值:选择是否在每个灯旁边显示数值。默认为 true。
- 显示图例:选择是否显示与每个灯关联的图例(查询名称)。默认为 true。
- 显示趋势:使用趋势颜色添加额外一层洞察。默认为 true。
- 红绿灯样式:选择以下样式之一:默认、圆形、侧边灯或动态。
- 灯排序:按照对您有意义的顺序组织您的红绿灯
- 无:保持数据序列顺序。
- 升序:按从最低到最高的值排列。
- 降序:按从最高到最低的值排列。
- 方向:将灯设置为水平或保持默认的垂直布局。
故障排除 / 帮助
查询未返回数据。
检查数据源是否从查询返回数据。
不支持此数据格式。
此插件支持任何返回包含一个数字字段的数据帧的数据源。
阈值设置不正确。
需要设置阈值才能使插件正常工作。请参阅上面的使用方法部分。阈值必须包含 base
和另外两个值。每个灯一个值。
在 Grafana Cloud 上安装 Traffic Light
在 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 工具从命令行安装 Traffic Light
grafana-cli plugins install
插件将安装到您的 grafana 插件目录中;默认目录是 /var/lib/grafana/plugins。有关 cli 工具的更多信息。
2. 将面板添加到仪表盘
已安装的面板可在您的 Grafana 主菜单的“仪表盘”部分立即使用,并且可以像 Grafana 中的任何其他核心面板一样添加。
要查看已安装面板列表,请点击主菜单中的插件项。核心面板和已安装的面板都会显示。
更新日志
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
首次发布。