Grafana-Singlestat用法
发布网友
发布时间：2022-11-26 04:12
共1个回答
热心网友
时间：2023-10-10 13:21
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、您有一个查询吗?
解决方案:这可能意味着您的查询返回多个时间序列。您将希望将此简化为单个时间序列。这可以通过多种方式实现，具体取决于您的数据源。一些常见的实践包括求和时间序列，平均或任意数量的其他函数。有关其他信息，请参阅数据源文档。
