菜单

XY 图

Grafana Cloud Enterprise 开源

XY 图

XY 图提供了一种在图表中可视化任意 x 和 y 值的方式，以便您可以轻松显示两个变量之间的关系。XY 图通常用于创建散点图。您也可以使用它们创建气泡图，其中字段值决定每个气泡的大小

An xy chart showing height weight distribution

支持的数据格式

您可以在 XY 图中使用任何类型的表格数据，其中至少包含两个数字字段。此类型可视化无需时间数据。

配置选项

以下部分描述了此可视化的面板编辑器窗格中可用的配置选项。这些选项尽可能按照它们在 Grafana 中的显示顺序排列。

面板选项

在面板编辑器窗格的面板选项部分，设置基本选项，例如面板标题和描述，以及面板链接。要了解更多信息，请参阅配置面板选项。

XY 图选项

以下选项允许您控制数据在 XY 图中的显示方式

选项	描述
序列映射	设置序列数据在图表中的映射方式。选择：自动和手动。根据您选择的序列映射，帧、X 字段和 Y 字段选项会有所不同。有关设置这些特定字段的信息，请参阅序列映射部分。
大小字段	设置哪个字段的值控制图表中点的大小。此值相对于数据帧中所有值的最小值和最大值。选择此选项后，您可以设置点最小大小和点最大大小选项。在手动模式下必需。
颜色字段	设置哪个字段的值控制图表中点的颜色。要使用标准选项下的颜色值选项，必须设置此字段。通常，仅当图表中显示一个序列时才使用此字段。在手动模式下必需。
显示	设置值在可视化中的表示方式。选择：点、线或两者。
点大小	设置图表中所有点的大小，直径从 1 到 100 像素。默认大小为 5 像素。您可以设置一个覆盖来按序列 (y 字段) 设置像素大小。
点最小/最大大小	当您设置了大小字段选项时，使用这些选项控制点的最小或最大大小。您可以覆盖这些选项以应用于特定序列。
点形状	设置图表中点的形状。选择圆 - 默认设置方块
点描边宽度	点描边的宽度，以像素为单位。默认为 1 像素。
填充不透明度	点填充的不透明度。默认为 50。
线条样式	设置连接点的线条样式。选择：实线、虚线或点线。
线条宽度	连接点的线条宽度，以像素为单位。

序列映射

设置序列数据在图表中的映射方式。选择

自动 - 自动从所有可用的数据帧（或数据集）生成序列。您可以过滤以仅选择一个帧。
手动 - 通过从可用的数据帧中选择来明确定义序列。

根据您选择的序列映射，帧、X 字段和Y 字段选项会有所不同。以下标签页描述了这些选项

当您选择自动作为序列映射模式时，以下选项已预先配置，但您也可以自行定义

选项	描述
帧	默认情况下，XY 图显示所有数据帧。您可以过滤以仅选择一个帧。
X 字段	选择 X 代表哪个或哪些字段。默认情况下，这是每个数据帧中的第一个数字字段。有关在自动模式下的示例，请参阅X 字段部分。
Y 字段	设置 X 字段后，默认情况下，数据帧中所有剩余的数字字段都被指定为 Y 字段。您可以使用此选项明确选择哪些字段用于 Y。有关在自动模式下如何使用此选项的更多信息，请参阅Y 字段部分。

当您选择手动作为序列模式时，您可以添加、编辑和删除序列。要管理序列，请单击序列字段；要重命名序列，请单击序列名称。

在手动模式下，这些字段是必需的

选项	描述
帧	选择您的数据帧或数据集。您可以添加任意数量的帧。
X 字段	选择 X 代表哪个字段。
Y 字段	选择 Y 代表哪个字段。

X 字段

在自动序列映射模式下，选择 X 代表哪个或哪些字段。默认情况下，这是每个数据帧中的第一个数字字段。例如，您输入以下 CSV 内容

a	b	c
0	0	0
1	1	9
2	2	4

在生成的图表中，X 字段由列“a”中的值生成，除非您另行定义。

Y 字段

在自动序列映射模式下，设置 X 字段后，默认情况下，数据帧中所有剩余的数字字段都被指定为 Y 字段。您可以使用此选项明确选择哪些字段用于 Y。

图表的序列由 Y 字段生成。要在 XY 图中更改序列，请对 Y 字段进行覆盖。

注意
您在大小字段或颜色字段中使用的任何字段都不会生成序列。

您还可以使用覆盖单独排除 Y 字段。为此，为您要移除的每个 Y 字段添加具有以下属性的覆盖

覆盖类型：按名称匹配字段
覆盖属性：序列 > 在区域中隐藏
区域：可视化

显示

设置值在可视化中的表示方式。选择

点 - 将值显示为点。选择此选项时，还会显示点大小选项。
线 - 在值之间添加线条。选择此选项时，还会显示线条样式和线条宽度选项。
两者 - 同时显示点和线。

线条样式

设置连接点的线条样式。要更改颜色，请使用标准的配色方案字段选项。

实线 - 显示实线。这是默认设置。
虚线 - 显示虚线。选择此选项时，将显示一个下拉列表，您可以在其中选择虚线的长度和间隙设置。默认情况下，长度和间隙设置为 10, 10。
点线 - 显示点线。选择此选项时，将显示一个下拉列表，您可以在其中选择点间距。默认情况下，点间距设置为 0, 10（第一个数字表示点长度，始终为零）。

提示框选项控制当您将鼠标悬停在可视化中的数据点上时出现的信息叠加层。

选项	描述
提示框模式	当您将光标悬停在可视化上时，Grafana 可以显示提示框。选择它们的行为方式单一 - 鼠标悬停提示框仅显示一个序列，即您在可视化上悬停的那个。隐藏 - 与可视化互动时，不显示提示框。
最大宽度	设置提示框的最大宽度。

图例选项

图例选项控制图表下方或右侧显示的序列名称和统计信息。有关图例的更多信息，请参阅配置图例。

选项	描述
可见性	切换开关以打开或关闭图例。
模式	使用这些设置定义图例在可视化中的显示方式。列表将图例显示为列表。这是图例的默认显示模式。表格将图例显示为表格。
位置	选择图例显示位置。底部将图例放置在图表下方。右侧将图例放置在图表右侧。
宽度	控制图例放置在可视化右侧时的宽度。仅当您将图例位置设置为右侧时才会显示此选项。
值	选择在图例中显示哪些标准计算。您可以选择多个。

轴选项

轴部分下的选项控制 X 轴和 Y 轴的渲染方式。某些选项在您单击正在编辑的字段选项框外部后才会生效。您也可以按Enter键。

选项	描述
位置	选择 Y 轴的位置。选择：自动、左侧、右侧和隐藏。
标签	设置 Y 轴文本标签。如果有一个以上的 Y 轴，则可以使用覆盖为其分配不同的标签。
宽度	为轴设置固定宽度。默认情况下，Grafana 会动态计算轴的宽度。
显示网格线	设置轴网格线的可见性。选择：自动、开启和关闭。
颜色	设置轴的颜色。选择文本 - 使用面板文本颜色。序列 - 使用序列的颜色。
显示边框	设置轴边框的可见性。
刻度	设置 Y 轴值刻度。选择：线性、对数和对称对数。
中心零点	设置 Y 轴使其中心位于零点。适用于线性或对称对数刻度选项。
软最小值	设置软最小值以更好地控制 Y 轴限制。
软最大值	设置软最大值以更好地控制 Y 轴限制。

位置

选择 Y 轴的位置。从以下选项中选择

自动 - 自动将 Y 轴分配给序列。当存在两个或多个具有不同单位的序列时，Grafana 将左轴分配给第一个单位，将右轴分配给后续单位。
左侧 - 在左侧显示所有 Y 轴。
右侧 - 在右侧显示所有 Y 轴。
隐藏 - 隐藏所有轴。要选择性地隐藏轴，请添加字段覆盖以针对特定字段。

刻度

设置 Y 轴值刻度。选择

线性 - 将刻度线分成相等的部分。
对数 - 使用对数刻度。如果选择此选项，请在对数底数列表中选择二进制（底数 2）或常用（底数 10）对数刻度。
对称对数 - 使用对称对数刻度。如果选择此选项，还需要选择
- 对数底数 - 选择二进制（底数 2）或常用（底数 10）对数刻度。
- 线性阈值 - 设置刻度从线性变为对数的阈值。

软最小值和软最大值

设置软最小值或软最大值选项，以更好地控制 Y 轴限制。默认情况下，Grafana 会根据数据集自动设置 Y 轴的范围。

软最小值和软最大值设置可以防止数据在大部分平坦时微小变化被放大。相比之下，硬最小值和最大值通过裁剪特定点之外的间歇性峰值，有助于防止数据中有用的细节被掩盖。

要定义 Y 轴的硬限制，请设置标准最小值/最大值选项。有关更多信息，请参阅配置标准选项。

标准选项

面板编辑器窗格中的标准选项允许您更改字段数据在可视化中的显示方式。设置标准选项后，更改将应用于所有字段或序列。要对字段显示进行更精细的控制，请参阅配置字段覆盖。

您可以自定义以下标准选项

字段最小值/最大值 - 启用字段最小值/最大值，让 Grafana 根据字段的最小值或最大值单独计算每个字段的最小值或最大值。
配色方案 - 为您的整个可视化设置单色或多色。要了解有关配色方案的更多信息，请参阅配置标准选项。

数据链接和操作

数据链接允许您链接到其他面板、仪表盘和外部资源，而操作允许您触发基本的、未经认证的 API 调用。在这两种情况下，您都可以在执行这些任务的同时保持源面板的上下文。

对于每个数据链接，设置以下选项

标题
URL
在新标签页中打开
一键打开 - 单击即可打开数据链接。一次只能有一个数据链接启用一键打开。

对于每个操作，定义以下 API 调用设置

选项	描述
标题	显示在 UI 中的操作的易于理解的标签。
确认消息	用于确认或取消操作的描述性提示。
方法	选择 POST、PUT 或 GET。
URL	请求 URL。要添加变量，请单击URL字段并输入`$`或按 Ctrl+Space 或 Cmd+Space 查看可用变量列表。
查询参数	键和值对。单击+图标可根据需要添加任意数量的键/值对。
请求头	由键和值对以及Content-Type组成。单击+图标可根据需要添加任意数量的键/值对。
Content-Type	从以下选项中选择：application/json、text/plain、application/XML 和 application/x-www-form-urlencoded。
请求体	请求的体。

要了解更多信息，请参阅配置数据链接和操作。

值映射

值映射是一种可用于更改数据在可视化中显示方式的技术。

对于每个值映射，设置以下选项

条件 - 选择要映射到显示文本和（可选）颜色的内容
- 值 - 特定值
- 范围 - 数值范围
- 正则表达式 - 正则表达式
- 特殊 - 特殊值，例如Null、NaN（非数字）或布尔值，例如true和false
显示文本
颜色（可选）
图标（仅 Canvas）

要了解更多信息，请参阅配置值映射。

阈值

阈值是您为指标设置的一个值或限制，当达到或超过该值或限制时，它会在视觉上得到反映。阈值是一种可以根据查询结果有条件地设置可视化样式和颜色的方法。

对于每个阈值，设置以下选项

选项	描述
值	设置每个阈值的值。
阈值模式	选择绝对和百分比。

要了解更多信息，请参阅配置阈值。

字段覆盖

覆盖允许您自定义特定字段或序列的可视化设置。添加覆盖规则时，它会针对特定的字段集，并允许您定义该字段的多种显示选项。

选择以下覆盖选项

选项	描述
按名称匹配字段	从所有可用字段列表中选择一个字段。
按正则表达式匹配字段名称	使用正则表达式指定要覆盖的字段。
按类型匹配字段	按类型选择字段，例如字符串、数字或时间。
按查询返回的字段	选择特定查询返回的所有字段，例如 A、B 或 C。
按值匹配字段	选择由您定义的聚合器条件返回的所有字段，例如最小值、最大值、计数、总计。