来源:http://docs.grafana.org/features/panels/singlestat/
一、Singlestat控制板
Singlestat面板允许您显示单个时间序列的一个主要摘要属性。它将时间序列归纳为单个数字(通过查看时间序列中的最大值、最小值、平均值或值之和)。Singlestat还提供阈值来为stat或面板背景着色。它还可以将单个数字转换为文本值,并显示该时间序列的sparkline摘要。
二、Singlestat面板配置
Singlestat面板有一个普通的查询编辑器,可以像其他面板一样定义精确的指标查询。在Options选项卡中,您可以访问具体的Singlestat功能。
1、Stats: Stats字段允许您设置将整个查询简化为单个值的函数(最小值min、最大值max、平均值average、当前值current、总数total、第一个值first、delta值、范围range),这将整个查询简化为显示的单个汇总值。
最小值min——时间序列中的最小值
最大值max——时间序列中最大的值
平均值avg——时间序列中所有非空值的平均值
当前值current——时间序列的最后一个值。如果时间序列以null结束,将使用之前的值。
总数total——时间序列中所有非空值的和
第一个值first——时间序列的第一个值
delta值——(计数器的)增量的总和。尝试解释计数器重置,但这只适用于单个实例度量。用来表示时间序列中总计数器的增加。
差异diff—— '当前'(最后一个值)和'第一'之间的差异。
范围range——最小值和最大值之间的差值。显示计量器的变化范围。
2、前缀/后缀(Prefix/Postfix):前缀/后缀字段允许您定义一个自定义标签,使其出现在值之前/之后。这里可以使用$__name变量从指标查询中使用系列名称或别名。
图中,“当前流量大小:”为Prefix字段的值。
3、单位(unit):单位被添加到面板中的Singlestat中,并且会尊重颜色和阈值设置。
4、小数(Decimal ):Decimal字段允许您重写自动小数精度,并显式地设置它。
5、字体大小(Font Size):您可以使用这个部分来选择Singlestat面板中不同文本的字体大小,即前缀、值和后缀。
三、颜色
Singlestat面板配置的着色选项允许您根据Singlestat值动态更改颜色。
1、背景(Background):此复选框将配置的阈值和颜色应用到整个Singlestat面板背景中。
2、阈值(Thresholds):根据Singlestat值,在面板内动态更改背景和值颜色。阈值字段接受两个逗号分隔的值,这些值表示三个范围,它们直接对应右边的三种颜色。例如:如果阈值为70,那么第一个颜色表示< 70,第二个颜色表示介于70到90之间,第三个颜色表示> 90。
在复选框中选择value后,显示的值变成绿色。
3、颜色(Colors):选择颜色和不透明度。
4、值(Value):此复选框将配置的阈值和颜色应用到汇总状态。
5、反向顺序(Invert order):此链接切换阈值颜色顺序。
例如:Green, Orange, Red()将变成Red, Orange, Green()。
四、走势图(Spark Lines)
Sparklines是查看与汇总数据相关的历史数据的一种很好的方式,提供了有价值的上下文。Sparklines的工作方式与传统图形面板不同,不包括x轴或y轴、坐标、图例或与图形交互的能力。
上图的蓝色区域就是走势图。
1、显示(show):显示(show)复选框将切换是否在面板中显示走势图。未选中时,只会出现Singlestat值。
2、全高度(Full Height):检查您是否希望sparklines占据整个面板高度,或者不选择它,走势图应该低于主Singlestat值。
3、线条颜色(Line Color):此颜色选择适用于线条本身的颜色。
4、填充色(Fill Color):此颜色选择适用于走势图下方的区域。
五、仪表
仪表(Gauge)清楚地说明了一个值在其上下文中的值有多大。这是一种很好的方法来观察一个值是否接近阈值。仪表(Gauge)使用颜色选项中设置的颜色。
1、显示(show):显示(show)复选框将切换是否在面板中显示仪表。未选中时,只会出现Singlestat值。
2、Min/Max:设置仪表的起点和终点。
3、阈值标签(Threshold Labels):检查是否要显示阈值标签。在颜色选项中设置阈值。
4、阈值标记(Threshold Markers):如果你想有第二个表显示阈值。
六、价值/范围到文本的映射
值/范围到文本映射允许您将汇总数据的值转换为显式文本。文本将尊重为该值定义的所有样式、阈值和定制。这对于将主Singlestat值的数目转换为上下文特定的人类可读的字或消息非常有用。
七、故障排除
多个系列的错误
grafana在单板上对多时间序列做了更严格的检查。在以前的版本中,面板逻辑并不验证只使用了单个时间序列,而是显示了遇到的第一个时间序列。根据数据源的不同,这可能会导致显示不一致的数据和/或对显示哪个指标存在普遍的混淆。
修复你的singlestat面板:
1、通过单击面板标题并选择Edit编辑您的面板。
在metrics选项卡中有多个查询吗?
解决方案:选择一个查询来可视化。您可以通过单击每行上的眼睛图标来切换查询是否显示。如果错误仍然存在,则继续下一个解决方案。
2、您有一个查询吗?
解决方案:这可能意味着您的查询返回多个时间序列。您将希望将此简化为单个时间序列。这可以通过多种方式实现,具体取决于您的数据源。一些常见的实践包括求和时间序列,平均或任意数量的其他函数。有关其他信息,请参阅数据源文档。