插件 〉D3 Gauge
D3 Gauge
Grafana Gauge 面板
此面板插件为 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 面板相同 (avg, sum, current 等)
单位格式与 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 Gauge
在 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 Gauge
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
- 初始提交