本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
配置标准选项
本文档主题专为支持 Grafana 版本 12.x 的 Grafana 工作空间而设计。
对于支持 Grafana 10.x 版本的 Grafana 工作区,请参阅使用 Grafana 版本 10。
对于支持 Grafana 9.x 版本的 Grafana 工作区,请参阅使用 Grafana 版本 9。
对于支持 Grafana 8.x 版本的 Grafana 工作区,请参阅使用 Grafana 版本 8。
Grafana 中使用的数据模型是一种面向列的表结构,统一了时间序列和表查询结果。此结构中的每一列都称为字段。一个字段可以表示单个时间序列或表列。
字段选项允许您更改数据在可视化中的显示方式。您应用的选项和替代不会更改数据,而是改变 Grafana 显示数据的方式。更改选项后,将应用于所有字段,即所有序列或列。例如,如果将单位更改为百分比,则所有带有数值的字段都将以百分比显示。
本主题后面提供了字段格式设置选项的完整列表。
注意
您可以将标准选项应用于大多数内置 Grafana 面板。一些尚未更新到新面板和数据模型的旧面板和社区面板将缺少全部或部分字段选项。
配置标准选项
-
打开控制面板。将鼠标悬停在面板的任何部分,控制面板右上角就会显示操作菜单。
-
从 操作菜单上选择编辑。
-
在面板显示选项窗格中,找到标准选项部分。
-
选择要应用的标准选项。
-
要预览更改,请选择您正在编辑的字段选项框的外部,或按 Enter 键。
标准选项定义
本节介绍了所有可用的标准选项。
您可以将标准选项应用于大多数内置 Grafana 面板。一些尚未更新到新面板和数据模型的旧面板和社区面板将缺少全部或部分字段选项。
除非您在正在编辑的字段选项框外部单击或按 Enter 键,否则大多数字段选项不会影响可视化。
注意
Grafana Labs 一直在努力为所有可视化添加和扩展选项,但并非所有选项都适用于所有可视化。
单位
允许选择字段应使用的单位。选择单位字段,然后向下钻取,直到找到所需的单位。您选择的单位将应用于除时间之外的所有字段。
自定义单位
您也可以使用单位下拉列表来指定自定义单位、自定义前缀或后缀以及日期时间格式。
要选择自定义单位,请输入单位,然后在下拉列表中选择最后一个自定义:xxx 选项。
-
后缀:<suffix> 应跟在值后面的自定义单位。
-
前缀:<prefix> 应放在值前面的自定义单位。
-
时间:<format> 自定义日期时间格式类型,例如
time:YYYY-MM-DD。有关格式语法和选项,请参阅Moment.js 文档中的 format。 -
si:<base scale><unit characters> 自定义 SI 单位。例如:
si: mF。这个更高级一些,因为您可以指定单位和来源数据比例。因此,如果您的来源数据表示为毫(千),请在单位前面加上该 SI 比例字符。 -
计数:<unit> 自定义计数单位。
-
货币:<unit> 自定义货币单位。
您还可以在单位选择器中粘贴原生表情符号,然后将其选择为自定义单位。
字符串单位
Grafana 有时在解析字符串并将其显示为数字时过于激进。要配置 Grafana 以显示原始字符串值,请创建一个字段覆盖,并添加一个带有字符串单位的单位属性。
缩放单位
默认情况下,Grafana 将根据值的大小自动缩放单位。例如,如果您的值为 0.14kW,Grafana 将显示为 140W;再比如 3000kW 将显示为 3MW。如果要禁用此行为,可以关闭缩放单位开关。
最小值
这让您可以设置百分比阈值计算中使用的最小值。留空可自动计算最小值。
最大值
这让您可以设置百分比阈值计算中使用的最大值。留空可自动计算最大值。
字段 min/max
默认情况下,计算的最小值和最大值将基于所有序列和字段中的最小值和最大值。打开字段将 min/max 根据每个字段的最小值或最大值分别计算每个字段的最小值或最大值。
小数
指定 Grafana 在渲染值中包含的小数位数。如果将此字段留空,Grafana 会根据值自动截断小数位数。例如,1.1234 将显示为 1.12,100.456 将显示为 100。
要显示所有小数,请将单位设置为字符串。
显示名称
可设置所有字段的显示标题。可以在字段标题中使用变量。
当显示多个统计数据、字段或序列时,此字段控制每个统计数据中的标题。您可以使用 ${__field.name} 这样的表达式,仅在标题中使用序列名称或字段名称。
给定一个名为 Temp,标签为 {"Loc"="PBI", "Sensor"="3"} 的字段:
| 表达式语法 | 示例 | 渲染为 | 说明 |
|---|---|---|---|
${__field.displayName} |
与语法相同 | Temp {Loc="PBI", Sensor="3"} |
在 {} 中显示字段名称和标签(如果存在)。如果响应中只有一个标签键,那么对于标签部分,Grafana 会显示不带大括号的标签值。 |
${__field.name} |
与语法相同 | Temp |
显示字段的名称(不带标签)。 |
${__field.labels} |
与语法相同 | Loc="PBI", Sensor="3" |
显示不带名称的标签。 |
${__field.labels. |
${__field.labels.Loc} |
PBI |
显示指定标签键的值。 |
${__field.labels.__values} |
与语法相同 | PBI, 3 |
显示用逗号分隔的标签值(不含标签键)。 |
如果在呈现特定字段的表达式后该值为空字符串,则使用默认的显示方法。
颜色方案
颜色选项及其对可视化的影响取决于您正在使用的可视化效果。有些可视化有不同的颜色选项。
您可以指定单一颜色,也可以根据值选择连续(渐变)颜色方案。连续颜色使用相对于最小值和最大值的百分比来插值颜色。
选择以下调色板之一:
| 颜色模式 | 说明 |
|---|---|
| 单色 | 指定单一颜色,这在覆盖规则中很有用 |
| 颜色阴影 | 选择单一颜色阴影,这在覆盖规则中很有用 |
| 来自阈值 | 通知 Grafana 从匹配的阈值中获取颜色 |
| 经典调色板 | Grafana 将通过序列索引在调色板中查找颜色来分配颜色。适用于图形、饼图和其他分类数据可视化 |
| 经典调色板(按序列名称) | Grafana 将根据序列的名称指定颜色。当要可视化的序列名称取决于可用数据时很有用。 |
| Green-Yellow-Red (按价值计算) | 连续颜色方案 |
| Red-Yellow-Green (按价值计算) | 连续颜色方案 |
| Blue-Yellow-Red (按价值计算) | 连续颜色方案 |
| Yellow-Red (按价值计算) | 连续颜色方案 |
| Blue-Purple (按价值计算) | 连续颜色方案 |
| Yellow-Blue (按价值计算) | 连续颜色方案 |
| 蓝色(按值) | 连续颜色方案(面板背景为蓝色) |
| 红色(按值) | 连续颜色方案(面板背景为红色) |
| 绿色(按值) | 连续颜色方案(面板背景为绿色) |
| 紫色(按值) | 连续颜色方案(面板背景为紫色) |
无值
输入当字段值为空或 null 时 Grafana 应显示的内容。默认值为连字符(-)。