插件 〉D3 仪表盘
D3 仪表盘
Grafana 仪表盘面板
此面板插件为 基于 D3 的 仪表盘面板,适用于 Grafana 8.4.10+/9.x/10.x
屏幕截图
仪表盘示例
配置选项
React 端口已将配置选项分离到多个可搜索的节,并添加了新功能。
标准选项
选项 | 描述 |
---|---|
统计 | 要在仪表盘上显示的统计数据 |
单位 | 显示值的单位。这将用于根据需要缩写 |
小数位数 | 如果需要,要显示的小数位数的最大值 |
字体设置
选项 | 描述 |
---|---|
数值字体 | 要用于显示值的字体 |
数值字体大小 | 显示值的字体大小 |
刻度标签字体 | 要用于刻度标签的字体 |
刻度标签字体大小 | 要用于刻度标签的字体大小 |
指针选项
选项 | 描述 |
---|---|
动画指针过渡 | 启用值之间指针动画 |
过渡速度(毫秒) | 启用动画时,设置过渡速度 |
允许超出限制 | 启用此选项允许指针低于和高于限制 |
指针超出限制角度 | 启用超出限制时,这将设置可以超出限制的角度 |
指针宽度 | 指定指针的宽度 |
显示末端标记 | 这将在指针末端创建指定形状的标记 |
显示起始标记 | 这将在指针起始端创建指定形状的标记 |
当启用选项“允许超出限制”时,指针可以超出最大或最小限制指定的角度。下面的示例显示了一个限制为 100 的仪表盘,并允许指针超出限制(将指针“埋入”)。
限制
选项 | 描述 |
---|---|
最小值 | 面板上允许的最小值 |
最大值 | 面板上允许的最大值 |
颜色
选项 | 描述 |
---|---|
外边缘 | 仪表盘外边缘的颜色 |
内部(表面) | 仪表盘表面(刻度盘背景)使用的颜色 |
枢轴 | 枢轴(中心)的颜色 |
指针 | 指针的颜色 |
单位标签 | 显示单位标签时的颜色 |
刻度标签 | 刻度主部分附近显示的值的颜色 |
刻度主线 | 主要刻度(较长线)的颜色 |
刻度次线 | 次要刻度(较短线)的颜色 |
径向自定义
请注意,许多这些设置对可视化非常敏感,因为它们是半径的百分比。以小增量进行调整以查看它们如何影响仪表盘。
选项 | 描述 |
---|---|
半径 | 通过半径指定仪表盘的大小。值 0(零)将自动缩放以适合面板 |
刻度仪表基准 | 刻度的缩放比例,较低的值将导致自动缩放效果不佳 |
枢轴半径 | 中心枢轴的大小,以半径的百分比表示 |
数值垂直偏移 | 设置垂直偏移以更好地放置显示的指标 |
填充 | 在刻度和外边缘之间添加间距 |
边缘宽度 | 仪表盘边缘圆圈的厚度,以仪表盘半径的百分比表示 |
刻度线边缘间隙 | 刻度线与外圆之间的间距,以仪表盘半径的百分比表示 |
主刻度线长度 | 主刻度线的长度,以仪表盘半径的百分比表示 |
主刻度线宽度 | 主刻度线的宽度,以像素为单位 |
次刻度线长度 | 次刻度线的长度,以仪表盘半径的百分比表示 |
次刻度线宽度 | 次刻度线的宽度,以像素为单位 |
指针刻度线间隙 | 刻度线与指针末端之间的间距,以仪表盘半径的百分比表示 |
指针杆长度 | 指针超出仪表盘中心的长度,以仪表盘半径的百分比表示 |
仪表盘角度
这是用于修改仪表盘上显示范围的主要部分。
选项 | 描述 |
---|---|
零刻度线角度 | 刻度值(0)开始的角度(默认 60) |
最大刻度线角度 | 刻度值结束的角度(默认 300) |
零指针角度 | 指针位于最小值时的角度(默认 40) |
最大指针角度 | 指针位于最大值时的角度(默认 320) |
仪表盘读数
选项 | 描述 |
---|---|
主刻度线间距 | 次增量刻度线的数值间距 |
次刻度线间距 | 主增量刻度线的数值间距 |
刻度线映射
使用“添加刻度线映射”按钮创建刻度线映射。
刻度线映射允许您为给定值替换文本。使用此选项可以构建罗盘样式的仪表盘。
选项 | 描述 |
---|---|
标签 | 设置刻度线映射的名称 |
值 | 将文本放置在其中的刻度值 |
文本 | 要显示的文本 |
阈值
阈值的操作方式与其他 Grafana 插件相同。
下面详细介绍了其他显示选项。
选项 | 描述 |
---|---|
在仪表盘上显示阈值区域 | 阈值显示为仪表盘表面上沿着指针弧线的区域 |
显示下限范围 | 下限阈值显示在区域上 |
显示中间范围 | 中间阈值显示在区域上 |
显示上限范围 | 上限阈值显示在区域上 |
在背景上显示阈值状态 | 仪表盘面颜色更改为阈值状态 |
在数值上显示阈值状态 | 显示数值的颜色更改为阈值状态 |
当选择中间和上限阈值选项时,仪表盘将类似于此
阈值的状态可以显示为仪表盘的背景颜色。
阈值的状态可以显示在仪表盘的数值上。
数值映射
数值映射的工作方式与其他 Grafana 插件相同。这允许根据范围或正则表达式显示替代文本而不是值。
主要用于将空数据显示为“N/A”,但也可以用于指示状态。
例如:对于温度计,低于 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 阈值机制
- 新增:指针可以选择超出刻度线(最小值和最大值)以显示超出限制的值
- 新增:指针中心可以使用所有标记类型,并添加了反向箭头选项
- 切换到
pnpm
v0.0.9 - 2021-04-21
- 添加显示指针箭头的选项
- 更新软件包
v0.0.8 - 2020-10-26
- 已签名的插件!
- 更新构建过程
v0.0.7 - 2020-04-18
- 修复
- 更新到 TypeScript 并使用标准化的构建过程。
- 简化数值显示
v0.0.1
- 初始提交