本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
字段选项和替换
本文档主题专为支持 Grafana 8.x 版本的 Grafana 工作空间而设计。
有关支持 Grafana 版本 10.x 的 Grafana 工作空间,请参阅。在 Grafana 版本 10 中工作
有关支持 Grafana 9.x 版本的 Grafana 工作空间,请参阅。在 Grafana 版本 9 中工作
本节介绍了 Amazon Managed Grafana 中的字段选项和字段重写以及如何使用它们。
Grafana 工作空间中使用的数据模型,即数据框,是一种面向列的表结构,它统一了时间序列和表查询结果。此结构中的每一列都称为字段。一个字段可以表示单个时间序列或表列。
字段选项允许您更改数据在可视化中的显示方式。您应用的选项和替代不会更改数据,它们会改变 Amazon Managed Grafana 显示数据的方式。
字段选项
可以在面板编辑器的 “字段” 选项卡上找到 “标准” 和 “自定义” 字段选项。在此选项卡上所做的更改适用于所有字段(即系列和列)。例如,如果将单位更改为百分比,则所有带有数值的字段都将以百分比显示。要了解如何应用字段选项,请参阅配置所有字段。
字段覆盖
可以在面板@@ 编辑器的 “覆盖” 选项卡上添加字段覆盖。您可以在此处添加与 “字段” 选项卡上相同的选项,但它们仅适用于特定字段。在中了解如何应用覆盖配置特定字段。
可用的字段选项和替代项
字段选项类型在字段选项和字段覆盖中都很常见。唯一的区别是更改将应用于所有字段(应用于 “字段” 选项卡)还是应用于字段的子集(应用于 “覆盖” 选项卡)。
配置所有字段
要更改所有字段显示数据的方式,可以更改 “字段” 选项卡上的选项。然后,在 “覆盖” 选项卡上,您可以覆盖特定字段的字段选项。有关更多信息,请参阅 配置特定字段。
例如,您可以通过更改 “小数” 选项来更改所有字段中显示的小数位数。有关选项的更多信息,请参阅标准字段选项和表格字段选项。
更改字段选项
您可以根据需要更改任意数量的选项。
更改字段选项
-
选择要编辑的面板,选择面板标题,然后选择 “编辑”。
-
选择 “字段” 选项卡。
-
找到您要更改的选项。您可以定义以下内容:
-
通过在字段中添加值来添加选项。要将选项恢复为默认值,请删除字段中的白色文本。
-
完成对仪表板的编辑后,选择保存。
字段选项示例
假设结果集是一个由两个字段组成的数据框:时间和温度。
time | 温度 |
---|---|
2020-01-02 03:04:00 | 45.0 |
2020-01-02 03:05:00 | 47.0 |
2020-01-02 03:06:00 | 48.0 |
此结构的每个字段(列)都可以应用字段选项,从而改变其值的显示方式。例如,您可以将单位设置为温度 > 摄氏度,结果如下表。
time | 温度 |
---|---|
2020-01-02 03:04:00 | 45.0 °C |
2020-01-02 03:05:00 | 47.0 °C |
2020-01-02 03:06:00 | 48.0 °C |
在这种情况下,小数位没有任何意义。您可以将小数从更改auto
为零 (0
),结果如下表。
time | 温度 |
---|---|
2020-01-02 03:04:00 | 45 °C |
2020-01-02 03:05:00 | 47 °C |
2020-01-02 03:06:00 | 48 °C |
配置特定字段
您可以使用替代来更改一个或多个字段的设置。覆盖的字段选项与特定可视化中可用的字段选项完全相同。唯一的区别是您可以选择将其应用于哪些字段。
例如,您可以通过更改类型与数值匹配的字段的 “小数” 选项来更改所有数值字段或列中显示的小数位数。有关选项的更多信息,请参阅标准字段选项,它们适用于所有允许转换的面板可视化表格字段选项,以及仅适用于表格面板可视化。
添加字段覆盖
您可以根据需要覆盖任意数量的字段选项。
添加字段覆盖
-
选择要编辑的面板,选择面板标题,然后选择 “编辑”。
-
选择 “覆盖” 选项卡。
-
选择 “为其添加覆盖”。
-
选择要应用改写规则的字段。
-
带名称的字段-使用它从所有可用字段的列表中选择一个字段。使用此选择器添加到规则中的属性仅适用于此单个字段。
-
名称与正则表达式匹配的字段-使用它来指定要用正则表达式覆盖的字段。使用此选择器向规则添加的属性将应用于字段名称与正则表达式匹配的所有字段。
-
带类型的字段-使用它可以按类型选择字段,例如字符串、数字等。使用此选择器添加到规则中的属性将应用于与所选类型匹配的所有字段。
-
-
选择 “添加覆盖属性”。
-
选择要应用的字段选项。
-
通过在字段中添加值来输入选项。要将选项恢复为默认值,请删除字段中的白色文本。
-
通过选择 “添加覆盖属性” 继续向该字段添加覆盖,或者您可以选择 “添加覆盖”,然后选择其他字段来添加覆盖。
-
完成后,选择保存。
删除字段覆盖
-
选择包含要删除的改写的 “覆盖” 选项卡。
-
选择覆盖旁边的垃圾桶图标。
字段覆盖示例
假设我们的结果集是一个由四个字段组成的数据框:时间、高温、低温和湿度。
time | 高温 | 低温 | 湿度 |
---|---|---|---|
2020-01-02 03:04:00 | 45.0 | 30.0 | 67 |
2020-01-02 03:05:00 | 47.0 | 34.0 | 68 |
2020-01-02 03:06:00 | 48.0 | 31.0 | 68 |
让我们应用中的字段选项字段选项示例来应用摄氏度单位并去掉小数位。结果如下表。
time | 高温 | 低温 | 湿度 |
---|---|---|---|
2020-01-02 03:04:00 | 45 °C | 30 °C | 67 °C |
2020-01-02 03:05:00 | 47 °C | 34 °C | 68 °C |
2020-01-02 03:06:00 | 48 °C | 31 °C | 68 °C |
温度场看起来不错,但湿度却很荒谬。您可以通过对湿度字段应用字段选项覆盖并将单位更改为杂项 > 百分比 (0-100) 来解决此问题。这会生成一个更有意义的表格。
time | 高温 | 低温 | 湿度 |
---|---|---|---|
2020-01-02 03:04:00 | 45 °C | 30 °C | 67% |
2020-01-02 03:05:00 | 47 °C | 34 °C | 68% |
2020-01-02 03:06:00 | 48 °C | 31 °C | 68% |
标准字段选项
本节介绍可用的字段选项。它们按字母顺序列出。
您可以将标准字段选项应用于大多数内置的 Grafana 工作区面板。一些尚未更新到新面板和数据模型的旧面板和社区面板将缺少全部或部分字段选项。
除非您在正在编辑的字段选项框之外进行选择或按 Enter,否则大多数字段选项不会影响可视化效果。
有关应用这些选项的更多信息,请参阅以下各节:
小数
此选项设置渲染值时要包含的小数位数。留空,让 Amazon Managed Grafana 使用数据源提供的小数位数。
要更改此设置,请在字段中输入一个数字。
数据链接
此选项控制值或可视化链接到的 URL。有关更多信息和说明,请参阅 数据链接。
显示名称
此选项设置所有字段的显示标题。可以在字段标题中使用变量。有关模板和模板变量的更多信息,请参阅模板和变量。
当显示多个统计数据、字段或系列时,此字段控制每个统计数据中的标题。您可以使用诸如${__field.name}
在标题中仅使用系列名称或字段名称之类的表达式。
给定一个名为 Temp 的字段,标签为 {“loc” = “pbi”,“传感器” = “3"}
表达式语法 | 示例 | 渲染到 | 说明 |
---|---|---|---|
${__field.displayName}
|
与语法相同 |
Temp {Loc="PBI",
Sensor="3"}
|
显示字段名称和标签({} 如果存在)。如果响应中只有一个标签密钥,那么对于标签部分,Amazon Managed Grafana 会显示不带大括号的标签值。 |
${__field.name}
|
与语法相同 |
Temp
|
显示字段的名称(不带标签)。 |
${__field.labels}
|
与语法相同 |
Loc="PBI", Sensor="3"
|
显示不带名称的标签。 |
${__field.labels.X}
|
${__field.labels.Loc}
|
PBI
|
显示指定标签键的值。 |
${__field.labels.__values}
|
与语法相同 |
PBI, 3
|
显示用逗号分隔的标签值(不含标签键)。 |
如果在呈现特定字段的表达式后该值为空字符串,则使用默认的显示方法。
最大值
此选项设置百分比阈值计算中使用的最大值。要根据所有系列和字段进行自动计算,请将此设置留空。
最小值
此选项设置百分比阈值计算中使用的最小值。要根据所有系列和字段进行自动计算,请将此设置留空。
没有价值
输入字段值为空或空时亚马逊托管 Grafana 应显示的内容。
单位
此选项指定字段应使用的单位。选择 “单位” 字段,然后向下钻取,直到找到所需的单位。您选择的单位将应用于除时间之外的所有字段。
自定义单位
您也可以使用单位下拉列表来指定自定义单位、自定义前缀或后缀以及日期/时间格式。
要选择自定义单位,请输入单位并选择下拉列表中的最后一个Custom: xxx
选项。
-
suffix:<suffix>
对于应该追随值的自定义单位。 -
time:<format>
用于自定义日期/时间格式;例如,。time:YYYY-MM-DD
有关格式语法和选项,请参阅显示。 -
si:<base scale><unit characters>
用于自定义 SI 单位;例如,si: mF
。此选项稍微高级一点,因为您可以同时指定单位和源数据比例。例如,如果您的源数据以毫升(千)单位表示,则在单位前面加上该 SI 刻度字符。 -
count:<unit>
用于自定义计数单位。 -
currency:<unit>
用于自定义货币单位。
您也可以将原生表情符号粘贴到单位选择器中,然后将其选为自定义单位。
字符串单位
Amazon Managed Grafana 有时可以解析字符串并将其显示为数字。要让 Amazon Managed Grafana 显示原始字符串,请创建一个字段覆盖并添加带有单位的单位属性。string
配色方案
字段颜色选项定义了 Amazon Managed Grafana 如何为系列或字段着色。这里有多种模式的工作方式不同,它们的效用在很大程度上取决于当前选择的可视化效果。
连续色彩模式使用值相对于最小值和最大值的百分比来插值颜色。
-
单色-使用颜色选择器设置的特定颜色。这在改写规则中最有用。
-
来自阈值-从匹配阈值派生的颜色。这对于仪表盘、统计数据和表格可视化非常有用。
按系列着色
Amazon Managed Grafana 包含按系列定义颜色的配色方案。例如,这对于图形和饼图很有用。
按值着色
Amazon Managed Grafana 还包括连续(渐变)配色方案。这对于为单个值着色的可视化非常有用;例如,统计面板和表格面板。
阈值
您可以使用阈值根据值更改字段的颜色。有关更多信息和说明,请参阅 阈值。
价值映射
您可以使用此选项来设置将字段值或值范围转换为显式文本的规则。您可以添加多个值映射。
-
映射类型-选择一个选项。
-
值-输入一个值。如果字段值大于或等于该值,则会显示文本。
-
起始和终止-输入范围。如果字段值介于或等于该范围内的值,则会显示文本。
-
-
文本-字段中满足条件时显示的文本。此字段接受变量。