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

主要用作表示null数据的N/A,但也可以用来指示状态。

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

Value Mappings


特性

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

  • 单位格式与SingleStat相同

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

  • 动画针头过渡(弹性或quadin)

  • 可调节的极限

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

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

  • 仪表上显示的阈值颜色

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

  • 针头动画速度可配置

  • 现在支持任意度数仪表(默认从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

  • 初始提交