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

# Performance Insights ダッシュボードを使用してメトリクスを分析する
<a name="performance-insights-analyzing"></a>

Performance Insights ダッシュボードには、パフォーマンスの問題を分析し、解決するのに役立つ、データベースのパフォーマンス情報が含まれます。ダッシュボードのメインページで、データベースロード (DB ロード) に関する情報を確認できます。待機状態やクエリなどのディメンションによって、DB のロードを「スライス」することが可能です。

**Topics**
+ [Performance Insights ダッシュボードの概要](performance-insights-dashboard-overview.md)
+ [Performance Insights ダッシュボードを開く](performance-insights-dashboard-opening.md)
+ [待機状態によるデータベースロードの分析](performance-insights-analyzing-db-load.md)
+ [[上位のクエリ] タブの概要](performance-insights-top-queries.md)
+ [データベースロードグラフのズームイン](performance-insights-zoom-db-load.md)

# Performance Insights ダッシュボードの概要
<a name="performance-insights-dashboard-overview"></a>

ダッシュボードは、Performance Insights を操作する最も簡単な方法です。次の例では、Amazon DocumentDB インスタンスのダッシュボードを示しています。デフォルトでは、Performance Insights ダッシュボードには過去 60 分間のデータが表示されます。

![\[Amazon DocumentDB インスタンスの CPU 使用率と時間の経過に伴うデータベース負荷を示す [パフォーマンスインサイト] ダッシュボード。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/overview-dashboard.png)


このダッシュボードは、以下の各パートに分割されています。

1. **カウンターメトリクス** - 特定のパフォーマンスカウンターメトリクスのデータを示します。

1. **データベースロード** - DB ロードと DB インスタンスの容量を比較して、**最大 vCPU** ラインで表します。

1.  **上位ディメンション** – DB ロードに影響が大きい上位ディメンションを表示します。これらのディメンションには `waits`、`queries`、`hosts`、`databases`、`applications` が含まれます。

**Topics**
+ [カウンターメトリクスグラフ](#performance-insights-overview-metrics)
+ [データベースロードのグラフ](#performance-insights-overview-db-load-chart)
+ [上位のディメンションテーブル](#performance-insights-overview-top-dimensions)

## カウンターメトリクスグラフ
<a name="performance-insights-overview-metrics"></a>

カウンターメトリクスを使用すると、Performance Insights ダッシュボードをカスタマイズして最大 10 個の追加グラフを含めることができます。これらのグラフは、数十種類のオペレーティングシステムメトリクスの一部を示しています。この情報をデータベースロードと関連付けることで、パフォーマンスの問題を特定して分析できます。

**カウンターメトリクス**グラフはパフォーマンスカウンターのデータを表示します。

![\[時間の経過に伴う CPU 使用率を示すカウンターメトリクスグラフ。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/counter-metrics.png)


**メトリクスの管理**を選択して、パフォーマンスカウンターを変更します。以下のスクリーンショットに示すように、複数の **OS メトリクス**を選択できます。メトリクスの詳細を表示するには、メトリクス名にカーソルを合わせます。

![\[OS メトリクスオプションを備えた [パフォーマンスインサイト] ダッシュボードメトリクス選択インターフェイス。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/overview-os-metrics.png)


## データベースロードのグラフ
<a name="performance-insights-overview-db-load-chart"></a>

**データベースロード**は、データベースアクティビティとインスタンス容量の比較結果が **最大 vCPU** の折れ線グラフとして表示されます。デフォルトでは、折れ線グラフは DB ロードを単位時間あたりの平均アクティブセッションで表します。DB ロードは、待機状態でスライス (グループ化) されます。

![\[CPU 使用率は最後に急増した、時間の経過に伴う平均アクティブセッション数を示すデータベース負荷グラフ。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/database-load.png)


**ディメンションでスライスされた DB のロード**  
サポートされているディメンション別にグループ化された、アクティブなセッションとしてロードを表示するように選択できます。次の図に、Amazon DocumentDB インスタンスのディメンションを示します。

![\[ドロップダウンリストに表示されるさまざまな「スライスバイ」オプションを含むデータベース負荷を示すグラフ。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/database-load-sliced.png)


**ディメンション項目に関する DB ロードの詳細**  
ディメンション内の DB ロード項目の詳細を表示するには、項目名にカーソルを合わせます。次の図は、クエリステートメントの詳細を示しています。

![\[項目名にカーソルを合わせてデータベースの負荷と追加の詳細を示す棒グラフ。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/database-load-details.png)


凡例で選択した期間に対する項目の詳細を表示するには、その項目にカーソルを合わせます。

![\[バーにカーソルを合わせてデータベースの負荷と追加の詳細を示す棒グラフ。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/database-load-hover.png)


## 上位のディメンションテーブル
<a name="performance-insights-overview-top-dimensions"></a>

**上位ディメンションテーブル**は、DB ロードを異なる次元でスライスします。ディメンションとは、DB ロードの異なる特性についてのカテゴリまたは「スライス化」のことです。ディメンションがクエリの場合、**上位のクエリ**は、DB ロードに最も寄与しているクエリステートメントを表示します。

以下のディメンションタブのいずれかを選択します。

![\[上位 2 つのクエリを示す上位クエリディメンションタブ。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/top-dimensions.png)


次の表では、各タブの簡単な説明を示します。


| タブ | 説明 | 
| --- | --- | 
|  上位待機  |   データベースバックエンドが待っているイベント  | 
|  上位のクエリ  |  現在実行中のクエリステートメント  | 
|  上位ホスト  |  接続されているクライアントのホスト IP  | 
|  上位データベース  |  プロキシが接続しているデータベースユーザーの名前  | 
|  上位アプリケーション  |  データベースに接続されたアプリケーションの名前。  | 

**[上位のクエリ]** タブを使用してクエリを分析する方法については、「[[上位のクエリ] タブの概要](performance-insights-top-queries.md)」を参照してください。

# Performance Insights ダッシュボードを開く
<a name="performance-insights-dashboard-opening"></a>

**AWS マネジメントコンソールで Performance Insights ダッシュボードを表示するには、次の手順を実行します。**

1. [https://console.aws.amazon.com/docdb/](https://console.aws.amazon.com/docdb/home#performance-insights) で Performance Insights コンソールを開きます。

1. DB インスタンスを選択します。その Amazon DocumentDB インスタンスの Performance Insights ダッシュボードが表示されます。

   Performance Insights を有効にした Amazon DocumentDB インスタンスでは、インスタンスのリストで **[セッション]** 項目を選択してダッシュボードにアクセスすることもできます。[**現在のアクティビティ**] の [**セッション**] 項目には、直近 5 分間におけるアクティブなセッションの平均データベースロードが表示されます。ロードはバーでグラフィカルに示されます。バーが空の場合、インスタンスはアイドル状態です。ロードが増加すると、バーが青色で塗りつぶされます。ロードがインスタンスクラスの仮想 CPU (vCPU) の数を超えると、バーが赤色になり、ボトルネックとなる可能性があることが示されます。  
![\[Amazon DocumentDB リージョンクラスターと、各クラスターインスタンスの CPU と現在のアクティビティを示すクラスターページ。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/opening-clusters.png)

1. (オプション) 右上のボタンを選択して、別の時間間隔を選択します。例えば、間隔を 1 時間に変更するには、**[1 時間]** を選択します。  
![\[5 分から 1 週間の範囲の時間間隔ボタン。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/opening-time.png)

   以下のスクリーンショットでは、DB ロードの間隔は 1 時間です。  
![\[平均アクティブセッションで測定されたデータベース負荷を示す棒グラフ。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/opening-db-load.png)

1. データを自動的に更新するには、**[自動更新]** を有効にします。  
![\[時間間隔ボタンの横に表示される、有効化された自動更新ボタン。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/opening-auto-refresh.png)

   Performance Insights ダッシュボードが自動的に新しいデータで更新されます。更新の頻度は、表示されるデータの量によって異なります。
   + 「5 分」は 5 秒ごとに更新されます。
   + 「1 時間」は 1 分ごとに更新されます。
   + 「5 時間」は 1 分ごとに更新されます。
   + 「24 時間」は 5 分ごとに更新されます。
   + 「1 週間」は 1 時間ごとに更新されます。

# 待機状態によるデータベースロードの分析
<a name="performance-insights-analyzing-db-load"></a>

**データベースロード (DB ロード)** のグラフにボトルネックが表示される場合、ロードの発生源を確認できます。これを実行するには、**データベースロード**グラフ下にある[上位ロード項目] テーブルを参照してください。クエリやアプリケーションのような特定の項目を選択すると、その項目をドリルダウンして詳細を表示できます。

待機および上位クエリによってグループ分けされた DB ロードは、通常、パフォーマンス問題に関する最も正しい情報を提供します。待機でグループ化された DB ロードは、データベースにリソースまたは同時のボトルネックがあるかどうかを示します。この場合、上位ロード項目のテーブルの **[上位のクエリ]** タブには、どのクエリがそのロードをかけているかが表示されます。

パフォーマンスの問題を診断するための一般的なワークフローは次のとおりです。

1. 「**データベースロード**」 グラフを確認し、**最大 CPU** ラインを超えているデータベースロードのインシデントがあるかどうかを確認します。

1. ある場合は、「**データベースロード**」 グラフを確認して、どの待機状態 (複数) が主に原因であるかを特定します。

1. 上位のロード項目テーブルの **[上位のクエリ]** タブが待機状態に最も影響しているクエリを確認することによって、ロードを引き起こすダイジェストクエリを特定します。これらは **[待機別ロード (AAS)]** 列で識別できます。

1. **[上位のクエリ]** タブでこれらのダイジェストクエリの 1 つを選択して展開し、構成されている子クエリを確認します。

また、**[上位のホスト]** または **[上位のアプリケーション]** をそれぞれ選択することで、どのホストまたはアプリケーションが最もロードを発生させているかを確認することもできます。アプリケーション名は Amazon DocumentDB インスタンスへの接続文字列で指定されます。`Unknown` は、アプリケーションフィールドが指定されなかったことを示します。

例えば、以下のダッシュボードで、**CPU** の待機はほとんどの DB ロードの主な原因となっています。**[上位のクエリ]** で上位クエリを選択すると、選択クエリによって発生しているロードが最も大きいことに焦点を当てるようにデータベースロードチャートが絞り込まれます。

![\[CPU 使用率のスパイクを示すデータベース負荷グラフ。対応する上位クエリタブには、待機状態に最も寄与するクエリが表示されます。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/db-load-1.png)


![\[待機状態に最も寄与するクエリの CPU 使用率の急増を示すデータベース負荷グラフ。対応する上位クエリタブには、クエリの子クエリが表示されます。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/db-load-2.png)


# [上位のクエリ] タブの概要
<a name="performance-insights-top-queries"></a>

デフォルトでは、**[上位のクエリ]** タブはデータベースロードに最も貢献しているクエリを表示します。クエリテキストを分析して、クエリの調整に役立てることができます。

**Topics**
+ [クエリダイジェスト](#performance-insights-top-queries-digests)
+ [待機によるロード (AAS)](#performance-insights-top-queries-aas)
+ [詳細なクエリ情報を表示します](#performance-insights-top-queries-query-info)
+ [ステートメントのクエリテキストへのアクセス](#performance-insights-top-queries-accessing-text)
+ [ステートメントのクエリテキストの表示とダウンロード](#performance-insights-top-queries-viewing-downloading)

## クエリダイジェスト
<a name="performance-insights-top-queries-digests"></a>

*クエリダイジェスト* は、構造的には類似しているが、異なるリテラル値を含む可能性の高い、複数の実際のクエリの複合体です。ダイジェストは、ハードコードされた値を疑問符に置き換えます。クエリダイジェストの例は次のようになります。

```
{"find":"customerscollection","filter":{"FirstName":"?"},"sort":{"key":{"$numberInt":"?"}},"limit":{"$numberInt":"?"}}
```

このダイジェストには、次の子クエリが含まれます。

```
{"find":"customerscollection","filter":{"FirstName":"Karrie"},"sort":{"key":{"$numberInt":"1"}},"limit":{"$numberInt":"3"}}
{"find":"customerscollection","filter":{"FirstName":"Met"},"sort":{"key":{"$numberInt":"1"}},"limit":{"$numberInt":"3"}}
{"find":"customerscollection","filter":{"FirstName":"Rashin"},"sort":{"key":{"$numberInt":"1"}},"limit":{"$numberInt":"3"}}
```

ダイジェスト内でリテラルクエリステートメントを表示するには、クエリを選択してからプラス記号 (`+`) を選択します。以下のスクリーンショットでは、選択されたクエリはダイジェストです。

![\[1 つの子クエリが選択された拡張クエリダイジェストを示す上位クエリテーブル。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/top-queries-literal.png)


**注記**  
クエリダイジェストでは、類似したクエリステートメントがグループ化されますが、機密情報は編集されません。

## 待機によるロード (AAS)
<a name="performance-insights-top-queries-aas"></a>

**[上位のクエリ]** の **[待機別のロード (AAS)]** 列は、上位の各ロード項目に関連付けられているデータベースロードの割合を示しています。この列には、**[DB ロードグラフ]** で現在選択されているグループ化に応じて、その項目に対するロードが反映されます。例えば、**DB ロードグラフ**を待機状態別にグループ化できます。この場合は、[**待機別の DB ロード**] バーは、クエリが貢献している待機状態の量を示すために、サイズ、セグメント、および色で分けられています。また、選択したクエリに影響を与えている待機状態も示されます。

![\[CPU、IO、ラッチ待機状態別にグループ化されたデータベース負荷を示す棒グラフ。対応するテーブルには、待機による負荷に基づく上位のクエリが表示されます。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/top-queries-aas.png)


## 詳細なクエリ情報を表示します
<a name="performance-insights-top-queries-query-info"></a>

**[上位のクエリ]** テーブルで、*ダイジェストステートメント*を開いてその情報を表示できます。下部のペインに情報が表示されます。

![\[選択したクエリステートメントと以下のそのクエリ情報を示す上位クエリテーブル。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/top-queries-detailed.png)


クエリステートメントに関連付けられているタイプの識別子 (ID) は以下のとおりです。

1. **サポートクエリ ID**: クエリ ID のハッシュ値。この値は、 AWS Support で作業しているときにクエリ ID を参照するためのものです。 AWS Support は実際のクエリ IDsとクエリテキストにアクセスできません。

1. **ダイジェスト ID のサポート** - ダイジェスト ID のハッシュ値。この値は、 AWS サポートで作業しているときにダイジェスト ID を参照するためのものです。 AWS サポートは実際のダイジェスト IDsとクエリテキストにアクセスできません。

## ステートメントのクエリテキストへのアクセス
<a name="performance-insights-top-queries-accessing-text"></a>

デフォルトでは、**[上位のクエリ]** テーブルの各行には各クエリステートメントごとに 500 バイトのクエリテキストが表示されます。ダイジェストステートメントのサイズが 500 バイトを超える場合、Performance Insights ダッシュボードでこのステートメントを開いて、テキストの表示量を増やすことができます。この場合、表示されるクエリの最大長は 1 KB です。フルクエリステートメントを表示する場合は、**[ダウンロード]** を選択することもできます。

## ステートメントのクエリテキストの表示とダウンロード
<a name="performance-insights-top-queries-viewing-downloading"></a>

Performance Insights ダッシュボードで、クエリテキストを表示およびダウンロードできます。

**Performance Insights ダッシュボードでクエリテキストの表示量を増やすには**

1. Amazon DocumentDB コンソールを、次の場所で開きます。[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb/) 

1. ナビゲーションペインで、[**Performance Insights**] を選択します。

1. DB インスタンスを選択します。この DB インスタンスに Performance Insights ダッシュボードが表示されます。

   500 バイトを超えるクエリステートメントは、次のように表示されます。  
![\[子クエリが選択された上位クエリテーブル。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/top-queries-statement.png)

1. クエリ情報セクションを調べて、クエリテキストをさらに表示します。  
![\[選択したクエリの全文を示すクエリ情報セクション。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/top-queries-query-text.png)

Performance Insights ダッシュボードは、各フルクエリステートメントで最大 1 KB までを表示できます。

**注記**  
クエリステートメントをコピーまたはダウンロードするには、ポップアップブロッカーを無効にします。

# データベースロードグラフのズームイン
<a name="performance-insights-zoom-db-load"></a>

Performance Insights のユーザーインターフェイスの他の機能を使用して、パフォーマンスデータを分析できます。

**クリックアンドドラッグしてズームイン**  
Performance Insights のインターフェイスでは、ロードグラフの小さな部分を選択して、詳細をズームインすることができます。

![\[その一部がズームイン用に強調表示されている、データベース負荷を示す棒グラフ。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/pi-zoom-1.png)


ロードグラフの一部を拡大するには、スタート時間を選択し、目的の期間の最後までドラッグします。これを行うと、選択した領域が強調表示されます。マウスを離すと、選択したエリアのロードグラフがズームインされ、**上位*項目*** テーブルが再計算されます。

![\[以下の対応する上位待機数テーブルがある、ズームインした部分を示すデータベースロード棒グラフ。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/performance-insights/pi-zoom-2.png)