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

# フレームグラフ
<a name="v10-panels-flamegraph"></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)」を参照してください。

フレームグラフを使用すると、プロファイリングデータを視覚化できます。この視覚化を使用すると、プロファイルをフレームグラフ、テーブル、またはその両方として表すことができます。

![\[Grafana のフレームグラフ視覚化の例を示す画像。\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/images/viz/flamegraph-panel-example.png)


## フレームグラフモード
<a name="v10-panels-flamegraph-mode"></a>

フレームグラフは、プロファイリングデータの階層的な性質を活用します。データを形式に集約することで、メモリを測定するときに、CPU 時間、割り当てられたオブジェクト、スペースなど、どのコードパスが最もシステムリソースを消費しているかを簡単に確認できます。フレームグラフの各ブロックはスタック内の関数呼び出しを表し、ブロックの幅は値を表します。

グレーアウトされたセクションは、比較的小さな値を表す関数のセットであり、パフォーマンス上の理由から 1 つのセクションにまとめられます。

特定の関数にカーソルを合わせると、関数の値、合計値の割合、その関数のサンプル数など、その関数に関する追加データを示すツールチップを表示できます。

**ドロップダウンアクション**

関数をクリックして、追加のアクションを含む以下のドロップダウンメニューを表示できます。
+ **[Focus block]** (フォーカスブロック) - **フォーカスブロック**を選択すると、ブロックまたは関数はフレームグラフの幅の 100% に設定され、そのすべての子関数が親関数の幅に対して更新された幅で表示されます。これにより、フレームグラフの小さな部分にドリルダウンしやすくなります。
+ **[コピー関数名]** - **[コピー関数名]**を選択すると、ブロックが表す関数のフルネームがコピーされます。
+ **[サンドウィッチビュー]** – サンドウィッチビューでは、クリックされた関数のコンテキストを表示できます。関数のすべての呼び出し元が上部に表示され、すべての呼び出し先が下部に表示されます。これは関数の集約コンテキストを示すため、関数がフレームグラフの複数の場所に存在する場合、すべてのコンテキストがサンドウィッチビューに表示され、集約されます。

**ステータスバー**

 ステータスバーには、フレームグラフと現在適用されている変更に関するメタデータが表示されます。例えば、グラフのどの部分がフォーカスされているか、どの関数がサンドイッチビューに表示されるかなどです。ステータスバーのプルダウンにある **[X]** をクリックして、その変更を削除します。

## ツールバー
<a name="v10-panels-flamegraph-toolbar"></a>

**[検索]**

検索フィールドを使用して、特定の名前の関数を検索できます。検索に一致するフレームグラフのすべての関数では色はそのままで、残りの関数はグレーアウトされます。

**Color schema picker** (カラースキーマピッカー)

色付け関数を値またはパッケージ名で切り替えて、同じパッケージから関数を視覚的に結び付けることができます。

**[テキスト配置]**

ブロックに収まらない場合、テキストを左または右に揃えて、関数名のより重要な部分を表示できます。

**視覚化ピッカー**

フレームグラフのみ、テーブルのみ、またはその両方を同時に表示することを選択できます。

## トップテーブルモード
<a name="v10-panels-flamegraph-toptablemode"></a>

トップテーブルは、プロファイルの関数を表形式で示しています。テーブルには、symbols、self、total (記号、自己、合計) の 3 つの列があります。テーブルはデフォルトでセルフタイムでソートされますが、列ヘッダーをクリックして合計時間またはシンボル名で並べ替えることができます。関数がプロファイル内の複数の場所に表示される場合、各行は特定の関数の集計値を表します。

行ごとに左側にアクションボタンもあります。最初のボタンは関数名を検索し、2 番目のボタンは関数のサンドウィッチビューを表示します。

## Data API
<a name="v10-panels-flamegraph-dataapi"></a>

フレームグラフをレンダリングするには、[[ネストされたセットモデル]](https://wikipedia.org/wiki/Nested_set_model)を使用してデータフレームのデータをフォーマットする必要があります。

ネストされたセットモデルは、フレームグラフの各項目が整数値、メタデータ、およびデータフレーム内の順序としてネストレベルによってのみエンコードされるようにします。つまり、項目の順序は重要であり、正しい必要があります。順序付けは、フレームグラフ内の項目の深さ優先探索であり、子配列のようにデータフレームに可変長値を使用せずにグラフを再作成します。

必須フィールド


| フィールド名 | タイプ | 説明 | 
| --- | --- | --- | 
| level | 数値 | 項目のネストレベル。つまり、この項目とフレームグラフの上位項目の間にある項目の数。 | 
| 値 | 数値 | 項目の絶対値または累積値。これは、グラフ内の項目の幅に変換される。 | 
| ラベル | string | 特定の項目に表示されるラベル。 | 
| self | 数値 | 通常、項目の累積値から直近の子の累積値の合計を引いた自己値。 |