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

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

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

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

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

節點圖形需要特定形狀的資料，才能顯示其節點和邊緣。並非所有資料來源或查詢都可以使用此圖表視覺化。如果您想要將此用作資料來源開發人員，請參閱有關資料 API 的一節。

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

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

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

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

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

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

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

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

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

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

**平移**

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

**放大或縮小**

您可以使用節點圖形左上角的按鈕來縮放，或使用滑鼠滾輪或其他捲動輸入搭配 `Ctrl`（或 `Cmd`) 鍵。

**探索隱藏的節點**

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

**網格檢視**

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

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

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

## Data API (資料 API)
<a name="v10-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` 用於更多人類可讀的標籤。 | 
| color | string/number | 可用來指定單一顏色，而不是使用`arc__`欄位來指定顏色區段。它可以是字串 （必須是可接受的 HTML 顏色字串），也可以是數字，在這種情況下，行為取決於 `field.config.color.mode`設定。例如，這可用來建立由欄位值控制的漸層顏色。 | 
| icon | string | 要在節點內顯示的圖示名稱，而非預設統計資料。僅允許內建 Grafana 圖示 （請參閱[此處](https://developers.grafana.com/ui/latest/index.html?path=/story/docs-overview-icon--icons-overview)可用的圖示）。 | 
| nodeRadius | number | 以像素為單位的半徑值。用來管理節點大小。 | 
| 反白 | Boolean | 設定是否應反白顯示節點。例如，透過反白多個節點和邊緣，使用 來代表圖形中的特定路徑。預設為 `false`。 |