插件 〉D3 Gauge


开发者

Brian Gann (bkgann@gmail.com)

订阅以接收不定期产品新闻和更新



面板
社区

D3 Gauge

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

Grafana Gauge 面板

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 插件的工作方式相同。这允许根据范围或正则表达式显示替代文本而不是值。

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

例如:对于温度计仪表盘,低于 0 的值可能有害,或高于 100 的值可能对设备有害。可以使用值映射将其显示为紧急消息,或仅指示一个“正常”读数。

Value Mappings


特性

  • 数据运算符与 SingleStat 面板相同 (avg, sum, current 等)

  • 单位格式与 SingleStat 相同

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

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

  • 可调整的限制

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

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

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

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

  • 指针动画速度可配置

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

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

贡献

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

致谢

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

贡献者

在 Grafana Cloud 上安装 D3 Gauge

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

变更日志

此处记录所有变更。

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

  • 初始提交