本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 節點圖形面板
<a name="v9-panels-node-graph"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

節點圖形面板會將導向圖形或網路視覺化。它使用導向力配置來有效地定位節點，以便協助顯示複雜的基礎設施地圖、階層或執行圖表。

## 資料要求
<a name="v9-panels-node-graph-requirements"></a>

節點圖形面板需要特定形狀的資料，才能顯示其節點和邊緣。並非所有資料來源或查詢都可以在此面板中視覺化。

節點圖形視覺化包含*節點*和*邊緣*。
+ *節點*會顯示為圓圈。從應用程式角度來看，節點可能代表應用程式、服務或任何其他相關項目。
+ *邊緣*顯示為連接兩個節點的行。連線可能是請求、 操作或兩個節點之間的一些其他關係。

節點和邊緣都可以有相關聯的中繼資料或統計資料。資料來源定義顯示哪些資訊和值，因此不同的資料來源可以顯示不同類型的值或不顯示某些值。

## 節點
<a name="v9-panels-node-graph-nodes"></a>

通常，節點會在節點內顯示兩個統計值，並在節點正下方顯示兩個識別符，通常是名稱和類型。節點也可以將另一組值顯示為節點周圍的顏色圓圈，不同顏色的區段代表應增加到 1 的不同值。例如，您可以擁有由圓圈紅色部分表示的錯誤百分比。

其他詳細資訊可以顯示在內容選單中，當您選擇節點時會顯示。內容功能表中也可以有其他連結，可以鎖定 Grafana 工作區的其他部分或任何外部連結。

**注意**  
節點圖形只能顯示 1，500 個節點。如果超過此限制，則會在右上角顯示警告，而且某些節點將會隱藏。您可以按一下圖形中的**隱藏節點**標記來展開圖形的隱藏部分。

## Edges (邊)
<a name="v9-panels-node-graph-edges"></a>

當您將游標暫留在邊緣上時，邊緣也可以顯示統計資料。與節點類似，您可以透過選擇邊緣來開啟內容選單，其中包含其他詳細資訊和連結。

支援此視覺化的第一個資料來源是其服務映射功能的 AWS X-Ray 資料來源。如需詳細資訊，請參閱[連線至 AWS X-Ray 資料來源](x-ray-data-source.md)。

## 導覽節點圖形
<a name="v9-panels-node-graph-navigation"></a>

您可以在任何節點或邊緣之外選擇並拖曳指標，以在節點圖形內平移。

您可以使用節點圖形左上角的按鈕來縮放。

**隱藏節點**

在特定時間顯示的節點數量受到限制，以維持合理的效能。超出此限制的節點會隱藏在可點選標記後方，顯示連線到該邊緣的隱藏節點的大致數量。您可以選擇標記來展開該節點周圍的圖形。

**網格檢視**

您可以切換到網格檢視，以更清楚地了解圖形中最有趣的節點。網格檢視會顯示網格中沒有邊緣的節點，並可依節點內顯示的統計資料或節點彩色邊界表示的統計資料進行排序。

若要排序節點，請選擇圖例中的統計資料。統計資料名稱旁的標記會顯示目前用於排序和排序方向的統計資料。

選擇節點，然後選擇**在圖形中顯示配置**選項，以切換回聚焦於所選節點的圖形配置，以在完整圖形的內容中顯示。

## Data API (資料 API)
<a name="v9-panels-node-graph-data-api"></a>

此視覺化需要從資料來源傳回特定形狀的資料，才能正確顯示資料。

Node Graph 至少需要描述圖形邊緣的資料框架。根據預設，節點圖形會根據此資料框架計算節點和任何統計資料。或者，如果需要顯示更多節點特定的中繼資料，則可以傳送描述節點的第二個資料框架。您必須同時在資料影格`frame.meta.preferredVisualisationType = 'nodeGraph'`上設定資料影格或為其命名`nodes`，並`edges`分別設定它們，節點圖形才能轉譯。

**來自結構的邊緣資料**

必要欄位：


| 欄位名稱 | Type | 說明 | 
| --- | --- | --- | 
|  id  |  string  |  邊緣的唯一識別符。  | 
|  source  |  string  |  來源節點的 ID。  | 
|  目標  |  string  |  目標的 ID。  | 

選用欄位：


| 欄位名稱 | Type | 說明 | 
| --- | --- | --- | 
|  mainstat  |  string/number  |  將游標暫留在邊緣上時，浮水印中顯示的第一個統計資料。它可以是顯示值為原狀的字串，也可以是數字。如果是數字，也會顯示與該欄位相關聯的任何單位  | 
|  secondarystat  |  string/number  |  與 mainStat 相同，但會顯示在其下方。  | 
|  detail\$1\$1\$1  |  string/number  |  按一下邊緣時，任何字首為 的欄位`detail__`都會顯示在內容選單的標頭中。`config.displayName` 用於更人類可讀的標籤。  | 

**來自結構的節點資料**

必要欄位：


| 欄位名稱 | Type | 說明 | 
| --- | --- | --- | 
|  id  |  string  |  節點的唯一識別符。此 ID 由來源和目標欄位中的邊緣參考。  | 

選用欄位：


| 欄位名稱 | Type | 說明 | 
| --- | --- | --- | 
|  標題  |  string  |  在節點下方可見的節點名稱。  | 
|  字幕  |  string  |  標題下顯示的其他、名稱、類型或其他識別符。  | 
|  mainstat  |  string/number  |  第一個顯示在節點本身內的統計資料。它可以是顯示原狀值的字串或數字。如果是數字，也會顯示與該欄位相關聯的任何單位。  | 
|  secondarystat  |  string/number  |  與 mainStat 相同，但會顯示在節點內。  | 
|  arc\$1\$1\$1  |  number  |  任何字首為 的欄位`arc__`都會用來在節點周圍建立顏色圓圈。這些欄位中的所有值最多應加 1。您可以使用 指定顏色`config.color.fixedColor`。  | 
|  detail\$1\$1\$1  |  string/number  |  按一下節點時，任何字首為 的欄位`detail__`都會顯示在內容選單的標頭中。`config.displayName` 用於更多人類可讀的標籤。  |