节点图 - Amazon Managed Grafana
数据要求NodesEdges在节点图中导航数据 API

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

节点图

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

有关支持 Grafana 9.x 版本的 Grafana 工作空间，请参阅。在 Grafana 版本 9 中工作

有关支持 Grafana 8.x 版本的 Grafana 工作空间，请参阅。在 Grafana 版本 8 中工作

节点图可以对定向图或网络进行可视化。他们使用定向力布局来有效地定位节点，因此他们可以帮助显示复杂的基础设施地图、层次结构或运行图。

数据要求

节点图需要数据的特定形状才能显示其节点和边缘。并非每个数据源或查询都可以使用此图表进行可视化。如果您想以数据源开发者的身份使用它，请参阅有关数据 API 的部分。

节点图由节点和边组成。

  • 节点显示为圆形。从应用程序的角度来看，节点可能代表应用程序、服务或其他任何相关的内容。

  • 一条边显示为一条连接两个节点的线。连接可能是请求、操作或两个节点之间的某种其他关系。

节点和边都可以关联元数据或统计数据。数据源定义了显示哪些信息和值，因此不同的数据源可以显示不同类型的值，也可以不显示某些值。

Nodes

通常，节点在节点内部显示两个统计值，在节点正下方显示两个标识符，通常是名称和类型。节点还可以将另一组值显示为节点周围的色圈，不同颜色的部分表示不同的值，这些值加起来应为 1。例如，您可以用圆圈的红色部分表示错误的百分比。

其他详细信息可以在上下文菜单中显示，该菜单会在您选择节点时显示。快捷菜单中还可以有其他链接，这些链接可以指向 Grafana 工作空间的其他部分或任何外部链接。

注意

节点图只能显示 1,500 个节点。如果超过此限制，则右上角会显示一条警告，并且某些节点将被隐藏。您可以通过单击图表中的隐藏节点标记来展开图表的隐藏部分。

Edges

当您将鼠标悬停在边缘上时，边缘也可以显示统计信息。与节点类似，您可以通过选择边缘来打开包含更多详细信息和链接的上下文菜单。

支持此可视化的第一个 AWS X-Ray 数据源是其服务地图功能的数据源。有关更多信息，请参阅 Connect 连接到 AWS X-Ray 数据源。

在节点图中导航

平底锅

通过选择任何节点或边的外部并拖动指针，可以在节点图中进行平移。

放大或缩小

您可以使用节点图左上角的按钮进行缩放，也可以使用鼠标滚轮或其他带有Ctrl（或Cmd）键的滚动输入进行缩放。

探索隐藏节点

为了保持合理的性能，在给定时间显示的节点数量是有限的。超出此限制的节点隐藏在可选标记后面，这些标记显示与该边缘相连的隐藏节点的大致数量。您可以选择标记来围绕该节点展开图表。

网格视图

您可以切换到网格视图，以便更好地了解图表中最有趣的节点。网格视图显示网格中没有边缘的节点，可以按节点内部显示的统计数据或由节点的彩色边框表示的统计数据进行排序。

要对节点进行排序，请在图例中选择统计数据。统计名称旁边的标记（˄或或˅）显示当前用于排序和排序方向的统计数据。

选择一个节点，然后选择 “在图表中显示” 布局选项，切换回图表布局，将焦点放在所选节点上，以便在整个图表的上下文中显示该节点。

数据 API

此可视化需要从数据源返回数据的特定形状才能正确显示。

Node Graph 至少需要一个描述图形边缘的数据框。默认情况下，节点图将根据此数据框计算节点和任何统计数据。或者，如果需要显示更多特定于节点的元数据，则可以发送描述节点的第二个数据框。你必须frame.meta.preferredVisualisationType = 'nodeGraph'对两个数据框进行设置，或者edges分别为它们命名nodes和，这样才能呈现节点图。

从结构中边缘数据

必填字段：

字段名称 类型 描述

id

字符串

边的唯一标识符。

源

字符串

源节点的 ID。

target

字符串

目标的 ID。

可选字段：

字段名称 类型 描述

mainstat

字符串/数字

将鼠标悬停在边缘上方时，叠加层中会显示第一个统计数据。它可以是按原样显示值的字符串，也可以是数字。如果是数字，则还会显示与该字段关联的任何单位。

secondarystat

字符串/数字

与 MainStat 相同，但显示在其正下方。

详情__*

字符串/数字

单击边缘时，任何前缀为的字段都detail__将显示在上下文菜单的标题中。config.displayName用于更易于阅读的标签。

来自结构的节点数据

必填字段：

字段名称 类型 描述

id

字符串

节点的唯一标识符。edge 在其源和目标字段中引用了此 ID。

可选字段：

字段名称 类型 描述

title

字符串

节点正下方可见的节点的名称。

subtitle

字符串

标题下方显示的附加信息、名称、类型或其他标识符。

mainstat

字符串/数字

第一个统计数据显示在节点本身内部。它可以是按原样显示值的字符串，也可以是数字。如果是数字，则还会显示与该字段关联的任何单位。

secondarystat

字符串/数字

与 MainStat 相同，但显示在节点内部的下方。

arc__*

number

任何前缀为的字段都arc__将用于在节点周围创建色圈。这些字段中的所有值加起来应为 1。您可以使用指定颜色config.color.fixedColor。

详情__*

字符串/数字

单击节点时，任何前缀为的字段都detail__将显示在上下文菜单的标题中。config.displayName用于更易于阅读的标签。

color

字符串/数字

可用于指定单一颜色，而不是使用arc__字段来指定颜色部分。它可以是字符串（必须是可接受的 HTML 颜色字符串），也可以是数字，在这种情况下，行为取决于field.config.color.mode设置。例如，这可以用来创建由字段值控制的渐变颜色。

icon

字符串

要在节点内部显示的图标名称，而不是默认统计信息。只允许使用 Grafana 内置图标（参见此处的可用图标）。

nodeRadius

number

以像素为单位的半径值。用于管理节点大小。

突出显示的

布尔值

设置是否应突出显示该节点。例如，用于通过突出显示多个节点和边来表示图表中的特定路径。默认值为 false。