ノードグラフ - Amazon Managed Grafana
データ要件ノードエッジノードグラフのナビゲーションData API

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

ノードグラフ

このドキュメントトピックは、Grafana バージョン 10.x をサポートする Grafana ワークスペース向けに設計されています。

Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 9 での作業。

Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 8 での作業。

ノードグラフは、有向グラフまたはネットワークを視覚化できます。有向フォースレイアウトを使用してノードを効果的に配置するため、複雑なインフラストラクチャマップ、階層、または実行図の表示に役立ちます。

データ要件

ノードグラフでは、ノードとエッジを表示するために、データの特定の形状が必要です。このグラフでは、すべてのデータソースまたはクエリを視覚化できるわけではありません。これをデータソース開発者として使用する場合は、データ API に関するセクションを参照してください。

ノードグラフは、ノードとエッジ で構成されます。

  • ノードは円として表示されます。ノードは、アプリケーション、サービス、またはアプリケーションの観点から関連性のあるその他のものを表す場合があります。

  • エッジは、2 つのノードを接続する線として表示されます。接続は、リクエスト、 オペレーション、または 2 つのノード間のその他の関係である可能性があります。

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

ノード

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

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

注記

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

エッジ

エッジにカーソルを合わせると、エッジに統計が表示されることもあります。ノードと同様に、エッジを選択すると、追加の詳細とリンクを含むコンテキストメニューを開くことができます。

この視覚化をサポートする最初のデータソースは、サービスマップ機能の AWS X-Ray データソースです。詳細については、「AWS X-Ray データソースに接続する」を参照してください。

ノードグラフのナビゲーション

パン

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

ズームインまたはズームアウト

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

隠しノードを調べる

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

グリッドビュー

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

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

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

Data API

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

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

構造からのエッジデータ

必須フィールド：

フィールド名 タイプ 説明

id

string

エッジの一意の識別子。

ソース

string

ソースノードの ID。

target

string

ターゲットの ID。

オプションフィールド：

フィールド名 タイプ 説明

mainstat

文字列/数値

エッジにカーソルを合わせるとオーバーレイに表示される最初の統計。値をそのまま表示する文字列でも、数値でもかまいません。数値の場合、そのフィールドに関連付けられている単位も表示されます。

セカンダリ統計

文字列/数値

mainStat と同じですが、その下に表示されます。

detail__*

文字列/数値

エッジをクリックすると、 というプレフィックスが付いたフィールドdetail__がコンテキストメニューのヘッダーに表示されます。より人間が読めるラベルconfig.displayNameには を使用します。

構造からのノードデータ

必須フィールド：

フィールド名 タイプ 説明

id

string

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

オプションフィールド：

フィールド名 タイプ 説明

title

string

ノードのすぐ下に表示されるノードの名前。

subtitle

string

タイトルの下に表示される追加の名前、タイプ、またはその他の識別子。

mainstat

文字列/数値

ノード自体内に表示される最初の統計。値はそのままの文字列でも数値でもかまいません。数値の場合、そのフィールドに関連付けられている単位も表示されます。

セカンダリ統計

文字列/数値

mainStat と同じですが、ノード内でその下に表示されます。

arc__*

数値

プレフィックス が付いたフィールドarc__はすべて、ノードの周囲に色円を作成するために使用されます。これらのフィールドのすべての値は、合計で 1 になる必要があります。を使用して色を指定できますconfig.color.fixedColor。

detail__*

文字列/数値

ノードをクリックすると、 というプレフィックスが付いたフィールドdetail__がコンテキストメニューのヘッダーに表示されます。より人間が読めるラベルconfig.displayNameには を使用します。

color

文字列/数値

arc__ フィールドを使用して色セクションを指定する代わりに、単一の色を指定するために使用できます。文字列 (許容される HTML カラー文字列) でも、数値でもかまいません。その場合、動作は field.config.color.mode設定によって異なります。これは、例えば、フィールド値によって制御されるグラデーション色を作成するために使用できます。

アイコン

string

デフォルトの統計ではなく、ノード内に表示されるアイコンの名前。Grafana の組み込みアイコンのみが許可されます (使用可能なアイコンについては、こちらを参照してください）。

nodeRadius

数値

ピクセル単位の半径値。ノードサイズを管理するために使用されます。

強調表示

ブール値

ノードを強調表示するかどうかを設定します。例えば、複数のノードとエッジを強調表示してグラフ内の特定のパスを表すには、 を使用します。デフォルトは false です。