配置标准选项
标准选项在面板编辑器窗格中,允许您更改字段数据在可视化中的显示方式。您应用的选项不会改变数据本身,只会改变 Grafana 显示数据的方式。
当您设置标准选项时,该更改将应用于所有字段或系列。例如,如果将单位选项设置为百分比,则所有具有数值的字段都将显示为百分比。
要更精细地控制字段的显示,请参阅配置覆盖。
支持的可视化类型
您可以为以下可视化类型配置标准选项
标准选项
本节解释了所有可用的标准选项。
要设置这些选项,请在面板编辑器窗格中展开标准选项部分。大多数字段选项在您单击正在编辑的字段选项框外部或按 Enter 键之前不会影响可视化。
注意
并非列出的所有选项都适用于所有支持标准选项的可视化类型。
单位
此选项允许您选择字段应使用的单位。在单位字段中点击,然后向下钻取直到找到所需的单位。您选择的单位将应用于除时间之外的所有字段。
自定义单位
您还可以使用单位下拉菜单指定自定义单位、自定义前缀或后缀以及日期时间格式。
要设置自定义单位,请输入您要使用的单位,然后在下拉菜单中选择它。它将是列出的最后一个选项。例如,如果您输入一个名为“Hearts”的单位,下拉菜单中将包含选项自定义单位:Hearts。
您可以使用特定语法进一步定义自定义单位。例如,要设置一个名为“Gems”的自定义货币单位,请在该字段中输入currency:Gems
。下拉菜单中将包含选项自定义单位:currency:Gems。
下表列出了自定义单位的特殊语法选项
自定义单位 | 描述 |
---|---|
suffix:<后缀> | 应位于值之后的自定义单位。 |
prefix:<前缀> | 应位于值之前的自定义单位。 |
time:<格式> | 自定义日期时间格式类型,例如 time:YYYY-MM-DD 。有关格式语法和选项,请参阅格式。 |
si:<基本刻度><单位字符> | 自定义 SI 单位,例如 si: mF 。您可以同时指定单位和源数据刻度。例如,如果您的源数据表示为毫(milli)级,则在单位前加上 m SI 刻度字符。 |
count:<单位> | 自定义计数单位。 |
currency:<单位> | 自定义货币单位。 |
您还可以在单位下拉菜单中粘贴原生表情符号,并将其选作自定义单位
时间格式单位
Grafana 中的所有日期与时间格式单位(例如Datetime ISO或Datetime US)都期望输入值是自 Unix 纪元(1970 年 1 月 1 日)以来的毫秒数。如果您的数据源提供的timestamp单位是秒,则这些值将被错误地解释为非常接近 1970 年 1 月 1 日的日期。
要显示自纪元以来的秒级时间戳,请按照以下步骤使用转换将您的 timestamp 值乘以 1000
在面板编辑器中,点击转换选项卡。
点击添加转换。
选择通过计算添加字段转换。
设置以下选项
- 模式 - 二元运算
- 运算
- 选择您的 timestamp 字段
- 选择星号 (
*
) 进行乘法运算 - 在字段或数字字段中输入 1000
- 如果您想看到计算出的字段,请打开替换所有字段开关。
控制单位缩放
默认情况下,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 根据字段或系列值相对于最小值和最大值的百分比自动分配单色阴影。对于某些可视化,您还需要选择颜色是按字段或系列的最后、最小值还是最大值设置。从以下选项中选择:蓝色、红色、绿色和紫色。 |
您还可以通过单击图例系列颜色图标来使用图例打开颜色选择器。通过这种方式设置颜色会自动创建一个覆盖规则,为特定系列设置特定颜色。
无值
输入 Grafana 在字段值为空或 null 时应显示的内容。默认值为连字符 (-)。