配置标准选项
面板编辑器窗格中的标准选项允许您更改字段数据在可视化中的显示方式。您应用的标准选项不会更改数据,它们只会更改 Grafana 显示数据的方式。
当您设置标准选项时,更改将应用于所有字段或系列。例如,如果您将单位选项设置为百分比,则所有具有数值的字段都将显示为百分比。
为了更精细地控制字段的显示,请参阅配置覆盖。
支持的可视化
您可以为以下可视化配置标准选项
标准选项
本节解释所有可用的标准选项。
要设置这些选项,请展开面板编辑器窗格中的标准选项部分。大多数字段选项在您单击正在编辑的字段选项框外部或按 Enter 键之前不会影响可视化。
注意
并非所有列出的选项都适用于具有标准选项的所有可视化。
单位
此选项允许您选择字段应使用的单位。单击单位字段,然后向下钻取直到找到您想要的单位。您选择的单位将应用于除时间之外的所有字段。
自定义单位
您还可以使用单位下拉列表来指定自定义单位、自定义前缀或后缀以及日期时间格式。
要设置自定义单位,请输入您要使用的单位,然后在下拉列表中选择它。它将是列出的最后一个选项。例如,如果您输入一个名为“Hearts”的单位,则下拉列表将包含选项自定义单位:Hearts。
您可以进一步使用特定语法定义自定义单位。例如,要设置名为“Gems”的自定义货币单位,请在字段中输入 currency:Gems
。下拉列表将包含选项自定义单位:currency:Gems
下表列出了自定义单位的特殊语法选项
自定义单位 | 描述 |
---|---|
suffix:<suffix> | 应在值之后显示的自定义单位。 |
prefix:<prefix> | 应在值之前显示的自定义单位。 |
time:<format> | 自定义日期时间格式类型,例如 time:YYYY-MM-DD 。有关格式语法和选项,请参阅formats。 |
si:<base scale><unit characters> | 自定义 SI 单位,例如 si: mF 。您可以指定单位和源数据比例。例如,如果您的源数据表示为毫-单位,请在单位前加上 m SI 比例字符。 |
count:<unit> | 自定义计数单位。 |
currency:<unit> | 自定义货币单位。 |
您还可以将原生表情符号粘贴到单位下拉列表中,并将其选择为自定义单位
控制单位缩放
默认情况下,Grafana 会根据值的大小自动缩放单位。例如,如果您有 0.14kW 和 3000kW 的值,Grafana 会将它们分别显示为 140W 和 3MW。您可以使用自定义单位,通过设置前缀、后缀或自定义 SI 单位来控制此行为。
字符串单位
有时,Grafana 在解释字符串并将其显示为数字时过于激进。要配置 Grafana 以显示原始字符串值,请在单位下拉列表中选择杂项 > 字符串。
最小值
设置百分比阈值计算中使用的最小值。将此字段留空以自动计算最小值。
最大值
设置百分比阈值计算中使用的最大值。将此字段留空以自动计算最大值。
字段最小值/最大值
默认情况下,计算出的最小值和最大值基于所有系列和字段的最小值和最大值。当您启用字段最小值/最大值时,Grafana 会根据字段的最小值或最大值单独计算每个字段的最小值或最大值。
小数位数
指定 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.X} | ${__field.labels.Loc} | PBI | 显示指定标签键的值。 |
${__field.labels.__values} | 与语法相同 | PBI, 3 | 显示标签的值,以逗号分隔(不带标签键)。 |
如果对于特定字段,在渲染表达式后值为空字符串,则应用默认显示方法。
配色方案
配色方案选项允许您为整个可视化设置单色或多种颜色。
颜色选项及其对可视化的影响取决于您正在使用的可视化,并且某些可视化具有不同的颜色选项。
选择以下方案之一
配色方案 | 描述 |
---|---|
单色 | 指定单种颜色。 |
颜色阴影 | Grafana 选择单种颜色的阴影。 |
来自阈值(按值) | 颜色取自匹配的阈值。对于某些可视化,您还需要选择颜色是由字段或系列的最后、最小还是最大值设置。 |
经典调色板 | Grafana 根据每个字段或系列的顺序自动分配颜色。如果查询中字段的顺序发生变化,颜色也会发生变化。适用于图表、饼图和其他分类数据可视化。 |
经典调色板(按系列名称) | Grafana 根据系列的名称自动分配颜色。当要可视化的系列名称可能根据可用数据而变化时很有用。 |
多种连续颜色(按值) | Grafana 根据值相对于字段或系列的最小值和最大值的百分比自动分配颜色。对于某些可视化,您还需要选择颜色是由字段或系列的最后、最小还是最大值设置。从以下选项中选择:绿-黄-红、红-黄-绿、蓝-黄-红、黄-红、蓝-紫和黄-蓝。 |
单种连续颜色(按值) | Grafana 根据值相对于字段或系列的最小值和最大值的百分比自动分配一种颜色的阴影。对于某些可视化,您还需要选择颜色是由字段或系列的最后、最小还是最大值设置。从以下选项中选择:蓝色、红色、绿色和紫色。 |
您还可以使用图例通过单击图例系列颜色图标来打开颜色选择器。以这种方式设置颜色会自动创建覆盖规则,该规则为特定系列设置特定颜色。
无值
输入当字段值为空或 null 时 Grafana 应显示的内容。默认值为连字符 (-)。