插件 〉D3 仪表盘

面板
社区

D3 仪表盘

  • 概述
  • 安装
  • 更改日志
  • 相关内容

Grafana 仪表盘面板

Marketplace Downloads License

Twitter Follow Release Maintainability Test Coverage

All Contributors

此面板插件为 基于 D3 的 仪表盘面板,适用于 Grafana 8.4.10+/9.x/10.x

屏幕截图

仪表盘示例

Default Gauge

Default Gauge With Threshold

Default Gauge With All Thresholds

Custom Gauge

Custom Gauge With Limits

配置选项

React 端口已将配置选项分离到多个可搜索的节,并添加了新功能。

标准选项

Standard Options

选项描述
统计要在仪表盘上显示的统计数据
单位显示值的单位。这将用于根据需要缩写
小数位数如果需要,要显示的小数位数的最大值

字体设置

Font Settings

选项描述
数值字体要用于显示值的字体
数值字体大小显示值的字体大小
刻度标签字体要用于刻度标签的字体
刻度标签字体大小要用于刻度标签的字体大小

指针选项

Needle Options

选项描述
动画指针过渡启用值之间指针动画
过渡速度(毫秒)启用动画时,设置过渡速度
允许超出限制启用此选项允许指针低于和高于限制
指针超出限制角度启用超出限制时,这将设置可以超出限制的角度
指针宽度指定指针的宽度
显示末端标记这将在指针末端创建指定形状的标记
显示起始标记这将在指针起始端创建指定形状的标记

当启用选项“允许超出限制”时,指针可以超出最大或最小限制指定的角度。下面的示例显示了一个限制为 100 的仪表盘,并允许指针超出限制(将指针“埋入”)。

Needle Cross Enabled

限制

Limits

选项描述
最小值面板上允许的最小值
最大值面板上允许的最大值

颜色

Coloring

选项描述
外边缘仪表盘外边缘的颜色
内部(表面)仪表盘表面(刻度盘背景)使用的颜色
枢轴枢轴(中心)的颜色
指针指针的颜色
单位标签显示单位标签时的颜色
刻度标签刻度主部分附近显示的值的颜色
刻度主线主要刻度(较长线)的颜色
刻度次线次要刻度(较短线)的颜色

径向自定义

请注意,许多这些设置对可视化非常敏感,因为它们是半径的百分比。以小增量进行调整以查看它们如何影响仪表盘。

Radial Customization

选项描述
半径通过半径指定仪表盘的大小。值 0(零)将自动缩放以适合面板
刻度仪表基准刻度的缩放比例,较低的值将导致自动缩放效果不佳
枢轴半径中心枢轴的大小,以半径的百分比表示
数值垂直偏移设置垂直偏移以更好地放置显示的指标
填充在刻度和外边缘之间添加间距

边缘宽度仪表盘边缘圆圈的厚度,以仪表盘半径的百分比表示
刻度线边缘间隙刻度线与外圆之间的间距,以仪表盘半径的百分比表示
主刻度线长度主刻度线的长度,以仪表盘半径的百分比表示
主刻度线宽度主刻度线的宽度,以像素为单位
次刻度线长度次刻度线的长度,以仪表盘半径的百分比表示
次刻度线宽度次刻度线的宽度,以像素为单位
指针刻度线间隙刻度线与指针末端之间的间距,以仪表盘半径的百分比表示
指针杆长度指针超出仪表盘中心的长度,以仪表盘半径的百分比表示

仪表盘角度

这是用于修改仪表盘上显示范围的主要部分。

Gauge Degrees

选项描述
零刻度线角度刻度值(0)开始的角度(默认 60)
最大刻度线角度刻度值结束的角度(默认 300)
零指针角度指针位于最小值时的角度(默认 40)
最大指针角度指针位于最大值时的角度(默认 320)

仪表盘读数

Gauge Readings

选项描述
主刻度线间距次增量刻度线的数值间距
次刻度线间距主增量刻度线的数值间距

刻度线映射

Tick Maps

使用“添加刻度线映射”按钮创建刻度线映射。

刻度线映射允许您为给定值替换文本。使用此选项可以构建罗盘样式的仪表盘。

选项描述
标签设置刻度线映射的名称
将文本放置在其中的刻度值
文本要显示的文本

阈值

阈值的操作方式与其他 Grafana 插件相同。

下面详细介绍了其他显示选项。

Thresholds

选项描述
在仪表盘上显示阈值区域阈值显示为仪表盘表面上沿着指针弧线的区域
显示下限范围下限阈值显示在区域上
显示中间范围中间阈值显示在区域上
显示上限范围上限阈值显示在区域上
在背景上显示阈值状态仪表盘面颜色更改为阈值状态
在数值上显示阈值状态显示数值的颜色更改为阈值状态

当选择中间和上限阈值选项时,仪表盘将类似于此

Thresholds Middle Upper

阈值的状态可以显示为仪表盘的背景颜色。

Threshold on Face

阈值的状态可以显示在仪表盘的数值上。

Threshold on Value

数值映射

数值映射的工作方式与其他 Grafana 插件相同。这允许根据范围或正则表达式显示替代文本而不是值。

主要用于将空数据显示为“N/A”,但也可以用于指示状态。

例如:对于温度计,低于 0 的值可能是有害的,或者高于 100 的值可能对设备有害。可以使用数值映射将其显示为紧急消息,或者仅指示“标称”读数。

Value Mappings


功能

  • 数据运算符与 SingleStat 面板相同(平均值、总和、当前值等)

  • 单位格式与 SingleStat 相同

  • 可自定义显示数值和刻度线的字体大小和类型

  • 动画指针过渡(弹性或二次缓入)

  • 可调整的限制

  • 仪表盘组件的所有可能的颜色选项

  • 可自定义的仪表盘组件大小(指针长度、宽度、刻度线长度等)

  • 在仪表盘上显示阈值颜色

  • 阈值可以修改显示的数值和背景

  • 指针动画速度可配置

  • 现在支持任意角度的仪表盘(默认范围为 60 到 320)

  • 仪表盘上的数值文本现在可以根据需要上下移动

贡献

欢迎所有贡献!有关更多信息,请参阅CONTRIBUTING.md 文档。

鸣谢

此面板基于 Grafana 的“SingleStat”面板,以及这些优秀的 D3 示例的大部分内容

贡献者

在 Grafana Cloud 上安装 D3 仪表盘

有关更多信息,请访问有关插件安装 的文档。

更改日志

此处记录了所有更改。

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

  • 初始提交