插件 〉D3 仪表盘


开发者

Brian Gann ([email protected])

注册以接收产品新闻和更新



面板
社区

D3 仪表盘

  • 概览
  • 安装
  • 更新日志
  • 相关内容

Grafana 仪表盘面板

Marketplace Downloads License

Twitter Follow Release Maintainability Test Coverage

All Contributors

此面板插件为 Grafana 8.4.10+/9.x/10.x 提供了一个基于 D3 的仪表盘面板

屏幕截图

仪表盘示例

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(零)将自动缩放以适合面板
刻度厚度基准刻度的缩放,较低的值将导致自动缩放效果不佳
中心点半径中心点的大小,以半径的百分比表示
值 Y 轴偏移设置垂直偏移以更好地放置显示的指标
内边距在刻度和外边缘之间添加空间
边缘宽度仪表盘边缘周围圆圈的厚度,以仪表盘半径的百分比表示
刻度边缘间隙刻度和外圆之间的间距,以仪表盘半径的百分比表示
主刻度长度主刻度的长度,以仪表盘半径的百分比表示
主刻度宽度主刻度的宽度,以像素为单位
次刻度长度次刻度的长度,以仪表盘半径的百分比表示
次刻度宽度次刻度的宽度,以像素为单位
指针刻度间隙刻度和指针末端之间的间距,以仪表盘半径的百分比表示
指针杆长度指针超出仪表盘中心部分的长度,以仪表盘半径的百分比表示

仪表盘角度

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

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 表示 null 数据,但也可用于指示状态。

例如:对于温度仪表盘,低于 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 阈值机制
  • 新增:指针可以选择超出刻度线(最小值和最大值)以显示超出限制的值
  • 新增:指针中心可以使用所有标记类型,选项中添加了 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

  • 初始提交