翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ノードグラフ
<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 に関するセクションを参照してください。

ノードグラフは、*ノード*と*エッジ*で構成されます。
+ ある*ノード*は円として表示されます。あるノードは、アプリケーション、サービス、またはアプリケーションの観点から関連するその他のものを表す場合があります。
+ ある*エッジ*は、2 つのノードを接続する線として表示されます。接続は、リクエスト、オペレーション、または 2 つのノード間の他の関係である場合があります。

ノードとエッジの両方にメタデータまたは統計を関連付けることができます。データソースは、表示される情報と値を定義するため、異なるデータソースが異なるタイプの値を表示したり、一部の値を表示しなかったりすることができます。

## ノード
<a name="v10-panels-node-graph-nodes"></a>

通常、ノードには、ノード内の 2 つの統計値とノードのすぐ下の 2 つの識別子、通常は名前とタイプが表示されます。ノードでは、ノードの周囲に一連の別の値を色付きの円として表示することもできます。異なる色のセクションは、合計が 1 になる異なる値を表します。例えば、円の赤い部分によってエラーの割合を表すことができます。

ノードを選択すると表示されるコンテキストメニューには、さらに詳細を表示できます。Grafana ワークスペースの他の部分または外部リンクをターゲットにできる追加のリンクを、コンテキストメニューに含めることもできます。

**注記**  
ノードグラフには 1,500 個のノードしか表示できません。この制限を超えると、右上隅に警告が表示され、一部のノードは非表示になります。グラフ内の **[非表示ノード]** マーカーをクリックすると、グラフの非表示部分を展開できます。

## エッジ
<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>

**Pan**

ノードグラフ内でパンするには、ノードまたはエッジの外部を選択してポインタをドラッグします。

**拡大または縮小**

ノードグラフの左上隅にあるボタンを使用してズームするか、マウスホイールまたは `Ctrl` (または `Cmd`) キーで他のスクロール入力を使用できます。

**非表示ノードを調べる**

特定の時間に表示されるノードの数は、合理的なパフォーマンスを維持するために制限されます。この制限外のノードは、そのエッジに接続されている非表示ノードのおよその数を示す選択可能なマーカーの背後に隠されます。マーカーを選択して、そのノードの周りのグラフを展開できます。

**グリッドビュー**

グリッドビューに切り替えて、グラフ内の最も興味深いノードの概要を把握できます。グリッドビューは、エッジのないグリッド内のノードを表示し、ノード内に表示される統計、またはノードの色付き境界で表される統計でソートできます。

ノードをソートするには、凡例内の統計を選択します。統計名 (`˄` または `˅`) の横にあるマーカーは、ソートおよびソート方向に現在使用されている統計を示します。

ノードを選択し、**[Show in Graph layout (グラフレイアウトで表示)]** オプションを選択すると、選択したノードに焦点を当ててグラフレイアウトに切り替え、グラフ全体のコンテキストで表示します。

## Data API
<a name="v10-panels-node-graph-data-api"></a>

この視覚化では、正しく表示するために、データソースから返されるデータの特定の形状が必要です。

ノードグラフには、少なくともグラフのエッジを記述するデータフレームが必要です。デフォルトでは、ノードグラフはこのデータフレームに基づいてノードと統計を計算します。必要に応じて、ノード固有のメタデータをより多く表示する必要がある場合に備えて、ノードを記述する 2 番目のデータフレームを送信できます。ノードグラフをレンダリングするには、両方のデータフレームに `frame.meta.preferredVisualisationType = 'nodeGraph'` を設定するか、`nodes` と `edges` にそれぞれ名前を付ける必要があります。

**構造からのエッジデータ**

必須フィールド


| フィールド名 | タイプ | 説明 | 
| --- | --- | --- | 
| id | string | エッジの一意の識別子。 | 
| ソース | string | ソースノードの ID。 | 
| target | string | ターゲットの ID。 | 

オプションのフィールド


| フィールド名 | タイプ | 説明 | 
| --- | --- | --- | 
| Mainstat | 文字列/数値 | エッジにカーソルを合わせたときのオーバーレイに表示される最初の統計。値はそのまま示す文字列でも、数値でもかまいません。数値の場合、そのフィールドに関連付けられている単位も表示されます。 | 
| secondarystat | 文字列/数値 | mainStat と同じですが、そのすぐ下に表示されます。 | 
| detail\$1\$1\$1 | 文字列/数値 | プレフィックスが `detail__` の任意のフィールドは、エッジをクリックするとコンテキストメニューのヘッダーに表示されます。より判読可能なラベルに `config.displayName` を使用します。 | 

**構造からのノードデータ**

必須フィールド


| フィールド名 | タイプ | 説明 | 
| --- | --- | --- | 
| id | string | ノードの一意の識別子。この ID は、ソースフィールドとターゲットフィールドのエッジによって参照されます。 | 

オプションのフィールド


| フィールド名 | タイプ | 説明 | 
| --- | --- | --- | 
| title | string | ノードのすぐ下に表示されるノードの名前。 | 
| subtitle | string | タイトルの下に表示される追加の名前、タイプ、またはその他の識別子。 | 
| mainstat | 文字列/数値 | ノード自体の中に表示される最初の統計。これは、値をそのまま表示する文字列でも数値でもかまいません。数値の場合、そのフィールドに関連付けられている単位も表示されます。  | 
| secondarystat | 文字列/数値 | mainStat と同じですが、ノード内でその下に表示されます。 | 
| arc\$1\$1\$1 | 数値 | プレフィックスが `arc__` の任意のフィールドは、ノードの周囲に色円を作成するために使用されます。これらのフィールドのすべての値は、合計で 1 になる必要があります。`config.color.fixedColor` を使用して色を指定できます。 | 
| detail\$1\$1\$1 | 文字列/数値 | ノードをクリックすると、プレフィックスが `detail__` の任意のフィールドがコンテキストメニューのヘッダーに表示されます。より人間が判読可能なラベルに `config.displayName` を使用します。 | 
| color | 文字列/数値 | `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 | 数値 | ピクセル単位の半径値。ノードサイズを管理するために使用されます。 | 
| highlighted | ブール値 | ノードを強調表示するかどうかを設定します。例えば、複数のノードとエッジを強調表示してグラフ内の特定のパスを表すために使用します。デフォルトは `false` です。 |