插件 〉D3 仪表
D3 仪表盘
Grafana 仪表盘插件
本面板插件为 Grafana 8.4.10+/9.x/10.x 提供了一个基于 D3 的仪表盘面板。
截图
示例仪表盘
配置选项
React 版本将配置选项分成多个可搜索的部分,并增加了新功能。
标准选项
选项 | 描述 |
---|---|
统计 | 仪表盘上要显示的统计信息 |
单位 | 显示值时使用的单位。这将在需要时进行缩写 |
小数 | 如果需要,显示的小数最大位数 |
字体设置
选项 | 描述 |
---|---|
值字体 | 用于显示值的字体 |
值字体大小 | 显示值的字体大小 |
刻度标签字体 | 用于刻度标签的字体 |
刻度标签字体大小 | 用于刻度标签的字体大小 |
指针选项
选项 | 描述 |
---|---|
动画指针过渡 | 启用指针在值之间动画 |
过渡速度(毫秒) | 当动画启用时,设置过渡速度 |
允许跨越限制 | 启用此选项以允许指针低于和高于限制 |
指针跨越限制度数 | 当跨越限制启用时,此设置可超过的限制度数 |
指针宽度 | 指定指针的宽度 |
显示终点标记 | 将在指针的指定形状的终点创建标记 |
显示起点标记 | 将在指针的指定形状的起点创建标记 |
当启用“允许跨越限制”选项时,指针可以超过最大或最小限制度数。下面的示例显示了一个限制为 100 的仪表盘,并允许指针跨越限制(指针被埋藏)。
限制
选项 | 描述 |
---|---|
最小值 | 仪表盘上允许的最小值 |
最大值 | 仪表盘上允许的最大值 |
着色
选项 | 描述 |
---|---|
外边缘 | 仪表盘外边缘的颜色 |
内(表面) | 仪表盘表面的颜色(表盘背景) |
枢轴 | 枢轴(中心)的颜色 |
指针 | 指针的颜色 |
单位标签 | 标签单位显示时的颜色 |
刻度标签 | 刻度主要部分附近显示的值的颜色 |
刻度主要 | 主要刻度的颜色(较长的线条) |
刻度次要 | 次要刻度的颜色(较短的线条) |
径向自定义
请注意,许多这些设置对可视化非常敏感,因为它们是半径的百分比。调整时要逐渐进行,以查看它们如何影响仪表。
选项 | 描述 |
---|---|
半径 | 通过半径指定仪表大小。值0(零)将自动缩放以适应面板 |
刻度基础宽度 | 刻度的缩放,值越小自动缩放效果越差 |
中心轴半径 | 中心轴的大小,以半径的百分比表示 |
值Y偏移 | 设置垂直偏移以更好地放置显示的指标 |
填充 | 在刻度和外部边缘之间添加空间 |
边缘宽度 | 仪表边缘圆圈的厚度,以仪表半径的百分比表示 |
刻度边缘间隙 | 刻度与外部圆圈之间的间距,以仪表半径的百分比表示 |
刻度主要长度 | 主要刻度的长度,以仪表半径的百分比表示 |
刻度主要宽度 | 主要刻度的宽度(以像素为单位) |
刻度次要长度 | 次要刻度的长度,以仪表半径的百分比表示 |
刻度次要宽度 | 次要刻度的宽度(以像素为单位) |
指针刻度间隙 | 刻度与指针末端的间距,以仪表半径的百分比表示 |
指针长度轴 | 指针部分延伸到仪表中心的长度,以仪表半径的百分比表示 |
仪表度数
这是用于修改仪表上显示范围的主要部分。
选项 | 描述 |
---|---|
零刻度角度 | 刻度值(0)开始的角度(默认60) |
最大刻度角度 | 刻度值结束的角度(默认300) |
零指针角度 | 指针位于最小值时的角度(默认40) |
最大指针角度 | 指针位于最大值时的角度(默认320) |
仪表读数
选项 | 描述 |
---|---|
刻度主要间距 | 次要增量刻度的数字间距 |
刻度次要间距 | 主要增量刻度的数字间距 |
刻度映射
使用添加刻度映射
按钮来创建刻度映射。
刻度映射允许您用文本替换给定值。使用此选项可以构建指南针风格的仪表。
选项 | 描述 |
---|---|
标签 | 设置刻度映射的名称 |
值 | 放置文本的刻度值 |
文本 | 要显示的文本 |
阈值
阈值与其他Grafana插件的操作方式相同。
以下详细介绍了额外的显示选项。
选项 | 描述 |
---|---|
在仪表上显示阈值带 | 阈值以带状形式显示在仪表表面沿指针弧线处 |
显示下限范围 | 下限阈值在带上显示 |
显示中间范围 | 中间阈值在带上显示 |
显示上限范围 | 上限阈值在带上显示 |
在背景上显示阈值状态 | 仪表面颜色改变为阈值状态 |
在值上显示阈值状态 | 显示的值颜色改变为阈值状态 |
当选择中间和上限阈值选项时,仪表将类似于这个样子
阈值状态可以显示为仪表的背景颜色。
阈值状态也可以显示在仪表的数值上。
值映射
值映射与其他Grafana插件的工作方式相同。这允许根据范围或正则表达式显示替代文本,而不是显示值。
主要用作表示null
数据的N/A
,但也可以用来指示状态。
例如:对于一个温度仪表,低于0的值可能是有害的,或者高于100的值可能对设备有害。可以使用值映射将其显示为紧急消息,或者简单地指示“正常”读数。
特性
数据操作符与SingleStat面板相同(平均、总和、当前等)
单位格式与SingleStat相同
可以自定义显示数值和刻度的字体大小和类型
动画针头过渡(弹性或quadin)
可调节的极限
仪表组件的所有可能颜色选项
可自定义仪表组件的大小(针头长度、宽度、刻度长度等)
仪表上显示的阈值颜色
阈值可以修改显示的值和背景
针头动画速度可配置
现在支持任意度数仪表(默认从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工具的更多信息,请参阅CLI工具信息。
2. 将仪表板添加到仪表板
已安装的仪表板将立即在Grafana主菜单的仪表板部分中可用,可以像添加其他任何核心仪表板一样添加。
要查看已安装仪表板的列表,请点击主菜单中的插件项。将显示核心仪表板和已安装仪表板。
变更日志
所有更改均在此处列出。
v2.0.1 - 2023-11-13
- 修复迁移期间的字体大小问题
- 根据仪表板大小自动调整字体大小
v2.0.0 - 2023-10-20
- 从Angular重写为React
- 新增:现在可以指定针宽度
- 新增:阈值现在使用标准的Grafana阈值机制
- 新增:针可以可选地超过刻度线(最小值和最大值)以显示超出限制的值
- 新增:针中心可以使用所有标记类型,新增了箭头反向选项
- 切换到
pnpm
v0.0.9 - 2021-04-21
- 添加显示针箭头的选项
- 更新包
v0.0.8 - 2020-10-26
- 签名插件!
- 更新构建过程
v0.0.7 - 2020-04-18
- 修复
- 更新到typescript并使用标准化构建过程。
- 简化值显示
v0.0.1
- 初始提交