插件 〉D3 仪表盘
D3 仪表盘
Grafana 仪表盘面板
此面板插件为 Grafana 8.4.10+/9.x/10.x 提供了一个基于 D3 的仪表盘面板
屏幕截图
仪表盘示例
配置选项
React 端口已将配置选项分为多个可搜索的部分,并添加了新功能。
标准选项
选项 | 描述 |
---|---|
统计 | 要在仪表盘上显示的统计数据 |
单位 | 显示值的单位。这将用于根据需要进行缩写 |
小数位数 | 如果需要,要显示的最大小数位数 |
字体设置
选项 | 描述 |
---|---|
值字体 | 用于显示值的字体 |
值字体大小 | 显示值时使用的字体大小 |
刻度标签字体 | 用于刻度标签的字体 |
刻度标签字体大小 | 用于刻度标签的字体大小 |
指针选项
选项 | 描述 |
---|---|
动画指针过渡 | 启用值之间的指针动画 |
过渡速度(毫秒) | 启用动画后,设置过渡发生的速度 |
允许超出限制 | 启用此选项可允许指针低于和高于限制 |
指针超出限制角度 | 启用超出限制后,这将设置可以超出的度数 |
指针宽度 | 指定指针的宽度 |
显示末端标记 | 这将会在指针末端创建指定形状的标记 |
显示起始标记 | 这将会在指针起始端创建指定形状的标记 |
当启用 允许超出限制
选项时,指针可以超出最大或最小限制指定的度数。下面的示例显示了一个限制为 100 的仪表盘,并允许指针超出限制(指针埋没)。
限制
选项 | 描述 |
---|---|
最小值 | 仪表盘表面允许的最小值 |
最大值 | 仪表盘表面允许的最大值 |
颜色
选项 | 描述 |
---|---|
外边缘 | 仪表盘外边缘的颜色 |
内部(表面) | 用于仪表盘表面的颜色(刻度盘的背景) |
中心点 | 中心点(中心)的颜色 |
指针 | 指针的颜色 |
单位标签 | 显示单位标签时使用的颜色 |
刻度标签 | 靠近主刻度部分显示的值的颜色 |
主刻度 | 主刻度(较长线)的颜色 |
次刻度 | 次刻度(较短线)的颜色 |
径向自定义
请注意,由于这些设置是半径的百分比,因此其中许多设置对可视化非常敏感。以小增量调整以查看它们如何影响仪表盘。
选项 | 描述 |
---|---|
半径 | 通过半径指定仪表盘的大小。值 0(零)将自动缩放以适合面板 |
刻度厚度基准 | 刻度的缩放,较低的值将导致自动缩放效果不佳 |
中心点半径 | 中心点的大小,以半径的百分比表示 |
值 Y 轴偏移 | 设置垂直偏移以更好地放置显示的指标 |
内边距 | 在刻度和外边缘之间添加空间 |
边缘宽度 | 仪表盘边缘周围圆圈的厚度,以仪表盘半径的百分比表示 |
刻度边缘间隙 | 刻度和外圆之间的间距,以仪表盘半径的百分比表示 |
主刻度长度 | 主刻度的长度,以仪表盘半径的百分比表示 |
主刻度宽度 | 主刻度的宽度,以像素为单位 |
次刻度长度 | 次刻度的长度,以仪表盘半径的百分比表示 |
次刻度宽度 | 次刻度的宽度,以像素为单位 |
指针刻度间隙 | 刻度和指针末端之间的间距,以仪表盘半径的百分比表示 |
指针杆长度 | 指针超出仪表盘中心部分的长度,以仪表盘半径的百分比表示 |
仪表盘角度
这是用于修改仪表盘上显示范围的主要部分。
选项 | 描述 |
---|---|
零刻度角 | 刻度值 (0) 开始的角度(默认为 60) |
最大刻度角 | 刻度值结束的角度(默认为 300) |
零指针角 | 指针处于最小值时的角度(默认为 40) |
最大指针角 | 指针处于最大值时的角度(默认为 320) |
仪表盘读数
选项 | 描述 |
---|---|
主刻度间距 | 次增量刻度的数值间距 |
次刻度间距 | 主增量刻度的数值间距 |
刻度映射
使用 添加刻度映射
按钮创建刻度映射。
刻度映射允许您用文本替换给定的值。使用此选项可以构建罗盘式仪表盘。
选项 | 描述 |
---|---|
标签 | 设置刻度映射的名称 |
值 | 文本将放置的刻度值 |
文本 | 要显示的文本 |
阈值
阈值的操作方式与其他 Grafana 插件相同。
下面详细介绍了其他显示选项。
选项 | 描述 |
---|---|
在仪表盘上显示阈值带 | 阈值在仪表盘表面沿指针弧线显示为带 |
显示下限范围 | 下限阈值显示在带上 |
显示中间范围 | 中间阈值显示在带上 |
显示上限范围 | 上限阈值显示在带上 |
在背景上显示阈值状态 | 仪表盘表面颜色更改为阈值状态 |
在值上显示阈值状态 | 显示的值颜色更改为阈值状态 |
当选择中间和上限阈值选项时,仪表盘将类似于此
阈值的状态可以显示为仪表盘的背景颜色。
阈值的状态可以显示在仪表盘的值上。
值映射
值映射的工作方式与其他 Grafana 插件相同。这允许显示替代文本而不是基于范围或正则表达式的值。
主要用于 N/A
表示 null
数据,但也可用于指示状态。
例如:对于温度仪表盘,低于 0 的值可能有害,或者高于 100 的值可能对设备有害。值映射可用于将此显示为紧急消息,或仅指示“正常”读数。
功能特性
数据运算符与 SingleStat 面板相同(平均值、总和、当前值等)
单位格式与 SingleStat 相同
可自定义的值和刻度的字体大小和类型
动画指针过渡(弹性或四次缓动)
可调整的限制
所有可能的仪表盘组件颜色选项
可自定义的仪表盘组件大小(指针长度、宽度、刻度长度等)
在仪表盘上显示阈值颜色
阈值可以修改显示的值和背景
指针动画速度可配置
现在支持任意角度仪表盘(默认为 60 到 320)
仪表盘上的值文本现在可以根据需要上下移动
贡献
欢迎所有贡献!有关更多信息,请参阅 CONTRIBUTING.md 文档。
致谢
此面板基于 Grafana 的“SingleStat”面板,以及这些优秀的 D3 示例的大部分内容
- https://oliverbinns.com/articles/D3js-gauge/
- http://bl.ocks.org/tomerd/1499279
- http://bl.ocks.org/dustinlarimer/5888271 标记!
贡献者
在 Grafana Cloud 上安装 D3 仪表盘
在 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 工具从命令行安装 D3 仪表盘
grafana-cli plugins install
插件将安装到您的 grafana 插件目录中;默认目录为 /var/lib/grafana/plugins。 有关 cli 工具的更多信息。
2. 将面板添加到仪表盘
安装的面板在 Grafana 主菜单的“仪表盘”部分中立即可用,并且可以像 Grafana 中的任何其他核心面板一样添加。
要查看已安装面板的列表,请单击主菜单中的“插件”项。核心面板和已安装面板都将出现。
更新日志
所有更改均在此处记录。
v2.0.1 - 2023-11-13
- 修复迁移期间的字体大小调整
- 根据仪表盘大小自动缩放字体
v2.0.0 - 2023-10-20
- 从 Angular 重写为 React
- 新增:现在可以指定指针宽度
- 新增:阈值现在使用标准的 Grafana 阈值机制
- 新增:指针可以选择超出刻度线(最小值和最大值)以显示超出限制的值
- 新增:指针中心可以使用所有标记类型,选项中添加了 arrow-inverse
- 切换到
pnpm
v0.0.9 - 2021-04-21
- 添加显示指针箭头的选项
- 更新包
v0.0.8 - 2020-10-26
- 已签名插件!
- 更新构建过程
v0.0.7 - 2020-04-18
- 修复
- 更新到 typescript 并使用标准化构建过程。
- 简化值显示
v0.0.1
- 初始提交