字段选项和覆盖 - Amazon Managed Grafana

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

字段选项和覆盖

本文档主题专为支持 Grafana 8.x 版本的 Grafana 工作区而设计。

对于支持 Grafana 10.x 版本的 Grafana 工作区,请参阅 使用 Grafana 版本 10

对于支持 Grafana 9.x 版本的 Grafana 工作区,请参阅 使用 Grafana 版本 9

本节介绍了 Amazon Managed Grafana 中的字段选项和字段覆盖以及如何使用它们。

Grafana 工作空间中使用的数据模型,即数据帧,是一种面向列的表结构,它统一了时间序列和表查询结果。此结构中的每一列都称为字段。一个字段可以表示单个时间序列或表列。

字段选项允许您更改数据在可视化中的显示方式。您应用的选项和覆盖不会更改数据,它们会改变 Amazon Managed Grafana 显示数据的方式。

字段选项

可以在面板编辑器的字段选项卡上找到字段选项(标准和自定义)。在此选项卡上所做的更改适用于所有字段(即序列和列)。例如,如果将单位更改为百分比,则所有带有数值的字段都将以百分比显示。要了解如何应用字段选项,请参阅配置所有字段

字段覆盖

可以在面板编辑器的覆盖选项卡上添加字段覆盖。您可以在此处添加与字段选项卡上相同的选项,但它们仅适用于特定字段。了解如何在 配置特定字段 中应用覆盖。

可用的字段选项和覆盖

字段选项类型在字段选项和字段覆盖中都很常见。唯一的区别是更改将应用于所有字段(应用于字段选项卡)还是应用于字段的子集(应用于覆盖选项卡)。

配置所有字段

要更改所有字段显示数据的方式,可以更改字段选项卡上的选项。然后,在覆盖选项卡上,您可以覆盖特定字段的字段选项。有关更多信息,请参阅 配置特定字段

例如,您可以通过更改小数选项来更改所有字段中显示的小数位数。有关选项的详细信息,请参阅 标准字段选项表字段选项

更改字段选项

您可以根据需要更改任意数量的选项。

要更改字段选项
  1. 选择要编辑的面板,选择面板标题,然后选择编辑

  2. 选择字段选项卡。

  3. 找到要更改的选项。您可以定义以下内容:

  4. 通过在字段中添加值来添加选项。要将选项恢复为默认值,请删除字段中的白色文本。

  5. 完成对控制面板的编辑后,选择保存

字段选项示例

假设结果集是由两个字段组成的数据帧:时间和温度。

时间 温度
2020-01-02 03:04:00 45.0
2020-01-02 03:05:00 47.0
2020-01-02 03:06:00 48.0

此结构的每个字段(列)都可以应用字段选项,从而改变其值的显示方式。例如,您可以将单位设置为温度 > 摄氏度,从而得到以下表。

时间 温度
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),从而得到以下表。

时间 温度
2020-01-02 03:04:00 45°C
2020-01-02 03:05:00 47°C
2020-01-02 03:06:00 48°C

配置特定字段

您可以使用覆盖,更改一个或多个字段的设置。覆盖的字段选项与特定可视化中可用的字段选项完全相同。唯一的区别是您可以选择将它们应用于哪些字段。

例如,您可以通过更改类型与数值匹配的字段小数选项来更改所有数值字段或列中显示的小数位数。有关选项的更多信息,请参阅标准字段选项(适用于所有允许转换的面板可视化),以及表字段选项(适用于表面板可视化)。

添加字段覆盖

您可以根据需要覆盖任意数量的字段选项。

添加字段覆盖
  1. 选择要编辑的面板,选择面板标题,然后选择编辑

  2. 选择覆盖选项卡。

  3. 选择为以下对象添加覆盖

  4. 选择要对其应用覆盖规则的字段。

    • 带名称的字段:使用该选项从所有可用字段的列表中选择一个字段。使用此选择器添加到规则中的属性仅应用于此单个字段。

    • 名称与正则表达式匹配的字段:使用该选项来指定要用正则表达式覆盖的字段。使用此选择器向规则添加的属性将应用于字段名称与正则表达式匹配的所有字段。

    • 带类型的字段:使用该选项可以按类型选择字段,例如字符串、数值等。使用此选择器添加到规则中的属性将应用于与所选类型匹配的所有字段。

  5. 选择添加覆盖属性

  6. 选择要应用的字段选项。

  7. 通过在字段中添加值来输入选项。要将选项恢复为默认值,请删除字段中的白色文本。

  8. 通过选择添加覆盖属性继续向该字段添加覆盖,或者您可以选择添加覆盖,然后选择其他要添加覆盖的字段。

  9. 完成后,选择保存

删除字段覆盖

  1. 选择包含待删除覆盖的“覆盖”选项卡。

  2. 选择覆盖旁边的垃圾桶图标。

字段覆盖示例

假设我们的结果集是一个由四个字段组成的数据帧:时间、高温、低温和湿度。

时间 高温 低温 湿度
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

让我们应用 字段选项示例 中的字段选项来应用摄氏度单位并去掉小数位。这将产生以下表。

时间 高温 低温 湿度
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)”来解决此问题。这会生成一个更有意义的表。

时间 高温 低温 湿度
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", "Sensor"="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 显示用逗号分隔的标签值(不含标签键)。

如果在呈现特定字段的表达式后该值为空字符串,则使用默认的显示方法。

最大值

此选项设置百分比阈值计算中使用的最大值。要根据所有序列和字段进行自动计算,请将此设置留空。

最小值

此选项设置百分比阈值计算中使用的最小值。要根据所有序列和字段进行自动计算,请将此设置留空。

无值

输入字段值为空或空值时 Amazon Managed 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 还包括连续(渐变)颜色方案。这对于为单个值着色的可视化非常有用;例如,统计面板和表面板。

阈值

您可以使用阈值根据值更改字段的颜色。有关更多信息和说明,请参阅 阈值

值映射

您可以使用此选项来设置将字段值或值范围转换为显式文本的规则。您可以添加多个值映射。

  • 映射类型:选择一个选项。

    • :输入值。如果字段值大于或等于该值,则显示文本

    • :输入范围。如果字段值介于或等于该范围内的值,则会显示文本

  • 文本:字段中条件得到满足时显示的文本。此字段接受变量。