ヒートマップの確認

このページでは、Key Visualizer スキャンのヒートマップを分析して、Datastore モードの Firestore のパフォーマンスの問題の原因を特定する方法について説明します。

このページを読む前に、Key Visualizer の概要を理解しておく必要があります。次のこともおすすめします。

Key Visualizer スキャンを開く方法を確認する。
一般的なエンティティキーのパターンまたはインデックスキーのパターンの例をご覧ください。

明るさを調整する

Key Visualizer のヒートマップでは、正常な値や低い値が暗い色で表示され、高い値が明るい色で表示されます。ヒートマップにパターンを確認できるように、カラースケールを調整できます。

ほとんどの指標で、Key Visualizer は、もっぱらデータベースの使用状況に基づいて値の高低を決定します。たとえば、特定のキー範囲で 1 秒間に 20 回の読み取りが行われ、他のキー範囲で 1 秒間に 1 回の読み取りが行われた場合、Key Visualizer はそのキー範囲に対して明るい色を使用します。明るい色は必ずしも問題を示すものではありません。

これらの値の色は、[Adjust Brightness] アイコンの隣にある + / - ボタンで調整します。明るくすると、各色で表す値の範囲が狭くなります。暗くすると、値の範囲が広くなります。

明るさをデフォルト設定にリセットするには、明るさを調整 アイコンをクリックします。

特定の期間とキーの範囲をズームインする

ヒートマップを開くと、スキャンに含まれる期間の値とデータベース内のアクティブなキーの範囲が表示されます。特定の期間や特定のキーの範囲に問題があることが特定できた場合、その箇所をズームインして、より詳しく調査を行うことができます。

ズームインまたはズームアウトには、いくつかの方法があります。

ヒートアップを上または下にスクロールします。
[Rectangular Zoom] ボタンをクリックして、クリックとドラッグで拡大領域を選択します。
Shift キーを押しながら、クリックとドラッグで拡大領域を選択します。
Backspace キーまたは Delete キーを押すと、ヒートマップの前の領域に戻ります。
[Reset Zoom] ボタンをクリックするか R キーを押すと、ズームアウトしてテーブル全体が表示されます。

キーの接頭辞によってドリルダウンする

次のセクションでは、エンティティキースキャンを例にドリルダウンする方法を説明します。インデックスキーの場合、プレフィックスはインデックスキーのグループに変わります。

Key Visualizer では、ヒートマップの左側にあるキーがデータベースの階層で整理されます。これを使用して、特定のキー範囲のデータをドリルダウンできます。

ヒートマップのデータをドリルダウンして、共通の接頭辞を持つキーのグループを表示するには:

ヒートマップの左側に表示されるキー階層のレベルの 1 つにカーソルを移動します。

Key Visualizer で、この階層レベルを表すヒートマップの領域がハイライトされます。このレベルのキーのキー接頭辞も表示されます。
調査するキーの階層レベルをクリックします。

Key Visualizer で、この階層レベルにズームインします。
キーの別の階層レベルをクリックしてさらにズームインするか、Backspace キーまたは Delete キーを押して前の領域に戻ります。

指標の詳細情報を固定する

Key Visualizer でヒートマップの上にカーソルを移動すると、カーソルが指している指標の詳細を含むツールチップが表示されます。ヒートマップをクリックするとこのツールチップを固定できます。固定されたツールチップには、指標の詳細が表示されます。ツールチップを固定すると、ツールチップのスクリーンショット撮影やツールチップの情報のコピーを簡単にできます。

指標を切り替える

デフォルトでは、Key Visualizer スキャンを開くと、エンティティキーのオペレーション/秒指標が表示され、使用パターンの概要を確認できます。別の指標に切り替えるには、ヒートマップの上にある [指標] プルダウンリストをクリックして、表示する指標をクリックします。

インデックスキーの場合、インデックスキーの使用状況の概要を示すインデックス書き込みオペレーション/秒指標を表示します。

各指標の説明については、Key Visualizer の指標をご覧ください。

エンティティキーの異なる指標間の関係の探索

指標を比較したり、指標間の関連性を調べる場合は、Key Visualizer で複数の指標を同時に表示できます。たとえば、オペレーション/秒 ヒートマップのホットスポットが平均書き込みレイテンシ ヒートマップの高レイテンシと相関しているかどうかを確認します。

複数の指標とその値を同時に表示するには、右上の [Show info panel] をクリックします。指標のリストがスキャンの右側のペインに表示されます。

[multimetric] ペインでのスキャンの表示例

複数の指標を一度に調べるには、[multimetric] ペインで次のツールを使用します。

すべての指標のミニチュアヒートマップを表示または非表示にするには、右上の Expand All または Collapse All をクリックします。
個々の指標のヒートマップを表示するには、指標名をクリックします。
個々の指標のヒートマップを非表示にするには、指標名を再度クリックします。
指標のヒートマップをメインウィンドウに表示するには、指標のタイトルバーの左端にある実線の矢印をクリックします。
ミニチュアヒートマップにカーソルを合わせると、対応するアクティビティがメインビューに表示されます。

キーバケットの同一時点での複数の指標を比較するには、スキャンで値を固定してから同一時点の別の指標に切り替えます。

メインウィンドウに表示されている大きなヒートマップで、関心のある部分を指定します。
クリックするとツールチップが固定されます。横のペインの値が、そのキーバケットの指定した時点の値に固定されます。
大きなヒートマップに指標を表示するには、その指標の左にある実線の矢印をクリックします。メインウィンドウのツールチップにその指標の詳細が表示されます。

次のステップ

エンティティキーのパターンまたはインデックスキーのパターンの認識について学ぶ。
ヒートマップで確認できる指標について読む。