

# Amazon RDS インスタンスでのメトリクスのモニタリング
<a name="CHAP_Monitoring"></a>

以下のセクションで、Amazon RDS のモニタリングの概要とメトリクスへのアクセス方法の説明を示します。イベント、ログ、およびデータベースアクティビティストリームをモニタリングする方法については、「[Amazon RDS DB インスタンスでの、イベント、ログ、およびストリーミングのモニタリング](CHAP_Monitor_Logs_Events.md)」を参照してください。

**Topics**
+ [モニタリング計画](#MonitoringOverview.plan)
+ [パフォーマンスのベースライン](#MonitoringOverview.baseline)
+ [パフォーマンスガイドライン](#MonitoringOverview.guidelines)
+ [Amazon RDS のモニタリングツール](MonitoringOverview.md)
+ [インスタンスのステータスの表示](accessing-monitoring.md)
+ [Amazon RDS の推奨事項](monitoring-recommendations.md)
+ [Amazon RDS コンソールでのメトリクスの表示](USER_Monitoring.md)
+ [Performance Insights ダッシュボードを使用して組み合わせたメトリクスを表示する](Viewing_Unifiedmetrics.md)
+ [Amazon CloudWatch を使用した Amazon RDS メトリクスのモニタリング](monitoring-cloudwatch.md)
+ [CloudWatch Database Insights による Amazon RDS データベースのモニタリング](USER_DatabaseInsights.md)
+ [Amazon RDS での Performance Insights を使用したDB 負荷のモニタリング](USER_PerfInsights.md)
+ [Amazon DevOps Guru for Amazon RDS でパフォーマンスの異常を分析する](devops-guru-for-rds.md)
+ [拡張モニタリングを使用した OS メトリクスのモニタリング](USER_Monitoring.OS.md)
+ [Amazon RDS のメトリクスリファレンス](metrics-reference.md)

## モニタリング計画
<a name="MonitoringOverview.plan"></a>

Amazon RDS のモニタリングをスタートする前に、モニタリングプランを作成します。この計画で、以下の質問に答えるようにします。
+ どのような目的でモニタリングしますか?
+ どのリソースをモニタリングしますか?
+ どのくらいの頻度でこれらのリソースをモニタリングしますか?
+ どのモニタリングツールを使用しますか?
+ 誰がモニタリングタスクを実行しますか?
+ 問題が発生したときに誰に通知しますか?

## パフォーマンスのベースライン
<a name="MonitoringOverview.baseline"></a>

モニタリング目標を達成するには、ベースラインを確立する必要があります。これを行うには、Amazon RDS 環境で負荷条件と時期をさまざまに変えてパフォーマンスを測定します。次のようなメトリクスをモニタリングできます。
+ ネットワークスループット
+ クライアント接続
+ 読み取り、書き込み、メタデータのいずれかのオペレーションの I/O
+ DB インスタンスのバーストクレジットバランス

Amazon RDS の履歴パフォーマンスデータを保存することをお勧めします。保存したデータを使用して、現在のパフォーマンスを過去の傾向と比較できます。また、正常なパフォーマンスパターンを異常から区別し、問題に対処するための方法を考案することもできます。

## パフォーマンスガイドライン
<a name="MonitoringOverview.guidelines"></a>

一般的に、パフォーマンスメトリクスの許容値は、ベースラインに対してアプリケーションの現在の動作によって異なります。ベースラインからの一貫した差異またはトレンドになっている差異を調べます。多くの場合、次のメトリクスがパフォーマンスの問題の原因を示しています。
+  **CPU または RAM の高消費量** - CPU または RAM の消費量が大きい値になっていても、それは妥当である場合があります。ただし、アプリケーションの目標 (スループット、同時実行数など) に沿った想定値であることが前提です。
+  **ディスクスペースの消費量 - ** 使用されているディスクスペースが一貫して合計ディスクスペースの 85% 以上である場合は、ディスクスペースの消費量を調べます。インスタンスからデータを削除するか、別のシステムにデータをアーカイブして、スペースを解放できるかどうかを確認します。
+  **ネットワークトラフィック** - ネットワークトラフィックについてシステム管理者に問い合わせて、ドメインネットワークとインターネット接続に対する想定スループットを把握します。スループットが一貫して想定よりも低い場合は、ネットワークトラフィックを調べます。
+  **データベース接続数** - ユーザー接続数が多いことが、インスタンスのパフォーマンスが下がっていること、応答時間が長くなっていることに関連しているとわかった場合、データベース接続数を制限することを検討します。DB インスタンスの最適なユーザー接続数は、インスタンスのクラスと実行中のオペレーションの複雑さによって異なります。データベース接続数を確認するには、`User Connections` パラメータが 0 (無制限) 以外の値に設定されているパラメータグループと DB インスタンスを関連付けます。既存のパラメータグループを使用するか、新しいパラメータグループを作成できます。詳細については、「[Amazon RDS のパラメータグループ](USER_WorkingWithParamGroups.md)」を参照してください。
+  **IOPS メトリクス - ** IOPS メトリクスの想定値はディスクの仕様とサーバーの設定によって異なるため、ベースラインを使用して一般的な値を把握します。値とベースラインとの差が一貫しているかどうかを調べます。最適な IOPS パフォーマンスを得るには、読み取りおよび書き込みオペレーションが最小限になるように、一般的な作業セットがメモリに収まることを確認してください。

確立したベースラインをパフォーマンスが下回ると、場合によって、ワークロードに対してデータベースの可用性を最適化するために変更を加える必要があります。例えば、DB インスタンスのインスタンスクラスの変更が必要になる場合があります。または、クライアントで使用できる DB インスタンスとリードレプリカの数の変更が必要になる場合があります。

# Amazon RDS のモニタリングツール
<a name="MonitoringOverview"></a>

モニタリングは、Amazon RDS およびその他の AWS ソリューションの信頼性、可用性、およびパフォーマンスを維持する上で重要な部分です。AWS には、Amazon RDS を監視したり、問題が発生したときに報告したり、必要に応じて自動アクションを実行したりするためのモニタリングツールが用意されています。

**Topics**
+ [自動モニタリングツール](#MonitoringOverview.tools.automated)
+ [手動モニタリングツール](#monitoring_manual_tools)

## 自動モニタリングツール
<a name="MonitoringOverview.tools.automated"></a>

モニタリングタスクをできるだけ自動化することをお勧めします。

**Topics**
+ [Amazon RDS インスタンスステータスと推奨事項](#MonitoringOverview.tools.automated.rds)
+ [Amazon RDS の Amazon CloudWatch メトリクス](#MonitoringOverview.tools.automated.integrated)
+ [Amazon RDS Performance Insights とオペレーティングシステムのモニタリング](#MonitoringOverview.tools.automated.metrics.rds)
+ [統合サービス](#MonitoringOverview.tools.automated.integrated.events-logs-streams)

### Amazon RDS インスタンスステータスと推奨事項
<a name="MonitoringOverview.tools.automated.rds"></a>

以下の自動化されたツールを使用して、Amazon RDS をモニタリングし、問題が発生したときにレポートできます。
+ **Amazon RDS インスタンスステータス** – Amazon RDS コンソール、AWS CLI、または RDS API を使用して、インスタンスの現在のステータスに関する詳細を表示します。
+ **Amazon RDS 推奨事項** — DB インスタンス、、リードレプリカ、DB パラメータグループなどのデータベースリソースに関する推奨事項が自動的に表示されます。詳細については、「[Amazon RDS の推奨事項](monitoring-recommendations.md)」を参照してください。

### Amazon RDS の Amazon CloudWatch メトリクス
<a name="MonitoringOverview.tools.automated.integrated"></a>

Amazon RDS が Amazon CloudWatch と統合し、追加のモニタリング機能が利用できるようになりました。
+ **Amazon CloudWatch** - このサービスは AWS で実行されている AWS リソースやアプリケーションをリアルタイムにモニタリングします。次の Amazon CloudWatch 機能を Amazon RDS で使用できます。
  + **Amazon CloudWatch メトリクス** - Amazon RDS は、アクティブな各データベースのメトリクスを 1 分ごとに CloudWatch に自動送信します。CloudWatch の Amazon RDS メトリクスに対する追加料金は発生しません。詳細については、[Amazon CloudWatch を使用した Amazon RDS メトリクスのモニタリング](monitoring-cloudwatch.md)を参照してください。
  + **Amazon CloudWatch アラーム** - 特定の期間にわたって 1 つの Amazon RDS メトリクスをモニタリングできます。そのため、設定したしきい値に関連するメトリクスの値に基づいて、1 つ以上のアクションを実行できます。詳細については、「[Amazon CloudWatch を使用した Amazon RDS メトリクスのモニタリング](monitoring-cloudwatch.md)」を参照してください。

### Amazon RDS Performance Insights とオペレーティングシステムのモニタリング
<a name="MonitoringOverview.tools.automated.metrics.rds"></a>

Amazon RDS のパフォーマンスをモニタリングするには、次の自動化されたツールを使用します。
+ **Amazon RDS Performance Insights** – データベース負荷を評価し、いつどこに措置を講じたらよいかを判断します。詳しくは、「[Amazon RDS での Performance Insights を使用したDB 負荷のモニタリング](USER_PerfInsights.md)」を参照してください。
+ **Amazon RDS 拡張モニタリング** – オペレーティングシステムのメトリクスをリアルタイムで参照します。詳しくは、「[拡張モニタリングを使用した OS メトリクスのモニタリング](USER_Monitoring.OS.md)」を参照してください。

### 統合サービス
<a name="MonitoringOverview.tools.automated.integrated.events-logs-streams"></a>

次の AWS のサービスが Amazon RDS と統合されます。
+ *Amazon EventBridge* は、アプリケーションをさまざまなソースのデータに簡単に接続できるようにするサーバーレスイベントバスサービスです。詳しくは、「[Amazon RDS イベントのモニタリング](working-with-events.md)」を参照してください。
+ *Amazon CloudWatch Logs* を使用すると、Amazon RDS  インスタンス、CloudTrail、およびその他のソースからのログファイルをモニタリングして保存し、それらにアクセスすることができます。詳しくは、「[Amazon RDS ログファイルのモニタリング](USER_LogAccess.md)」を参照してください。
+ *AWS CloudTrail* は、AWS アカウント により、またはそのアカウントに代わって行われた API コールや関連イベントを取得し、指定した Amazon S3 バケットにログファイルを配信します。詳しくは、「[AWS CloudTrail での Amazon RDS API コールのモニタリング](logging-using-cloudtrail.md)」を参照してください。
+ *データベースアクティビティストリーミング*は、Amazon RDS  の一機能であり、Oracle DB インスタンス内のアクティビティのストリーミングをほぼリアルタイムで提供します。詳しくは、「[データベースアクティビティストリームを使用した Amazon RDS のモニタリング](DBActivityStreams.md)」を参照してください。

## 手動モニタリングツール
<a name="monitoring_manual_tools"></a>

CloudWatch アラームがカバーしない項目については、手動でモニタリングする必要があります。Amazon RDS、CloudWatch、AWS Trusted Advisor などの AWS コンソールダッシュボードには、AWS 環境の状態が一目でわかるビューが表示されます。また、DB インスタンスのログファイルを確認することをお勧めします。
+ Amazon RDS コンソールから、リソースに関する以下の項目をモニタリングできます。
  + DB インスタンスへの接続の数
  + DB インスタンスへの読み書きオペレーションの量
  + DB インスタンスが現在使用しているストレージの量
  + DB インスタンスに使用されているメモリと CPU の量
  + DB インスタンスとの間で送受信されるネットワークトラフィックの量
+ Trusted Advisor ダッシュボードから、以下のコスト最適化、セキュリティ、対障害性、パフォーマンス向上のチェックを確認できます。
  + Amazon RDS アイドル DB インスタンス
  + Amazon RDS セキュリティグループのアクセスリスク
  + Amazon RDS バックアップ
  + Amazon RDS Multi-AZ

  これらのチェックの詳細については、「[Trusted Advisor のベストプラクティス (チェック)](https://aws.amazon.com/premiumsupport/trustedadvisor/best-practices/)」を参照してください。
+ CloudWatch ホームページには、次の内容が表示されます。
  + 現在のアラームとステータス
  + アラームとリソースのグラフ
  + サービスのヘルスステータス

  また、CloudWatch を使用して、次のことが可能です。
  + 重視するサービスをモニタリングするための[カスタマイズしたダッシュボード](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/CloudWatch_Dashboards.html)を作成する。
  + メトリクスデータをグラフ化して、問題をトラブルシューティングして、傾向を確認する。
  + AWS リソースのすべてのメトリクスを検索およびブラウズする。
  + 問題があることを通知するアラームを作成/編集する。

# インスタンスのステータスの表示
<a name="accessing-monitoring"></a>

Amazon RDS コンソールを使用すると、DB インスタンスのステータスにすばやくアクセスできます。

**Topics**
+ [Amazon RDS DB インスタンスのステータスの表示](#Overview.DBInstance.Status)

## Amazon RDS DB インスタンスのステータスの表示
<a name="Overview.DBInstance.Status"></a>

の DB インスタンスのステータスは、現在の運用状態を示します。次の手順で、Amazon RDS コンソール、AWS CLI コマンド、または API オペレーションで DB インスタンスのステータスを表示できます。

**注記**  
Amazon RDS では、*メンテナンスのステータス*と呼ばれる別のステータスも使用します。これは、Amazon RDS コンソールの [**メンテナンス**] 列に表示されます。この値は、DB インスタンスに適用する必要があるメンテナンスパッチのステータスを示します。メンテナンスのステータスは、DB インスタンスのステータスから独立しています。メンテナンスのステータスの詳細については、「[DB インスタンスへの更新の適用](USER_UpgradeDBInstance.Maintenance.md#USER_UpgradeDBInstance.OSUpgrades)」を参照してください。

DB インスタンスの考えられるステータス値を以下の表に示します。また、この表は、DB インスタンスとストレージが請求されるか、ストレージのみ請求されるか、または請求されないかを示します。DB インスタンスのすべてのステータスで、バックアップの使用は常に請求されます。


| DB インスタンスのステータス | 請求される  | 説明 | 
| --- | --- | --- | 
|  **使用可能**  |  請求対象  |  DB インスタンスは変更可能です。  | 
|  **バックアップ中**  |  請求される  |  DB インスタンスを現在バックアップ中です。  | 
|  **拡張モニタリングを設定中**  |  請求される  |  この DB インスタンスに対して拡張モニタリングを有効または無効にしています。  | 
|  **iam データベース認証を設定中**  |  請求される  |  AWS Identity and Access Managementこの DB インスタンスに対して (IAM) データベース認証を有効または無効にしています。  | 
|  **ログエクスポートを設定中**  |  請求される  |  この DB インスタンスに対して Amazon CloudWatch Logs へのログファイルの発行を有効または無効にしています。  | 
|  **vpc に変換中**  |  請求される  |  DB インスタンスを、Amazon Virtual Private Cloud (Amazon VPC) 外の DB インスタンスから Amazon VPC 内の DB インスタンスに変換中です。  | 
|  **作成中**  |  請求されない (PITR 以外) 請求される (PITR のみ)  |  DB インスタンスを作成中です。作成中の DB インスタンスにはアクセスできません。 ポイントインタイムリカバリ (PITR) 中にデータベースを復元する場合、データベースが**作成中**状態の間は課金されます。これは、**作成中**状態で料金が発生する唯一のシナリオです。  | 
|  **削除の事前チェック**  |  非請求対象  |  Amazon RDS は、リードレプリカを削除しても安全かどうかを検証しています。  | 
|  **削除中**  |  課金されない  |  DB インスタンスを削除しています。  | 
|  **「失敗**」  |  課金されない  |  DB インスタンスでエラーが発生し、Amazon RDS では復旧できません。DB インスタンスの復元可能な直近の時間までポイントインタイムリカバリを実行し、データを復旧してください。  | 
|  **暗号化認証情報にアクセスできません**  |  非請求対象  |  DB インスタンスの暗号化または復号に使用する AWS KMS key にアクセスしたり、それを復元したりすることはできません。  | 
|  **inaccessible-encryption-credentials-recoverable**  |  ストレージが請求対象  |  DB インスタンスの暗号化または復号に使用する KMS キーにアクセスできません。ただし、KMS キーがアクティブな場合は、DB インスタンスを再起動すると復元できます。 詳細については、「[DB インスタンスの暗号化](Overview.Encryption.md#Overview.Encryption.Enabling)」を参照してください。  | 
|  **互換性がない、作成**  |  非請求対象  |  Amazon RDS は DB インスタンスを作成しようとしていますが、リソースが DB インスタンスと互換性がないため、作成できません。このステータスは、例えば DB インスタンスのインスタンスプロファイルに適切なアクセス許可がない場合に発生する可能性があります。  | 
|  **互換性のないネットワーク**  |  課金されない  |  Amazon RDS は、DB インスタンスに対して復旧アクションを実行しようとしていますが、VPC がアクションを完了できない状態にあるため実行できません。このステータスは、例えば、サブネット内の使用可能なすべての IP アドレスが使用中で、Amazon RDS が DB インスタンスの IP アドレスを取得できない場合などに発生する可能性があります。  | 
|  **互換性のないオプショングループ**  |  請求される  |  Amazon RDS がオプショングループの変更を適用しようとしましたが、適用できませんでした。また、Amazon RDS はオプショングループの前の状態にロールバックできませんでした。詳細については、DB インスタンスの [**最近のイベント**] 一覧を参照してください。このステータスは、例えば、オプショングループに TDE などのオプションが含まれており、DB インスタンスに暗号化情報が含まれていない場合などに発生する可能性があります。  | 
|  **互換性のないパラメータ**  |  請求される  |  DB インスタンスの DB パラメータグループに指定されたパラメータが DB インスタンスと互換性がないため、Amazon RDS は DB インスタンスを起動できません。パラメータの変更を元に戻すか、パラメータを DB インスタンスと互換させて、DB インスタンスへのアクセスを回復してください。互換性のないパラメータの詳細については、DB インスタンスの [**最近のイベント**] 一覧を参照してください。  | 
|  **互換性のない復元**  |  課金されない  |  Amazon RDS は、特定の時点への復旧を行うことはできません。この状況の一般的な原因としては、temp テーブルの使用、MySQL での MyISAM テーブルの使用、または MariaDB での Aria テーブルの使用が考えられます。  | 
| insufficient-capacity |  非請求対象  |  十分な容量が現在利用できないため、Amazon RDS はインスタンスを作成できません。同じ AZ に、同じインスタンスタイプで DB インスタンスを作成するには、DB インスタンスを削除し、数時間待ってから、もう一度作成を試みます。または、別のインスタンスクラスまたは AZ を使用して新しいインスタンスを作成します。  | 
|  **メンテナンス**  |  請求される  |  Amazon RDS は、DB インスタンスにメンテナンス更新を適用しています。このステータスは、RDS が事前に十分スケジュールしたインスタンスレベルのメンテナンスに使用されます。  | 
|  **変更中**  |  請求される  |  ユーザーからの DB インスタンスの変更リクエストに応じて、DB インスタンスを変更中です。  | 
|  **vpc に移動中**  |  請求される  |  DB インスタンスを新しい Amazon Virtual Private Cloud (Amazon VPC) に移動中です。  | 
|  **再起動**  |  請求される  |  DB インスタンスの再起動を要求するユーザーのリクエストまたは Amazon RDS プロセスに応じて、インスタンスを再起動中です。  | 
|  **マスター認証をリセット中**  |  請求される  |  ユーザーからのリセットのリクエストに応じて、DB インスタンスのマスター認証情報をリセット中です。  | 
|  **名前変更中**  |  請求される  |  ユーザーからの名前変更のリクエストに応じて、DB インスタンスの名前を変更中です。  | 
|  **復元エラー**  |  請求される  |  特定時点への復元またはスナップショットからの復元を実行しようとした際に、DB インスタンスでエラーが発生しました。  | 
|  **スタート中**  |  ストレージが請求対象  |  DB インスタンスを起動中です。  | 
|  **停止済み**  |  ストレージが請求対象  |  DB インスタンスは停止済みです。  | 
|  **停止**  |  ストレージが請求対象  |  DB インスタンスを停止中です。  | 
|  **ストレージ設定をアップグレード**  |  請求対象  |  DB インスタンスのストレージファイルシステム設定をアップグレード中です。このステータスはブルー/グリーンデプロイ内のグリーンデータベース、または DB インスタンスのリードレプリカにのみ適用されます。  | 
|  **ストレージ不足**  |  請求される  |  DB インスタンスが、ストレージ容量の割り当て分に達しました。これは非常に重要なステータスで、この問題はすぐに修正することをお勧めします。これを行うには、DB インスタンスを変更してストレージを拡張します。このような状況を回避するために、ストレージ容量が減少したときに警告を生成する Amazon CloudWatch アラームを設定します。  | 
| ストレージの初期化 |  請求対象  |  DB インスタンスは、スナップショットから復元された後のボリュームパフォーマンスを最適化するために、Amazon S3 からデータブロックをロードしています。オペレーションで引き続き使用できますが、初期化が完了するまでパフォーマンスが最大にならない可能性があります。  | 
|  **ストレージの最適化**  |  請求対象  |  Amazon RDS が、DB インスタンスのストレージを最適化しています。ストレージ最適化プロセスは通常短時間で終了しますが、場合によっては 24 時間以上かかることもあります。 ストレージの最適化中、DB インスタンスは引き続き使用できます。ストレージの最適化は、インスタンスの可用性に影響を与えないバックグラウンドプロセスです。  | 
|  **アップグレード**  |  請求対象  |  データベースエンジンまたはオペレーティングシステムのバージョンをアップグレード中です。  | 
|  **upgrade\$1failed**  |  非請求対象  |  DB インスタンスをサポートされているバージョンにアップグレードできませんでした。Aurora は、プレフィックス `rds-final` を持つ最終スナップショットを作成します。  | 

### コンソール
<a name="DBinstance.Status.Console"></a>

**DB インスタンスのステータスを表示するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. ナビゲーションペインで、**データベース** を選択します。

   **データベースページ**が DB インスタンスのリストとともに表示されます。 DB クラスターごとに、ステータス値が表示されます。  
![\[DB インスタンスのステータスを表示する\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/RDS_instance_status.png)

### CLI
<a name="DBinstance.Status.Cli"></a>

AWS CLI を使用して DB インスタンスとそのステータス情報を表示するには、[describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) コマンドを使用します。例えば、次の AWS CLI コマンドは、すべての DB インスタンス情報を一覧表示します。

```
aws rds describe-db-instances
```

特定の DB インスタンスとそのステータスを表示するには、次のオプションを指定して [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) コマンドを呼び出します。
+ `DBInstanceIdentifier` ​- DB インスタンスの名前です。

```
aws rds describe-db-instances --db-instance-identifier mydbinstance
```

DB インスタンスのステータスだけを表示するには、AWS CLI で次のクエリを使用します。

```
aws rds describe-db-instances --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceStatus]' --output table
```

### API
<a name="DBinstance.Status.Api"></a>

Amazon RDS API を使用して DB インスタンスのステータスを表示するには、[DescribeDBInstances](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html) オペレーションを呼び出します。

# Amazon RDS の推奨事項
<a name="monitoring-recommendations"></a>

Amazon RDS では、DB インスタンス、リードレプリカ、DB パラメータグループなどのデータベースリソースについての推奨事項が自動で表示されます。これらの推奨事項は、、DB インスタンス構成、使用状況、パフォーマンスデータを分析して、ベストプラクティスガイダンスを提供します。

Amazon RDS Performance Insights は特定のメトリクスを監視し、特定のリソースで潜在的に問題であると見なされるレベルを分析することで自動的にしきい値を作成します。新しいメトリクス値が事前定義されたしきい値を一定期間にわたって超えた場合に、Performance Insights は事前対応型推奨事項を生成します。この推奨事項は、将来のデータベースパフォーマンスへの影響を防ぐのに役立ちます。例えば、データベースに接続されているセッションがアクティブな作業を行っていないが、データベースリソースがブロックされている可能性がある場合、RDS for PostgreSQL インスタンスに対して「トランザクションでのアイドル状態」という推奨事項が生成されます。事前対応型推奨事項を受け取るには、有料利用枠の保持期間を使用して Performance Insights を有効にする必要があります。Performance Insights を有効にする方法については、「[Amazon RDS の Performance Insights の有効化と無効化](USER_PerfInsights.Enabling.md)」を参照してください。Performance Insights の料金とデータ保持については、「[Performance Insights の料金とデータ保持](USER_PerfInsights.Overview.cost.md)」を参照してください。

DevOps Guru for RDS は特定のメトリクスを監視して、メトリクスの動作が非常に異常または異常になったことを検出します。これらの異常は、推奨事項を含む事後対応型インサイトとして報告されます。例えば、DevOps Guru for RDS は、CPU 容量の増加を検討したり、DB ロードに寄与している待機イベントを調査するよう推奨することがあります。DevOps Guru for RDS は、しきい値ベースの事前対応型推奨事項も提供します。これらの推奨事項を受け取るには、DevOps Guru for RDS を有効にする必要があります。DevOps Guru for RDS を有効にする方法については、「[DevOps Guru をオンにしてリソースカバレッジを指定する](devops-guru-for-rds.md#devops-guru-for-rds.configuring.coverage)」を参照してください。

推奨事項のステータスは、アクティブ、却下、保留中、解決済みのいずれかになります。解決済みの推奨事項は 365 日間利用できます。

推奨事項は、表示または却下できます。設定ベースのアクティブな推奨事項をすぐに適用したり、次のメンテナンスウィンドウでスケジュールしたり、却下したりできます。しきい値ベースの事前対応型推奨事項と機械学習ベースの事後対応型推奨事項については、推奨される問題の原因を確認し、推奨アクションを実行して問題を解決する必要があります。

推奨事項は、以下の AWS リージョンでサポートされています。
+ 米国東部(オハイオ)
+ 米国東部 (バージニア北部)
+ 米国西部 (北カリフォルニア)
+ 米国西部 (オレゴン)
+ アジアパシフィック (ムンバイ)
+ アジアパシフィック (ソウル)
+ アジアパシフィック (シンガポール)
+ アジアパシフィック (シドニー)
+ アジアパシフィック (東京)
+ カナダ (中部)
+ 欧州 (フランクフルト)
+ 欧州 (アイルランド)
+ 欧州 (ロンドン)
+ 欧州 (パリ)
+ 欧州 (ストックホルム)
+ 南米 (サンパウロ)

Amazon RDS の推奨事項を表示、適用、却下、および変更する方法については、以下のセクションを参照してください。。

**Topics**
+ [Amazon RDS の推奨事項の表示](UserRecommendationsView.md)
+ [Amazon RDS の推奨事項の適用](USERRecommendationsManage.ApplyRecommendation.md)
+ [Amazon RDS の推奨事項の却下](USERRecommendationsManage.DismissRecommendation.md)
+ [却下された Amazon RDS 推奨事項のアクティブな推奨事項への変更](USERRecommendationsManage.DismissToActiveRecommendation.md)
+ [Amazon RDS からの推奨事項のリファレンス](USERRecommendationsManage.RecommendationReference.md)

# Amazon RDS の推奨事項の表示
<a name="UserRecommendationsView"></a>

Amazon RDS コンソールを使用して、データベースリソースに関する Amazon RDS の推奨事項を表示できます。

## コンソール
<a name="UserRecommendationsView.Con"></a>

**Amazon RDS の推奨事項を表示するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. ナビゲーションペインで、次のいずれかを実行します。
   + **[レコメンデーション]** を選択します。リソースに対するアクティブな推奨事項の数と、前の月に生成された重要度が最も高い推奨事項の数は、**[レコメンデーション]** の横に表示されます。重要度ごとにアクティブな推奨事項の数を確認するには、最も重要度が高い番号を選択します。  
![\[コンソールでの推奨事項の選択\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/recommendations-select.png)

     デフォルトでは、**[レコメンデーション]** ページには前の月の新しい推奨事項のリストが表示されます。Amazon RDS は、アカウント内のすべてのリソースの推奨事項を提供し、重要度でソートします。  
![\[すべての推奨事項を含むコンソールの [メイン推奨事項] ページ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Recommendations_List.png)

     推奨事項を選択すると、ページの下部に、影響を受けるリソースと推奨事項の適用方法の詳細を含むセクションが表示されます。
   + **[データベース]** ページで、リソースの **[レコメンデーション]** を選択します。  
![\[コンソールの [データベース] ページで選択した推奨事項オプション\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Recommendations_DBpage.png)

     **[レコメンデーション]** タブには、選択したリソースの推奨事項とその詳細が表示されます。  
![\[コンソールの [データベース] ページの [レコメンデーション] タブ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/RecommendationsTab_DBpage.png)

   推奨事項には以下の詳細があります。
   + **[重要度]** — 問題の意味するレベル。重要度レベルは、**[高]**、**[中]**、**[低]**、および **[情報]** です。
   + **[検出]** — 影響を受けるリソースの数と問題の簡単な説明。このリンクを選択すると、推奨事項と分析の詳細が表示されます。
   + **[レコメンデーション]** — 適用する推奨事項アクションの簡単な説明。
   + **[影響]** — 推奨事項が適用されない場合に発生する可能性のある影響の簡単な説明。
   + **[カテゴリ]** – 推奨事項のタイプ。カテゴリは、**[パフォーマンス効率]**、**[セキュリティ]**、**[信頼性]**、**[コスト最適化]**、**[運用上の優秀性]**、**[持続可能性]**です。
   + **[ステータス]** – ターゲットエンジンの推奨事項のステータス 指定できるステータスは、**[すべて]**、**[アクティブ]**、**[却下済み]**、**[解決済み]**、**[保留中]** です。
   + **[開始時刻]** – 問題が開始された時刻。例えば、**18 時間前**と指定します。
   + **[最終更新日]** – **[重要度]** の変更により推奨事項がシステムによって最後に更新された時刻、または推奨事項に応答した時刻。例えば、**10 時間前**と指定します。
   + **[終了時刻]** – 問題が終了した時刻。時間には、継続中の問題は表示されません。
   + **[リソース識別子]** – 1 つ以上のリソースの名前。

1. (オプション) フィールドで **[重要度]** または **[カテゴリ]** 演算子を選択して、推奨事項のリストをフィルタリングします。  
![\[コンソールの重要度オペレーションを含む [レコメンデーション] ページ。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Recommendations_Severity.png)

   選択したオペレーションの推奨事項が表示されます。

1. (オプション) 次のいずれかの推奨事項ステータスを選択します。
   + **[アクティブ]** (デフォルト) - 次のメンテナンスウィンドウで適用、スケジュール設定できるか、または却下できる現在の推奨事項が表示されます。
   + **[すべて]** – 現在のステータスのすべての推奨事項を表示します。
   + **[却下済み]** – 却下された推奨事項を表示します。
   + **[解決済み]** — 解決済みの推奨事項を表示します。
   + **[保留中]** — 推奨アクションが進行中であるか、次のメンテナンスウィンドウにスケジュールされている推奨事項を表示します。  
![\[コンソールのステータスでフィルタリングされた推奨事項\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Recommendations_Status.png)

1. (オプション) **[最終更新日]** の **[相対モード]** または **[絶対モード]** を選択して期間を変更します。**[レコメンデーション]** ページには、期間中に生成された推奨事項が表示されます。デフォルトの期間は過去 1 か月です。**[絶対モード]** では、期間を選択するか、**[開始日]** フィールドと **[終了日]** フィールドに時刻を入力できます。  
![\[コンソールで期間別にフィルタリングされた推奨事項\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Recommendations_TimeMode.png)

   設定された期間表示の推奨事項。

   範囲を **[すべて]** に設定することで、アカウント内のリソースに関するすべての推奨事項を表示できます。

1. (オプション) 右側の **[詳細設定]** を選択して、表示する詳細をカスタマイズします。ページサイズを選択し、テキストの行を折り返して、列を許可または非表示にすることができます。

1. (オプション) 推奨事項を選択し、**[詳細を表示]** を選択します。  
![\[選択した推奨事項とビューの詳細ボタンが選択されているコンソールの [レコメンデーション] ページ。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Recommendations_viewDetailsSelect.png)

   推奨事項の詳細ページが表示されます。タイトルには、問題が検出されたリソースの総数と重要度が表示されます。

   異常ベースの事後推奨事項の詳細ページにあるコンポーネントについては、*Amazon DevOps Guru ユーザーガイド* 「[事後対応型異常を表示する](https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-rds.analyzing.metrics.html)」を参照してください。

   しきい値ベースのプロアクティブ推奨事項の詳細ページのコンポーネントについては、「」を参照してください[Performance Insights のプロアクティブ推奨事項の表示](USER_PerfInsights.InsightsRecommendationViewDetails.md)。

   その他の自動推奨事項では、推奨事項の詳細ページに次のコンポーネントが表示されます。
   + **推奨事項** — 推奨事項の概要と、推奨事項を適用するためにダウンタイムが必要かどうか。  
![\[コンソールの「推奨事項」セクションを示す推奨事項の詳細ページ。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/RecommendationSummary.png)
   + **[影響を受けるリソース]** — 影響を受けるリソースの詳細。  
![\[コンソールの [影響を受けるリソース￥] セクションを示す推奨事項の詳細ページ。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Recommendations_AffectedResources.png)
   + **推奨事項の詳細** – サポートされるエンジン情報、推奨事項を適用するために必要な関連コスト、および詳細情報を確認するためのドキュメントリンク。  
![\[コンソールの「推奨事項の詳細」セクションを示す推奨事項の詳細ページ。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/RecommendationDetails.png)

## CLI
<a name="UserRecommendationsView.Cli"></a>

DB インスタンスの Amazon RDS の推奨事項を表示するには、AWS CLI で次のコマンドを使用します。

```
aws rds describe-db-recommendations
```

## RDS API
<a name="UserRecommendationsView.API"></a>

Amazon RDS API を使用して Amazon RDS の推奨事項を表示するには、[DescribeDBRecommendations](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBRecommendations.html) オペレーションを使用します。

# Amazon RDS の推奨事項の適用
<a name="USERRecommendationsManage.ApplyRecommendation"></a>

Amazon RDS コンソールを使用して Amazon RDS 推奨事項を適用するには、詳細ページで設定ベースの推奨事項または影響を受けるリソースを選択します。次に、推奨事項をすぐに適用するか、次のメンテナンスウィンドウにスケジュールするかを選択します。(これらの変更を有効にするには、クラスターの再起動が必要な場合があります。) いくつかの DB パラメータグループの推奨事項については、リソースの再起動が必要になる場合があります。

しきい値ベースの事前対応型推奨事項または異常ベースの事後対応型推奨事項には適用オプションがないため、追加のレビューが必要になる場合があります。

## コンソール
<a name="USERRecommendationsManage.ApplyRecommendation-Console"></a>

**設定ベースの推奨事項を適用するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. ナビゲーションペインで、次のいずれかを実行します。
   + **[レコメンデーション]** を選択します。

     **[レコメンデーション]** ページには、すべての推奨事項のリストが表示されます。
   + **[データベース]** を選択し、データベースページでリソースの **[レコメンデーション]** を選択します。

     詳細は、選択した推奨事項の **[レコメンデーション]** タブに表示されます。
   + **[レコメンデーション]** ページでアクティブな推奨事項の **[検出]**、または **[データベース]** ページの **[レコメンデーション]** タブを選択します。

     推奨事項の詳細ページが表示されます。

1. 推奨事項、または推奨事項の詳細ページで影響を受ける 1 つ以上のリソースを選択し、次のいずれかを実行します。
   + **[適用]** を選択し、**[今すぐ適用]** を選択して、すぐに推奨事項を適用します。
   + **[適用]** を選択し、次に **[次のメンテナンスウィンドウで適用]** を選択して、次のメンテナンスウィンドウ中にスケジュール設定します。

     選択した推奨事項ステータスは、次のメンテナンスウィンドウまで保留に更新されます。  
![\[アクティブな推奨事項が選択され、[適用] ボタンでコンソールのオプションが強調表示されています。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Recommendations_Apply_Defer.png)

   確認ウィンドウが表示されます。

1. **[アプリケーションの確認]** を選択して、推奨事項を適用します。このウィンドウは、変更を有効にするためにリソースを自動再起動する必要があるか手動で再起動する必要があるかを確認します。

   次の例は、推奨事項をすぐに適用するための確認ウィンドウを示しています。  
![\[推奨事項をすぐに適用するためのコンソールの確認ウィンドウ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Recommendations_ApplyImmediately.png)

   次の例は、次のメンテナンスウィンドウで推奨事項の適用をスケジュールする確認ウィンドウを示しています。  
![\[次のメンテナンスウィンドウで推奨事項の適用をスケジュールするコンソールの確認ウィンドウ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Recommendations_Defer.png)

   バナーには、適用された推奨事項が成功または失敗したときにメッセージが表示されます。

   次の例は、成功メッセージを含むバナーを示しています。  
![\[推奨事項を適用するリソースの数を示すメッセージがコンソールに表示されるバナー\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Recommendation-Apply-Banner.png)

   次の例は、失敗メッセージを含むバナーを示しています。  
![\[推奨事項の適用に失敗したリソースと失敗の理由が記載されたメッセージがコンソールに表示されるバナー\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Recommendation-Apply-Banner-failure.png)

## RDS API
<a name="USERRecommendationsManage.ApplyRecommendation-API"></a>

**Amazon RDS API を使用して設定ベースの RDS 推奨事項を適用するには**

1. [DescribeDBRecommendations](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBRecommendations.html) オペレーションを使用します。出力の `RecommendedActions` には、1 つ以上の推奨アクションを含めることができます。

1. ステップ 1 の推奨アクションごとに [RecommendedAction](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RecommendedAction.html) オブジェクトを使用します。出力には `Operation` と `Parameters` が含まれます。

   次の例は、1 つの推奨アクションを含む出力を示しています。

   ```
       "RecommendedActions": [
           {
               "ActionId": "0b19ed15-840f-463c-a200-b10af1b552e3",
               "Title": "Turn on auto backup", // localized
               "Description": "Turn on auto backup for my-mysql-instance-1", // localized
               "Operation": "ModifyDbInstance",
               "Parameters": [
                   {
                       "Key": "DbInstanceIdentifier",
                       "Value": "my-mysql-instance-1"
                   },
                   {
                       "Key": "BackupRetentionPeriod",
                       "Value": "7"
                   }
               ],
               "ApplyModes": ["immediately", "next-maintenance-window"],
               "Status": "applied"
           },
           ... // several others
       ],
   ```

1. ステップ 2 の出力からの推奨アクションごとに `operation` を使用し、`Parameters` 値を入力します。

1. ステップ 2 の オペレーションが成功したら、[ModifyDBRecommendation](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBRecommendation.html) オペレーションを使用して推奨事項のステータスを変更します。

# Amazon RDS の推奨事項の却下
<a name="USERRecommendationsManage.DismissRecommendation"></a>

Amazon RDS コンソール、AWS CLI、または Amazon RDS API を使用して、1 つ以上の Amazon RDS 推奨事項を却下できます。

## コンソール
<a name="USERRecommendationsManage.DismissRecommendation-Console"></a>

**1 つまたは複数の推奨事項を却下するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. ナビゲーションペインで、次のいずれかを実行します。
   + **[レコメンデーション]** を選択します。

     **[レコメンデーション]** ページには、すべての推奨事項のリストが表示されます。
   + **[データベース]** を選択し、データベースページでリソースの **[レコメンデーション]** を選択します。

     詳細は、選択した推奨事項の **[レコメンデーション]** タブに表示されます。
   + **[レコメンデーション]** ページでアクティブな推奨事項の **[検出]**、または **[データベース]** ページの **[レコメンデーション]** タブを選択します。

     推奨事項の詳細ページには、影響を受けるリソースのリストが表示されます。

1. 1 つ以上の推奨事項を選択するか、推奨事項の詳細ページで影響を受けるリソースを 1 つ以上選択し、**[閉じる]** を選択します。

   次の例は、却下するアクティブな推奨事項が複数選択されている **[レコメンデーション]** ページを示しています。  
![\[アクティブな推奨事項がいくつか選択され、[閉じる] ボタンがコンソールで強調表示されています\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Recommendations_Dismiss.png)

   選択した 1 つ以上の推奨事項が却下されると、バナーにメッセージが表示されます。

   次の例は、成功メッセージを含むバナーを示しています。  
![\[推奨事項の却下に成功したリソースの数を示すメッセージがコンソールに表示されるバナー\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Recommendation-Dismiss-Banner.png)

   次の例は、失敗メッセージを含むバナーを示しています。  
![\[推奨事項を却下できなかったリソースを含むメッセージを表示するコンソールのバナー\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Recommendation-Dismiss-Banner-failure.png)

## CLI
<a name="USERRecommendationsManage.DismissRecommendation-Cli"></a>

**AWS CLI を使用して RDS 推奨事項を却下するには**

1. コマンドを実行します。`aws rds describe-db-recommendations --filters "Name=status,Values=active"`

   出力には、`active` ステータスの推奨事項のリストが表示されます。

1. ステップ 1 で却下する推奨事項の `recommendationId` を見つけます。

1. ステップ 2 の `recommendationId` で `>aws rds modify-db-recommendation --status dismissed --recommendationId <ID>` コマンドを実行して、推奨事項を却下します。

## RDS API
<a name="USERRecommendationsManage.DismissRecommendation-API"></a>

Amazon RDS API を使用して RDS 推奨事項を却下するには、[ModifyDBRecommendation](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBRecommendation.html) オペレーションを使用します。

# 却下された Amazon RDS 推奨事項のアクティブな推奨事項への変更
<a name="USERRecommendationsManage.DismissToActiveRecommendation"></a>

Amazon RDS コンソール、AWS CLI、または Amazon RDS API を使用して、1 つ以上の却下された Amazon RDS 推奨事項をアクティブな推奨事項に移動できます。

## コンソール
<a name="USERRecommendationsManage.DismissToActiveRecommendation-Console"></a>

**却下された推奨事項をアクティブな推奨事項に移動するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. ナビゲーションペインで、次のいずれかを実行します。
   + **[レコメンデーション]** を選択します。

     **[レコメンデーション]** ページには、アカウント内のすべてのリソースの重要度でソートされた推奨事項のリストが表示されます。
   + **[データベース]** を選択し、データベースページでリソースの **[レコメンデーション]** を選択します。

     **[レコメンデーション]** タブには、選択したリソースの推奨事項とその詳細が表示されます。

1. リストから却下された推奨事項を 1 つ以上選択し、**[アクティブに移動]** を選択します。  
![\[却下された推奨事項がいくつか選択され、[アクティブに移動] ボタンがコンソールで強調表示されています\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Recommendations_DismissToActive.png)

   選択した推奨事項を却下からアクティブなステータスに移行すると、バナーに成功または失敗のメッセージが表示されます。

   次の例は、成功メッセージを含むバナーを示しています。  
![\[却下されたリソースの数をアクティブな推奨事項に正常に移動したことを示すコンソールのバナー\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Recommendation-DismissToActive-Banner.png)

   次の例は、失敗メッセージを含むバナーを示しています。  
![\[却下された推奨事項からアクティブな推奨事項への移行に失敗したリソースを含むメッセージを表示するコンソールのバナー\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Recommendation-DismissToActive-Banner-Failure.png)

## CLI
<a name="USERRecommendationsManage.DismissToActiveRecommendation-Cli"></a>

**AWS CLI を使用して却下された RDS 推奨事項をアクティブな推奨事項に変更するには**

1. コマンドを実行します。`aws rds describe-db-recommendations --filters "Name=status,Values=dismissed"`

   出力には、`dismissed` ステータスの推奨事項のリストが表示されます。

1. ステップ 1 でステータスを変更する推奨事項の `recommendationId` を見つけます。

1. ステップ 2 の `recommendationId` で `>aws rds modify-db-recommendation --status active --recommendationId <ID>` コマンドを実行して、アクティブな推奨事項を変更します。

## RDS API
<a name="USERRecommendationsManage.DismissToActiveRecommendation-API"></a>

Amazon RDS API を使用して却下された RDS 推奨事項を変更するには、[ModifyDBRecommendation](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBRecommendation.html) オペレーションを使用します。

# Amazon RDS からの推奨事項のリファレンス
<a name="USERRecommendationsManage.RecommendationReference"></a>

Amazon RDS では、リソースが作成または変更されると、リソースの推奨事項が生成されます。次の表に、Amazon RDS からの推奨事項の例を示します。


| 型 | 説明 | 推奨事項 | ダウンタイムが必要 | 追加情報 | 
| --- | --- | --- | --- | --- | 
|  マグネティックボリュームが使用中です  |  DB インスタンスはマグネティックストレージを使用しています。ほとんどの DB インスタンスには、マグネティックストレージは推奨されません。別のストレージタイプとして、汎用 (SSD) またはプロビジョンド IOPS を選択してください。  |  別のストレージタイプとして、汎用 (SSD) またはプロビジョンド IOPS を選択してください。  |  はい  |  Amazon EC2 ドキュメントの[旧世代のボリューム](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-volume-types.html#vol-type-prev)。  | 
|  リソースの自動バックアップは無効になっています  |  自動バックアップは DB インスタンスに対して有効ではありません。DB インスタンスのポイントインタイムリカバリを可能にするため、自動バックアップが推奨されます。  |  最大 14 日間の保存期間で自動バックアップを有効にします。  |  はい  |  [自動バックアップの有効化](USER_WorkingWithAutomatedBackups.Enabling.md) AWS データベースブログの「[ Amazon RDS バックアップストレージコストの説明](https://aws.amazon.com/blogs/database/demystifying-amazon-rds-backup-storage-costs/)」   | 
|  エンジンのマイナーバージョンアップグレードが必要です  |  データベースリソースで最新のマイナー DB エンジンバージョンが実行されていません。最新のマイナーバージョンには、最新のセキュリティ修正プログラムやその他の改善が含まれています。  |  最新のエンジンバージョンにアップグレードします。  |  はい  |  [DB インスタンスのエンジンバージョンのアップグレード](USER_UpgradeDBInstance.Upgrading.md)  | 
|  拡張モニタリングは無効になっています  |  データベースリソースでは拡張モニタリングが有効になっていません。拡張モニタリングにより、モニタリングとトラブルシューティングのためのリアルタイムのオペレーティングシステムメトリクスが提供されます。  |  Enhanced monitoring] を有効にします。  |  いいえ  |  [拡張モニタリングを使用した OS メトリクスのモニタリング](USER_Monitoring.OS.md)  | 
|  ストレージの暗号化は無効になっています。  |  Amazon RDS では、AWS Key Management Service (AWS KMS) で管理しているキーを使用して、すべてのデータベースエンジンの保存時の暗号化をサポートしています。Amazon RDS 暗号化を使用するアクティブな DB インスタンスでは、ストレージに保存されているデータは、自動バックアップ、リードレプリカ、スナップショットのように暗号化されます。 DB インスタンスの作成時に暗号化が有効になっていない場合は、暗号化を有効にする前に、DB インスタンスの復号化されたスナップショットの暗号化されたコピーを作成および復元する必要があります。  |  DB インスタンスの保管中のデータの暗号化を有効にします。  |  はい  |  [Amazon RDS でのセキュリティ](UsingWithRDS.md) [Amazon RDS の DB スナップショットのコピー](USER_CopySnapshot.md)  | 
| Performance Insights は無効になっている | Performance Insights では、DB インスタンスの負荷をモニタリングし、データベースパフォーマンスの問題の分析と解決をサポートします。Performance Insights を有効にすることをお勧めします。 | Performance Insights をオンにします。 | いいえ |  [Amazon RDS での Performance Insights を使用したDB 負荷のモニタリング](USER_PerfInsights.md)  | 
| DB インスタンスのストレージの自動スケーリングが無効になっている | DB インスタンスのストレージ自動スケーリングが有効になっていません。RDS ストレージの自動スケーリングは、データベースのワークロードが増加したときに、ダウンタイムなしでストレージ容量を自動的にスケーリングします。 | 指定した最大ストレージしきい値で Amazon RDS ストレージ自動スケーリングを有効にします | いいえ |  [Amazon RDS ストレージの自動スケーリングによる容量の自動管理](USER_PIOPS.Autoscaling.md)  | 
|  RDS リソースのメジャーバージョンの更新が必須 | DB エンジンの、現行メジャーバージョンのデータベースはサポートされません。新しい機能や拡張機能を含む最新のメジャーバージョンにアップグレードすることをお勧めします。 | DB エンジンを最新のメジャーバージョンにアップグレードします。 | はい | [DB インスタンスのエンジンバージョンのアップグレード](USER_UpgradeDBInstance.Upgrading.md) [データベース更新のために Amazon RDS ブルー/グリーンデプロイを使用する](blue-green-deployments.md)  | 
| RDS リソースのインスタンスクラスの更新が必須 | DB インスタンスは、旧世代の DB インスタンスクラスで実行されています。旧世代の DB インスタンスクラスは、コスト、パフォーマンス、またはその両方が向上した DB インスタンスクラスに置き換えられました。DB インスタンスには、新しい世代の DB インスタンスクラスを使用して実行することをお勧めします。 | DB インスタンスクラスをアップグレードします。 | はい |  [DB インスタンスクラスでサポートされている DB エンジン](Concepts.DBInstanceClass.Support.md)  | 
| ライセンス付きのサポート終了エンジンエディションを使用する RDS リソース | 現在のライセンスサポートを継続するには、メジャーバージョンを Amazon RDS がサポートする最新のエンジンバージョンにアップグレードすることをお勧めします。データベースのエンジンバージョンは、現在のライセンスではサポートされません。 | ライセンスモデルを引き続き使用するには、データベースを Amazon RDS でサポートされている最新バージョンにアップグレードすることをお勧めします。 | はい |  [Oracle のメジャーバージョンのアップグレード](USER_UpgradeDBInstance.Oracle.Major.md)  | 
| DB インスタンスがマルチ AZ 配置を使用していない | マルチ AZ 配置を使用することをお勧めします。マルチ AZ 配置により、DB インスタンスの可用性と耐久性が向上します。 | 影響を受ける DB インスタンスにマルチ AZ を設定します。 | いいえ この変更時にダウンタイムは発生しません。ただし、パフォーマンスに影響する可能性があります。詳細については、[Amazon RDS の DB インスタンスをマルチ AZ 配置に変換する](Concepts.MultiAZ.Migrating.md)を参照してください。  |  [Amazon RDS マルチ AZ の料金](https://aws.amazon.com/rds/features/multi-az/#Pricing)  | 
| DB のメモリパラメータがデフォルトと異なる | DB インスタンスのメモリパラメータがデフォルト値と大きく異なります。これらの設定はパフォーマンスに影響が及び、エラーの原因となる可能性があります。 DB インスタンスのカスタムメモリパラメータを、DB パラメータグループのデフォルト値に再設定することをお勧めします。  | メモリパラメータをデフォルト値にリセットします。 | いいえ |   [Amazon RDS for MySQL のパラメータを設定するためのベストプラクティス](https://aws.amazon.com/blogs/database/best-practices-for-configuring-parameters-for-amazon-rds-for-mysql-part-1-parameters-related-to-performance/) (AWS データベースブログ)  | 
| 最適値未満を使用する `InnoDB_Change_Buffering` パラメータ | 変更バッファリングでは、MySQL DB インスタンスは、セカンダリインデックスを維持するために必要ないくつかの書き込みを延期することができます。この機能は、低速ディスクを使用する環境で有効でした。バッファリング設定を変更することで DB のパフォーマンスはわずかに向上しましたが、クラッシュリカバリの遅延やアップグレード中のシャットダウン時間の増加の原因となりました。MySQL バージョン 8.4 では、デフォルトで `OFF` に設定されます。 | DB パラメータグループの `InnoDB_Change_Buffering` パラメータを 1 に設定します。 | いいえ | [Amazon RDS for MySQL のパラメータを設定するためのベストプラクティス](https://aws.amazon.com/blogs/database/best-practices-for-configuring-parameters-for-amazon-rds-for-mysql-part-1-parameters-related-to-performance/) (AWS データベースブログ)  | 
| Amazon RDS クエリキャッシュパラメータは有効になっている | 変更によってクエリキャッシュの削除が必要になった場合、DB インスタンスは停止しているように見えます。通常ワークロードでは、クエリキャッシュのメリットは得られません。クエリキャッシュは、MySQL 8.0 以降のバージョンから削除されました。query\$1cache\$1type パラメータを 0 に設定することをお勧めします。 | DB パラメータグループの `query_cache_type` パラメータを `0` に設定します。 | はい |  [Amazon RDS for MySQL のパラメータを設定するためのベストプラクティス](https://aws.amazon.com/blogs/database/best-practices-for-configuring-parameters-for-amazon-rds-for-mysql-part-1-parameters-related-to-performance/) (AWS データベースブログ)  | 
| `log_output` パラメータが table に設定されている | `log_output` が `TABLE` に設定されている場合、`log_output` が `FILE` に設定されている場合よりも多くのストレージが使用されます。ストレージサイズの制限に達しないように、パラメーターを `FILE` に設定することをお勧めします。MySQL 8.4 以降のバージョンでは、デフォルトで `FILE` に設定されます。 | DB パラメータグループの `log_output` パラメータを `FILE` に設定します。 | いいえ |  [ MySQL データベースのログファイル](USER_LogAccess.Concepts.MySQL.md)  | 
| パラメータグループで huge pages が使用されない | Large pages はデータベースのスケーラビリティを高めることができますが、DB インスタンスは Large pages を使用していません。DB インスタンスの DB パラメータグループで、`use_large_pages` パラメータを `ONLY` に設定することをお勧めします。 | DB パラメータグループの `use_large_pages` パラメータを `ONLY` に設定します。 | はい | [サポートされている RDS for Oracle インスタンスで HugePages をオンにする](Oracle.Concepts.HugePages.md)  | 
| `autovacuum` パラメータがオフになっている | DB インスタンスの自動バキュームパラメータは無効になっています。自動バキュームを無効にすると、テーブルとインデックスが肥大化し、パフォーマンスに影響します。 DB パラメータグループの自動バキュームを有効にすることをお勧めします。  | DB パラメータグループの自動バキュームパラメータを有効にしてください。 | いいえ |  AWS データベースブログの「[Amazon RDS for PostgreSQL 環境における自動バキュームについて](https://aws.amazon.com/blogs/database/understanding-autovacuum-in-amazon-rds-for-postgresql-environments/)」  | 
| `synchronous_commit` パラメータがオフになっている | `synchronous_commit` パラメータを無効にすると、データベースのクラッシュでデータが失われる可能性があります。データベースの耐久性が危険にさらされます。 `synchronous_commit` パラメータをオンにすることをお勧めします。  | DB パラメータグループの `synchronous_commit` パラメータを有効にします。 | はい |  AWS データベースブログの「[ Amazon Aurora PostgreSQL パラメータ: データベースブログの「レプリケーション、セキュリティ、ログ記録](https://aws.amazon.com/blogs/database/amazon-aurora-postgresql-parameters-part-2-replication-security-and-logging/)」  | 
| `track_counts` パラメータがオフになっている | `track_counts` パラメータが無効の場合、データベースはデータベースアクティビティ統計を収集しません。自動バキュームでは、これらの統計が正しく機能する必要があります。 `track_counts` パラメータを `1` に設定することをお勧めします。 | `track_counts` パラメータを `1` に設定します。 | いいえ |  [PostgreSQL のランタイム統計](https://www.postgresql.org/docs/current/runtime-config-statistics.html#GUC-TRACK-COUNTS)   | 
| `enable_indexonlyscan` パラメータがオフになっている | クエリプランナーまたはオプティマイザーは、インデックスのみのスキャン計画タイプが無効になっている場合は使用できません。 `enable_indexonlyscan` パラメータ値を `1` に設定することをお勧めします。 | `enable_indexonlyscan` パラメータ値を `1` に設定します。 | いいえ |  [PostgreSQL のプランナーメソッド設定](https://www.postgresql.org/docs/current/runtime-config-query.html#GUC-ENABLE-INDEXONLYSCAN)  | 
| `enable_indexscan` パラメータがオフになっている | クエリプランナーまたはオプティマイザーは、インデックスのみのスキャン計画タイプが無効になっている場合は使用できません。 `enable_indexscan` 値を `1` に設定することをお勧めします。 | `enable_indexscan` パラメータ値を `1` に設定します。 | いいえ |  [PostgreSQL のプランナーメソッド設定](https://www.postgresql.org/docs/current/runtime-config-query.html#GUC-ENABLE-INDEXONLYSCAN)  | 
| `innodb_flush_log_at_trx` パラメータがオフになっている | DB インスタンスの `innodb_flush_log_at_trx` パラメータの値は安全ではありません。このパラメータは、ディスクへのコミット操作の持続性を制御します。 `innodb_flush_log_at_trx` パラメータを `1` に設定することをお勧めします。 | `innodb_flush_log_at_trx` パラメータ値を `1` に設定します。 | いいえ |  [Amazon RDS for MySQL のパラメータを設定するためのベストプラクティス](https://aws.amazon.com/blogs/database/best-practices-for-configuring-parameters-for-amazon-rds-for-mysql-part-1-parameters-related-to-performance/) (AWS データベースブログ)  | 
| `sync_binlog` パラメータがオフになっている | DB インスタンスでトランザクションのコミットが確認される前には、バイナリログのディスクへの同期は実行されません。 `sync_binlog` パラメータ値を `1` に設定することをお勧めします。 | `sync_binlog` パラメータ値を `1` に設定します。 | いいえ | AWS データベースブログの[Amazon RDS for MySQL のレプリケーションパラメータを設定するためのベストプラクティス](https://aws.amazon.com/blogs/database/best-practices-for-configuring-parameters-for-amazon-rds-for-mysql-part-1-parameters-related-to-performance/) | 
| `innodb_stats_persistent` パラメータがオフになっている | DB インスタンスは、InnoDB 統計をディスクに保持するように設定されていません。統計が保存されていない場合は、インスタンスが再起動してテーブルにアクセスするたびに再計算されます。これにより、クエリ実行プランにばらつきが生じます。このグローバルパラメータの値はテーブルレベルで変更できます。 `innodb_stats_persistent` パラメータ値を `ON` に設定することをお勧めします。 | `innodb_stats_persistent` パラメータ値を `ON` に設定します。 | いいえ | [Amazon RDS for MySQL のパラメータを設定するためのベストプラクティス](https://aws.amazon.com/blogs/database/best-practices-for-configuring-parameters-for-amazon-rds-for-mysql-part-1-parameters-related-to-performance/) (AWS データベースブログ)  | 
| `innodb_open_files` パラメータが低い | `innodb_open_files` パラメータは、InnoDB が一度に開くことができるファイル数を制御します。InnoDB は、mysqld の実行時にすべてのログファイルとシステムテーブルスペースファイルを開きます。 お使いの DB インスタンスは、InnoDB が一度に開くことができる最大ファイル数の値が低くなっています。`innodb_open_files` パラメータを少なくとも `65` に設定することをお勧めします。 | `innodb_open_files` パラメータを最小値の `65` に設定します。 | はい | [MySQL 用の InnoDB オープンファイル](https://dev.mysql.com/doc/refman/5.7/en/innodb-parameters.html#sysvar_innodb_open_files)  | 
| `max_user_connections` パラメータが低い | DB インスタンスは、各データベースアカウントの最大同時接続数の値が低くなっています。 `max_user_connections` パラメータを `5` より大きい数に設定することをお勧めします。 | `max_user_connections` パラメータの値を `5` より大きい数にします。 | はい | [MySQL のアカウントリソース制限の設定](https://dev.mysql.com/doc/refman/8.0/en/user-resources.html) | 
| リードレプリカは書き込み可能モードで開かれている | DB インスタンスには書き込み可能モードのリードレプリカがあり、クライアントからの更新が可能です。 リードレプリカが書き込み可能モードにならないように、`read_only` パラメータを `TrueIfReplica` に設定することをお勧めします。 | `read_only` パラメータ値を `TrueIfReplica` に設定します。 | いいえ | AWS データベースブログの[Amazon RDS for MySQL のレプリケーションパラメータを設定するためのベストプラクティス](https://aws.amazon.com/blogs/database/best-practices-for-configuring-parameters-for-amazon-rds-for-mysql-part-2-parameters-related-to-replication/)  | 
| `innodb_default_row_format` パラメータ設定が安全ではない | DB インスタンスで既知の問題が発生しました: MySQL バージョン 8.0.26 よりも前のバージョンで、`row_format` を `COMPACT` または `REDUNDANT` に設定して作成されたテーブルは、インデックスが 767 バイトを超えるとアクセスできなくなり、回復できなくなります。 `innodb_default_row_format` パラメータ値を `DYNAMIC` に設定することをお勧めします。 | `innodb_default_row_format` パラメータ値を `DYNAMIC` に設定します。 | いいえ | [MySQL 8.0.26 での変更](https://dev.mysql.com/doc/relnotes/mysql/8.0/en/news-8-0-26.html#mysqld-8-0-26-bug) | 
| `general_logging` パラメータがオンになっている | DB インスタンスの一般ログ記録が有効になっています。この設定は、データベースの問題のトラブルシューティングに役立ちます。しかし、一般ログ記録を有効にすると、入出力操作の量と割り当てられるストレージ容量が増え、競合やパフォーマンスの低下につながる可能性があります。 一般ログ記録の使用状況の要件を確認してください。`general_logging` パラメータ値を `0` に設定することをお勧めします。 | 一般ログ記録の使用状況の要件を確認してください。必須ではない場合は、`general_logging` パラメーターの値を `0` に設定することをお勧めします。 | いいえ |  [RDS for MySQL データベースログの概要](USER_LogAccess.MySQL.LogFileSize.md)  | 
| システムメモリ容量のプロビジョニングが不十分な RDS インスタンス | メモリの使用量を減らすか、メモリの割り当て量の多い DB インスタンスタイプを使用するようにクエリを調整することをお勧めします。インスタンスのメモリが不足すると、データベースのパフォーマンスに影響を及ぼします。 | メモリ容量のより高い DB インスタンスを使用する | はい |  AWS データベースブログの[「Amazon RDS インスタンスの垂直スケーリングと水平スケーリング](https://aws.amazon.com/blogs/database/scaling-your-amazon-rds-instance-vertically-and-horizontally/)」 [Amazon RDS インスタンスタイプ](https://aws.amazon.com/rds/instance-types/) [Amazon RDS の価格設定](https://aws.amazon.com/rds/pricing/)  | 
| システム CPU 容量のプロビジョニングが不十分な RDS インスタンス | より少ないメモリを使用するようにクエリを調整するか、vCPU の割り当て量がより多い DB インスタンスを使用するように DB インスタンスを変更することをお勧めします。DB インスタンスの CPU が少なくなると、データベースのパフォーマンスが低下する可能性があります。 | CPU 容量がより多い DB インスタンスを使用する | はい |  AWS データベースブログの[「Amazon RDS インスタンスの垂直スケーリングと水平スケーリング](https://aws.amazon.com/blogs/database/scaling-your-amazon-rds-instance-vertically-and-horizontally/)」 [Amazon RDS インスタンスタイプ](https://aws.amazon.com/rds/instance-types/) [Amazon RDS の価格設定](https://aws.amazon.com/rds/pricing/)  | 
| RDS リソースは接続プールを正しく利用していません。 | Amazon RDS Proxy を有効にして、既存のデータベース接続を効率的にプールして共有することをお勧めします。データベースで既にプロキシを使用している場合は、複数の DB インスタンス間の接続プールと負荷分散を改善するようにプロキシを正しく設定します。RDS Proxy は、接続の枯渇やダウンタイムのリスクを軽減すると同時に、可用性とスケーラビリティを向上させるのに役立ちます。 | RDS プロキシを有効にするか、既存のプロキシ設定を変更する | いいえ |  AWS データベースブログの[「Amazon RDS インスタンスの垂直スケーリングと水平スケーリング](https://aws.amazon.com/blogs/database/scaling-your-amazon-rds-instance-vertically-and-horizontally/)」 [Amazon RDS Proxy ](rds-proxy.md) [Amazon RDS Proxy の料金](https://aws.amazon.com/rds/proxy/pricing/)  | 
| RDS インスタンスが過剰な一時オブジェクトを作成している | ワークロードを調整して過剰な一時オブジェクトが作成されないようにするか、最適化された読み取りをサポートする RDS インスタンスクラスに切り替えることをお勧めします。RDS Optimized Reads は、多数の一時オブジェクトや大きな一時オブジェクトを含むワークロードのデータベースパフォーマンスを向上させます。ワークロードを評価し、インスタンスで RDS Optimized Reads を使用することで、データベースワークロードが改善されるかどうかを判断します。 | RDS Optimized Reads で DB インスタンスタイプを使用する | はい |  [Amazon RDS インスタンスタイプ](https://aws.amazon.com/rds/instance-types/) [Amazon RDS Optimized Reads による RDS for MySQL のクエリパフォーマンスの向上](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-optimized-reads.html) [Amazon RDS Optimized Reads による RDS for MariaDB のクエリパフォーマンスの向上](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-optimized-reads-mariadb.html) [Amazon RDS Optimized Reads による RDS for PostgreSQL のクエリパフォーマンスの向上](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PostgreSQL.optimizedreads.html)  | 
| システム IOPS 容量のプロビジョニングが不十分な RDS インスタンス | データベースワークロードを調整して IOPS を減らすか、デフォルトの IOPS 制限が高いタイプに DB インスタンスをスケールアップすることをお勧めします。現在の DB インスタンスではプロビジョンド IOPS をサポートできないか、データベースワークロードの IOPS 使用率が高くなっています。 | より高い IOPS デフォルト制限を持つ DB インスタンスタイプを使用する | はい |  [Amazon RDS インスタンスタイプ](https://aws.amazon.com/rds/instance-types/) [Amazon RDS DB インスタンスストレージ](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html) [データベース負荷](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html)  | 
| RDS インスタンスにプロビジョニング不足の Amazon EBS ボリュームがある | データベースワークロードを調整して IOPS を減らすか、データベースのプロビジョンド IOPS を増やすことをお勧めします。IOPS 使用率がプロビジョンド IOPS に近づくと、データベースのパフォーマンスが低下する可能性があります。 | DB インスタンスにより多くの IOPS をプロビジョニングする | はい |  [Amazon RDS インスタンスタイプ](https://aws.amazon.com/rds/instance-types/) [Amazon RDS DB インスタンスストレージ](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html) [データベース負荷](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html)  | 
| RDS インスタンスのスループットキャパシティがプロビジョニング不足  | データベースワークロードを調整してスループットを減らすか、データベースのプロビジョンドスループットを増やすことをお勧めします。スループット使用率がプロビジョニングされたスループットに近づくと、データベースのパフォーマンスに影響する可能性があります。 | DB インスタンスにより多くのスループットをプロビジョニングする | はい |  [Amazon RDS インスタンスタイプ](https://aws.amazon.com/rds/instance-types/) [Amazon RDS DB インスタンスストレージ](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html) [データベース負荷](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html)  | 
| RDS インスタンスは EBS I/O のプロビジョニング不足  | データベースワークロードを調整して I/O 操作を減らすか、Amazon RDS io2 Block Express ボリュームを使用するように DB インスタンスを変更することをお勧めします。このボリュームは、高パフォーマンス、高スループット、および低レイテンシーを必要とするデータベースワークロード用に設計されています。現在のワークロードでは、データベースは必要な速度で I/O 操作を処理できない可能性があり、パフォーマンスが低下する可能性があります。 | RDS インスタンスに Amazon RDS io2 Block Express ボリュームを使用する | いいえ |  [Amazon RDS DB インスタンスストレージ](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html) [Amazon RDS の Amazon CloudWatch メトリクス](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-metrics.html) 「Amazon EBS ユーザーガイド」の「[プロビジョンド IOPS SSD ボリューム](https://docs.aws.amazon.com/ebs/latest/userguide/provisioned-iops.html)」  | 

# Amazon RDS コンソールでのメトリクスの表示
<a name="USER_Monitoring"></a>

Amazon RDS は Amazon Cloudwatch と統合し、さまざまな RDS DB インスタンスメトリクスを RDS コンソールで表示できるようになりました。の詳細については、「[Amazon RDS のメトリクスリファレンス](metrics-reference.md)」を参照してください。

DB インスタンス については、次のカテゴリのメトリクスがモニタリングされます。
+ **CloudWatch** – RDS コンソールからアクセスできる  RDS の Amazon CloudWatch メトリクスを表示します。これらのメトリクスには、CloudWatch コンソールからアクセスすることもできます。各メトリクスには、特定の期間にわたってモニタリングされたメトリクスを示すグラフが含まれます。CloudWatch メトリクスのリストについては、「[Amazon RDS の Amazon CloudWatch メトリクス](rds-metrics.md)」を参照してください。
+ **[Enhanced monitoring]** (拡張モニタリング) – RDS DB インスタンスで、拡張モニタリングがオンにされたときのオペレーティングシステムメトリクスの概要を表示します。RDS は、拡張モニタリングのメトリクスを Amazon CloudWatch Logs アカウントに配信します。各 OS メトリクスには、特定の期間にわたってモニタリングされたメトリクスを示すグラフが含まれます。概要については、「[拡張モニタリングを使用した OS メトリクスのモニタリング](USER_Monitoring.OS.md)」を参照してください。拡張モニタリングメトリクスのリストについては、「[拡張モニタリングの OS メトリクス](USER_Monitoring-Available-OS-Metrics.md)」を参照してください。
+ **[OS Process list]** (OS プロセスリスト) – DB インスタンスで実行中の各プロセスの詳細を表示します。
+ **[Performance Insights]** – DB インスタンスで Amazon RDS Performance Insights ダッシュボードを開きます。Performance Insights の概要については、「[Amazon RDS での Performance Insights を使用したDB 負荷のモニタリング](USER_PerfInsights.md)」を参照してください。Performance Insights メトリクスのリストについては、「[Amazon RDS Performance Insights の Amazon CloudWatch メトリクス](USER_PerfInsights.Cloudwatch.md)」を参照してください。

Amazon RDS の Performance Insights ダッシュボードで、Performance Insights と CloudWatch メトリクスの統合ビューが提供されるようになりました。このビューを使用するには、DB インスタンスの Performance Insights がオンになっている必要があります。**[モニタリング]** タブまたは、ナビゲーションペインの **[Performance Insights]** で新しいモニタリングビューを選択できます。このビューを選択する手順については、「[Performance Insights ダッシュボードを使用して組み合わせたメトリクスを表示する](Viewing_Unifiedmetrics.md)」を参照してください。

# Performance Insights ダッシュボードを使用して組み合わせたメトリクスを表示する
<a name="Viewing_Unifiedmetrics"></a>

**重要**  
 AWS は、Performance Insights のサポート終了日を 2026 年 6 月 30 日と発表しました。この日以降、Amazon RDS は Performance Insights コンソールのエクスペリエンス、柔軟な保持期間 (1～24 か月)、および関連する料金のサポートを終了します。Performance Insights API は存続し、料金の変更はありません。Performance Insights API の料金は、CloudWatch Database Insights の料金とともに AWS 請求書に表示されます。  
 Performance Insights の有料利用枠を使用する DB インスタンスは、2026 年 6 月 30 日より前に Database Insights のアドバンストモードにアップグレードすることをお勧めします。Database Insights のアドバンストモードへのアップグレード方法については、「[Amazon RDS で Database Insights のアドバンストモードを有効にする](USER_DatabaseInsights.TurningOnAdvanced.md)」を参照してください。  
 アクションを実行しない場合、Performance Insights を使用する DB インスタンスは、デフォルトで Database Insights のスタンダードモードを使用します。Database Insights のスタンダードモードでは、7 日間を超えたパフォーマンスデータ履歴、実行プラン機能とオンデマンド分析機能が Amazon RDS コンソールで利用できなくなる可能性があります。2026 年 6 月 30 日以降、Database Insights のアドバンストモードのみが実行プランとオンデマンド分析をサポートします。  
 CloudWatch Database Insights を使用すると、データベースのフリートのデータベース負荷をモニタリングし、パフォーマンスの大規模な分析とトラブルシューティングを行うことができます。Database Insights の詳細については、「[CloudWatch Database Insights による Amazon RDS データベースのモニタリング](USER_DatabaseInsights.md)」を参照してください。詳細については、[Amazon CloudWatch 料金表](https://aws.amazon.com/cloudwatch/pricing/)をご覧ください。

Amazon RDS の Performance Insights ダッシュボードでは、DB インスタンスに対する Performance Insights メトリクスと CloudWatch メトリクスの統合ビューが提供されます。事前設定されたダッシュボードを使用するか、カスタムダッシュボードを作成できます。事前設定されたダッシュボードには、データベースエンジンのパフォーマンス問題の診断に役立つ最も一般的に使用されるメトリクスが表示されます。また、分析要件を満たすデータベースエンジンのメトリダッシュボードを作成することもできます。次に、このダッシュボードを AWS アカウント内のそのデータベースエンジンタイプのすべての DB インスタンスに使用します。

**[モニタリング]** タブまたは、ナビゲーションペインの **[Performance Insights]** でモニタリングビューを選択できます。

Performance Insights ダッシュボードに組み合わせたメトリクスを表示するには、 DB インスタンス に対して Performance Insights がオンになっている必要があります。Performance Insights をオンにする方法の詳細については、「[Amazon RDS の Performance Insights の有効化と無効化](USER_PerfInsights.Enabling.md)」を参照してください。

以下のセクションでは、Performance Insights メトリクスと CloudWatch メトリクスを表示する方法について説明します。

**Topics**
+ [[モニタリング] タブで新しいモニタリングビューを選択する](Viewing_Unifiedmetrics.MonitoringTab.md)
+ [Performance Insights ページから新しいモニタリングビューを選択する](Viewing_Unifiedmetrics.PInavigationPane.md)
+ [Performance Insights が表示されたカスタムダッシュボードの作成](Viewing_Unifiedmetrics.PIcustomizeMetricslist.md)
+ [Performance Insights で、事前設定されたダッシュボードを選択する](Viewing_Unifiedmetrics.PI-preconfigured-dashboard.md)

# [モニタリング] タブで新しいモニタリングビューを選択する
<a name="Viewing_Unifiedmetrics.MonitoringTab"></a>

**重要**  
 AWS は、Performance Insights のサポート終了日を 2026 年 6 月 30 日と発表しました。この日以降、Amazon RDS は Performance Insights コンソールのエクスペリエンス、柔軟な保持期間 (1～24 か月)、および関連する料金のサポートを終了します。Performance Insights API は存続し、料金の変更はありません。Performance Insights API の料金は、CloudWatch Database Insights の料金とともに AWS 請求書に表示されます。  
 Performance Insights の有料利用枠を使用する DB インスタンスは、2026 年 6 月 30 日より前に Database Insights のアドバンストモードにアップグレードすることをお勧めします。Database Insights のアドバンストモードへのアップグレード方法については、「[Amazon RDS で Database Insights のアドバンストモードを有効にする](USER_DatabaseInsights.TurningOnAdvanced.md)」を参照してください。  
 アクションを実行しない場合、Performance Insights を使用する DB インスタンスは、デフォルトで Database Insights のスタンダードモードを使用します。Database Insights のスタンダードモードでは、7 日間を超えたパフォーマンスデータ履歴、実行プラン機能とオンデマンド分析機能が Amazon RDS コンソールで利用できなくなる可能性があります。2026 年 6 月 30 日以降、Database Insights のアドバンストモードのみが実行プランとオンデマンド分析をサポートします。  
 CloudWatch Database Insights を使用すると、データベースのフリートのデータベース負荷をモニタリングし、パフォーマンスの大規模な分析とトラブルシューティングを行うことができます。Database Insights の詳細については、「[CloudWatch Database Insights による Amazon RDS データベースのモニタリング](USER_DatabaseInsights.md)」を参照してください。詳細については、[Amazon CloudWatch 料金表](https://aws.amazon.com/cloudwatch/pricing/)をご覧ください。

Amazon RDS コンソールから、新しいモニタリングビューを選択すると、DB インスタンスのパフォーマンスインサイトと CloudWatch メトリクスを表示できます。

**[モニタリング] タブで新しいモニタリングビューを選択するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. 左のナビゲーションペインの **[データベース]** を選択します。

1. モニタリングする DB インスタンスの名前を選択します。

1. 下にスクロールし、**[モニタリング]** タブを選択します。

   新しいモニタリングビューを選択するオプションを含むバナーが表示されます。次の例は、新しいモニタリングビューを選択するためのバナーを示しています。  
![\[新しいモニタリングビューへのナビゲーションが表示されたバナー。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/NewMonitoringViewOption.png)

1. **[新しいモニタリングビューに移動]** を選択すると、に対して、Performance Insights と CloudWatch メトリクスが表示された Performance Insights ダッシュボードが開きます。

1. (オプション) DB インスタンスの Performance Insights がオフになっている場合、DB クラスターを変更して Performance Insights をオンにするオプションを含むバナーが表示されます。

   次の例は、**[モニタリング]** タブの DB クラスターを変更するためのバナーを示しています。  
![\[DB インスタンスを変更して、Performance Insights をオンにします。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Monitoring_modifyInstnc_banner.png)

   **[変更]** を選択して DB クラスターを変更し、Performance Insights をオンにします。Performance Insights をオンにする方法の詳細については、「[Amazon RDS の Performance Insights の有効化と無効化](USER_PerfInsights.Enabling.md)」を参照してください。

# Performance Insights ページから新しいモニタリングビューを選択する
<a name="Viewing_Unifiedmetrics.PInavigationPane"></a>

**重要**  
 AWS は、Performance Insights のサポート終了日を 2026 年 6 月 30 日と発表しました。この日以降、Amazon RDS は Performance Insights コンソールのエクスペリエンス、柔軟な保持期間 (1～24 か月)、および関連する料金のサポートを終了します。Performance Insights API は存続し、料金の変更はありません。Performance Insights API の料金は、CloudWatch Database Insights の料金とともに AWS 請求書に表示されます。  
 Performance Insights の有料利用枠を使用する DB インスタンスは、2026 年 6 月 30 日より前に Database Insights のアドバンストモードにアップグレードすることをお勧めします。Database Insights のアドバンストモードへのアップグレード方法については、「[Amazon RDS で Database Insights のアドバンストモードを有効にする](USER_DatabaseInsights.TurningOnAdvanced.md)」を参照してください。  
 アクションを実行しない場合、Performance Insights を使用する DB インスタンスは、デフォルトで Database Insights のスタンダードモードを使用します。Database Insights のスタンダードモードでは、7 日間を超えたパフォーマンスデータ履歴、実行プラン機能とオンデマンド分析機能が Amazon RDS コンソールで利用できなくなる可能性があります。2026 年 6 月 30 日以降、Database Insights のアドバンストモードのみが実行プランとオンデマンド分析をサポートします。  
 CloudWatch Database Insights を使用すると、データベースのフリートのデータベース負荷をモニタリングし、パフォーマンスの大規模な分析とトラブルシューティングを行うことができます。Database Insights の詳細については、「[CloudWatch Database Insights による Amazon RDS データベースのモニタリング](USER_DatabaseInsights.md)」を参照してください。詳細については、[Amazon CloudWatch 料金表](https://aws.amazon.com/cloudwatch/pricing/)をご覧ください。

Amazon RDS コンソールから、新しいモニタリングビューを選択すると、DB インスタンスのパフォーマンスインサイトと CloudWatch メトリクスを表示できます。

**ナビゲーションペインの Performance Insights を使用して新しいモニタリングビューを選択するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

1. DB インスタンスを選択すると、DB インスタンスの Performance Insights と CloudWatch メトリクスの両方が表示された Performance Insights ダッシュボードが表示されます。  
![\[統合された Performance Insights と CloudWatch メトリクスダッシュボード。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Monitoring_UnifiedDashboard.png)

# Performance Insights が表示されたカスタムダッシュボードの作成
<a name="Viewing_Unifiedmetrics.PIcustomizeMetricslist"></a>

**重要**  
 AWS は、Performance Insights のサポート終了日を 2026 年 6 月 30 日と発表しました。この日以降、Amazon RDS は Performance Insights コンソールのエクスペリエンス、柔軟な保持期間 (1～24 か月)、および関連する料金のサポートを終了します。Performance Insights API は存続し、料金の変更はありません。Performance Insights API の料金は、CloudWatch Database Insights の料金とともに AWS 請求書に表示されます。  
 Performance Insights の有料利用枠を使用する DB インスタンスは、2026 年 6 月 30 日より前に Database Insights のアドバンストモードにアップグレードすることをお勧めします。Database Insights のアドバンストモードへのアップグレード方法については、「[Amazon RDS で Database Insights のアドバンストモードを有効にする](USER_DatabaseInsights.TurningOnAdvanced.md)」を参照してください。  
 アクションを実行しない場合、Performance Insights を使用する DB インスタンスは、デフォルトで Database Insights のスタンダードモードを使用します。Database Insights のスタンダードモードでは、7 日間を超えたパフォーマンスデータ履歴、実行プラン機能とオンデマンド分析機能が Amazon RDS コンソールで利用できなくなる可能性があります。2026 年 6 月 30 日以降、Database Insights のアドバンストモードのみが実行プランとオンデマンド分析をサポートします。  
 CloudWatch Database Insights を使用すると、データベースのフリートのデータベース負荷をモニタリングし、パフォーマンスの大規模な分析とトラブルシューティングを行うことができます。Database Insights の詳細については、「[CloudWatch Database Insights による Amazon RDS データベースのモニタリング](USER_DatabaseInsights.md)」を参照してください。詳細については、[Amazon CloudWatch 料金表](https://aws.amazon.com/cloudwatch/pricing/)をご覧ください。

新しいモニタリングビューでは、分析要件を満たすために必要なメトリクスを含むカスタムダッシュボードを作成できます。

DB インスタンスに対して Performance Insights と CloudWatch メトリクスを選択することで、カスタムダッシュボードを作成できます。次に、このカスタムダッシュボードを AWS アカウント内の同じデータベースエンジンタイプのすべての DB インスタンスに使用します。

**注記**  
カスタマイズされたダッシュボードは、最大 50 のメトリクスをサポートします。

ウィジェット設定メニューを使用して、ダッシュボードを編集または削除したり、ウィジェットウィンドウを移動したり、サイズを変更したりできます。

**ナビゲーションペインに Performance Insights が表示されたカスタムダッシュボードを作成するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

1. DB インスタンスを選択します。

1. ウィンドウの **[メトリクス]** タブが表示されるまで下にスクロールします。

1. ドロップダウンリストから、カスタムダッシュボードを選択します。次の例は、カスタムダッシュボードの作成を示しています。  
![\[まだウィジェットがないカスタムメトリクスダッシュボード。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Monitoring_custmDashbrd_addWidget.png)

1. **[ウィジェットの追加]** を選択して、**[ウィジェットの追加]** ウィンドウを開きます。使用可能なオペレーティングシステム (OS) メトリクス、データベースメトリクス、および CloudWatch メトリックスをウィンドウで開いて表示できます。

   次の例は、メトリクスが表示された**[ウィジェットの追加]** ウィンドウを示しています。  
![\[[ウィジェットの追加] ウィンドウのメトリクスオプション。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Monitoring_AddWidget.png)

1. ダッシュボードで表示するメトリクスを選択してから、**[ウィジェットの追加]** を選択します。検索フィールドを使用して、特定のメトリクスを検索できます。

   選択したメトリクスがダッシュボードに表示されます。

1. (オプション) ダッシュボードを変更または削除する場合は、ウィジェットの右上にある設定アイコンを選択し、メニューで次のいずれかのアクションを選択します。
   + **編集** — ウィンドウ内のメトリクスリストを変更します。ダッシュボードのメトリクスを選択したら、**[ウィジェットの更新]** を選択します。
   + **削除** — ウィジェットを削除します。確認ウィンドウで、**[削除]** を選択します。

# Performance Insights で、事前設定されたダッシュボードを選択する
<a name="Viewing_Unifiedmetrics.PI-preconfigured-dashboard"></a>

**重要**  
 AWS は、Performance Insights のサポート終了日を 2026 年 6 月 30 日と発表しました。この日以降、Amazon RDS は Performance Insights コンソールのエクスペリエンス、柔軟な保持期間 (1～24 か月)、および関連する料金のサポートを終了します。Performance Insights API は存続し、料金の変更はありません。Performance Insights API の料金は、CloudWatch Database Insights の料金とともに AWS 請求書に表示されます。  
 Performance Insights の有料利用枠を使用する DB インスタンスは、2026 年 6 月 30 日より前に Database Insights のアドバンストモードにアップグレードすることをお勧めします。Database Insights のアドバンストモードへのアップグレード方法については、「[Amazon RDS で Database Insights のアドバンストモードを有効にする](USER_DatabaseInsights.TurningOnAdvanced.md)」を参照してください。  
 アクションを実行しない場合、Performance Insights を使用する DB インスタンスは、デフォルトで Database Insights のスタンダードモードを使用します。Database Insights のスタンダードモードでは、7 日間を超えたパフォーマンスデータ履歴、実行プラン機能とオンデマンド分析機能が Amazon RDS コンソールで利用できなくなる可能性があります。2026 年 6 月 30 日以降、Database Insights のアドバンストモードのみが実行プランとオンデマンド分析をサポートします。  
 CloudWatch Database Insights を使用すると、データベースのフリートのデータベース負荷をモニタリングし、パフォーマンスの大規模な分析とトラブルシューティングを行うことができます。Database Insights の詳細については、「[CloudWatch Database Insights による Amazon RDS データベースのモニタリング](USER_DatabaseInsights.md)」を参照してください。詳細については、[Amazon CloudWatch 料金表](https://aws.amazon.com/cloudwatch/pricing/)をご覧ください。

事前設定されたダッシュボードを使用して、最も一般的に使用されるメトリクスを表示できます。このダッシュボードは、データベースエンジンのパフォーマンスの問題を診断し、平均復旧時間を数時間から数分に短縮するのに役立ちます。

**注記**  
このダッシュボードは編集できません。

**ナビゲーションペインの Performance Insights で、事前設定されたダッシュボードを選択するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

1. DB インスタンスを選択します。

1. ウィンドウの **[メトリクス]** タブが表示されるまで下にスクロールします

1. ドロップダウンリストから、事前設定されたダッシュボードを選択します。

   ダッシュボードで DB インスタンスのメトリクスを表示できます。次の例は、事前設定されたメトリクスダッシュボードを示しています。  
![\[事前設定されたメトリクスダッシュボード。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Monitoring_preconfigDashboard.png)

# Amazon CloudWatch を使用した Amazon RDS メトリクスのモニタリング
<a name="monitoring-cloudwatch"></a>

Amazon CloudWatch はメトリクスリポジトリです。リポジトリは、Amazon RDS から raw データを収集し、リアルタイムに近い読み取り可能なメトリクスに加工することができます。CloudWatch に送信される Amazon RDS メトリクスの詳細なリストについては、「[Amazon RDS のメトリクスリファレンス](https://docs.aws.amazon.com/en_us/AmazonRDS/latest/UserGuide/metrics-reference.html)」を参照してください。

大規模なデータベースのパフォーマンスを分析およびトラブルシューティングするには、[CloudWatch Database InsightsCloudWatch](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DatabaseInsights.html) を使用します。

**Topics**
+ [Amazon RDS および Amazon CloudWatch の概要](#cw-metrics-overview)
+ [CloudWatch コンソールおよび AWS CLI での DB インスタンスメトリクスの表示](metrics_dimensions.md)
+ [Performance Insights メトリクスの CloudWatch へのエクスポート](PI_metrics_export_CW.md)
+ [Amazon RDS をモニタリングするための CloudWatch アラームの作成](creating_alarms.md)
+ [チュートリアル: Amazon RDS のマルチ AZ DB クラスターレプリカラグ用の Amazon CloudWatch アラームを作成する](multi-az-db-cluster-cloudwatch-alarm.md)

## Amazon RDS および Amazon CloudWatch の概要
<a name="cw-metrics-overview"></a>

デフォルトでは、Amazon RDS はメトリクスデータを 1 分間隔で CloudWatch に自動的に送信します。例えば、`CPUUtilization` メトリクスは、DB インスタンスの CPU 使用率のパーセンテージを時間の経過とともに記録します。期間が 60 秒 (1 分) のデータポイントは、15 日間使用できます。これにより、履歴情報にアクセスし、ウェブアプリケーションやサービスのパフォーマンスを確認できます。

Performance Insights メトリクスダッシュボードを Amazon RDS から Amazon CloudWatch にエクスポートできるようになりました。事前設定またはカスタマイズされたメトリクスダッシュボードを新しいダッシュボードとしてエクスポートするか、それらを既存の CloudWatch ダッシュボードに追加できます。エクスポートしたメトリクスは CloudWatch コンソールに表示できます。Performance Insights メトリクスダッシュボードを CloudWatch にエクスポートする方法の詳細については、「[Performance Insights メトリクスの CloudWatch へのエクスポート](PI_metrics_export_CW.md)」を参照してください。

次の図に示すように、CloudWatch メトリクスのアラームを設定できます。例えば、インスタンスの CPU 使用率が 70% を超えたときに通知するアラームを作成できます。Amazon Simple Notification Service を設定して、しきい値が過ぎたときにメールを送信できます。

![\[AWS CloudWatch の RDS メトリクス\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/rds-cloudwatch.png)


Amazon RDS は、次のタイプのメトリクスを Amazon CloudWatch に発行します。
+ RDS DB インスタンスのメトリクス

  これらのメトリクスの表については、「[Amazon RDS の Amazon CloudWatch メトリクス](rds-metrics.md)」を参照してください。
+ Performance Insights メトリクス

  これらのメトリクスの表については、「[Amazon RDS Performance Insights の Amazon CloudWatch メトリクス](USER_PerfInsights.Cloudwatch.md)」および「[Performance Insights カウンターメトリクス](USER_PerfInsights_Counters.md)」を参照してください。
+ 拡張モニタリングメトリクス (Amazon CloudWatch Logs に公開)

  これらのメトリクスの表については、「[拡張モニタリングの OS メトリクス](USER_Monitoring-Available-OS-Metrics.md)」を参照してください。
+ AWS アカウント の Amazon RDS サービスクォータの使用状況メトリクス

  これらのメトリクスの表については、「[Amazon RDS の Amazon CloudWatch 使用状況メトリクス](rds-metrics.md#rds-metrics-usage)」を参照してください。Amazon RDS のクォータの詳細については、[Amazon RDS のクォータと制約](CHAP_Limits.md) を参照してください。

CloudWatch の詳細については、*Amazon CloudWatch ユーザーガイド*の「[Amazon CloudWatch とは](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatch.html)」を参照してください。CloudWatch メトリクスの保持の詳細については、「[メトリクスの保持](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/cloudwatch_concepts.html#metrics-retention)」を参照してください。

# CloudWatch コンソールおよび AWS CLI での DB インスタンスメトリクスの表示
<a name="metrics_dimensions"></a>

CloudWatch を使用して DB インスタンスのメトリクスを表示する方法の詳細を次に示します。CloudWatch Logs を使用して DB インスタンスのオペレーティングシステムのメトリクスをリアルタイムでモニタリングする方法については、「[拡張モニタリングを使用した OS メトリクスのモニタリング](USER_Monitoring.OS.md)」を参照してください。

Amazon RDS リソースを使用する場合、Amazon RDS が 1 分ごとにメトリクスとディメンションを Amazon CloudWatch に送信します。

Performance Insights メトリクスダッシュボードを Amazon RDS から Amazon CloudWatch にエクスポートし、これらのメトリクスを CloudWatch コンソールで表示できるようになりました。Performance Insights メトリクスダッシュボードを CloudWatch にエクスポートする方法の詳細については、「[Performance Insights メトリクスの CloudWatch へのエクスポート](PI_metrics_export_CW.md)」を参照してください。

CloudWatch コンソールや CLI で Amazon RDS のメトリクスを表示する場合は、次の手順に従います。

## コンソール
<a name="metrics_dimensions.console"></a>

**Amazon CloudWatch コンソールを使用してメトリクスを表示するには**

メトリクスはまずサービスの名前空間ごとにグループ化され、次に各名前空間内のさまざまなディメンションの組み合わせごとにグループ化されます。

1. CloudWatch コンソール ([https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)) を開きます。

   CloudWatch 概要のホームページが表示されます。  
![\[CloudWatch 概要ページ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/monitoring-overviewpage-console2.png)

1. 必要に応じて AWS リージョン を変更します。ナビゲーションバーから、AWS リソースがある AWS リージョン リージョンを選択します。詳細については、「[リージョンとエンドポイント](https://docs.aws.amazon.com/general/latest/gr/rande.html)」を参照してください。

1. ナビゲーションペインで、**[Metrics]** (メトリクス)、**[All metrics]** (すべてのメトリクス) の順に選択します。  
![\[メトリクスの名前空間を選択する\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/cw-all-metrics.png)

1. 下にスクロールし、**RDS** メトリクス名前空間を選択します。

   ページに Amazon RDS ディメンションが表示されます。これらのディメンションの詳細については、「[Amazon RDS の Amazon CloudWatch ディメンション](dimensions.md)」を参照してください。  
![\[メトリクスの名前空間を選択する\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/rds-monitoring-01.png)

1. メトリクスディメンションを選択します。例えば [**データベースクラス別**] を選択します。  
![\[メトリクスのフィルタリング\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/metrics-by-instance-class.png)

1. 次のアクションのいずれかを実行します。
   + メトリクスを並べ替えるには、列見出しを使用します。
   + メトリクスをグラフ表示するには、メトリクスの横にあるチェックボックスを選択します。
   + リソースでフィルタするには、リソース ID を選択し、[**Add to search**] (検索に追加) を選択します。
   + メトリクスでフィルターするには、メトリクス名を選択し、**[Add to search]** (検索に追加) を選択します。

   次の例では、**db.t3.medium** クラスをフィルタリングし、**CPUUtilization** メトリクスをグラフ化します。  
![\[メトリクスのフィルタリング\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/rds-monitoring-03.png)

## AWS CLI
<a name="metrics_dimensions.CLI"></a>

AWS CLI を使用してメトリクスの情報を取得するには、CloudWatch の [https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) コマンドを使用します。次の例では、`AWS/RDS` 名前空間にすべてのメトリクスがリストされています。

```
aws cloudwatch list-metrics --namespace AWS/RDS
```

メトリクスデータを取得するには、[https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-data.html](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-data.html) コマンドを使用します。

次の例では、特定の 24 時間において 5 分の精度でインスタンス `my-instance` の`CPUUtilization` 統計情報を取得します。

次の内容を含む JSON ファイル `CPU_metric.json` を作成します。

```
 1. {
 2.    "StartTime" : "2023-12-25T00:00:00Z",
 3.    "EndTime" : "2023-12-26T00:00:00Z",
 4.    "MetricDataQueries" : [{
 5.      "Id" : "cpu",	    
 6.      "MetricStat" : {
 7. 	   "Metric" : {	  
 8.   	     "Namespace" : "AWS/RDS",
 9.   	     "MetricName" : "CPUUtilization",
10.   	     "Dimensions" : [{ "Name" : "DBInstanceIdentifier" , "Value" : my-instance}]
11. 	   },  
12.        "Period" : 360,
13.        "Stat" : "Minimum" 
14.      }
15.    }]
16. }
```

**Example**  
Linux、macOS、Unix の場合:  

```
1. aws cloudwatch get-metric-data \
2.     --cli-input-json file://CPU_metric.json
```
Windows の場合:  

```
1. aws cloudwatch get-metric-data ^
2.      --cli-input-json file://CPU_metric.json
```
出力例は次のとおりです。  

```
{
    "MetricDataResults": [
        {
            "Id": "cpu",
            "Label": "CPUUtilization",
            "Timestamps": [
                "2023-12-15T23:48:00+00:00",
                "2023-12-15T23:42:00+00:00",
                "2023-12-15T23:30:00+00:00",
                "2023-12-15T23:24:00+00:00",
                ...
            ],
            "Values": [
                13.299778337027714,
                13.677507543049558,
                14.24976250395827,
                13.02521708695145,
                ...
            ],
            "StatusCode": "Complete"
        }
    ],
    "Messages": []
}
```
詳細については、「*Amazon CloudWatch ユーザーガイド*」の「[メトリクスの統計の取得](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/getting-metric-data.html)」を参照してください。

# Performance Insights メトリクスの CloudWatch へのエクスポート
<a name="PI_metrics_export_CW"></a>

Performance Insights では、DB インスタンスの事前設定済みまたはカスタムメトリクスダッシュボードを Amazon CloudWatch にエクスポートできます。メトリクスダッシュボードを新しいダッシュボードとしてエクスポートするか、それらを既存の CloudWatch ダッシュボードに追加できます。ダッシュボードを既存の CloudWatch ダッシュボードに追加することを選択した場合、ヘッダーラベルを作成して、メトリクスが CloudWatch ダッシュボードの個別のセクションに表示されるようにすることができます。

エクスポートしたメトリクスダッシュボードは、CloudWatch コンソールで表示できます。Performance Insights メトリクスダッシュボードをエクスポートした後に、新しいメトリクスを追加した場合、CloudWatch コンソールに新しいメトリクスを表示するには、このダッシュボードを再度エクスポートする必要があります。

Performance Insights ダッシュボードでメトリクスウィジェットを選択し、CloudWatch コンソールでメトリクスデータを表示することもできます。

CloudWatch コンソールでメトリクスの表示する詳細については、「[CloudWatch コンソールおよび AWS CLI での DB インスタンスメトリクスの表示](metrics_dimensions.md)」を参照してください。

以下のセクションでは、Performance Insights メトリクスを新規または既存のダッシュボードとして CloudWatch にエクスポートし、CloudWatch で Performance Insights メトリクスを表示します。

**Topics**
+ [Performance Insights メトリクスを新しいダッシュボードとして CloudWatch にエクスポート](PI_metrics_export_CW.new_dashboard.md)
+ [既存の CloudWatch ダッシュボードへの Performance Insights メトリクスの追加](PI_metrics_export_CW.existing_dashboard.md)
+ [CloudWatch での Performance Insights メトリクスウィジェットの表示](PI_metrics_export_CW.individual_widget.md)

# Performance Insights メトリクスを新しいダッシュボードとして CloudWatch にエクスポート
<a name="PI_metrics_export_CW.new_dashboard"></a>

Performance Insights ダッシュボードから事前設定済みまたはカスタムのメトリクスダッシュボードを選択し、新しいダッシュボードとして CloudWatch にエクスポートします。エクスポートしたダッシュボードは、CloudWatch コンソールで表示できます。

**Performance Insights メトリクスダッシュボードを新しいダッシュボードとして CloudWatch にエクスポートするには**

1. Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

1. DB インスタンスを選択します。

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

1. 下にスクロールして **[メトリクス]** を選択します。

   デフォルトでは、Performance Insights メトリクスで、事前設定されたダッシュボードが表示されます。

1. 事前設定されたダッシュボードまたはカスタムダッシュボードを選択してから、**[CloudWatch にエクスポート]** を選択します。

   **[CloudWatch にエクスポート]** ウィンドウが表示されます。  
![\[[CloudWatch にエクスポート] ボタンのある Performance Insights ダッシュボード\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/PI-ExprtToCW.png)

1. **[新しいダッシュボードとしてエクスポート]** を選択します。  
![\[[新しいダッシュボードとしてエクスポート] オプションが選択されている [CloudWatch にエクスポート] ウィンドウ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/PI-ExprtToCW-NewDashboard.png)

1. **[ダッシュボード名]** フィールドに新しいダッシュボードの名前を入力し、**[確認]** を選択します。

   ダッシュボードのエクスポートが成功すると、バナーにメッセージが表示されます。  
![\[成功メッセージの記載されたバナー\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/PI-ExprtToCW-SuccessBanner.png)

1. リンクまたはバナーの **[CloudWatch で表示]** を選択すると、CloudWatch コンソールにメトリクスダッシュボードが表示されます。

# 既存の CloudWatch ダッシュボードへの Performance Insights メトリクスの追加
<a name="PI_metrics_export_CW.existing_dashboard"></a>

事前設定済みまたはカスタムのメトリクスダッシュボードを既存の CloudWatch ダッシュボードに追加します。メトリクスダッシュボードにラベルを追加して、CloudWatch ダッシュボードの個別のセクションに表示することができます。

**メトリクスを既存の CloudWatch ダッシュボードにエクスポートするには**

1. Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

1. DB インスタンスを選択します。

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

1. 下にスクロールして **[メトリクス]** を選択します。

   デフォルトでは、Performance Insights メトリクスで、事前設定されたダッシュボードが表示されます。

1. 事前設定されたダッシュボードまたはカスタムダッシュボードを選択し、**[CloudWatch にエクスポート]** を選択します。

   **[CloudWatch にエクスポート]** ウィンドウが表示されます。

1. **[既存のダッシュボードに追加]** を選択します。  
![\[[既存のダッシュボードに追加] オプションを選択した状態の [CloudWatch にエクスポート] ウィンドウ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/Pi-ExprtToCW-AddToExistingBoard.png)

1. ダッシュボードの送信先とラベルを指定し、**[確認]** を選択します。
   + **[CloudWatch ダッシュボードの送信先]** - 既存の CloudWatch ダッシュボードを選択します。
   + **[CloudWatch ダッシュボードセクションラベル - オプション]** - CloudWatch ダッシュボードのこのセクションに表示する Performance Insights メトリクスの名前を入力します。

   ダッシュボードのエクスポートが成功すると、バナーにメッセージが表示されます。

1. リンクまたはバナーの **[CloudWatch で表示]** を選択すると、CloudWatch コンソールにメトリクスダッシュボードが表示されます。

# CloudWatch での Performance Insights メトリクスウィジェットの表示
<a name="PI_metrics_export_CW.individual_widget"></a>

Amazon RDS Performance Insights ダッシュボードで Performance Insights メトリクスウィジェットを選択し、CloudWatch コンソールでメトリクススデータを表示します。

**メトリクスウィジェットをエクスポートして CloudWatch コンソールでメトリクスデータを表示するには**

1. Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

1. DB インスタンスを選択します。

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

1. **[メトリクス]** までスクロールします。

   デフォルトでは、Performance Insights メトリクスで、事前設定されたダッシュボードが表示されます。

1. メトリクスウィジェットを選択し、メニューで **[CloudWatch で表示]** を選択します。  
![\[[CloudWatch で表示] メニューのある選択したウィジェット\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/PI-ExprtToCW-SelectedMetric.png)

   メトリクスデータは CloudWatch コンソールに表示されます。

# Amazon RDS をモニタリングするための CloudWatch アラームの作成
<a name="creating_alarms"></a>

アラームの状態が変わったら、Amazon SNS メッセージを送信する Amazon CloudWatch のアラームを作成することができます。1 つのアラームで、指定した期間中、1 つのメトリクスをモニタリングします。アラームは、指定された複数の期間にわたるしきい値に関連するメトリクスの値に基づいて、1 つ以上のアクションを実行することもできます。アクションは、Amazon SNS トピックまたは Amazon EC2 Auto Scaling ポリシーに送信される通知です。

アラームは、持続している状態変化に対してのみアクションを呼び出します。CloudWatch アラームは、特定の状態にあるというだけの理由ではアクションを呼び出しません。状態が変わって、変わった状態が指定期間にわたって維持される必要があります。

CloudWatch コンソールの **DB\$1PERF\$1INSIGHTS** メトリクス数学関数を使用して Amazon RDS にクエリを実行し、Performance Insights カウンターメトリクスを取得できます。**DB\$1PERF\$1INSIGHTS** 関数には、1 分未満の間隔での DBLoad メトリクスも含まれます。これらのメトリクスに基づいた CloudWatch アラームを設定することができます。

アラームの作成方法の詳細については、「[AWS データベースから Performance Insights カウンターメトリクスのアラームを作成する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_alarm_database_performance_insights.html)」を参照してください。

**AWS CLI を使用してアラームを設定するには**
+ [https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-alarm.html](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-alarm.html) を呼び出します。詳細については、「*[AWS CLI コマンドリファレンス](https://docs.aws.amazon.com/cli/latest/reference/)*」を参照してください。

**CloudWatch API を使用してアラームを設定するには**
+ を呼び出します。[https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)詳細については、*[Amazon CloudWatch API リファレンス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/)*を参照してください。

Amazon SNS トピックの設定およびアラームの作成の詳細については、「[Amazon CloudWatch アラームの使用](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)」を参照してください。

# チュートリアル: Amazon RDS のマルチ AZ DB クラスターレプリカラグ用の Amazon CloudWatch アラームを作成する
<a name="multi-az-db-cluster-cloudwatch-alarm"></a>

マルチ AZ DB クラスターのレプリカ遅延がしきい値を超えたときに Amazon SNS メッセージを送信する Amazon CloudWatch アラームを作成できます。1 つのアラームで、指定した期間中、`ReplicaLag` メトリクスを監視します。アクションは、Amazon SNS トピックまたは Amazon EC2 Auto Scaling ポリシーに送信される通知です。

**マルチ AZ DB クラスターレプリカラグ用の CloudWatch アラームを設定するには**

1. AWS マネジメントコンソール にサインインして、CloudWatch コンソール ([https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)) を開きます。

1. ナビゲーションペインで、**[アラーム]**、**[すべてのアラーム]** の順に選択します。

1. [**アラームの作成**] を選択します。

1. **[Specify metric and conditions]** (メトリクスと条件の指定) ページで、**[Select metric]** (メトリクスの選択) を選択します。

1. 検索ボックスに、マルチ AZ DB クラスターの名前を入力し、Enter キーを押します。

   次の図は、`rds-cluster` という名前のマルチ AZ DB クラスターが入力された **[Select metric]** (メトリクスの選択) ページを示しています。  
![\[[Select metric] (メトリクスの選択) ページ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/multi-az-db-cluster-cw-tutorial-select-metric.png)

1. **[RDS]**、**[Per-Database Metrics]** (データベース別メトリクス) を順に選択します。

1. 検索ボックスに「**ReplicaLag**」と入力して Enter キーを押し、DB クラスター内の各 DB インスタンスを選択します。

   次の図は、**ReplicaLag** メトリクスに DB インスタンスが選択されている **[Select metric]** (メトリクスの選択) ページを示しています。  
![\[ReplicaLag メトリクスに DB インスタンスが選択されている [Select metric] (メトリクスの選択) ページ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/multi-az-db-cluster-cw-tutorial-metric-replica-lag.png)

   このアラームでは、マルチ AZ DB クラスター内の 3 つの DB インスタンスすべてのレプリカラグが考慮されます。いずれかの DB インスタンスがしきい値を超えると、アラームが応答します。アラームでは、3 つのメトリクスの最大値を返す数式が使用されています。まず、メトリクス名でソートしてから、3 つの **ReplicaLag** メトリクスすべてを選択します。

1. **[Add math]** (算術の追加) で、**[All functions]** (すべての関数)、**[MAX]** (最大) を順に選択します。  
![\[[Add math] (算術の追加) 設定\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/multi-az-db-cluster-cw-tutorial-select-metric-math.png)

1. **[Graphed metrics]** (グラフ化したメトリクス) タブを選択し、**Expression1** の詳細を **MAX([m1,m2,m3])** に編集します。

1. 3 つの **ReplicaLag** メトリクスすべてについて、**[Period]** (期間) を **1 分**に変更します。

1. **Expression1** を除くすべてのメトリクスの選択を解除します。

   **[Select metric]** (メトリクスの選択) ページは、次の図のようになります。  
![\[メトリクスが選択された [Select metric] (メトリクスの選択) ページ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/multi-az-db-cluster-cw-tutorial-select-metric-expression1.png)

1. **[メトリクスの選択]** を選択します。

1. **[Specify metric and conditions]** (メトリクスと条件の指定) ページで、ラベルをわかりやすい名前 (**ClusterReplicaLag** など) に変更し、**[Define the threshold value]** (しきい値の定義) で秒数を入力します。このチュートリアルでは、「**1200**」秒 (20 分) と入力します。この値は、ワークロード要件に合わせて調整できます。

   **[Specify metric and conditions]** (メトリクスと条件の指定) ページは、次の図のようになります。  
![\[[Specify metric and conditions] (メトリクスと条件の指定) ページ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/multi-az-db-cluster-cw-tutorial-specify-metric-conditions.png)

1. **[Next]** (次へ) をクリックすると、**[Configure actions]** (アクションの設定) ページが表示されます。

1. **[In alarm]** (アラーム状態) を選択したまま、**[Create new topic]** (新しいトピックの作成) 選択し、トピック名と有効な E メールアドレスを入力します。  
![\[[Configure actions] (アクションの設定) ページ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/multi-az-db-cluster-cw-tutorial-configure-actions.png)

1. **[Create topic]** (トピックの作成) を選択してから、**[Next]** (次へ) をクリックします。

1. **[Add name and description]** (名前と説明を追加) ページで、**アラーム名**と**アラームの説明**を入力し、**[Next]** (次へ) をクリックします。  
![\[[Add name and description] (名前と説明を追加) ページ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/multi-az-db-cluster-cw-tutorial-add-name-and-description.png)

1. **[Preview and create]** (プレビューと作成) ページで、作成しようとしているアラームをプレビューしてから、**[Create alarm]** (アラームの作成) を選択します。

# CloudWatch Database Insights による Amazon RDS データベースのモニタリング
<a name="USER_DatabaseInsights"></a>

Amazon RDS DB インスタンスのフリートのデータベース負荷 (DB 負荷) は、Database Insights を使用してモニタリングします。DB 負荷は、データベース内のセッションアクティビティのレベルを測定するものです。Database Insights を使用して、Amazon RDS データベースのパフォーマンスを大規模に分析およびトラブルシューティングできます。

Database Insights を使用してデータベースのフリートの DB 負荷を視覚化したり、負荷を待機、SQL ステートメント、ホスト、ユーザー別にフィルタリングしたりできます。

RDS では、Amazon RDS データベースに対してデフォルトで Database Insights のスタンダードモードが有効になっています。

Amazon CloudWatch コンソールで Database Insights を使用する方法については、「*Amazon CloudWatch ユーザーガイド*」の「[CloudWatch Database Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Database-Insights.html)」を参照してください。

## 料金
<a name="USER_Database-Insights-pricing"></a>

料金の詳細については、「[Amazon CloudWatch の料金](https://aws.amazon.com/cloudwatch/pricing/)」を参照してください。

**Topics**
+ [料金](#USER_Database-Insights-pricing)
+ [Amazon RDS エンジン、リージョン、インスタンスクラスの Database Insights のサポート](USER_DatabaseInsights.Engines.md)
+ [Amazon RDS で Database Insights のアドバンストモードを有効にする](USER_DatabaseInsights.TurningOnAdvanced.md)
+ [Amazon RDS で Database Insights のスタンダードモードを有効にする](USER_DatabaseInsights.TurningOnStandard.md)
+ [Amazon RDS の Database Insights でスロー SQL クエリをモニタリングするようにデータベースを設定する](USER_DatabaseInsights.SlowSQL.md)
+ [Amazon RDS の Database Insights に関する考慮事項](USER_DatabaseInsights.Considerations.md)

# Amazon RDS エンジン、リージョン、インスタンスクラスの Database Insights のサポート
<a name="USER_DatabaseInsights.Engines"></a>

次の表に、Database Insights をサポートしている Amazon RDS DB エンジンを示します。


|  Amazon RDS DB エンジン  | サポート対象のエンジンバージョンとリージョン | インスタンスクラスに関する制限 | 
| --- | --- | --- | 
|  Amazon RDS for MariaDB  |  RDS for MariaDB に関する Database Insights のバージョンとリージョンの可用性の詳細については、「[Amazon RDS の Performance Insights でサポートされているリージョンと DB エンジン](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md)」を参照してください。  |  Database Insights は、次のインスタンスクラスではサポートされていません。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/USER_DatabaseInsights.Engines.html)  | 
|  RDS for MySQL  |  RDS for MySQL で Database Insights が使用できるバージョンとリージョンの詳細については、「[Amazon RDS の Performance Insights でサポートされているリージョンと DB エンジン](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md)」を参照してください。  |  Database Insights は、次のインスタンスクラスではサポートされていません。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/USER_DatabaseInsights.Engines.html)  | 
|  Amazon RDS for Microsoft SQL Server  |  RDS for SQL Server で Database Insights が使用できるバージョンとリージョンの詳細については、「[Amazon RDS の Performance Insights でサポートされているリージョンと DB エンジン](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md)」を参照してください。  |  該当なし  | 
|  Amazon RDS for PostgreSQL  |  RDS for PostgreSQL で Database Insights が使用できるバージョンとリージョンの詳細については、「[Amazon RDS の Performance Insights でサポートされているリージョンと DB エンジン](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md)」を参照してください。  |  該当なし  | 
|  Amazon RDS for Oracle  |  RDS for Oracle で Database Insights が使用できるバージョンとリージョンの詳細については、「[Amazon RDS の Performance Insights でサポートされているリージョンと DB エンジン](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md)」を参照してください。  |  該当なし  | 

## Amazon RDS DB エンジン、リージョン、インスタンスクラスの Database Insights のサポート
<a name="database-insights-feature-support"></a>

次の表に、Database Insights の機能をサポートしている Amazon RDS DB エンジンを示します。


| 機能 | [料金階層](https://aws.amazon.com/rds/performance-insights/pricing/) |  [サポートされるリージョン](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html#Concepts.RegionsAndAvailabilityZones.Regions)  |  [サポートされる DB エンジン](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html#Welcome.Concepts.DBInstance)  |  [サポートされるインスタンスクラス](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html#Concepts.DBInstanceClass.Types)  | 
| --- | --- | --- | --- | --- | 
| [Performance Insights の SQL 統計](sql-statistics.md) | すべて | すべて |  すべて  | すべて | 
| [Amazon RDS の Performance Insights ダッシュボードを使用した Oracle 実行プランの分析](USER_PerfInsights.UsingDashboard.AccessPlans.md) | すべて | すべて |  RDS for Oracle  | すべて | 
| [一定期間のデータベースパフォーマンスの分析](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md) | 有料階層のみ |  すべて  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/USER_DatabaseInsights.Engines.html)  |  すべて  | 
|  [Performance Insights のプロアクティブ推奨事項の表示](USER_PerfInsights.InsightsRecommendationViewDetails.md) | 有料階層のみ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/USER_DatabaseInsights.Engines.html)  |  すべて  | すべて  | 

## Amazon RDS が Database Insights をサポートしているリージョン
<a name="database-insights-region-support"></a>

Amazon RDS は、次の AWS リージョンで Database Insights をサポートしています。
+ 米国東部 (バージニア北部)
+ 米国東部 (オハイオ)
+ 米国西部 (北カリフォルニア)
+ 米国西部 (オレゴン)
+ アフリカ (ケープタウン)
+ アジアパシフィック (香港)
+ アジアパシフィック (ハイデラバード)
+ アジアパシフィック (ジャカルタ)
+ アジアパシフィック (マレーシア)
+ アジアパシフィック (メルボルン)
+ アジアパシフィック (ムンバイ)
+ アジアパシフィック (大阪)
+ アジアパシフィック (ソウル)
+ アジアパシフィック (シンガポール)
+ アジアパシフィック (シドニー)
+ アジアパシフィック (東京)
+ カナダ (中部)
+ カナダ西部 (カルガリー)
+ 欧州 (フランクフルト)
+ 欧州 (アイルランド)
+ 欧州 (ロンドン)
+ 欧州 (ミラノ)
+ 欧州 (パリ)
+ 欧州 (スペイン)
+ 欧州 (ストックホルム)
+ 欧州 (チューリッヒ)
+ イスラエル (テルアビブ)
+ 中東 (バーレーン)
+ 中東 (アラブ首長国連邦)
+ 南米 (サンパウロ)
+ AWS GovCloud (米国東部)
+ AWSGovCloud(米国西部)

# Amazon RDS で Database Insights のアドバンストモードを有効にする
<a name="USER_DatabaseInsights.TurningOnAdvanced"></a>

Amazon RDS で Database Insights のアドバンストモードを有効にするには、次の手順を使用します。

## DB インスタンスまたはマルチ AZ DB クラスターの作成時に Database Insights のアドバンストモードを有効にする
<a name="USER_DatabaseInsights.TurnOnCreateDatabase"></a>

Amazon RDS のデータベースを作成するときに、Database Insights のアドバンストモードを有効にします。

------
#### [ Console ]

コンソールで、DB インスタンスまたマルチ AZ DB クラスターを作成するときに Database Insights のアドバンストモードを有効にできます。

**コンソールを使用して DB インスタンスまたはマルチ AZ DB クラスターを作成するときに Database Insights のアドバンストモードを有効にするには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. [**データベース**] をクリックします。

1. **[データベースの作成]** を選択します。

1. **[Database Insights]** セクションで **[アドバンストモード]** を選択し、次のいずれかのオプションを選択します。
   + **保持期間** - Performance Insights データを保持する期間。Database Insights のアドバンストモードでは、保持期間は 15 か月とする必要があります。
   + **AWS KMS key** - KMS キーを指定します。Performance Insights は、潜在的に機密性の高いすべてのデータを KMS キーを使用して暗号化します。データは、転送中と不使用時のいずれも暗号化されます。詳細については、「[Amazon RDS リソースの暗号化](Overview.Encryption.md)」を参照してください。

1. [**データベースの作成**] を選択します。

------
#### [ AWS CLI ]

DB インスタンスまたマルチ AZ DB クラスターの作成時に Database Insights のアドバンストモードを有効にするには、[create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) または [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) AWS CLI コマンドを呼び出し、次の値を指定します。
+ `--database-insights-mode advanced` – Database Insights のアドバンストモードを有効にします。
+ `--engine` – DB インスタンス のデータベースエンジン。
+ `--db-instance-identifier` - DB インスタンスの識別子または `--db-cluster-identifier` - マルチ AZ DB クラスターの識別子。
+ `--enable-performance-insights` – Database Insights の Performance Insights を有効にします。
+ `--performance-insights-retention-period` – DB インスタンスまたはマルチ AZ DB クラスターのデータの保持期間。Database Insights を有効にするには、保持期間を 465 日以上にする必要があります。

次の例では、DB インスタンスの作成時に Database Insights のアドバンストモードを有効にします。

Linux、macOS、Unix の場合:

```
aws rds create-db-instance \
    --database-insights-mode advanced \ 
    --engine postgresql \
    --db-instance-identifier sample-db-identifier \
    --enable-performance-insights \
    --performance-insights-retention-period 465
```

Windows の場合:

```
aws rds create-db-instance ^
    --database-insights-mode advanced ^ 
    --engine postgresql ^
    --db-instance-identifier sample-db-identifier ^
    --enable-performance-insights ^
    --performance-insights-retention-period 465
```

------
#### [ RDS API ]

DB インスタンスまたはマルチ AZ DB クラスターの作成時に Database Insights のアドバンストモードを有効にするには、[CreateDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) または [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) Amazon RDS API オペレーションに次のパラメータを指定します。
+ `DatabaseInsightsMode`～`advanced`
+ `EnablePerformanceInsights`～`True`
+ `PerformanceInsightsRetentionPeriod` – 465 日以上

------

## DB インスタンスまたはマルチ AZ DB クラスターの変更時に Database Insights のアドバンストモードを有効にする
<a name="USER_DatabaseInsights.TurnOnModifyDatabase"></a>

Amazon RDS のデータベースを変更するときに Database Insights を有効にします。DB インスタンスを変更して Database Insights のアドバンストモードを有効にしても、ダウンタイムは発生しません。

**注記**  
Database Insights を有効にするには、マルチ AZ DB クラスター内の各 DB インスタンスに、同じ Performance Insights と拡張モニタリング設定が必要です。

------
#### [ Console ]

コンソールで、DB インスタンスまたマルチ AZ DB クラスターを変更するときに Database Insights のアドバンストモードを有効にできます。

**コンソールを使用して DB インスタンスまたはマルチ AZ DB クラスターを変更するときに Database Insights のアドバンストモードを有効にするには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. [**データベース**] をクリックします。

1. DB インスタンスまたはマルチ AZ DB クラスターを選択した上で、**[Modify]** (変更) を選択します。

1. **[Database Insights]** セクションで **[アドバンストモード]** を選択し、次のいずれかのオプションを選択します。
   + **保持期間** - Performance Insights データを保持する期間。Database Insights のアドバンストモードでは、保持期間は 15 か月とする必要があります。
   + **AWS KMS key** - KMS キーを指定します。Performance Insights は、潜在的に機密性の高いすべてのデータを KMS キーを使用して暗号化します。データは、転送中と不使用時のいずれも暗号化されます。詳細については、「[Amazon RDS リソースの暗号化](Overview.Encryption.md)」を参照してください。

1. [**続行**] を選択します。

1. [**Scheduling of Modifications**] で、[**Apply immediately**] を選択します。**[スケジュールされた次回のメンテナンス時間帯に適用]** を選択すると、データベースではこの設定が無視され、Database Insights のアドバンストモードが直ちに有効になります。

1. **[インスタンスの変更]** を選択します。

------
#### [ AWS CLI ]

DB インスタンスまたマルチ AZ DB クラスターの変更時に Database Insights のアドバンストモードを有効にするには、[modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) または [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) AWS CLI コマンドを呼び出し、次の値を指定します。
+ `--database-insights-mode advanced` – Database Insights のアドバンストモードを有効にします。
+ `--db-instance-identifier` - DB インスタンスの識別子または `--db-cluster-identifier` - マルチ AZ DB クラスターの識別子。
+ `--enable-performance-insights` – Database Insights の Performance Insights を有効にします。
+ `--performance-insights-retention-period` – DB インスタンスのデータの保持期間。Database Insights のアドバンストモードを有効にするには、保持期間を 465 日以上にする必要があります。

次の例では、DB インスタンスの変更時に Database Insights のアドバンストモードを有効にします。

Linux、macOS、Unix の場合:

```
aws rds modify-db-instance \
    --database-insights-mode advanced \
    --db-instance-identifier sample-db-identifier \
    --enable-performance-insights \
    --performance-insights-retention-period 465
```

Windows の場合:

```
aws rds modify-db-instance ^
    --database-insights-mode advanced ^
    --db-instance-identifier sample-db-identifier ^
    --enable-performance-insights ^
    --performance-insights-retention-period 465
```

------
#### [ RDS API ]

DB インスタンスまたはマルチ AZ DB クラスターの変更時に Database Insights のアドバンストモードを有効にするには、[ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) または [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) Amazon RDS API オペレーションに次のパラメータを指定します。
+ `DatabaseInsightsMode`～`advanced`
+ `EnablePerformanceInsights`～`True`
+ `PerformanceInsightsRetentionPeriod` ～ 465 日以上

------

# Amazon RDS で Database Insights のスタンダードモードを有効にする
<a name="USER_DatabaseInsights.TurningOnStandard"></a>

Amazon RDS で Database Insights のスタンダードモードを有効にするには、次の手順を使用します。

## DB インスタンスまたはマルチ AZ DB クラスターの作成時に Database Insights のスタンダードモードを有効にする
<a name="USER_DatabaseInsights.TurnOnCreateDatabaseStandard"></a>

Amazon RDS のデータベースを作成するときに、Database Insights のスタンダードモードを有効にします。

------
#### [ Console ]

コンソールで、DB インスタンスまたはマルチ AZ DB クラスターを作成するときに Database Insights のスタンダードモードを有効にできます。

**コンソールを使用して DB インスタンスまたはマルチ AZ DB クラスターを作成するときに Database Insights のスタンダードモードを有効にするには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. [**データベース**] をクリックします。

1. **[データベースの作成]** を選択します。

1. **[Database Insights]** セクションで **[スタンダードモード]** を選択し、次のオプションから選択して Performance Insights のオンとオフを切り替えます。
   + Performance Insights を無効にするには、**[Performance Insights を有効にする]** の選択を解除します。
   + Performance Insights を有効にするには、**[Performance Insights を有効にする]** を選択します。Performance Insights を設定するには、次のオプションを指定します。
     + **保持期間** - Performance Insights データを保持する期間。保持期間は 7 日以上にする必要があります。
     + **AWS KMS key** - KMS キーを指定します。Performance Insights は、潜在的に機密性の高いすべてのデータを KMS キーを使用して暗号化します。データは、転送中と不使用時のいずれも暗号化されます。詳細については、「[Amazon RDS リソースの暗号化](Overview.Encryption.md)」を参照してください。

1. **[データベースの作成]** を選択します。

------
#### [ AWS CLI ]

DB インスタンスまたマルチ AZ DB クラスターの作成時に Database Insights のスタンダードモードを有効にするには、[create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) または [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) AWS CLI コマンドを呼び出し、次の値を指定します。
+ `--database-insights-mode standard` – Database Insights のスタンダードモードを有効にします。
+ `--engine` – DB インスタンス のデータベースエンジン。
+ `--db-instance-identifier` - DB インスタンスの識別子または `--db-cluster-identifier` - マルチ AZ DB クラスターの識別子。
+ `--enable-performance-insights` または `--no-enable-performance-insights` – Performance Insights を有効または無効にします。`--enable-performance-insights` を指定する場合は、`--performance-insights-retention-period` (DB インスタンスのデータの保持期間) も指定する必要があります。保持期間は 7 日以上にする必要があります。

次の例では、DB インスタンスに Database Insights のスタンダードモードと Performance Insights を有効にします。

Linux、macOS、Unix の場合:

```
aws rds create-db-instance \
    --database-insights-mode standard \ 
    --engine postgresql \
    --db-instance-identifier sample-db-identifier \
    --enable-performance-insights \
    --performance-insights-retention-period 7
```

Windows の場合:

```
aws rds create-db-instance ^
    --database-insights-mode standard ^ 
    --engine postgresql ^
    --db-instance-identifier sample-db-identifier ^
    --enable-performance-insights ^
    --performance-insights-retention-period 7
```

次の例では、DB インスタンスに Database Insights のスタンダードモードと Performance Insights を有効および無効にします。

Linux、macOS、Unix の場合:

```
aws rds create-db-instance \
    --database-insights-mode standard \ 
    --engine postgresql \
    --db-instance-identifier sample-db-identifier \
    --no-enable-performance-insights
```

Windows の場合:

```
aws rds create-db-instance ^
    --database-insights-mode standard ^ 
    --engine postgresql ^
    --db-instance-identifier sample-db-identifier ^
    --no-enable-performance-insights
```

------
#### [ RDS API ]

DB インスタンスまたはマルチ AZ DB クラスターの作成時に Database Insights のスタンダードモードを有効にするには、[CreateDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) または [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) Amazon RDS API オペレーションに次のパラメータを指定します。
+ `DatabaseInsightsMode`～`standard`
+ `EnablePerformanceInsights` ～ `True` または `False`。`EnablePerformanceInsights` を `True` に設定する場合は、`PerformanceInsightsRetentionPeriod` を 7 日以上に設定する必要があります。

------

## DB インスタンスまたはマルチ AZ DB クラスターの変更時に Database Insights のスタンダードモードを有効にする
<a name="USER_DatabaseInsights.TurnOnModifyDatabaseStandard"></a>

Amazon RDS のデータベースを変更するときに Database Insights のスタンダードモードを有効にします。DB インスタンスを変更して Database Insights の標準モードを有効にしても、ダウンタイムは発生しません。

**注記**  
Database Insights を有効にするには、マルチ AZ DB クラスター内の各 DB インスタンスに、同じ Performance Insights と拡張モニタリング設定が必要です。

------
#### [ Console ]

コンソールで、DB インスタンスまたはマルチ AZ DB クラスターを作成するときに Database Insights のスタンダードモードを有効にできます。

**コンソールを使用して DB インスタンスまたはマルチ AZ DB クラスターを変更するときに Database Insights のスタンダードモードを有効にするには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. [**データベース**] をクリックします。

1. DB インスタンスまたはマルチ AZ DB クラスターを選択した上で、**[Modify]** (変更) を選択します。

1. **[Database Insights]** セクションで **[スタンダードモード]** を選択し、次のオプションから選択します。
   + Performance Insights を無効にするには、**[Performance Insights を有効にする]** の選択を解除します。
   + Performance Insights を有効にするには、**[Performance Insights を有効にする]** を選択します。Performance Insights を設定するには、次のオプションを指定します。
     + **保持期間** - Performance Insights データを保持する期間。保持期間は 7 日以上にする必要があります。
     + **AWS KMS key** - KMS キーを指定します。Performance Insights は、潜在的に機密性の高いすべてのデータを KMS キーを使用して暗号化します。データは、転送中と不使用時のいずれも暗号化されます。詳細については、「[Amazon RDS リソースの暗号化](Overview.Encryption.md)」を参照してください。

1. [**続行**] を選択します。

1. [**Scheduling of Modifications**] で、[**Apply immediately**] を選択します。**[スケジュールされた次回のメンテナンス時間帯に適用]** を選択すると、データベースではこの設定が無視され、Database Insights のスタンダードモードが直ちに有効になります。

1. **[インスタンスの変更]** を選択します。

------
#### [ AWS CLI ]

DB インスタンスまたマルチ AZ DB クラスターの変更時に Database Insights のスタンダードモードを有効にするには、[modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) または [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) AWS CLI コマンドを呼び出し、次の値を指定します。
+ `--database-insights-mode standard` – Database Insights のスタンダードモードを有効にします。
+ `--db-instance-identifier` - DB インスタンスの識別子または `--db-cluster-identifier` - マルチ AZ DB クラスターの識別子。
+ `--enable-performance-insights` または `--no-enable-performance-insights` – Performance Insights を有効または無効にします。`--enable-performance-insights` を指定する場合は、`--performance-insights-retention-period` (DB インスタンスまたはマルチ AZ DB クラスターのデータの保持期間) も指定する必要があります。保持期間は 7 日以上にする必要があります。

次の例では、DB インスタンスの変更時に Database Insights のスタンダードモードを有効にし、Performance Insights を有効にします。

Linux、macOS、Unix の場合:

```
aws rds modify-db-instance \
    --database-insights-mode standard \
    --db-instance-identifier sample-db-identifier \
    --enable-performance-insights \
    --performance-insights-retention-period 7
```

Windows の場合:

```
aws rds modify-db-instance ^
    --database-insights-mode standard ^
    --db-instance-identifier sample-db-identifier ^
    --enable-performance-insights ^
    --performance-insights-retention-period 7
```

次の例では、DB インスタンスの変更時に Database Insights のスタンダードモードを有効にし、Performance Insights を無効にします。

Linux、macOS、Unix の場合:

```
aws rds modify-db-instance \
    --database-insights-mode standard \
    --db-instance-identifier sample-db-identifier \
    --no-enable-performance-insights
```

Windows の場合:

```
aws rds modify-db-instance ^
    --database-insights-mode standard ^
    --db-instance-identifier sample-db-identifier ^
    --no-enable-performance-insights
```

------
#### [ RDS API ]

DB インスタンスまたはマルチ AZ DB クラスターの変更時に Database Insights のスタンダードモードを有効にするには、[ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) または [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) Amazon RDS API オペレーションに次のパラメータを指定します。
+ `DatabaseInsightsMode`～`standard`
+ `EnablePerformanceInsights` ～ `True` または `False`。`EnablePerformanceInsights` を `True` に設定する場合は、`PerformanceInsightsRetentionPeriod` を 7 日以上に設定する必要があります。

------

# Amazon RDS の Database Insights でスロー SQL クエリをモニタリングするようにデータベースを設定する
<a name="USER_DatabaseInsights.SlowSQL"></a>

データベースのスロー SQL クエリをモニタリングするには、Database Insights ダッシュボードの **[スロー SQL クエリ]** セクションを使用できます。スロー SQL クエリをモニタリングするようにデータベースを設定する前は、**[スロー SQL クエリ]** セクションは空白です。

Database Insights ダッシュボードでのスロー SQL クエリのモニタリングの詳細については、「*Amazon CloudWatch ユーザーガイド*」の「[CloudWatch Database Insights のデータベースインスタンスダッシュボードの表示](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Database-Insights-Database-Instance-Dashboard.html)」を参照してください。

Database Insights を使用して、スロー SQL クエリをモニタリングするようにデータベースを設定するには、次の手順を実行します。

1. CloudWatch Logs へのログエクスポートを有効にします。

1. DB インスタンスの DB パラメータグループを作成または変更します。

ログエクスポートの設定方法については、「*Amazon RDS ユーザーガイド*」の「[Amazon CloudWatch Logs へのデータベースログの発行](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch)」を参照してください。

DB パラメータグループを作成または変更するには、以下のトピックを参照してください。
+ [Amazon RDS での DB パラメータグループの作成](USER_WorkingWithParamGroups.Creating.md)
+ [Amazon RDS の DB パラメータグループのパラメータの変更](USER_WorkingWithParamGroups.Modifying.md)

------
#### [ RDS for MariaDB ]

スロー SQL クエリをモニタリングするように RDS for MariaDB DB インスタンスを設定するには、次のパラメータを設定します。
+ `log_slow_query` - `1` に設定
+ `log_slow_query_time` - `1.0` に設定
+ `log_output` - `FILE` に設定

------
#### [ RDS for MySQL ]

スロー SQL クエリをモニタリングするように RDS for MySQL DB インスタンスを設定するには、次のパラメータを設定します。
+ `slow_query_log` - `1` に設定
+ `long_query_time` - `1.0` に設定
+ `log_output` - `FILE` に設定

------
#### [ RDS for PostgreSQL ]

スロー SQL クエリをモニタリングするように RDS for PostgreSQL DB インスタンスを設定するには、次のパラメータを設定します。これらのパラメータを設定すると、DB インスタンスのパフォーマンスが低下する可能性があることに注意してください。
+ `log_min_duration_statement` - `1000` に設定
+ `log_statement` - `none` に設定
+ `log_destination` - `stderr` に設定

------

**注記**  
RDS for MySQL では、`long_query_time` パラメータを 1 マイクロ秒の精度で設定できます。例えば、このパラメータを `0.000001` に設定できます。DB インスタンスのクエリの量によっては、`long_query_time` パラメータの値によってパフォーマンスが低下する可能性があります。値 `1.0` から開始し、ワークロードに基づいて調整します。このパラメータを `0` に設定すると、Database Insights はすべてのクエリをログに記録します。

RDS for MariaDB、RDS for MySQL、および RDS for PostgreSQL ログの詳細については、以下を参照してください。
+ [MariaDB データベースのログファイル](USER_LogAccess.Concepts.MariaDB.md)
+ [ MySQL データベースのログファイル](USER_LogAccess.Concepts.MySQL.md)
+ [ RDS for PostgreSQL データベースログファイル](USER_LogAccess.Concepts.PostgreSQL.md)

# Amazon RDS の Database Insights に関する考慮事項
<a name="USER_DatabaseInsights.Considerations"></a>

Amazon RDS の Database Insights に関する考慮事項を次に示します。
+ 特定の マルチ AZ DB クラスター内の特定の DB インスタンスで Database Insights を管理することはできません。
+ Database Insights のアドバンストモードを有効にするには、Performance Insights を有効にし、Performance Insights の保持期間を少なくとも 465 日 (15 か月) に設定する必要があります。Performance Insights の保持期間を15 か月に設定しても、Database Insights のコスト以外に追加のコストは発生しません。Database Insights の料金については、「[Amazon CloudWatch 料金表](https://aws.amazon.com/cloudwatch/pricing/)」を参照してください。
+ Database Insights を有効にするには、マルチ AZ DB クラスター内の各 DB インスタンスに、同じ Performance Insights と拡張モニタリング設定が必要です。
+ Database Insights のいずれかのモードを有効にするために DB インスタンスを変更しても、ダウンタイムは発生しません。

# Amazon RDS での Performance Insights を使用したDB 負荷のモニタリング
<a name="USER_PerfInsights"></a>

**重要**  
 AWS は、Performance Insights のサポート終了日を 2026 年 6 月 30 日と発表しました。この日以降、Amazon RDS は Performance Insights コンソールのエクスペリエンス、柔軟な保持期間 (1～24 か月)、および関連する料金のサポートを終了します。Performance Insights API は存続し、料金の変更はありません。Performance Insights API の料金は、CloudWatch Database Insights の料金とともに AWS 請求書に表示されます。  
 Performance Insights の有料利用枠を使用する DB インスタンスは、2026 年 6 月 30 日より前に Database Insights のアドバンストモードにアップグレードすることをお勧めします。Database Insights のアドバンストモードへのアップグレード方法については、「[Amazon RDS で Database Insights のアドバンストモードを有効にする](USER_DatabaseInsights.TurningOnAdvanced.md)」を参照してください。  
 アクションを実行しない場合、Performance Insights を使用する DB インスタンスは、デフォルトで Database Insights のスタンダードモードを使用します。Database Insights のスタンダードモードでは、7 日間を超えたパフォーマンスデータ履歴、実行プラン機能とオンデマンド分析機能が Amazon RDS コンソールで利用できなくなる可能性があります。2026 年 6 月 30 日以降、Database Insights のアドバンストモードのみが実行プランとオンデマンド分析をサポートします。  
 CloudWatch Database Insights を使用すると、データベースのフリートのデータベース負荷をモニタリングし、パフォーマンスの大規模な分析とトラブルシューティングを行うことができます。Database Insights の詳細については、「[CloudWatch Database Insights による Amazon RDS データベースのモニタリング](USER_DatabaseInsights.md)」を参照してください。詳細については、[Amazon CloudWatch 料金表](https://aws.amazon.com/cloudwatch/pricing/)をご覧ください。

Performance Insights は、既存の Amazon RDS モニタリング機能を拡張して、データベースのパフォーマンスを明確にし、分析しやすくします。Performance Insights ダッシュボードを使用してAmazon RDS DB インスタンスのロードのデータベースロードを視覚化したり、ロードを待機、SQL ステートメント、ホスト、ユーザー別にフィルタリングしたりできます。Amazon DocumentDB での Performance Insights 使用については、「*[Amazon DocumentDB デベロッパーガイド](https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html)*」を参照してください。

**Topics**
+ [Amazon RDS での Performance Insights の概要](USER_PerfInsights.Overview.md)
+ [Amazon RDS の Performance Insights の有効化と無効化](USER_PerfInsights.Enabling.md)
+ [Amazon RDS for MariaDB または MySQL における Performance Insights のPerformance Schema の概要](USER_PerfInsights.EnableMySQL.md)
+ [Performance Insights 用のアクセスポリシーの設定](USER_PerfInsights.access-control.md)
+ [Performance Insights ダッシュボードを使用してメトリクスを分析する](USER_PerfInsights.UsingDashboard.md)
+ [Performance Insights のプロアクティブ推奨事項の表示](USER_PerfInsights.InsightsRecommendationViewDetails.md)
+ [Performance Insights API for Amazon RDS によるメトリクスの取得](USER_PerfInsights.API.md)
+ [AWS CloudTrail を使用した Performance Insights 呼び出しのログ記録](USER_PerfInsights.CloudTrail.md)
+ [Performance Insights API とインターフェイス VPC エンドポイント (AWS PrivateLink)](pi-vpc-interface-endpoints.md)

# Amazon RDS での Performance Insights の概要
<a name="USER_PerfInsights.Overview"></a>

**重要**  
 AWS は、Performance Insights のサポート終了日を 2026 年 6 月 30 日と発表しました。この日以降、Amazon RDS は Performance Insights コンソールのエクスペリエンス、柔軟な保持期間 (1～24 か月)、および関連する料金のサポートを終了します。Performance Insights API は存続し、料金の変更はありません。Performance Insights API の料金は、CloudWatch Database Insights の料金とともに AWS 請求書に表示されます。  
 Performance Insights の有料利用枠を使用する DB インスタンスは、2026 年 6 月 30 日より前に Database Insights のアドバンストモードにアップグレードすることをお勧めします。Database Insights のアドバンストモードへのアップグレード方法については、「[Amazon RDS で Database Insights のアドバンストモードを有効にする](USER_DatabaseInsights.TurningOnAdvanced.md)」を参照してください。  
 アクションを実行しない場合、Performance Insights を使用する DB インスタンスは、デフォルトで Database Insights のスタンダードモードを使用します。Database Insights のスタンダードモードでは、7 日間を超えたパフォーマンスデータ履歴、実行プラン機能とオンデマンド分析機能が Amazon RDS コンソールで利用できなくなる可能性があります。2026 年 6 月 30 日以降、Database Insights のアドバンストモードのみが実行プランとオンデマンド分析をサポートします。  
 CloudWatch Database Insights を使用すると、データベースのフリートのデータベース負荷をモニタリングし、パフォーマンスの大規模な分析とトラブルシューティングを行うことができます。Database Insights の詳細については、「[CloudWatch Database Insights による Amazon RDS データベースのモニタリング](USER_DatabaseInsights.md)」を参照してください。詳細については、[Amazon CloudWatch 料金表](https://aws.amazon.com/cloudwatch/pricing/)をご覧ください。

デフォルトで RDS は、すべての Amazon RDS エンジンのコンソール作成ウィザードで Performance Insights を有効にします。DB インスタンスに複数のデータベースがある場合、Performance Insights はパフォーマンスデータを集計します。

Amazon RDS の Performance Insights の概要は次の動画で確認できます。

[![AWS Videos](http://img.youtube.com/vi/yOeWcPBT458/0.jpg)](http://www.youtube.com/watch?v=yOeWcPBT458)


**重要**  
以下のトピックでは、Aurora 以外の DB エンジンで Amazon RDS Performance Insights を使用する方法について説明します。Amazon Aurora での Amazon RDS Performance Insights の使用については、「*Amazon Aurora ユーザーガイド*」の「[Using Amazon RDS Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.html)」(Amazon RDS Performance Insights の使用) を参照してください。

**Topics**
+ [データベース負荷](USER_PerfInsights.Overview.ActiveSessions.md)
+ [最大 CPU 容量](USER_PerfInsights.Overview.MaxCPU.md)
+ [Amazon RDS DB エンジンとインスタンスクラスでサポートされている Performance Insights](USER_PerfInsights.Overview.Engines.md)
+ [Performance Insights の料金とデータ保持](USER_PerfInsights.Overview.cost.md)

# データベース負荷
<a name="USER_PerfInsights.Overview.ActiveSessions"></a>

*データベース負荷 (DB 負荷)* は、データベース内のセッションアクティビティのレベルを測定します。`DBLoad` は Performance Insights の主要なメトリクスで、Performance Insights は 1 秒ごとに DB 負荷を収集します。

**Topics**
+ [アクティブなセッション](#USER_PerfInsights.Overview.ActiveSessions.active-sessions)
+ [平均アクティブセッション](#USER_PerfInsights.Overview.ActiveSessions.AAS)
+ [平均アクティブ実行](#USER_PerfInsights.Overview.ActiveSessions.AAE)
+ [ディメンション](#USER_PerfInsights.Overview.ActiveSessions.dimensions)

## アクティブなセッション
<a name="USER_PerfInsights.Overview.ActiveSessions.active-sessions"></a>

*データベースセッション*は、リレーショナルデータベースとのアプリケーションのダイアログを表します。アクティブなセッションとは、DB エンジンに作業を送信し、レスポンスを待っている接続です。

セッションは、CPU での動作中、またはリソースが使用可能になるのを待っているときにアクティブになります。例えば、アクティブなセッションでは、ページ (またはブロック) がメモリに読み込まれるのを待機し、ページからデータを読み取る間に CPU を消費することがあります。

## 平均アクティブセッション
<a name="USER_PerfInsights.Overview.ActiveSessions.AAS"></a>

*平均アクティブセッション (AAS)*は`DBLoad`Performance Insights のメトリクスの単位です。データベース上で同時にアクティブなセッション数を測定します。

毎秒、Performance Insights は、クエリを同時に実行するセッションの数をサンプリングします。Performance Insights は、アクティブなセッションごとに以下のデータを収集します。
+ SQL ステートメント
+ セッション状態 (CPU で実行中または待機中)
+ ホスト
+ SQL を実行しているユーザー

Performance Insights は、特定期間の総セッション数を総サンプル数で割って AAS を計算します。たとえば、次の表は、1 秒間隔で実行中のクエリの連続する 5 つのサンプルを示しています。

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html)

前述の例では、時間間隔の DB ロードは 2 AAS でした。この測定は、5 つのサンプルを採取した期間に、平均して 2 つのセッションがある時点でアクティブであったことを意味します。

## 平均アクティブ実行
<a name="USER_PerfInsights.Overview.ActiveSessions.AAE"></a>

1 秒あたりの平均アクティブ実行 (AAE) は AAS に関連しています。AAE を計算するために、Performance Insightsでは、クエリの合計実行時間を時間間隔で割ります。次の表に、前述の表の同じクエリに対する AAE 計算を示します。

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html)

ほとんどの場合、クエリの AAS と AAE はほぼ同じです。ただし、計算への入力は異なるデータソースであるため、計算はわずかに異なります。

## ディメンション
<a name="USER_PerfInsights.Overview.ActiveSessions.dimensions"></a>

この `db.load` メトリクスは、ディメンションと呼ばれるサブコンポーネントに分割できるため、他の時系列メトリクスとは異なります。ディメンションは、`DBLoad` メトリクスのさまざまな特性のカテゴリにより「スライス化されている」と考えることができます。

パフォーマンスの問題を診断する場合、多くの場合、以下のディメンションが最も役立ちます。

**Topics**
+ [待機イベント](#USER_PerfInsights.Overview.ActiveSessions.waits)
+ [上位の SQL](#USER_PerfInsights.Overview.ActiveSessions.top-sql)
+ [プラン](#USER_PerfInsights.Overview.ActiveSessions.plans)

のディメンションの詳細なリストについては、Amazon RDSエンジン、「[ディメンションでスライスされた DB の負荷](USER_PerfInsights.UsingDashboard.Components.md#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.dims)」を参照してください。

### 待機イベント
<a name="USER_PerfInsights.Overview.ActiveSessions.waits"></a>

*待機イベント*を指定すると、SQL ステートメントは、特定のイベントが発生するまで待機してから、実行を継続できます。待機イベントは、作業が妨げられる場所を示すため、DB ロードの重要なディメンションまたはカテゴリになります。

すべてのアクティブなセッションはCPU 上で実行されているか、待っています。例えば、セッションがメモリでバッファを検索したり、計算を実行したり、プロシージャコードを実行したりするときに CPU を消費します。セッションが CPU を消費していないときは、メモリバッファが空くのを待っているか、データファイルの読み取りやログの書き込みを待っている可能性があります。セッションのリソース待機時間が長くなると、CPU 上で動作する時間は短くなります。

データベースのチューニングのとき、セッションが待っているリソースを見つけようとすることがよくあります。例えば、2 つまたは 3 つの待機イベントが DBロードの 90% を占めることがあります。これは、平均して、アクティブなセッションが少数のリソースを待機するためにほとんどの時間を費やしていることを意味します。これらの待機の原因がわかれば、解決策を試すことができます。

待機イベントは、DB エンジンごとに異なります。
+ MariaDB および MySQL のすべての待機イベントの詳細については、MySQL ドキュメントの「[イベント待機サマリーテーブル](https://dev.mysql.com/doc/refman/8.0/en/performance-schema-wait-summary-tables.html)」を参照してください。
+ すべての PostgreSQL 待機イベントの詳細については、PostgreSQL ドキュメントの「[統計コレクター > 待機イベントテーブル](https://www.postgresql.org/docs/current/monitoring-stats.html#WAIT-EVENT-TABLE)」を参照してください。
+ すべての Oracle 待機イベントについては、Oracle ドキュメントの「[待機リストの説明](https://docs.oracle.com/database/121/REFRN/GUID-2FDDFAA4-24D0-4B80-A157-A907AF5C68E2.htm#REFRN-GUID-2FDDFAA4-24D0-4B80-A157-A907AF5C68E2)」を参照してください。
+ SQL Server のすべての待機イベントについては、SQL Server ドキュメントの「[待機の種類](https://docs.microsoft.com/en-us/sql/relational-databases/system-dynamic-management-views/sys-dm-os-wait-stats-transact-sql?view=sql-server-2017#WaitTypes)」を参照してください。

**注記**  
Oracle では、関連付けられた SQL ステートメントがなくてもバックグラウンドプロセスが実行されることがあります。このような場合、Performance Insights はバックグラウンドプロセスのタイプとそのバックグラウンドプロセスに関連付けられた待機クラスをコロンで連結してレポートします。バックグラウンドプロセスのタイプには、`LGWR`、`ARC0`、`PMON`などが含まれます。  
例えば、アーカイブ処理で I/O を実行しているとき、Performance Insights によるレポートは `ARC1:System I/O` のようになります。バックグラウンドプロセスタイプが欠落していて、Performance Insights が `:System I/O` のように待機クラスだけをレポートする場合もあります。

### 上位の SQL
<a name="USER_PerfInsights.Overview.ActiveSessions.top-sql"></a>

待機イベントはボトルネックを示しますが、上位の SQL は、どのクエリが DB ロードの最も大きな原因になっているかを示します。例えば、多くのクエリが現在データベースで実行されている可能性がありますが、1 つのクエリが DB ロードの 99% を占めている可能性もあります。この場合、負荷が高いと、クエリに問題がある可能性があります。

デフォルトでは、Performance Insights コンソールには、データベース負荷の原因となっている上位の SQL クエリが表示されます。コンソールには、各ステートメントに関連する統計情報も表示されます。特定のステートメントのパフォーマンスの問題を診断するには、その実行プランを調べます。

### プラン
<a name="USER_PerfInsights.Overview.ActiveSessions.plans"></a>

*実行プラン* (あるいはシンプルに*プラン*とも呼ばれるもの) は、データにアクセスする際の一連のステップのことです。例えば、テーブル `t1` と `t2` を統合するプランでは、`t1` 内のすべての行をループしながら、その各行を `t2` 内の行と比較します。リレーショナルデータベースでの*オプティマイザ*とは組み込みのコードのことで、これは SQL クエリのための最も効率的なプランを決定します。

DB インスタンスの場合、Performance Insights が実行プランを自動的に収集します。SQL のパフォーマンスに関する問題を診断するには、リソースの使用量が高い SQL クエリに関して取得したプランを検証します。プランから、データベースがどのようにクエリを解析して実行したかがわかります。

プランを使用して DB 負荷を分析する方法については、以下を参照してください。
+ Oracle: [Amazon RDS の Performance Insights ダッシュボードを使用した Oracle 実行プランの分析](USER_PerfInsights.UsingDashboard.AccessPlans.md)
+ SQL Server: [Amazon RDS の Performance Insights ダッシュボードを使用した SQL Server 実行プランの分析](USER_PerfInsights.UsingDashboard.AccessPlansSqlServer.md)

#### プランキャプチャ
<a name="USER_PerfInsights.Overview.ActiveSessions.plans.capture"></a>

Performance Insights は、5 分ごとに、リソースを最も多く消費しているクエリを特定し、対応するプランをキャプチャします。したがって、膨大な数のプランを手動で収集して管理する必要はありません。ユーザーは、**[Top SQL]** (上位の SQL) タブを通じて、最も問題のあるクエリのプランに対処することができます。

**注記**  
Performance Insights では、含まれるテキストが収集可能な最大数を超えるクエリのプランはキャプチャされません。詳しくは、「[Performance Insights ダッシュボードでより多くの SQL テキストにアクセスする](USER_PerfInsights.UsingDashboard.SQLTextSize.md)」を参照してください。

実行プランの保持期間は、Performance Insights のデータの保持期間と同じです。無料利用枠の保持設定は「**デフォルト (7 日)**」です。パフォーマンスデータをさらに長期間保持するには、1～24 か月を指定します。保持期間の詳細については、「[Performance Insights の料金とデータ保持](USER_PerfInsights.Overview.cost.md)」を参照してください。

#### ダイジェストクエリ
<a name="USER_PerfInsights.Overview.ActiveSessions.plans.digest"></a>

**[Top SQL]** (上位の SQL) タブには、デフォルトでダイジェストクエリが表示されます。ダイジェストクエリ自体にはプランはありませんが、リテラル値を使用するすべてのクエリにはプランがあります。例えば、ダイジェストクエリにテキスト`WHERE `email`=?`が含まれる場合があります。このダイジェストの中には、テキスト `WHERE email=user1@example.com` を含むクエリと、`WHERE email=user2@example.com` を含むクエリの 2 つがあります。これらのリテラルクエリには、それぞれ複数のプランが含まれる可能性があります。

ダイジェストクエリを選択すると、選択したダイジェストの子ステートメントのすべてのプランがコンソールに表示されます。したがって、プランを見つけるために、子ステートメント全体を確認する必要はありません。表示されているプランの中に、上位 10 の子ステートメントのリストにないものが含まれる場合があります。コンソールには、クエリが上位 10 であるかどうかにかかわらず、プランが収集されたすべての子クエリのプランが表示されます。

# 最大 CPU 容量
<a name="USER_PerfInsights.Overview.MaxCPU"></a>

ダッシュボードの [**データベースロード**] グラフで、セッション情報が収集、集計、表示されます。アクティブなセッションが最大 CPU 容量を超えているかどうかを確認するには、**最大 vCPU** ラインとの関係を調べます。Performance Insights は、**最大 vCPU** 値を DB インスタンスの vCPU (仮想 CPU) のコア数によって決定します。

vCPU では一度に 1 つのプロセスを実行できます。プロセスの数が vCPU の数を超えると、プロセスはキューイングを開始します。キューイングが増加すると、データベースのパフォーマンスが低下します。DB 負荷が [**Max vCPU (最大 vCPU)**] ラインをしばしば超過し、プライマリ待機状態が CPU である場合、CPU が過負荷になっています。この場合、インスタンスへの接続を抑制したり、CPU ロードの高い SQL クエリを調整したり、より大きなインスタンスクラスを検討する必要があります。待機状態の高い一貫したインスタンスは、解決するボトルネックまたはリソースの競合問題がある可能性があることを示します。これは、DB ロードが**最大 vCPU** ラインを超えていない場合にも該当します。

# Amazon RDS DB エンジンとインスタンスクラスでサポートされている Performance Insights
<a name="USER_PerfInsights.Overview.Engines"></a>

**重要**  
 AWS は、Performance Insights のサポート終了日を 2026 年 6 月 30 日と発表しました。この日以降、Amazon RDS は Performance Insights コンソールのエクスペリエンス、柔軟な保持期間 (1～24 か月)、および関連する料金のサポートを終了します。Performance Insights API は存続し、料金の変更はありません。Performance Insights API の料金は、CloudWatch Database Insights の料金とともに AWS 請求書に表示されます。  
 Performance Insights の有料利用枠を使用する DB インスタンスは、2026 年 6 月 30 日より前に Database Insights のアドバンストモードにアップグレードすることをお勧めします。Database Insights のアドバンストモードへのアップグレード方法については、「[Amazon RDS で Database Insights のアドバンストモードを有効にする](USER_DatabaseInsights.TurningOnAdvanced.md)」を参照してください。  
 アクションを実行しない場合、Performance Insights を使用する DB インスタンスは、デフォルトで Database Insights のスタンダードモードを使用します。Database Insights のスタンダードモードでは、7 日間を超えたパフォーマンスデータ履歴、実行プラン機能とオンデマンド分析機能が Amazon RDS コンソールで利用できなくなる可能性があります。2026 年 6 月 30 日以降、Database Insights のアドバンストモードのみが実行プランとオンデマンド分析をサポートします。  
 CloudWatch Database Insights を使用すると、データベースのフリートのデータベース負荷をモニタリングし、パフォーマンスの大規模な分析とトラブルシューティングを行うことができます。Database Insights の詳細については、「[CloudWatch Database Insights による Amazon RDS データベースのモニタリング](USER_DatabaseInsights.md)」を参照してください。詳細については、[Amazon CloudWatch 料金表](https://aws.amazon.com/cloudwatch/pricing/)をご覧ください。

次の表に、Performance Insights をサポートしている Amazon RDS DB エンジンを示します。

**注記**  
Amazon Aurora については、*Amazon Aurora ユーザーガイド*の [Performance Insights でサポートされている DB エンジン](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.Engines.html)を参照してください。


|  Amazon RDS DB エンジン  | サポート対象のエンジンバージョンとリージョン | インスタンスクラスに関する制限 | 
| --- | --- | --- | 
|  Amazon RDS for MariaDB  |  RDS for MariaDB に関する Performance Insights のバージョンとリージョンの可用性の詳細については、「[Amazon RDS の Performance Insights でサポートされているリージョンと DB エンジン](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md)」を参照してください。  |  Performance Insights は、 次のインスタンスクラスではサポートされていません。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.Engines.html)  | 
|  RDS for MySQL  |  RDS for MySQL に関する Performance Insights のバージョンとリージョンの可用性の詳細については、「[Amazon RDS の Performance Insights でサポートされているリージョンと DB エンジン](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md)」を参照してください。  |  Performance Insights は、 次のインスタンスクラスではサポートされていません。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.Engines.html)  | 
|  Amazon RDS for Microsoft SQL Server  |  RDS for SQL Server に関する Performance Insights のバージョンとリージョンの可用性の詳細については、「[Amazon RDS の Performance Insights でサポートされているリージョンと DB エンジン](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md)」を参照してください。  |  該当なし  | 
|  Amazon RDS for PostgreSQL  |  RDS for PostgreSQL に関する Performance Insights のバージョンとリージョンの可用性の詳細については、「[Amazon RDS の Performance Insights でサポートされているリージョンと DB エンジン](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md)」を参照してください。  |  該当なし  | 
|  Amazon RDS for Oracle  |  RDS for Oracle に関する Performance Insights のバージョンとリージョンの可用性の詳細については、「[Amazon RDS の Performance Insights でサポートされているリージョンと DB エンジン](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md)」を参照してください。  |  該当なし  | 

## Amazon RDS DB エンジン、リージョン、およびインスタンスクラスでサポートされている Performance Insights 機能
<a name="USER_PerfInsights.Overview.PIfeatureEngnRegSupport"></a>

次の表に、Performance Insights 機能をサポートしている Amazon RDS DB エンジンを示します。


| 機能 | [料金階層](https://aws.amazon.com/rds/performance-insights/pricing/) |  [サポートされるリージョン](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html#Concepts.RegionsAndAvailabilityZones.Regions)  |  [サポートされる DB エンジン](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html#Welcome.Concepts.DBInstance)  |  [サポートされるインスタンスクラス](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html#Concepts.DBInstanceClass.Types)  | 
| --- | --- | --- | --- | --- | 
| [Performance Insights の SQL 統計](sql-statistics.md) | すべて | すべて |  すべて  | すべて | 
| [Amazon RDS の Performance Insights ダッシュボードを使用した Oracle 実行プランの分析](USER_PerfInsights.UsingDashboard.AccessPlans.md) | すべて | すべて |  RDS for Oracle  | すべて | 
| [一定期間のデータベースパフォーマンスの分析](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md) | 有料階層のみ |  すべて  |  RDS for PostgreSQL  |  すべて  | 
|  [Performance Insights のプロアクティブ推奨事項の表示](USER_PerfInsights.InsightsRecommendationViewDetails.md) | 有料階層のみ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.Engines.html)  |  すべて  | すべて  | 

# Performance Insights の料金とデータ保持
<a name="USER_PerfInsights.Overview.cost"></a>

デフォルトでは、Performance Insights には、7 日間のパフォーマンスデータ履歴と 1 か月あたり 100 万件の API リクエストを含む無料利用枠が用意されています。また、より長い保持期間を購入することもできます。料金情報の詳細については、「[Performance Insights の料金](https://aws.amazon.com/rds/performance-insights/pricing/)」を参照してください。

RDS コンソールでは、Performance Insights データの保持期間を次の中から選択できます。
+ **デフォルト (7 日)**
+ ***n* か月** (***n*** は 1 ～ 24 の数値)

![\[Performance Insights データの保持期間を選択してください。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/pi-retention-periods.png)


AWS CLI を使用して保持期間を設定する方法については、「」を参照してください。

# Amazon RDS の Performance Insights の有効化と無効化
<a name="USER_PerfInsights.Enabling"></a>

**重要**  
 AWS は、Performance Insights のサポート終了日を 2026 年 6 月 30 日と発表しました。この日以降、Amazon RDS は Performance Insights コンソールのエクスペリエンス、柔軟な保持期間 (1～24 か月)、および関連する料金のサポートを終了します。Performance Insights API は存続し、料金の変更はありません。Performance Insights API の料金は、CloudWatch Database Insights の料金とともに AWS 請求書に表示されます。  
 Performance Insights の有料利用枠を使用する DB インスタンスは、2026 年 6 月 30 日より前に Database Insights のアドバンストモードにアップグレードすることをお勧めします。Database Insights のアドバンストモードへのアップグレード方法については、「[Amazon RDS で Database Insights のアドバンストモードを有効にする](USER_DatabaseInsights.TurningOnAdvanced.md)」を参照してください。  
 アクションを実行しない場合、Performance Insights を使用する DB インスタンスは、デフォルトで Database Insights のスタンダードモードを使用します。Database Insights のスタンダードモードでは、7 日間を超えたパフォーマンスデータ履歴、実行プラン機能とオンデマンド分析機能が Amazon RDS コンソールで利用できなくなる可能性があります。2026 年 6 月 30 日以降、Database Insights のアドバンストモードのみが実行プランとオンデマンド分析をサポートします。  
 CloudWatch Database Insights を使用すると、データベースのフリートのデータベース負荷をモニタリングし、パフォーマンスの大規模な分析とトラブルシューティングを行うことができます。Database Insights の詳細については、「[CloudWatch Database Insights による Amazon RDS データベースのモニタリング](USER_DatabaseInsights.md)」を参照してください。詳細については、[Amazon CloudWatch 料金表](https://aws.amazon.com/cloudwatch/pricing/)をご覧ください。

DB インスタンスまたはマルチ AZ DB クラスターの作成時に、Performance Insights をオンにすることができます。必要に応じて、後でコンソールから DB インスタンスを変更することでオフにできます。Performance Insights を有効化または無効化した場合も、ダウンタイム、再起動、フェイルオーバーが発生することはありません。

**注記**  
Performance Schema は、 Amazon RDS for MariaDB または MySQL で使用される、オプションのパフォーマンスツールです。Performance Schema のオンとオフを切り替える場合は、再起動する必要があります。ただし、Performance Insights のオンとオフを切り替えた場合は、再起動する必要はありません。詳細については、「[Amazon RDS for MariaDB または MySQL における Performance Insights のPerformance Schema の概要](USER_PerfInsights.EnableMySQL.md)」を参照してください。

Performance Insights エージェントは DB ホストの限られた CPU とメモリを消費します。DB のロードが高い場合、エージェントはデータ収集の頻度を下げることでパフォーマンスへの影響を抑えます。

------
#### [ Console ]

コンソールでは、DB インスタンスまたはマルチ AZ DB クラスターの作成時または変更時に、Performance Insights のオンとオフを切り替えることができます。

**DB インスタンスまたはマルチ AZ DB クラスター の作成時に Performance Insights のオンとオフを切り替える**

新しい DB インスタンスまたはマルチ AZ DB クラスターを作成した後、Amazon RDS では Performance Insights がデフォルトで有効になります。Performance Insights をオフにするには、**[データベースインサイト - スタンダード]** オプションを選択し、**[Performance Insights を有効化]** オプションの選択を解除します。

詳細については、以下のトピックを参照してください。
+ DB インスタンスを作成するには、「[Amazon RDS DB インスタンスの作成](USER_CreateDBInstance.md)」の DB エンジンの手順に従ってください。
+ マルチ AZ DB クラスターを作成するには、「[Amazon RDS 用のマルチ AZ DB クラスターの作成](create-multi-az-db-cluster.md)」の DB エンジンの手順に従ってください。

次のスクリーンショットは [**Performance Insights**] セクションを示しています。

![\[コンソールを使用した DB インスタンスまたはマルチ AZ DB クラスターの作成中に Performance Insights をオンにする\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_enabling.png)


[**Performance Insights の有効化**] を選択すると、次のオプションがあります。
+ **保有** (Database Insights のスタンダードモードのみ) – Performance Insights データを保持する時間。保持期間の設定は、**デフォルト (7 日間)** です。パフォーマンスデータをさらに長期間保持するには、1～24 か月を指定します。保持期間の詳細については、「[Performance Insights の料金とデータ保持](USER_PerfInsights.Overview.cost.md)」を参照してください。
+ ** AWS KMS key** ―を指定します。。AWS KMS keyPerformance Insights は、潜在的に機密性の高いすべてのデータを KMS キーを使用して暗号化します。データは、転送中と不使用時のいずれも暗号化されます。詳細については、「[Performance Insights 用の AWS KMS ポリシーの変更](USER_PerfInsights.access-control.cmk-policy.md)」を参照してください。

**DB インスタンスまたはマルチ AZ DB クラスターの変更時に Performance Insights のオン/オフを切り替える**

コンソールでは、DB インスタンスまたはマルチ AZ DB クラスターを変更して Performance Insights を管理できます。

**コンソールを使用して DB インスタンスまたはマルチ AZ DB クラスターの Performance Insights を管理するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. [**データベース**] をクリックします。

1. DB インスタンスまたはマルチ AZ DB クラスターを選択し、**[変更]** を選択します。

1. Performance Insights を有効にするには、**[Performance Insights を有効にする]** を選択します。Performance Insights をオフにするには、**[データベースインサイト - スタンダード]** オプションを選択し、**[Performance Insights を有効化]** オプションの選択を解除します。

   [**Performance Insights の有効化**] を選択すると、次のオプションがあります。
   + **保有** (Database Insights のスタンダードモードのみ) – Performance Insights データを保持する時間。保持期間の設定は、**デフォルト (7 日間)** です。パフォーマンスデータをさらに長期間保持するには、1～24 か月を指定します。保持期間の詳細については、「[Performance Insights の料金とデータ保持](USER_PerfInsights.Overview.cost.md)」を参照してください。
   + **AWS KMS key** - KMS キーを指定します。Performance Insights は、潜在的に機密性の高いすべてのデータを KMS キーを使用して暗号化します。データは、転送中と不使用時のいずれも暗号化されます。詳細については、「[Amazon RDS リソースの暗号化](Overview.Encryption.md)」を参照してください。

1. [**Continue**] を選択します。

1. [**変更のスケジュール**] で、[今すぐ適用] を選択します。次にスケジュールされたメンテナンスウィンドウで [Apply] (適用) を選択すると、インスタンスではこの設定が無視され、Performance Insights が直ちにオンになります。

1. [**インスタンスの変更**] を選択します。

------
#### [ AWS CLI ]

[create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) AWS CLI コマンドを使用する場合は、`--enable-performance-insights` を指定して Performance Insights をオンにし、`--database-insights-mode` を `advanced` または `standard` に設定します。Performance Insights をオフにするには、`--no-enable-performance-insights` を指定し、`database-insights-mode` を `standard` に設定します。

以下の AWS CLI コマンドを使用してこれらの値を指定することもできます。
+  [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) 
+  [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) 
+  [create-db-instance-read-replica](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance-read-replica.html) 
+  [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) 
+  [restore-db-instance-from-s3](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-s3.html) 

CLI で Performance Insights をオンにする際に、`--performance-insights-retention-period` オプションを使用して Performance Insights のデータを保持する日数を指定できます (オプション)。`7`、*month* \$1 31 (*month* は 1 ～ 23 の範囲の数値)、または `731` を指定できます。例えば、パフォーマンスデータを 3 か月間保持する場合は、`93` (3 \$1 31) を指定します。デフォルトは `7` 日間です。保持期間の詳細については、「[Performance Insights の料金とデータ保持](USER_PerfInsights.Overview.cost.md)」を参照してください。

次の例では、`sample-db-cluster` で Performance Insights をオンにして、Performance Insights のデータの保持期間を 93 日間 (3 か月) に指定します。

Linux、macOS、Unix の場合:

```
aws rds modify-db-cluster \
	--database-insights-mode standard \
    --db-cluster-identifier sample-db-instance \
    --enable-performance-insights \
    --performance-insights-retention-period 93
```

Windows の場合:

```
aws rds modify-db-cluster ^
	--database-insights-mode standard ^
    --db-cluster-identifier sample-db-instance ^
    --enable-performance-insights ^
    --performance-insights-retention-period 93
```

94 日などの有効な値ではない保持期間を指定すると、RDS はエラーを発行します。

```
An error occurred (InvalidParameterValue) when calling the CreateDBInstance operation: 
Invalid Performance Insights retention period. Valid values are: [7, 31, 62, 93, 124, 155, 186, 217, 
248, 279, 310, 341, 372, 403, 434, 465, 496, 527, 558, 589, 620, 651, 682, 713, 731]
```

**注記**  
Performance Insights がクラスターレベルで管理されていない DB クラスター内のインスタンスに対してのみ、Performance Insights を切り替えることができます。

------
#### [ RDS API ]

Amazon RDS API 操作の [CreateDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) オペレーションを使用して 新しい DB インスタンスを作成する場合、`EnablePerformanceInsights` を `True` に設定して、Performance Insights をオンにします。Performance Insights をオフにするには、`EnablePerformanceInsights` を `False` に設定し、`DatabaseInsightsMode` を `standard` に設定します。

以下の API オペレーションを使用して `EnablePerformanceInsights` 値を指定することもできます。
+  [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) (マルチ AZ DB クラスター) 
+  [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) (マルチ AZ DB クラスター) 
+  [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) 
+  [CreateDBInstanceReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstanceReadReplica.html) 
+  [RestoreDBInstanceFromS3](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromS3.html) 

Performance Insights をオンにする際に、`PerformanceInsightsRetentionPeriod` パラメータを使用して Performance Insights のデータを保持する期間を日数で指定できます (オプション)。`7`、*month* \$1 31 (*month* は 1 ～ 23 の範囲の数値)、または `731` を指定できます。例えば、パフォーマンスデータを 3 か月間保持する場合は、`93` (3 \$1 31) を指定します。デフォルトは `7` 日間です。保持期間の詳細については、「[Performance Insights の料金とデータ保持](USER_PerfInsights.Overview.cost.md)」を参照してください。

------

# Amazon RDS for MariaDB または MySQL における Performance Insights のPerformance Schema の概要
<a name="USER_PerfInsights.EnableMySQL"></a>

Performance Schema は、Amazon RDS for MariaDB または MySQL ランタイムのパフォーマンスを低い詳細レベルでモニタリングするオプション機能です。Performance Schema は、データベースのパフォーマンスへの影響を最小限に抑えるように設計されています。Performance Insights は、Performance Schema の有無に関係なく使用できる独立した機能です。

**Topics**
+ [Performance Schema の概要](#USER_PerfInsights.EnableMySQL.overview)
+ [Performance Insights と Performance Schema](#USER_PerfInsights.effect-of-pfs)
+ [Performance Insights による Performance Schema の自動管理](#USER_PerfInsights.EnableMySQL.options)
+ [Performance Schema の再起動による影響](#USER_PerfInsights.EnableMySQL.reboot)
+ [Performance Insights が Performance Schema を管理しているかどうかの確認](USER_PerfInsights.EnableMySQL.determining-status.md)
+ [Amazon RDS for MariaDB または MySQL における Performance Schema の有効化](USER_PerfInsights.EnableMySQL.RDS.md)

## Performance Schema の概要
<a name="USER_PerfInsights.EnableMySQL.overview"></a>

Performance Schema は、MariaDB および MySQL データベースのイベントをモニタリングします。*イベント*とは、時間を消費し、タイミング情報を収集できるように実装されたデータベースサーバーアクションです。イベントの例には、以下のようなものがあります。
+ 関数呼び出し
+ オペレーティングシステムの待機
+ SQL 実行のステージ
+ SQL ステートメントのグループ

`PERFORMANCE_SCHEMA` ストレージエンジンは、Performance Schema 機能を実装するためのメカニズムです。このエンジンは、データベースのソースコード内の計測を使用してイベントデータを収集します。エンジンは、イベントを `performance_schema` データベースのメモリ専用テーブルに保存します。他のテーブルにクエリを実行するのと同様に、`performance_schema` をクエリできます。詳細については、*MySQL リファレンスマニュアル*の「[MySQL Performance Schema](https://dev.mysql.com/doc/refman/8.0/en/performance-schema.html)」を参照してください。

## Performance Insights と Performance Schema
<a name="USER_PerfInsights.effect-of-pfs"></a>

Performance Insights と Performance Schema は別々の機能ですが、両者は関連しています。 Amazon RDS for MariaDB または MySQL の Performance Insights の動作は、Performance Schema がオンになっているかどうか、およびオンになっている場合は、Performance Insights が Performance Schema を自動的に管理するかどうかによって異なります。次の表は、動作の説明です。


| Performance Schema がオンになっている | Performance Insights 管理モード | Performance Insights の動作 | 
| --- | --- | --- | 
|  はい  |  自動  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/USER_PerfInsights.EnableMySQL.html)  | 
|  はい  |  手動  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/USER_PerfInsights.EnableMySQL.html)  | 
|  いいえ  |  該当なし  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/USER_PerfInsights.EnableMySQL.html)  | 

## Performance Insights による Performance Schema の自動管理
<a name="USER_PerfInsights.EnableMySQL.options"></a>

Performance Insights を有効にした状態で Amazon RDS for MariaDB または MySQL DB インスタンスを作成すると、Performance Schema も有効になります。この場合、Performance Insights は Performance Schema パラメータを自動的に管理します。この設定を推奨します。

Performance Insights が Performance Schema を自動的に管理するとき、`performance_schema` の **Source** は `System default` です。

**注記**  
t4g.medium インスタンスクラスでは、パフォーマンススキーマの自動管理はサポートされていません。

`performance_schema` パラメータの値を手動で変更し、後で自動管理に戻す方法については、「[Amazon RDS for MariaDB または MySQL における Performance Schema の有効化](USER_PerfInsights.EnableMySQL.RDS.md)」を参照してください。

**重要**  
Performance Insights で Performance Schema を有効にしても、パラメータグループ値は変更されません。ただし、値は実行中の DB インスタンスで変更されます。変更された値を表示する唯一の方法は、`SHOW GLOBAL VARIABLES` コマンドを実行することです。

## Performance Schema の再起動による影響
<a name="USER_PerfInsights.EnableMySQL.reboot"></a>

Performance Insights と Performance Schema は、DB インスタンスの再起動の要件が異なります。

**Performance Schema**  
この機能をオンまたはオフにするには、DB インスタンスを再起動する必要があります。

**Performance Insights**  
この機能をオンまたはオフにするために、DB インスタンスを再起動する必要はありません。

Performance Schema が現在有効になっていない場合、DB インスタンスを再起動せずに Performance Insights を有効にすると、Performance Schema は有効になりません。

# Performance Insights が Performance Schema を管理しているかどうかの確認
<a name="USER_PerfInsights.EnableMySQL.determining-status"></a>

Performance Insights が、現在、サポート対象のメジャーエンジンバージョンの Performance Schema を管理しているかどうかを確認するには、次の表を参照してください。


| performance\$1schema パラメータの設定 | [Source] (ソース) 列の設定 | Performance Insights が Performance Schema を管理しているかどうか | 
| --- | --- | --- | 
| 0 | System default | はい | 
| 0 または 1 | Modified | いいえ | 

次の手順では、Performance Insights が Performance Schema を自動的に管理しているかどうかを確認します。

**Performance Insights が Performance Schema を自動管理しているかどうかを確認するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. [**パラメータグループ**] を選択します。

1. DB インスタンスのパラメータグループを選択します。

1. 検索バーに **performance\$1schema** と入力します。

1. **[ソース]** がシステムデフォルト、**[値]** が **[0]** であることをチェックします。上記の設定の場合、Performance Insights は Performance Schema を自動管理します。

   上記の例では、Performance Insights は Performance Schema を自動管理していません。  
![\[performance_schema パラメータの設定が変更されていることを示しています。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_schema_user.png)

# Amazon RDS for MariaDB または MySQL における Performance Schema の有効化
<a name="USER_PerfInsights.EnableMySQL.RDS"></a>

DB インスタンスまたはマルチ AZ DB クラスターで Performance Insights がオンになっているが、現在 Performance Schema は管理していないと仮定します。Performance Insights が Performance Schema を自動管理できるようにするには、次のステップを実行します。

**自動管理用 Performance Schema を設定するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. **[パラメータグループ]** を選択します。

1. DB インスタンスまたはマルチ AZ DB クラスターのパラメータグループの名前を選択します。

1. **[編集]** を選択します。

1. 検索バーに **performance\$1schema** と入力します。

1. `performance_schema` パラメータを選択します。

1. **[デフォルト値に設定]** を選択します。

1. **[値をデフォルトに設定]** を選択して確定します。

1. **[Save changes]** (変更の保存) をクリックします。

1. DB インスタンスまたはマルチ AZ DB クラスターを再起動します。
**重要**  
Performance Schema のオンとオフを切り替えるたびに、DB インスタンスまたはマルチ AZ DB クラスターを必ず再起動します。

インスタンスのパラメータの変更の詳細については、「[Amazon RDS の DB パラメータグループのパラメータの変更](USER_WorkingWithParamGroups.Modifying.md)」を参照してください。ダッシュボードのページの詳細については、「[Performance Insights ダッシュボードを使用してメトリクスを分析する](USER_PerfInsights.UsingDashboard.md)」を参照してください。MySQL パフォーマンススキーマの詳細については、MySQL ドキュメントの「[MySQL Performance Schema](https://dev.mysql.com/doc/refman/8.0/en/performance-schema.html)」(8.0 の場合) および「[MySQL Performance Schema](https://dev.mysql.com/doc/refman/8.4/en/performance-schema.html)」(8.4 の場合) を参照してください。

# Performance Insights 用のアクセスポリシーの設定
<a name="USER_PerfInsights.access-control"></a>

Performance Insights にアクセスするには、プリンシパルが AWS Identity and Access Management (IAM) から適切な許可を得る必要があります。

**注記**  
カスタマーマネージドキーで Performance Insights を使用するには、ユーザーに AWS AWS KMS キーの `kms:Decrypt` および `kms:GenerateDataKey` アクセス許可を付与します。

以下の方法を使用して Performance Insights にアクセスします。
+ [読み取り専用アクセスのための `AmazonRDSPerformanceInsightsReadOnly` 管理ポリシーをアタッチする](USER_PerfInsights.access-control.managed-policy.md)
+ [Performance Insights API のすべてのオペレーションにアクセスするための `AmazonRDSPerformanceInsightsFullAccess` 管理ポリシーをアタッチする](USER_PerfInsights.access-control.FullAccess-managed-policy.md)
+ [特定のアクセス許可を持つカスタム IAM ポリシーを作成する](USER_PerfInsights.access-control.custom-policy.md)
+ [暗号化された Performance Insights データの AWS KMS アクセス許可を設定する](USER_PerfInsights.access-control.cmk-policy.md)
+ [リソースレベルのアクセス許可を使用してきめ細かなアクセスを設定する](USER_PerfInsights.access-control.dimensionAccess-policy.md)
+ [タグベースのアクセスコントロールを使用して、リソースタグを介してアクセス許可を管理する](USER_PerfInsights.access-control.tag-based-policy.md)

# AmazonRDSPerformanceInsightsReadOnly ポリシーの IAM プリンシパルへのアタッチ
<a name="USER_PerfInsights.access-control.managed-policy"></a>

`AmazonRDSPerformanceInsightsReadOnly` は Amazon RDS Performance Insights API のすべての読み取り専用オペレーションへのアクセス許可を付与する AWS マネージドポリシーです。

アクセス許可セットまたはロールに `AmazonRDSPerformanceInsightsReadOnly` をアタッチする場合は、次の CloudWatch アクセス許可もアタッチする必要があります。
+ `GetMetricStatistics`
+ `ListMetrics`
+ `GetMetricData`

これらのアクセス許可により、受信者は他のコンソール機能で Performance Insights を使用できます。

 Amazon CloudWatch のアクセス許可の詳細については、「[Amazon CloudWatch の許可リファレンス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html)」を参照してください。

`AmazonRDSPerformanceInsightsReadOnly` の詳細については、「[AWS マネージドポリシー: AmazonRDSPerformanceInsightsReadOnly](rds-security-iam-awsmanpol.md#rds-security-iam-awsmanpol-AmazonRDSPerformanceInsightsReadOnly)」を参照してください。

# AmazonRDSPerformanceInsightsFullAccess ポリシーの IAM プリンシパルへのアタッチ
<a name="USER_PerfInsights.access-control.FullAccess-managed-policy"></a>

`AmazonRDSPerformanceInsightsFullAccess` は Amazon RDS Performance Insights API のすべての操作へのアクセス許可を付与する AWS マネージドポリシーです。

アクセス許可セットまたはロールに `AmazonRDSPerformanceInsightsFullAccess` をアタッチする場合は、次の CloudWatch アクセス許可もアタッチする必要があります。
+ `GetMetricStatistics`
+ `ListMetrics`
+ `GetMetricData`

これらのアクセス許可により、受信者は他のコンソール機能で Performance Insights を使用できます。

 Amazon CloudWatch のアクセス許可の詳細については、「[Amazon CloudWatch の許可リファレンス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html)」を参照してください。

`AmazonRDSPerformanceInsightsFullAccess` の詳細については、「[AWS 管理ポリシー: AmazonRDSPerformanceInsightsFullAccess](rds-security-iam-awsmanpol.md#rds-security-iam-awsmanpol-AmazonRDSPerformanceInsightsFullAccess)」を参照してください。

# Performance Insights 用のカスタム IAM ポリシーの作成
<a name="USER_PerfInsights.access-control.custom-policy"></a>

`AmazonRDSPerformanceInsightsReadOnly` または `AmazonRDSPerformanceInsightsFullAccess` ポリシーを持たないユーザーの場合、ユーザーマネージド IAM ポリシーを作成または変更することによって、Performance Insights へのアクセス許可を付与できます。ポリシーを IAM アクセス許可セットまたはロールにアタッチすると、受取人は Performance Insights を使用できます。

**カスタムポリシーを作成するには**

1. IAM コンソール ([https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)) を開きます。

1. ナビゲーションペインで、**ポリシー** を選択してください。

1. **[Create policy]** (ポリシーの作成) を選択します。

1. **[ポリシーの作成]** ページで、**[JSON]** オプションを選択します。

1. 「**AWS マネージドポリシーリファレンスガイド」の「**JSON ポリシードキュメント」セクションに記載されている文字列をコピーして、[https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsReadOnly.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsReadOnly.html) または [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsFullAccess.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsFullAccess.html) ポリシーに貼り付けます。

1. **[ポリシーの確認]** を選択します。

1. ポリシーの名前と (必要に応じて) 説明を入力し、[**ポリシーの作成**] を選択します。

これで、そのポリシーをアクセス許可セットまたはロールにアタッチできます。次の手順では、この目的で使用できるユーザーが既に存在することを前提としています。

**ポリシーをユーザーにアタッチするには**

1. IAM コンソール ([https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)) を開きます。

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

1. リストから存在するユーザーを 1 人選択します。
**重要**  
Performance Insights を使用するには、カスタムポリシーのほかに別のポリシーで、Amazon RDS へのアクセスを許可されている必要があります。例えば、`AmazonRDSPerformanceInsightsReadOnly` 事前定義ポリシーで、ユーザーに Amazon RDS への読み取り専用アクセスを許可します。詳細については、「[ポリシーを使用したアクセスの管理](UsingWithRDS.IAM.md#security_iam_access-manage)」を参照してください。

1. [**Summary**] ページで、[**Add permissions**] を選択します。

1. **[Attach existing policies directly (既存のポリシーを直接アタッチする)**] を選択します。**検索**を行う場合は、次の画像に示すようにポリシー名の初期の数文字を入力します。  
![\[ポリシーの選択\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_attach_iam_policy.png)

1. ポリシーを選択し、[**次へ: レビュー**] を選択します。

1. [**アクセス権限の追加**] を選択します。

# Performance Insights 用の AWS KMS ポリシーの変更
<a name="USER_PerfInsights.access-control.cmk-policy"></a>

Performance Insights は、AWS KMS key を使用して機密データを暗号化します。API またはコンソールを通じて Performance Insights を有効にする場合は、次のいずれかを実行します。
+ デフォルト AWS マネージドキー を選択します。

  Amazon RDS は、新しい DB インスタンスに AWS マネージドキー を使用します。Amazon RDS は、AWS アカウント に AWS マネージドキー を作成します。AWS アカウント には、AWS リージョン ごとに Amazon RDS の AWS マネージドキー が別々にあります。
+ カスタマーマネージドキーを選択します。

  カスタマーマネージドキーを指定する場合、Performance Insights API を呼び出すアカウント内のユーザーは、KMS キーに対する `kms:Decrypt` および `kms:GenerateDataKey` アクセス許可が必要です。IAM ポリシーを使用して、これらのアクセス許可を設定できます。ただし、KMS キーポリシーを使用してこれらのアクセス許可を管理することをお勧めします。詳細については、「*AWS Key Management Service デベロッパーガイド*」の「[AWS KMS でのキーポリシー](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html)」を参照してください。

**Example**  
次の例では、KMS キーポリシーにステートメントを追加する方法を示します。これらのステートメントは、Performance Insights へのアクセスを許可します。KMS キーの使用方法によっては、いくつかの制限を変更することもできます。ポリシーにステートメントを追加する前に、すべてのコメントを削除してください。    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Id" : "your-policy",
    "Statement" : [ 
        {
            "Sid" : "AllowViewingRDSPerformanceInsights",
            "Effect": "Allow",
            "Principal": {
                "AWS": [
                    "arn:aws:iam::444455556666:role/Role1"
                ]
                },
             "Action": [
                "kms:Decrypt",
                "kms:GenerateDataKey"
                ],
            "Resource": "*",
            "Condition" : {
            "StringEquals" : {
                "kms:ViaService" : "rds.us-east-1.amazonaws.com"
                },
            "ForAnyValue:StringEquals": {
                "kms:EncryptionContext:aws:pi:service": "rds",
                "kms:EncryptionContext:service": "pi",
                "kms:EncryptionContext:aws:rds:db-id": "db-AAAAABBBBBCCCCDDDDDEEEEE"
                }
            }
        }
    ]
}
```

## Performance Insights が AWS KMS カスタマー管理キーを使用する方法
<a name="USER_PerfInsights.access-control.PI-using-KMS-cmk-policy"></a>

Performance Insights は、カスタマー管理型のキー (CMK) を使用して機密データを暗号化します。Performance Insights を有効にすると、API を介して AWS KMS キーを提供できます。Performance Insights は、このキーの AWS KMS アクセス許可を作成します。キーを使用して、機密データを処理するために必要な操作を実行します。機密データには、ユーザー、データベース、アプリケーション、SQL クエリテキストなどのフィールドが含まれます。Performance Insights により、データは保存中も転送中も暗号化されたままになります。

## Performance Insights IAM と AWS KMS の連携
<a name="USER_PerfInsights.access-control.PI-work-with-kms"></a>

IAM は特定の API にアクセス権限を付与します。Performance Insights には以下のパブリック API があり、IAM ポリシーを使用して制限できます。
+ `DescribeDimensionKeys`
+ `GetDimensionKeyDetails`
+ `GetResourceMetadata`
+ `GetResourceMetrics`
+ `ListAvailableResourceDimensions`
+ `ListAvailableResourceMetrics`

機密データを取得するには、以下の API リクエストを使用できます。
+ `DescribeDimensionKeys`
+ `GetDimensionKeyDetails`
+ `GetResourceMetrics`

API を使用して機密データを取得する場合、Performance Insights は呼び出し元の認証情報を利用します。このチェックにより、機密データへのアクセスが KMS キーにアクセスできるユーザーに限定されます。

これらの API を呼び出すときは、IAM ポリシーを通じて API を呼び出す権限と、AWS KMS キーポリシーを通じて `kms:decrypt` アクションを呼び出す権限が必要となります。

`GetResourceMetrics` API は、機密データと非機密データの両方を返すことができます。リクエストパラメータにより、レスポンスに機密データを含めるかどうかが決定されます。リクエストのフィルターパラメーターまたは group-by パラメーターのいずれかに機密ディメンションが含まれている場合、API は機密データを返します。

`GetResourceMetrics` API で使用できるディメンションの詳細については、[DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html) を参照してください。

**Example 例**  
次の例では、`db.user` グループの機密データをリクエストしています:  

```
POST / HTTP/1.1
Host: <Hostname>
Accept-Encoding: identity
X-Amz-Target: PerformanceInsightsv20180227.GetResourceMetrics
Content-Type: application/x-amz-json-1.1
User-Agent: <UserAgentString>
X-Amz-Date: <Date> 
Authorization: AWS4-HMAC-SHA256 Credential=<Credential>, SignedHeaders=<Headers>, Signature=<Signature>
Content-Length: <PayloadSizeBytes>
{
  "ServiceType": "RDS",
  "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W",
  "MetricQueries": [
    {
      "Metric": "db.load.avg",
      "GroupBy": {
        "Group": "db.user",
        "Limit": 2
      }
    }
  ],
  "StartTime": 1693872000,
  "EndTime": 1694044800,
  "PeriodInSeconds": 86400
}
```

**Example**  
次の例では、`db.load.avg` メトリクスの非機密データをリクエストしています:  

```
POST / HTTP/1.1
Host: <Hostname>
Accept-Encoding: identity
X-Amz-Target: PerformanceInsightsv20180227.GetResourceMetrics
Content-Type: application/x-amz-json-1.1
User-Agent: <UserAgentString>
X-Amz-Date: <Date> 
Authorization: AWS4-HMAC-SHA256 Credential=<Credential>, SignedHeaders=<Headers>, Signature=<Signature>
Content-Length: <PayloadSizeBytes>
{
    "ServiceType": "RDS",
    "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W",
    "MetricQueries": [
        {
            "Metric": "db.load.avg"
        }
    ],
    "StartTime": 1693872000,
    "EndTime": 1694044800,
    "PeriodInSeconds": 86400
}
```

# Performance Insights への詳細なアクセス許可の付与
<a name="USER_PerfInsights.access-control.dimensionAccess-policy"></a>

詳細なアクセスコントロールを使用して、Performance Insights データへの追加のアクセスコントロールを適用することができます。このアクセスコントロールは、Performance Insights の `GetResourceMetrics`、`DescribeDimensionKeys`、`GetDimensionKeyDetails` アクションの個々のディメンションへのアクセスを許可または拒否できます。詳細なアクセスコントロールを使用するには、条件キーを使用して IAM ポリシーでディメンションを指定します。アクセスの評価は、IAM ポリシーの評価ロジックに基づきます。詳細については、「*IAM ユーザーガイド*」の「[ポリシーの評価論理](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_evaluation-logic.html)」を参照してください。IAM ポリシーステートメントでディメンションが指定されていない場合、ステートメントは指定されたアクションのすべてのディメンションへのアクセスをコントロールします。使用可能なディメンションのリストについては、「[https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html)」を参照してください。

認証情報でアクセスが許可されているディメンションを確認するには、`ListAvailableResourceDimensions` の `AuthorizedActions` パラメータを使用してアクションを指定します。`AuthorizedActions` の許容値は、次のとおりです。
+ `GetResourceMetrics`
+ `DescribeDimensionKeys`
+ `GetDimensionKeyDetails`

例えば、`AuthorizedActions` パラメータに `GetResourceMetrics` を指定すると、`ListAvailableResourceDimensions` は `GetResourceMetrics` アクションがアクセスを許可されているディメンションのリストを返します。`AuthorizedActions` パラメータで複数のアクションを指定すると、`ListAvailableResourceDimensions` はそれらのアクションがアクセスを許可されているディメンションの交差を返します。

**Example**  
次の例では、`GetResourceMetrics` および `DescribeDimensionKeys` アクションに指定されたディメンションへのアクセスを付与します。    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "AllowToDiscoverDimensions",
            "Effect": "Allow",
            "Action": [
                "pi:ListAvailableResourceDimensions"
            ],
            "Resource": [
                "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W"
            ]
        },
        {
            "Sid": "SingleAllow",
            "Effect": "Allow",
            "Action": [
                "pi:GetResourceMetrics",
                "pi:DescribeDimensionKeys"
            ],
            "Resource": [
                "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W"
            ],
            "Condition": {
                "ForAllValues:StringEquals": {
                    "pi:Dimensions": [
                        "db.sql_tokenized.id",
                        "db.sql_tokenized.statement"
                    ]
                }
            }
        }
        

    ]
}
```
リクエストされたディメンションのレスポンスを次に示します。  

```
	// ListAvailableResourceDimensions API
// Request
{
    "ServiceType": "RDS",
    "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W",
    "Metrics": [ "db.load" ],
    "AuthorizedActions": ["DescribeDimensionKeys"]
}

// Response
{    
    "MetricDimensions": [ {
        "Metric": "db.load",
        "Groups": [
            {
                "Group": "db.sql_tokenized",
                "Dimensions": [
                    { "Identifier": "db.sql_tokenized.id" },
                  //  { "Identifier": "db.sql_tokenized.db_id" }, // not included because not allows in the IAM Policy
                    { "Identifier": "db.sql_tokenized.statement" }
                ] 
            }
            
        ] }
    ]
}
```
次の例は、ディメンションに対する 1 つの許可アクセスと 2 つの拒否アクセスを指定します。    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
          {
            "Sid": "AllowToDiscoverDimensions",
            "Effect": "Allow",
            "Action": [
                "pi:ListAvailableResourceDimensions"
            ],
            "Resource": [
                "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W"
            ]
          },

          {
            "Sid": "O01AllowAllWithoutSpecifyingDimensions",
            "Effect": "Allow",
            "Action": [
                "pi:GetResourceMetrics",
                "pi:DescribeDimensionKeys"
            ],
            "Resource": [
                "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W"
            ]
        },
        
        {
            "Sid": "O01DenyAppDimensionForAll",
            "Effect": "Deny",
            "Action": [
                "pi:GetResourceMetrics",
                "pi:DescribeDimensionKeys"
            ],
            "Resource": [
                "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W"
            ],
            "Condition": {
                "ForAnyValue:StringEquals": {
                    "pi:Dimensions": [
                        "db.application.name"
                    ]
                }
            }
        },
        
        {
            "Sid": "O01DenySQLForGetResourceMetrics",
            "Effect": "Deny",
            "Action": [
                "pi:GetResourceMetrics"
            ],
            "Resource": [
                "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W"
            ],
            "Condition": {
                "ForAnyValue:StringEquals": {
                    "pi:Dimensions": [
                        "db.sql_tokenized.statement"
                    ]
                }
            }
        }
    ]
}
```
リクエストされたディメンションのレスポンスを次に示します。  

```
			// ListAvailableResourceDimensions API
// Request
{
    "ServiceType": "RDS",
    "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W",
    "Metrics": [ "db.load" ],
    "AuthorizedActions": ["GetResourceMetrics"]
}

// Response
{    
    "MetricDimensions": [ {
        "Metric": "db.load",
        "Groups": [
            {
                "Group": "db.application",
                "Dimensions": [
                
                  // removed from response because denied by the IAM Policy
                  //  { "Identifier": "db.application.name" }  
                ]
            },
            {
                "Group": "db.sql_tokenized",
                "Dimensions": [
                    { "Identifier": "db.sql_tokenized.id" },
                    { "Identifier": "db.sql_tokenized.db_id" },
                    
                  // removed from response because denied by the IAM Policy
                  //  { "Identifier": "db.sql_tokenized.statement" }
                ] 
            },
            ...
        ] }
    ]
}
```

```
// ListAvailableResourceDimensions API
// Request
{
    "ServiceType": "RDS",
    "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W",
    "Metrics": [ "db.load" ],
    "AuthorizedActions": ["DescribeDimensionKeys"]
}

// Response
{    
    "MetricDimensions": [ {
        "Metric": "db.load",
        "Groups": [
            {
                "Group": "db.application",
                "Dimensions": [
                  // removed from response because denied by the IAM Policy
                  //  { "Identifier": "db.application.name" }  
                ]
            },
            {
                "Group": "db.sql_tokenized",
                "Dimensions": [
                    { "Identifier": "db.sql_tokenized.id" },
                    { "Identifier": "db.sql_tokenized.db_id" },
                    
                  // allowed for DescribeDimensionKeys because our IAM Policy 
                  // denies it only for GetResourceMetrics
                    { "Identifier": "db.sql_tokenized.statement" }
                ] 
            },
            ...
        ] }
    ]
}
```

# Performance Insights でのタグベースのアクセスコントロールの使用
<a name="USER_PerfInsights.access-control.tag-based-policy"></a>

親 DB インスタンスから継承されたタグを使用して、Performance Insights メトリクスへのアクセスを制御できます。Performance Insights オペレーションへのアクセスを制御するには、IAM ポリシーを使用します。これらのポリシーは、DB インスタンスのタグをチェックしてアクセス許可を決定できます。

## Performance Insights でのタグの仕組み
<a name="USER_PerfInsights.access-control.tag-inheritance"></a>

Performance Insights は、DB インスタンスタグを自動的に適用して Performance Insights メトリクスを承認します。DB インスタンスにタグを追加すると、すぐにそれらのタグを使用して Performance Insights データへのアクセスを制御できます。
+ Performance Insights メトリクスのタグを追加または更新するには、DB インスタンスのタグを変更します。
+ Performance Insights メトリクスのタグを表示するには、Performance Insights メトリクスリソースで `ListTagsForResource` を呼び出します。メトリクスに関連付けられた DB インスタンスからタグを返します。

**注記**  
Performance Insights メトリクスで直接使用しようとすると、`TagResource` および `UntagResource` オペレーションはエラーを返します。

## タグベースの IAM ポリシーの作成
<a name="USER_PerfInsights.access-control.tag-based-policies"></a>

Performance Insights オペレーションへのアクセスを制御するには、IAM ポリシーで `aws:ResourceTag` 条件キーを使用します。これらのポリシーは、yourDB インスタンスのタグをチェックします。

**Example**  
このポリシーは、本番データベースの Performance Insights メトリクスへのアクセスを防止します。このポリシーは、`env:prod` でタグ付けされたデータベースリソースの Performance Insights での `pi:GetResourceMetrics` オペレーションを拒否します。  

```
 {
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Deny",
            "Action": "pi:GetResourceMetrics",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/env": "prod"
                }
            }
        }
    ]
}
```

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

**重要**  
 AWS は、Performance Insights のサポート終了日を 2026 年 6 月 30 日と発表しました。この日以降、Amazon RDS は Performance Insights コンソールのエクスペリエンス、柔軟な保持期間 (1～24 か月)、および関連する料金のサポートを終了します。Performance Insights API は存続し、料金の変更はありません。Performance Insights API の料金は、CloudWatch Database Insights の料金とともに AWS 請求書に表示されます。  
 Performance Insights の有料利用枠を使用する DB インスタンスは、2026 年 6 月 30 日より前に Database Insights のアドバンストモードにアップグレードすることをお勧めします。Database Insights のアドバンストモードへのアップグレード方法については、「[Amazon RDS で Database Insights のアドバンストモードを有効にする](USER_DatabaseInsights.TurningOnAdvanced.md)」を参照してください。  
 アクションを実行しない場合、Performance Insights を使用する DB インスタンスは、デフォルトで Database Insights のスタンダードモードを使用します。Database Insights のスタンダードモードでは、7 日間を超えたパフォーマンスデータ履歴、実行プラン機能とオンデマンド分析機能が Amazon RDS コンソールで利用できなくなる可能性があります。2026 年 6 月 30 日以降、Database Insights のアドバンストモードのみが実行プランとオンデマンド分析をサポートします。  
 CloudWatch Database Insights を使用すると、データベースのフリートのデータベース負荷をモニタリングし、パフォーマンスの大規模な分析とトラブルシューティングを行うことができます。Database Insights の詳細については、「[CloudWatch Database Insights による Amazon RDS データベースのモニタリング](USER_DatabaseInsights.md)」を参照してください。詳細については、[Amazon CloudWatch 料金表](https://aws.amazon.com/cloudwatch/pricing/)をご覧ください。

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

**Topics**
+ [Performance Insights ダッシュボードの概要](USER_PerfInsights.UsingDashboard.Components.md)
+ [Performance Insights ダッシュボードにアクセスする](USER_PerfInsights.UsingDashboard.Opening.md)
+ [待機イベントによる DB 負荷の分析](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.md)
+ [一定期間のデータベースパフォーマンスの分析](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md)
+ [Performance Insights のトップ SQL タブを使用したクエリの分析](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.md)
+ [Oracle PDB の上位負荷の分析](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.TopPDB.md)
+ [Amazon RDS の Performance Insights ダッシュボードを使用した実行プランの分析](USER_PerfInsights.UsingDashboard.AnalyzingPlans.md)

# Performance Insights ダッシュボードの概要
<a name="USER_PerfInsights.UsingDashboard.Components"></a>

ダッシュボードは、Performance Insights を操作する最も簡単な方法です。次の例では、PostgreSQL DB インスタンスのダッシュボードを示しています。

![\[メトリクスのフィルタリング\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_0b.png)


**Topics**
+ [時間範囲フィルター](#USER_PerfInsights.UsingDashboard.Components.time-range)
+ [カウンターメトリクスグラフ](#USER_PerfInsights.UsingDashboard.Components.Countermetrics)
+ [データベースロードのグラフ](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions)
+ [上位のディメンションテーブル](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable)

## 時間範囲フィルター
<a name="USER_PerfInsights.UsingDashboard.Components.time-range"></a>

デフォルトでは、Performance Insights ダッシュボードには過去 60 分間の DB ロードが表示されます。この範囲は、最短で 5 分、最長で 2 年まで調整することができます。カスタム相対範囲を選択することもできます。

![\[Performance Insights の相対時間\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf-insights-relative-time.png)


開始日時と終了日時の絶対範囲を選択できます。次の例は、24/9/25 の午前 0 時から 24/9/28 の午後 11 時 59 分までの時間範囲を示しています。

![\[Performance Insights の絶対時間\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf-insights-absolute-time.png)


デフォルトでは、Performance Insights ダッシュボードのタイムゾーンは協定世界時 (UTC) です。ローカルタイムゾーンを選択することもできます。

![\[Performance Insights ダッシュボードのローカルタイムゾーンを選択する\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf-insights-local-time-zone.png)


## カウンターメトリクスグラフ
<a name="USER_PerfInsights.UsingDashboard.Components.Countermetrics"></a>

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

 **カウンターメトリクス**グラフはパフォーマンスカウンターのデータを表示します。デフォルトのメトリクスは DB エンジンによって異なります。
+ MySQL と MariaDB - `db.SQL.Innodb_rows_read.avg`
+ Oracle - `db.User.user calls.avg`
+ Microsoft SQL Server - `db.Databases.Active Transactions(_Total).avg`
+ PostgreSQL - `db.Transactions.xact_commit.avg`

![\[カウンターメトリクス\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/oracle_perf_insights_counters.png)


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

![\[メトリクスのフィルタリング\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_select_metrics.png)


各 DB エンジンで追加できるカウンターメトリクスの詳細については、「[Performance Insights カウンターメトリクス](USER_PerfInsights_Counters.md)」を参照してください。

## データベースロードのグラフ
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions"></a>

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

![\[データベース負荷\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_2.png)


### ディメンションでスライスされた DB の負荷
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.dims"></a>

サポートされているディメンション別にグループ化された、アクティブなセッションとして負荷を表示するように選択できます。次の表に、各エンジンでサポートされているディメンションを示します。


| ディメンション | Oracle | SQL Server | PostgreSQL | MySQL | 
| --- | --- | --- | --- | --- | 
|  ホスト  |  可能  |  はい  |  はい  |  はい  | 
|  SQL  |  可能  |  はい  |  はい  |  はい  | 
|  ユーザー  |  可能  |  はい  |  はい  |  はい  | 
|  待機  |  可能  |  はい  |  はい  |  はい  | 
|  プラン  |  はい  |  なし  |  なし  |  いいえ  | 
|  アプリケーション  |  いいえ  |  なし  |  あり  |  なし  | 
|  データベース  |  いいえ  |  なし  |  はい  |  はい  | 
|  セッションタイプ  |  いいえ  |  なし  |  あり  |  なし  | 

次の図に、PostgreSQL DB インスタンスのディメンションを示します。

![\[メトリクスのフィルタリング\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_2b.png)


### ディメンション項目に関する DB ロードの詳細
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.item-details"></a>

ディメンション内の DB 負荷項目の詳細を表示するには、項目名にカーソルを合わせます。次の図は、SQL ステートメントの詳細を示しています。

![\[データベース負荷項目の詳細\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_2c.png)


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

![\[DB 負荷の期間の詳細\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_3.png)


## 上位のディメンションテーブル
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable"></a>

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

![\[上位 N のディメンション\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_4c.png)


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


| タブ | 説明 | サポートされているエンジン | 
| --- | --- | --- | 
|  上位の SQL  |  現在実行中の SQL ステートメント  |  すべて  | 
|  上位待機  |  データベースバックエンドが待っているイベント  |  すべて  | 
|  上位ホスト  |  接続されているクライアントのホスト名  |  すべて  | 
|  上位ユーザー  |  データベースにログインしているユーザー  |  すべて  | 
|  上位データベース  |  プロキシが接続しているデータベースユーザーの名前  |  PostgreSQL、MySQL、MariaDB、SQL Server のみ  | 
|  上位アプリケーション  |  データベースに接続されたアプリケーションの名前。  |  PostgreSQL と SQL Server のみ  | 
|  上位セッションタイプ  |  現在のセッションのタイプ  |  PostgreSQL のみ | 

[**上位の SQL**] タブを使用してクエリを分析する方法を学習するには、「[[トップ SQL] タブの概要](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.md#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL)」を参照してください。

# Performance Insights ダッシュボードにアクセスする
<a name="USER_PerfInsights.UsingDashboard.Opening"></a>

Amazon RDS のPerformance Insights ダッシュボードでは、Performance Insights と CloudWatch メトリクスの統合ビューが提供されます。

Performance Insights ダッシュボードにアクセスするには、以下の手順を使用します。

**AWS マネジメントコンソールで Performance Insights ダッシュボードを表示するには**

1. Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

1. DB インスタンスを選択します。

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

1. (オプション) 右上の日付または時間範囲を選択し、別の相対時間間隔または絶対時間間隔を指定します。これで、期間を指定して、データベースパフォーマンス分析レポートを生成できます。レポートには、特定されたインサイトと推奨事項が記載されています。詳細については、「[Performance Insights でのパフォーマンス分析レポートの作成](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md)」を参照してください。  
![\[時間間隔でメトリクスをフィルタリングする\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_0c.png)

   以下のスクリーンショットでは、DB 負荷の間隔は 5 時間です。  
![\[時間間隔を 5 時間に設定する\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_1.png)

1. (オプション) DB ロードグラフの一部を拡大表示するには、スタート時間を選択し、目的の期間の最後までドラッグします。

   選択した領域が DB ロードチャートで強調表示されます。  
![\[指定した時間間隔の DB ロード\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_zoom_in.png)

   マウスを離すと、選択した AWS リージョンの DB ロードグラフが拡大表示され、**上位*ディメンション***のテーブルが再計算されます。  
![\[選択した DB ロードを拡大表示する\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_zoom_in_b.png)

1. (オプション) データを自動的に更新するには、**[自動更新]** を選択します。  
![\[自動更新を設定する\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_1b.png)

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

# 待機イベントによる DB 負荷の分析
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad"></a>

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

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

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

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

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

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

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

例えば、以下のダッシュボードで、[**ログファイルの同期**] の待機はほとんどの DB 負荷の主な原因となっています。[**LGWR すべてのワーカーグループ**] の待機も高くなっています。「**上位の SQL**」 グラフでは、「**ログファイルの同期**」 の待機の発生元として、頻繁な`COMMIT` ステートメントが示されています。この場合、コミット頻度を下げると、DB 負荷が軽減されます。

![\[ログファイル同期エラー\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_7.png)


# 一定期間のデータベースパフォーマンスの分析
<a name="USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod"></a>

一定期間のパフォーマンス分析レポートを作成して、オンデマンド分析でデータベースのパフォーマンスを分析します。パフォーマンス分析レポートで、リソースのボトルネックや DB インスタンスでのクエリの変更などのパフォーマンスの問題を確認します。Performance Insights ダッシュボードでは、期間を選択してパフォーマンス分析レポートを作成できます。レポートに 1 つ以上のタグを追加することもできます。

この機能を使用するには、有料利用枠の保持期間を使用している必要があります。詳細については、「[Performance Insights の料金とデータ保持](USER_PerfInsights.Overview.cost.md)」を参照してください。

レポートは **[パフォーマンス分析レポート - 新規]** タブで選択して表示できます。レポートには、インサイト、関連するメトリクス、およびパフォーマンス問題を解決するための推奨事項が含まれています。レポートは、Performance Insights 保存期間中は表示できます。

レポート分析期間の開始時刻が保存期間外の場合、レポートは削除されます。保存期間が終了する前にレポートを削除することもできます。

パフォーマンス問題を検出し、DB インスタンスの分析レポートを生成するには、Performance Insights を有効にする必要があります。Performance Insights をオンにする方法の詳細については、「[Amazon RDS の Performance Insights の有効化と無効化](USER_PerfInsights.Enabling.md)」を参照してください。

この機能のリージョン、DB エンジン、およびインスタンスクラスのサポート情報については、「[Amazon RDS DB エンジン、リージョン、およびインスタンスクラスでサポートされている Performance Insights 機能](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport)」を参照してください。

以下のセクションでは、パフォーマンス分析レポートの作成、表示、タグの追加、削除を行うことができます。

**Topics**
+ [Performance Insights でのパフォーマンス分析レポートの作成](USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.md)
+ [Performance Insights でのパフォーマンス分析レポートの表示](USER_PerfInsights.UsingDashboard.ViewPerfAnalysisReport.md)
+ [Performance Insights のパフォーマンス分析レポートにタグを追加する](USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.md)
+ [Performance Insights のパフォーマンス分析レポートの削除](USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport.md)

# Performance Insights でのパフォーマンス分析レポートの作成
<a name="USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport"></a>

Performance Insights ダッシュボードで特定期間のパフォーマンス分析レポートを作成できます。期間を選択し、分析レポートに 1 つ以上のタグを追加できます。

分析期間は 5 分から 6 日間までに設定できます。分析開始時刻の前に、少なくとも 24 時間のパフォーマンスデータが必要です。

この機能のリージョン、DB エンジン、およびインスタンスクラスのサポート情報については、「[Amazon RDS DB エンジン、リージョン、およびインスタンスクラスでサポートされている Performance Insights 機能](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport)」を参照してください。

**一定期間のパフォーマンス分析レポートを作成するには**

1. Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

1. DB インスタンスを選択します。

1. Performance Insights ダッシュボードの **[データベース負荷]** セクションで **[パフォーマンスを分析]** を選択します。

   期間を設定するフィールドと、パフォーマンス分析レポートに 1 つ以上のタグを追加するフィールドが表示されます。  
![\[分析レポートを作成するためのフィールドが表示されている Performance Insights ダッシュボード\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/PI_CreateAnalysisReport.png)

1. 期間を選択します。右上の **[相対範囲]** または **[絶対範囲]** で期間を設定した場合は、この期間内の分析レポートの日付と時刻のみを入力または選択できます。この期間以外の分析期間を選択すると、エラーメッセージが表示されます。

    期間を設定するには、次のいずれかを行います。
   + DB 負荷チャートのいずれかのスライダーを押してドラッグします。

     **[パフォーマンス分析期間]** ボックスに選択した期間が表示され、DB 負荷チャートに選択した期間が強調表示されます。
   + **[パフォーマンス分析期間]** ボックスで、**[開始日]**、**[開始時間]**、**[終了日]**、および **[終了時間]** を選択します。  
![\[分析期間が選択された Performance Insights ダッシュボード\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/PI_CreateAnalysisRep_TimePeriod.png)

1. (オプション) **[キー]** と **[値 - *オプション*]** を入力して、レポートにタグを追加します。  
![\[新しいタグを追加するためのフィールドを含む Performance Insights ダッシュボード\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/PI_CreateAnalysisRep_AddTag.png)

1. **[パフォーマンスを分析]** を選択します。

   バナーに、レポート生成が成功したか失敗したかを示すメッセージが表示されます。メッセージには、レポートを表示するためのリンクも記載されています。

   次の例は、レポート作成成功メッセージを含むバナーを示しています。  
![\[分析レポート作成成功メッセージバナー\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/PI_CreateAnaysisRep_SuccessMsg.png)

   レポートは **[パフォーマンス分析レポート - 新規]** タブで表示できます。

パフォーマンス分析レポートは、AWS CLI を使用して作成できます。AWS CLI を使用してレポートを作成する方法の例については、「[一定期間のパフォーマンス分析レポートの作成](USER_PerfInsights.API.Examples.md#USER_PerfInsights.API.Examples.CreatePerfAnalysisReport)」を参照してください。

# Performance Insights でのパフォーマンス分析レポートの表示
<a name="USER_PerfInsights.UsingDashboard.ViewPerfAnalysisReport"></a>

**[パフォーマンス分析レポート - 新規]** タブには、DB インスタンスについて作成されたすべてのレポートが表示されます。各レポートには、以下が表示されます。
+ **[ID]**: レポートの一意識別子。
+ **[名前]**: レポートに追加されたタグキー。
+ **[レポート作成時間]**: レポートを作成した時刻。
+ **[分析開始時間]**: レポート内の分析の開始時刻。
+ **[分析終了時間]**: レポート内の分析の終了時刻。

**パフォーマンス分析レポートを表示するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

1. 分析レポートを表示する DB インスタンスを選択します。

1. 下にスクロールして、Performance Insights ダッシュボードの **[パフォーマンス分析レポート - 新規]** タブを選択します。

   異なる期間のすべての分析レポートが表示されます。

1. 表示するレポートの **[ID]** を選択します。

   複数のインサイトが特定された場合、DB 負荷チャートにはデフォルトで分析期間全体が表示されます。レポートで 1 つのインサイトが特定された場合、DB 負荷チャートにはデフォルトでそのインサイトが表示されます。

   ダッシュボードには、**[タグ]** セクションにレポートのタグも一覧表示されます。

   次の例は、レポートの分析期間全体を示しています。  
![\[分析レポート期間全体を示している DB 負荷チャート\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/PI_EntireAnalysisRep.png)

1. レポートで複数のインサイトが特定された場合、**[データベース負荷に関するインサイト]** リストで、表示するインサイトを選択します。

   ダッシュボードには、インサイトメッセージ、インサイトの期間が強調表示された DB 負荷チャート、分析と推奨事項、およびレポートタグのリストが表示されます。

   次の例は、レポートの DB 負荷インサイトを示しています。  
![\[レポート内のインサイトを示す DB 負荷チャート\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/PI_AnalysisRepInsight_chart.png)  
![\[レポートのインサイト分析と推奨セクション\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/PI_AnalysisRepInsight_Recommendations.png)

# Performance Insights のパフォーマンス分析レポートにタグを追加する
<a name="USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags"></a>

レポートを作成または表示するときに、タグを追加できます。レポートには最大 50 個のタグを追加できます。

タグを追加するアクセス許可が必要です。Performance Insights のアクセスポリシーの詳細については、「[Performance Insights 用のアクセスポリシーの設定](USER_PerfInsights.access-control.md)」を参照してください。

レポートの作成時に 1 つ以上のタグを追加するには、手順 [Performance Insights でのパフォーマンス分析レポートの作成](USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.md) のステップ 6 を参照してください。

**レポートを表示するときに 1 つ以上のタグを追加するには**

1. Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

1. DB インスタンスを選択します。

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

1. 下にスクロールして、**パフォーマンス分析レポート - 新規]** タブを選択します。

1. タグを追加するレポートを選択します。

   ダッシュボードにレポートが表示されます。

1. **[タグ]** までスクロールして、**[タグを管理]** を選択します。

1. [**新しいタグを追加**] をクリックします。

1. **[キー]** と **[値 - *オプション*]** を入力し、**[新しいタグを追加]** を選択します。

   次の例では、選択したレポートに新しいタグを追加するオプションを提供しています。  
![\[レポートに新しいタグを追加するための [タグの管理] ウィンドウ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/PI_AddTag_ManageTags.png)

   レポート用に新しいタグが作成されます。

   ダッシュボードの **[タグ]** セクションにレポートのタグのリストが表示されます。レポートからタグを削除する場合は、タグの横の **[削除]** を選択します。

# Performance Insights のパフォーマンス分析レポートの削除
<a name="USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport"></a>

**[パフォーマンス分析レポート]** タブに表示されているレポートのリストから、またはレポートの表示中にレポートを削除できます。

**レポートを削除するには**

1. Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

1. DB インスタンスを選択します。

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

1. 下にスクロールして、**パフォーマンス分析レポート - 新規]** タブを選択します。

1. 削除するレポートを選択し、右上の **[削除]** を選択します。  
![\[削除対象としてレポートが選択されている Performance Insights ダッシュボード\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/PI_DeleteAnalysisRep.png)

   確認ウィンドウが表示されます。確認を選択すると、レポートは削除されます。

1. (オプション) 削除するレポートの **ID** を選択します。

   レポートページの右上にある **[削除]** を選択します。

   確認ウィンドウが表示されます。確認を選択すると、レポートは削除されます。

# Performance Insights のトップ SQL タブを使用したクエリの分析
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics"></a>

Amazon RDS Performance Insights ダッシュボードでは、実行中のクエリや最近のクエリに関する情報を **[Top dimensions]** (上位ディメンション) テーブルの**[Top SQL]** (上位の SQL) タブで見ることができます。この情報を使用して、クエリをチューニングできます。

**Topics**
+ [[トップ SQL] タブの概要](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL)
+ [Performance Insights ダッシュボードでより多くの SQL テキストにアクセスする](USER_PerfInsights.UsingDashboard.SQLTextSize.md)
+ [Performance Insights ダッシュボードでの SQL 統計の表示](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.AnalyzingSQLLevel.md)

## [トップ SQL] タブの概要
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL"></a>

デフォルトでは、[**Top SQL**] (上位の SQL) タブはデータベースロードに最も貢献している 25 クエリを表示します。クエリをチューニングするために、クエリテキスト、SQL 統計などの情報を分析できます。また、[**トップ SQL**] タブに表示する統計を選択することもできます。

**Topics**
+ [SQL テキスト](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.text)
+ [SQL 統計](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.statistics)
+ [待機によるロード (AAS)](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Load-by-waits)
+ [SQL 情報の表示](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.SQL-information)
+ [統計設定を選択する](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Preferences)

### SQL テキスト
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.text"></a>

デフォルトでは、[**Top SQL**] (上位の SQL) テーブルの各行にはステートメントごとに 500 バイトのテキストが表示されます。

![\[SQL テキスト\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/sql-text-oracle.png)


デフォルトの 500 バイト以上の SQL テキストを表示する方法については、「[Performance Insights ダッシュボードでより多くの SQL テキストにアクセスする](USER_PerfInsights.UsingDashboard.SQLTextSize.md)」を参照してください。

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

```
SELECT * FROM emp WHERE lname = 'Sanchez'
SELECT * FROM emp WHERE lname = 'Olagappan'
SELECT * FROM emp WHERE lname = 'Wu'
```

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

![\[選択された SQL ダイジェスト\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_4b.png)


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

Performance Insights では、Oracle SQL テキストが **[Unknown]** (不明) と表示される可能性があります。次のような状況では、テキストはこの状態になります。
+ `SYS` 以外の Oracle データベースユーザーはアクティブですが、現在 SQL を実行していません。例えば、並列クエリが完了すると、クエリコーディネータはヘルパープロセスがセッション統計を送信するのを待ちます。待機中は、クエリテキストに **[Unknown]** (不明) と表示されます。
+ Standard Edition 2 の RDS for Oracle インスタンスの場合、リソースマネージャは並列スレッドの数を制限します。この作業を行うバックグラウンドプロセスにより、クエリテキストに [**不明**] と表示されます。

### SQL 統計
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.statistics"></a>

*SQL 統計*は、SQL クエリに関するパフォーマンス関連のメトリックです。例えば、Performance Insights には 1 秒あたりの実行数や 1 秒あたりの処理行数が表示されることがあります。Performance Insights は、最も一般的なクエリのみの統計を収集します。通常、これらは Performance Insights ダッシュボードに負荷別に表示される上位のクエリと一致します。

[**トップ SQL**] テーブル内の各行は、次の例のように、SQL ステートメントまたはダイジェストに関連する統計を示します。

![\[上位の SQL\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_4.png)


Performance Insights は、SQL 統計で `0.00` および `-` (不明) をレポートする可能性があります。この状況は、以下の条件で発生します。
+ サンプルが 1 つだけ存在する。例えば、Performance Insights は、`pg_stat_statements` ビューからの複数のサンプルに基づいて、RDS PostgreSQL クエリの変更率を計算します。ワークロードが短時間実行されると、Performance Insights ではサンプルが 1 つしか収集されない場合があります。つまり、変更率を計算できません。不明な値はダッシュ (`-`) で表されます。
+ 2 つのサンプルが同じ値を持っている。Performance Insights は、変更が発生していないため、変更率を計算することができず、変化率を `0.00` と報告します。
+ RDS PostgreSQL ステートメントに有効な識別子がない。PostgreSQL は、構文解析と分析の後にのみ、ステートメントの識別子を作成します。したがって、PostgreSQL の内部インメモリ構造に、識別子なしでステートメントが存在する可能性があります。Performance Insights は内部メモリ内構造を 1 秒に 1 回サンプリングするため、低レイテンシーのクエリは 1 つのサンプルに対してのみ表示されることがあります。このサンプルでクエリ識別子を使用できない場合、Performance Insights はこのステートメントを統計に関連付けることはできません。不明な値はダッシュ (`-`) で表されます。

Amazon RDS エンジンの SQL 統計の説明については、「[Performance Insights の SQL 統計](sql-statistics.md)」を参照してください。

### 待機によるロード (AAS)
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Load-by-waits"></a>

[**トップ SQL**] の [**待機別の負荷 (AAS)**] 列は、上位の各ロード項目に関連付けられているデータベースロードの割合を示しています。この列には、**DB 負荷グラフ**で現在選択されているグループ化に応じて、その項目に対する負荷が反映されます。平均アクティブセッション（AAS）の詳細については、[平均アクティブセッション](USER_PerfInsights.Overview.ActiveSessions.md#USER_PerfInsights.Overview.ActiveSessions.AAS) を参照してください。

例えば、**DB 負荷グラフ**を待機状態別にグループ化できます。上位負荷項目のテーブルで SQL クエリを調べます。この場合は、[**待機別の DB 負荷**] バーは、クエリが貢献している待機状態の量を示すために、サイズ、セグメント、および色で分けられています。また、選択したクエリに影響を与えている待機状態も示されます。

![\[待機別の DB 負荷\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_6.png)


### SQL 情報の表示
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.SQL-information"></a>

[**トップ SQL**] テーブルで、ステートメントを開いてその情報を表示できます。下部のペインに情報が表示されます。

![\[リテラルクエリが選択された上位の SQL テーブル\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf-insights-sql-ids-open.png)


SQL ステートメントに関連付けられているタイプの識別子 (ID) は以下のとおりです。
+ **Support SQL ID** - SQL ID のハッシュ値。この値は、AWS サポートを利用しているときに SQL ID を参照するためだけのものです。AWS サポートが実際の SQL ID や SQL テキストにアクセスすることはできません。
+ **ダイジェスト ID のサポート** - Digest ID のハッシュ値。この値は、AWS サポートを利用しているときにダイジェスト ID を参照するためだけのものです。AWSサポートが実際のダイジェスト ID や SQL テキストにアクセスすることはできません。

### 統計設定を選択する
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Preferences"></a>

「**設定**」 アイコンを選択すると、[**トップ SQL**] タブに表示される統計を制御できます。

![\[統計設定\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf-insights-sql-ids-preferences-icon.png)


[**設定**] アイコンを選択すると、[**設定**] ウィンドウが開きます。次のスクリーンショットは、**[Preferences]** (環境設定) ウィンドウの例です。

![\[設定ウィンドウ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf-insights-sql-ids-preferences.png)


[**トップ SQL**] タブに表示させたい統計を有効にするには、マウスを使用してウィンドウの下部までスクロールし、[**続行**] を選択します。

Amazon RDS エンジンの秒単位または呼び出し単位の統計の詳細については、[Performance Insights の SQL 統計](sql-statistics.md) の「エンジン固有の SQL 統計」セクションを参照してください。

# Performance Insights ダッシュボードでより多くの SQL テキストにアクセスする
<a name="USER_PerfInsights.UsingDashboard.SQLTextSize"></a>

デフォルトでは、[**トップ SQL**] テーブルの各行には SQL ステートメントごとに 500 バイトの SQL テキストが表示されます。

![\[500 バイトの SQL\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf-insights-top-sql-bytes.png)


SQL ステートメントのサイズが 500 バイトを超える場合、**[Top SQL]** (トップ SQL) テーブルの **[SQL text]** (SQL テキスト) セクションでテキストの表示量を増やすことができます。この場合、**[SQL text]** (SQL テキスト) に表示されるテキストの最大長は 4 KB です。コンソールで導入されるこの制限には、データベースエンジンによって設定された制限が適用されます。**[SQL text]** (SQL テキスト) に表示されているテキストを保存するには、**[Download]** (ダウンロード) を選択します。

**Topics**
+ [Amazon RDS エンジン のテキストサイズの制限](#sql-text-engine-limits)
+ [Amazon RDS for PostgreSQL DB インスタンスの SQL テキスト制限の設定](USER_PerfInsights.UsingDashboard.SQLTextLimit.md)
+ [Performance Insights ダッシュボードでの SQL テキストの表示とダウンロード](view-download-text.md)

## Amazon RDS エンジン のテキストサイズの制限
<a name="sql-text-engine-limits"></a>

SQL テキストをダウンロードするときに、データベースエンジンがテキストの最大長を決定します。エンジンごとのダウンロードできる SQL テキストの上限は次のとおりです。


| DB エンジン | ダウンロードされるテキストの最大長 | 
| --- | --- | 
| Amazon RDS for MySQL および MariaDB | Performance Schema が有効になっている場合、長さは 4,096 バイトに固定されます。Performance Schema が有効になっていない場合、長さは 65,535 バイトに固定されます。 | 
| Amazon RDS for Microsoft SQL Server | 4,096 文字 | 
| 「Amazon RDS for Oracle」 | 1,000 バイト | 

Performance Insights コンソールの **[SQL text]** (SQL テキスト) では、エンジンが返すテキストが最大値まで表示できます。例えば、 MySQL は、Performance Insights に対して最大 1 KB を返します。元のクエリが大きい場合でも、収集して表示できるのは 1 KB のみです。したがって、**[SQL text]** (SQL テキスト) でクエリを表示するか、ダウンロードすると、Performance Insights は同じバイト数を返します。

AWS CLI または API を使用する場合、Performance Insights には、コンソールで適用される 4 KB の制限がありません。`DescribeDimensionKeys` と `GetResourceMetrics` は、最大で 500 バイトを返します。

**注記**  
`GetDimensionKeyDetails` はクエリ全体を返しますが、サイズにはエンジンの制限が適用されます。

# Amazon RDS for PostgreSQL DB インスタンスの SQL テキスト制限の設定
<a name="USER_PerfInsights.UsingDashboard.SQLTextLimit"></a>

Amazon RDS for PostgreSQL は、テキストを異なる方法で処理します。DB インスタンスパラメータ `track_activity_query_size` を使用して、テキストサイズの制限を設定できます。このパラメータには次の特徴があります。

デフォルトのテキストサイズ  
Amazon RDS for PostgreSQL バージョン 9.6 では、`track_activity_query_size` パラメータのデフォルト設定は 1,024 バイトです。Amazon RDS for PostgreSQL バージョン 10 以降では、デフォルトは 4,096 バイトです。

最大テキストサイズ  
Amazon RDS for PostgreSQL バージョン 12 以前の場合、`track_activity_query_size` の制限は 102,400 バイトです。バージョン 13 以降の場合、最大値は 1 MB です。  
エンジンが Performance Insights に対して 1 MB を返す場合、コンソールでは最初の 4 KB のみが表示されます。クエリをダウンロードする場合、1 MB すべてを取得できます。この場合、表示する場合とダウンロードする場合では異なるバイト数が返されます。`track_activity_query_size` DB インスタンスパラメータの詳細については、PostgreSQL ドキュメントで「[ランタイム統計](https://www.postgresql.org/docs/current/runtime-config-statistics.html)」を参照してください。

SQL テキストのサイズを大きくするには、`track_activity_query_size` の制限を引き上げます。パラメータを変更するには、Amazon RDS for PostgreSQL DB インスタンスに関連付けられているパラメータグループのパラメータ設定を変更します。

**インスタンスでデフォルトのパラメータグループが使用される際に設定を変更するには**

1. 該当する DB エンジンおよび DB エンジンバージョンの新しい DB インスタンスパラメータグループを作成します。

1. 新しいパラメータグループにパラメータを設定します。

1. 新しいパラメータグループを DB インスタンスに関連付けます。

DB インスタンスパラメータの設定の詳細については、「[Amazon RDS の DB パラメータグループのパラメータの変更](USER_WorkingWithParamGroups.Modifying.md)」を参照してください。

# Performance Insights ダッシュボードでの SQL テキストの表示とダウンロード
<a name="view-download-text"></a>

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

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

1. Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

1. DB インスタンスを選択します。

1. Performance Insights ダッシュボードの **[トップ SQL]** タブまでスクロールします。

1. プラス記号を選択して SQL ダイジェストを展開し、ダイジェストの子クエリのいずれかを選択します。

   500 バイトを超える SQL ステートメントは、次のイメージのように表示されます。  
![\[テキストサイズが大きい SQL ステートメント\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-1.png)

1. 下部にある [**SQL テキスト**] タブまでスクロールします。  
![\[SQL 情報セクションに SQL テキストがさらに表示される\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-2.png)

   Performance Insights ダッシュボードは、各 SQL ステートメントの最大 4,096 バイトまでを表示できます。

1. (オプション) [**コピー**] を選択して、表示された SQL ステートメントをコピーするか、[**ダウンロード**] を選択して、DB エンジンに応じた最大サイズの SQL ステートメントをダウンロードします。
**注記**  
SQL ステートメントをコピーまたはダウンロードするには、ポップアップブロッカーを無効にします。

# Performance Insights ダッシュボードでの SQL 統計の表示
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.AnalyzingSQLLevel"></a>

Performance Insights ダッシュボードでは、SQL 統計を [**データベース負荷**] グラフの [**トップ SQL**] タブで見ることができます。

**SQL 統計を表示するには**

1. Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

1. ページの上部で、SQL 統計を表示するデータベースを選択します。

1. ページの下部までスクロールし、[**トップ SQL**] タブを選択します。

1. 個々のステートメント またはダイジェストクエリを選択します。  
![\[クエリを実行するためのメトリクスの表示\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_sql.png)

1. グラフの右上にある歯車のアイコンを選択して、表示する統計を選択します。Amazon RDS エンジンの SQL 統計の説明については、「[Performance Insights の SQL 統計](sql-statistics.md)」を参照してください。

   次の例は、Oracle DB インスタンスの統計設定を示しています。  
![\[Oracle DB インスタンスのクエリを実行するためのメトリクス\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_pref_oracle.png)

   次の例は、MariaDB および MySQL DB インスタンスの設定を示しています。  
![\[MariaDB および MySQL DB インスタンスのクエリを実行するためのメトリクスの設定。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_pref_ams.png)

1. 設定を保存するには [保存] を選択します。

   [**トップ SQL**] テーブルが更新されます。

   次の例は、Oracle SQL クエリの統計を示しています。  
![\[SQL クエリの統計\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_stats_oracle.png)

# Oracle PDB の上位負荷の分析
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.TopPDB"></a>

Oracle コンテナ DB (CDB) の負荷を分析する際、DB 負荷に最も寄与しているプラグ可能なデータベース (PDB) を特定できます。また、同様のクエリを実行している個々の PDB のパフォーマンスを比較して、パフォーマンスを微調整することもできます。Oracle CDB の詳細については、「[Oracle データベースアーキテクチャの RDS](oracle-multi-architecture.md)」を参照してください。

Amazon RDS Performance Insights ダッシュボードでは、プラグ可能なデータベースに関する情報は、**[ディメンション]** タブの **[上位 PDB]** タブにあります。

この機能のリージョン、DB エンジン、およびインスタンスクラスのサポート情報については、「[Amazon RDS DB エンジン、リージョン、およびインスタンスクラスでサポートされている Performance Insights 機能](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport)」を参照してください。

**Oracle CDB の上位 PDB 負荷を分析するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) を開きます。

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

1. Oracle CDB インスタンスを選択します。

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

1. **[データベース負荷 (DB 負荷)]** セクションで、[スライス基準] の横にある **[プラグ可能なデータベース (PDB)]** を選択します。

   平均アクティブセッショングラフには、負荷が最も高い PDB が表示されます。PDB 識別子は、色分けされた四角形の右側に表示されます。各識別子は PDB を一意に識別します。  
![\[PDB 負荷の平均アクティブセッショングラフ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_topPDB_AAS.png)

1. 下部にある [**トップ SQL**] タブまでスクロールします。

   次の例では、同じ SQL クエリと、それが複数の PDB に駆動する負荷を確認できます。  
![\[複数の PDB に対する同じ SQL クエリの負荷\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_topPDB_ex1.png)

   次の例では、1 つの PDB が CDB 内の他の PDB よりも高い負荷を処理しています。  
![\[PDB の SQL クエリ負荷が高い\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf_insights_topPDB_ex2.png)

   Oracle CDB の詳細については、「[CDBs and PDBs](https://docs.oracle.com/en/database/oracle/oracle-database/21/cncpt/CDBs-and-PDBs.html#GUID-FC2EB562-ED31-49EF-8707-C766B6FE66B8)」を参照してください。

# Amazon RDS の Performance Insights ダッシュボードを使用した実行プランの分析
<a name="USER_PerfInsights.UsingDashboard.AnalyzingPlans"></a>

Amazon RDS Performance Insights ダッシュボードでは、Oracle および SQL Server DB インスタンスの実行プランに関する情報を確認できます。この情報を使用して、どのプランが DB 負荷に最も影響しているかを知ることができます。

Oracle または SQL Server の実行プランを分析するには、以下のトピックを参照してください。

**実行プランの分析**
+ [Amazon RDS の Performance Insights ダッシュボードを使用した Oracle 実行プランの分析](USER_PerfInsights.UsingDashboard.AccessPlans.md)
+ [Amazon RDS の Performance Insights ダッシュボードを使用した SQL Server 実行プランの分析](USER_PerfInsights.UsingDashboard.AccessPlansSqlServer.md)

## Amazon RDS の実行プランの分析の概要
<a name="USER_PerfInsights.UsingDashboard.AnalyzingPlans.Overview"></a>

Amazon RDS Performance Insights ダッシュボードを使用して、Oracle および SQL Server DB インスタンスの DB 負荷に最も影響しているプランを確認できます。

 例えば、特定の時点の上位の SQL ステートメントが、次の表に示すプランを使用している場合があります。


****  

| 上位の SQL | 計画 | 
| --- | --- | 
|  SELECT SUM(amount\$1sold) FROM sales WHERE prod\$1id = 10  |  プラン A  | 
|  SELECT SUM(amount\$1sold) FROM sales WHERE prod\$1id = 521  |  プラン B  | 
|  SELECT SUM(s\$1total) FROM sales WHERE region = 10  |  プラン A  | 
|  SELECT \$1 FROM emp WHERE emp\$1id = 1000  |  プラン C  | 
|  SELECT SUM(amount\$1sold) FROM sales WHERE prod\$1id = 72  |  プラン A  | 

Performance Insights のプランニング機能を使用すると、以下を実行できます。
+ 上位 SQL クエリでどのプランが使用されているかを確認する。

  例えば、DB の負荷の大部分は、プラン A とプラン B を使用したクエリによって生成され、プラン C を使用する割合はごく小規模だということがあります。
+ 同じクエリについてさまざまなプランを比較する。

  前の例では、製品 ID を除けば、3 つのクエリは同一です。この内 2 つのクエリでプラン A が使用されますが、1 つのクエリではプラン B を使用しています。2 つのプランの違いを確認するには、Performance Insights を使用します。
+ クエリが新しいプランに切り替わった時期を確認する。

  プラン A を使用するクエリで、特定のタイミングでプラン B に切り替えられたことを確認できます。この時点で、データベースに変更があったかどうか。例えば、テーブルが空の場合、オプティマイザはテーブル全体に対するスキャンを選択することがあります。仮にテーブルに 100 万行がロードされたとすると、オプティマイザはインデックス範囲のスキャンに切り替えます。
+ コストが最も高いプランの特定のステップにドリルダウンします。

  例えば、実行時間の長いクエリで、等価結合に結合条件がないと表示される場合があります。この欠落条件により、2 つのテーブルのすべての行を結合するデカルト結合が強制的に実行されます。

上記のタスクは、Performance Insights のプランキャプチャ機能を使用して実行できます。クエリは、待機イベントと上位 SQL でスライスできるのと同様に、プランのディメンションでスライスできます。

# Amazon RDS の Performance Insights ダッシュボードを使用した Oracle 実行プランの分析
<a name="USER_PerfInsights.UsingDashboard.AccessPlans"></a>

Oracle Database の DB 負荷を分析する際に、DB 負荷に最も影響しているプランを知りたい場合があります。DB 負荷に最も影響しているプランを特定するには、Performance Insights のプランキャプチャ機能を使用できます。

**コンソールを使用して Oracle 実行プランを分析するには**

1. Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

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

1. [**データベース負荷 (DB 付加)**] セクションで、[**スライス基準**] の横にある [**プラン**] をクリックします。

   平均アクティブセッションのグラフには、上位 SQL ステートメントで使用されているプランが表示されます。プランのハッシュ値は、色分けされた四角形の右側に表示されます。各ハッシュ値によりプランを一意に識別できます。  
![\[プランによるスライス化\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/pi-slice-by-plans.png)

1. 下部にある [**トップ SQL**] タブまでスクロールします。

   次の例では、上位 SQL ダイジェストに 2 つのプランがあります。ステートメント内で疑問符を付けることで、それがダイジェストだと伝えることができます。  
![\[ダイジェストプランを選択する\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/top-sql-plans-unselected.png)

1. ダイジェストを選択して、そのコンポーネントステートメントを展開します。

   以下の例では、`SELECT` ステートメントがダイジェストクエリです。ダイジェスト内のコンポーネントクエリでは、2 つの異なるプランが使用されます。プランに付けられた色は、データベースの負荷チャートのものと対応しています。ダイジェスト内のプランの総数が、2 列目に表示されます。  
![\[ダイジェストプランを選択する\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/pi-digest-plan.png)

1. 下にスクロールし、[**ダイジェストクエリのプラン**] リストから、比較する 2 つの [**プラン**] を選択します。

   1 つのクエリについて、一度に 1 つまたは 2 つのプランを表示できます。次のスクリーンショットは、ダイジェスト内で、ハッシュ 2032253151 とハッシュ 1117438016 を含む 2 つのプランを比較しています。次の例では、このダイジェストクエリを実行する平均アクティブセッションの 62% が左側のプランを使用しているのに対し、38% は右側のプランを使用しています。  
![\[プランを並べて比較する\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/pi-compare-plan.png)

   この例では、それぞれのプランに重要な相違点があります。プラン 2032253151 のステップ 2 ではインデックススキャンが使用されますが、プラン 1117438016 ではフルテーブルスキャンが使用されます。ほとんどの場合、行数が多いテーブルでは、インデックススキャンを使用すると 1 行のクエリを高速化できます。  
![\[プランを並べて比較する\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/pi-table-access.png)

1. (オプション) [**コピー**] をクリックし、クリップボードにプランをコピーします。あるいは、[**ダウンロード**] により、ハードドライブにプランを保存します。

# Amazon RDS の Performance Insights ダッシュボードを使用した SQL Server 実行プランの分析
<a name="USER_PerfInsights.UsingDashboard.AccessPlansSqlServer"></a>

SQL Server データベースの DB 負荷を分析する際に、DB 負荷に最も影響しているプランを確認することもできます。DB 負荷に最も影響しているプランを特定するには、Performance Insights のプランキャプチャ機能を使用できます。

**コンソールを使用して SQL Server 実行プランを分析するには**

1. Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

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

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

1. [**データベース負荷 (DB 付加)**] セクションで、[**スライス基準**] の横にある [**プラン**] をクリックします。

   平均アクティブセッションのグラフには、上位 SQL ステートメントで使用されているプランが表示されます。プランのハッシュ値は、色分けされた四角形の右側に表示されます。各ハッシュ値によりプランを一意に識別できます。  
![\[プランによるスライス化\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/pi-slice-by-plans-sqlserver.png)

1. 下部にある [**トップ SQL**] タブまでスクロールします。

   次の例では、上位の SQL ダイジェストに 3 つのプランがあります。SQL ステートメントに疑問符が付いている場合は、そのステートメントがダイジェストであることを示しています。SQL ステートメント全体を表示するには、**[SQL ステートメント]** 列の値を選択します。  
![\[ダイジェストプランを選択する\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/top-sql-plans-unselected-sqlserver.png)

1. ダイジェストを選択して、そのコンポーネントステートメントを展開します。

   以下の例では、`SELECT` ステートメントがダイジェストクエリです。ダイジェスト内のコンポーネントクエリでは、3 つの異なる実行プランを使用します。プランに付けられた色は、データベースの負荷チャートに対応しています。  
![\[ダイジェストプランを選択する\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/pi-digest-plan-sqlserver.png)

1. 下にスクロールし、[**ダイジェストクエリのプラン**] リストから、比較する 2 つの [**プラン**] を選択します。

   1 つのクエリについて、一度に 1 つまたは 2 つのプランを表示できます。次のスクリーンショットは、ダイジェスト内の 2 つのプランを比較しています。次の例では、このダイジェストクエリを実行する平均アクティブセッションの 40% が左側のプランを使用し、28% が右側のプランを使用しています。  
![\[プランを並べて比較する\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/pi-compare-plan-sqlserver.png)

   前の例では、プラン間に重要な違いがあります。左側のプランのステップ 2 ではテーブルスキャンを使用しているのに対し、右側のプランではクラスター化インデックススキャンを使用しています。行数が多いテーブルでは、ほとんどの場合、1 行を取得するクエリはクラスター化インデックススキャンより高速です。

1. (オプション) [プランの詳細] テーブルの **[設定]** アイコンを選択して、列の表示と順序をカスタマイズします。次のスクリーンショットでは、[プランの詳細] テーブルに **[出力リスト]** 列が 2 番目の列として表示されています。  
![\[[プランの詳細] テーブルの列の表示と順序をカスタマイズする\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/pi-plan-fields-sql-server.png)

1. (オプション) [**コピー**] をクリックし、クリップボードにプランをコピーします。あるいは、[**ダウンロード**] により、ハードドライブにプランを保存します。

**注記**  
Performance Insights は、階層ツリーテーブルを使用して推定実行プランを表示します。このテーブルには、各ステートメントの部分的な実行情報が含まれています。[プランの詳細] テーブルの列の詳細については、SQL Server ドキュメントの「[SET SHOWPLAN\$1ALL](https://learn.microsoft.com/en-us/sql/t-sql/statements/set-showplan-all-transact-sql)」を参照してください。推定実行プランの実行情報全体を表示するには、**[ダウンロード]** を選択してプランをダウンロードし、これを SQL Server Management Studio にアップロードします。SQL Server Management Studio を使用して推定実行プランを表示する方法の詳細については、SQL Server ドキュメントの「[Display an Estimated Execution Plan](https://learn.microsoft.com/en-us/sql/relational-databases/performance/display-the-estimated-execution-plan)」を参照してください。

# Performance Insights のプロアクティブ推奨事項の表示
<a name="USER_PerfInsights.InsightsRecommendationViewDetails"></a>

Amazon RDS Performance Insights は特定のメトリクスを監視し、指定されたリソースで潜在的に問題と見なされる可能性があるレベルを分析することで自動的にしきい値を作成します。新しいメトリクス値が事前定義されたしきい値を一定期間にわたって超えた場合に、Performance Insights はプロアクティブ推奨事項を生成します。この推奨事項は、将来のデータベースパフォーマンスへの影響を防ぐのに役立ちます。これらのプロアクティブ推奨事項を受け取るには、有料利用枠の保持期間を使用して Performance Insights を有効にする必要があります。

Performance Insights をオンにする方法の詳細については、「[Amazon RDS の Performance Insights の有効化と無効化](USER_PerfInsights.Enabling.md)」を参照してください。Performance Insights の料金とデータ保持については、「[Performance Insights の料金とデータ保持](USER_PerfInsights.Overview.cost.md)」を参照してください。

プロアクティブ推奨事項でサポートされているリージョン、DB エンジン、インスタンスクラスについては、「[Amazon RDS DB エンジン、リージョン、およびインスタンスクラスでサポートされている Performance Insights 機能](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport)」を参照してください。

プロアクティブ推奨事項の詳細な分析と推奨される調査は、推奨事項の詳細ページで確認できます。

推奨事項の詳細については、「[Amazon RDS の推奨事項](monitoring-recommendations.md)」を参照してください。

**プロアクティブ推奨事項の詳細な分析を表示するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) を開きます。

1. ナビゲーションペインで、次のいずれかを実行します。
   + **[レコメンデーション]** を選択します。

     **[レコメンデーション]** ページには、アカウント内のすべてのリソースの重要度でソートされた推奨事項のリストが表示されます。
   + **[データベース]** を選択し、データベースページでリソースの **[レコメンデーション]** を選択します。

     **[レコメンデーション]** タブには、選択したリソースの推奨事項とその詳細が表示されます。

1. プロアクティブ推奨事項を検索し、**[詳細の表示]** を選択します。

   推奨事項の詳細ページが表示されます。タイトルには、影響を受けたリソースの名前と、検出された問題および重要度が表示されます。

   推奨事項の詳細ページのコンポーネントは次のとおりです。
   + **[推奨事項の概要]** – 検出された問題、推奨事項と問題のステータス、問題の開始時刻と終了時刻、推奨事項の変更時刻、エンジンタイプ。  
![\[コンソールの [推奨事項の概要] セクションを示すプロアクティブ推奨事項の推奨事項の詳細ページ。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/RecommendationProactive-RecSummary.png)
   + **[メトリクス]** – 検出された問題のグラフ。各グラフには、リソースのベースライン動作によって決まるしきい値と、問題の開始時刻から報告されたメトリクスのデータが表示されます。  
![\[コンソールの [メトリクス] セクションを示すプロアクティブ推奨事項の推奨事項の詳細ページ。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/RecommedationProactive_Metrics.png)
   + **[分析と推奨事項]** — 推奨事項と示唆された推奨事項の理由。  
![\[コンソールの[分析と推奨事項] セクションを示すプロアクティブ推奨事項の推奨事項の詳細ページ。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/ProactiveRecommendation-AnalysisAndRec.png)

   問題の原因を確認し、示唆された推奨アクションを実行して問題を解決するか、右上の **[閉じる]** を選択して推奨事項を却下できます。

# Performance Insights API for Amazon RDS によるメトリクスの取得
<a name="USER_PerfInsights.API"></a>

Performance Insights がオンになっている場合、API はインスタンスのパフォーマンスを可視化します。Amazon CloudWatch Logs は、AWS のサービスをモニタリングしたメトリクスの信頼性のある提供元です。

Performance Insightsは、平均アクティブ・セッション(AAS)として測定されるデータベースロードのドメイン固有のビューを提供します。このメトリクスはAPI利用者には2次元時系列データセットのように見えます。データの時間ディメンションは、クエリされた時間範囲内の各時点のDBロード・データを提供します。各時点で、その時点で計測された `SQL`、`Wait-event`、`User`、`Host` などのリクエストされたディメンションに関する負荷全体が分解されます。

Amazon RDS Performance Insights では、Amazon RDS DB インスタンス をモニタリングし、データベースパフォーマンスの分析とトラブルシューティングを行うことができます。Performance Insights は、AWS マネジメントコンソール で表示することができます。また、Performance Insights では独自のデータをクエリできるように、パブリック API も提供されています。API を使用して、次を実行できます。
+ データベースにデータをオフロードする
+ Performance Insights データを既存のモニタリングダッシュボードに追加する
+ モニタリングツールを構築する

Performance Insights API を使用するには、いずれかの Amazon RDS DB インスタンスで Performance Insights を有効にします。Performance Insights の有効化については、「[Amazon RDS の Performance Insights の有効化と無効化](USER_PerfInsights.Enabling.md)」を参照してください。Performance Insights API の詳細については、「[Amazon RDS Performance Insights API リファレンス](https://docs.aws.amazon.com/performance-insights/latest/APIReference/Welcome.html)」を参照してください。

Performance Insights API は、以下のオペレーションを提供します。


****  

|  Performance Insights でのアクション  |  AWS CLI コマンド  |  説明  | 
| --- | --- | --- | 
|  [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_CreatePerformanceAnalysisReport.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_CreatePerformanceAnalysisReport.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/pi/CreatePerformanceAnalysisReport.html](https://docs.aws.amazon.com/cli/latest/reference/pi/CreatePerformanceAnalysisReport.html)  |  DB インスタンスの特定の期間のパフォーマンス分析レポートを作成します。結果は、レポートの固有識別子である `AnalysisReportId` です。  | 
|  [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DeletePerformanceAnalysisReport.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DeletePerformanceAnalysisReport.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/pi/DeletePerformanceAnalysisReport.html](https://docs.aws.amazon.com/cli/latest/reference/pi/DeletePerformanceAnalysisReport.html)  |  パフォーマンス分析レポートを削除します。  | 
|  [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DescribeDimensionKeys.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DescribeDimensionKeys.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/pi/describe-dimension-keys.html](https://docs.aws.amazon.com/cli/latest/reference/pi/describe-dimension-keys.html)  |  特定の期間に、メトリクスの上位 N 個のディメンションキーを取得します。  | 
|  [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetDimensionKeyDetails.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetDimensionKeyDetails.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/pi/get-dimension-key-details.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-dimension-key-details.html)  |  DB インスタンスまたはデータソースの指定されたディメンショングループの属性を取得します。例えば、SQL ID を指定し、ディメンションの詳細が使用可能な場合、`GetDimensionKeyDetails` は、この ID に関連付けられているディメンション `db.sql.statement` の全文を取得します。このオペレーションは、`GetResourceMetrics` および `DescribeDimensionKeys` が大きな SQL ステートメントテキストの取得をサポートしないため、便利です。  | 
|  [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetPerformanceAnalysisReport.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetPerformanceAnalysisReport.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/pi/GetPerformanceAnalysisReport.html](https://docs.aws.amazon.com/cli/latest/reference/pi/GetPerformanceAnalysisReport.html)  |  レポートのインサイトを含むレポートを取得します。結果には、レポートのステータス、レポート ID、レポート時間の詳細、インサイト、および推奨事項が含まれます。  | 
| [GetResourceMetadata](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetadata.html) |  [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metadata.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metadata.html)  |  さまざまな機能に関するメタデータを取得します。例えば、メタデータにより、特定の DB インスタンスで何等かの機能が有効化されているか無効化されているかを、示すことができます。  | 
|  [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetrics.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetrics.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html)  |  期間中、データソースのセットに Performance Insights のメトリクスを取得します。特定のディメンショングループおよびディメンションを提供し、各グループの集約とフィルタリング条件を提供することができます。  | 
| [ListAvailableResourceDimensions](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListAvailableResourceDimensions.html) |  [https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-dimensions.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-dimensions.html)  |  指定したインスタンスで、指定したメトリクスタイプごとにクエリできるディメンションを取得します。  | 
| [ListAvailableResourceMetrics](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListAvailableResourceMetrics.html) |  [https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-metrics.html)  |  DB インスタンスを指定しながら、指定されたメトリクスタイプでクエリが可能なメトリクスをすべて取得します。  | 
|  `[ListPerformanceAnalysisReports](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListPerformanceAnalysisReports.html)` |  [https://docs.aws.amazon.com/cli/latest/reference/pi/list-performance-analysis-reports.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-performance-analysis-reports.html)  | DB インスタンスについて入手可能なすべての分析レポートを取得します。レポートは、各レポートの開始時間に基づいて一覧表示されます。 | 
|  `[ListTagsForResource](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListTagsForResource.html)` |  [https://docs.aws.amazon.com/cli/latest/reference/pi/list-tags-for-resource.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-tags-for-resource.html)  |  リソースに追加されたすべてのメタデータタグを一覧表示します。リストには、タグの名前と値が含まれます。  | 
|  `[TagResource](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_TagResource.html)` |  [https://docs.aws.amazon.com/cli/latest/reference/pi/tag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/pi/tag-resource.html)  |  Amazon RDS リソースにメタデータタグを追加します。タグには名前と値が含まれます。  | 
|  `[UntagResource](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_UntagResource.html)` |  [https://docs.aws.amazon.com/cli/latest/reference/pi/untag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/pi/untag-resource.html)  |  メタデータタグをリソースから削除します。  | 

Performance Insights の時系列メトリクスの取得と AWS CLI の例の詳細については、以下のトピックを参照してください。

**Topics**
+ [Performance Insights の時系列メトリクスの取得](USER_PerfInsights.API.TimeSeries.md)
+ [AWS CLIPerformance Insights での の例](USER_PerfInsights.API.Examples.md)

# Performance Insights の時系列メトリクスの取得
<a name="USER_PerfInsights.API.TimeSeries"></a>

`GetResourceMetrics` オペレーションでは、1 つ以上の時系列メトリクスを Performance Insights データから取得します。`GetResourceMetrics` には、メトリクスおよび期間が必要であり、データポイントのリストを含むレスポンスが返ります。

例えば、AWS マネジメントコンソール は、次のイメージのように、[**カウンターメトリクス**] チャートと [**データベースロード**] チャートの入力に `GetResourceMetrics` を使用します。

![\[カウンターメトリクスグラフおよびデータベースロードグラフ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf-insights-api-charts.png)


`GetResourceMetrics` によって返るメトリクスはすべて、`db.load` の例外を除き、スタンダードの時系列メトリクスです。このメトリクスは、[**データベースロード**] グラフに表示されます。この `db.load` メトリクスは、*ディメンション*と呼ばれるサブコンポーネントに分割できるため、他の時系列メトリクスとは異なります。前のイメージでは、`db.load` は分割され、`db.load` を構成する待機状態によってグループ化されています。

**注記**  
`GetResourceMetrics` は、`db.sampleload` メトリクスを返すこともできますが、通常 `db.load` メトリクスが適切です。

`GetResourceMetrics` により返されるカウンターメトリクスに関する情報は、「[Performance Insights カウンターメトリクス](USER_PerfInsights_Counters.md)」を参照してください。

以下の計算は、メトリクスにサポートされています。
+ 平均 - 期間中のメトリクスの平均値。`.avg` をメトリクス名に追加します。
+ 最小 - 期間中のメトリクスの最小値。`.min` をメトリクス名に追加します。
+ 最大 - 期間中のメトリクスの最大値。`.max` をメトリクス名に追加します。
+ 合計 - 期間中のメトリクス値の合計。`.sum` をメトリクス名に追加します。
+ サンプル数 - 期間中にメトリクスが収集された回数。`.sample_count` をメトリクス名に追加します。

例えば、メトリクスが 300 秒 (5 分) 収集され、メトリクスが 1 分に 1 回収集されたものと見なします。毎分の値は、1、2、3、4、5 です。この場合、以下の計算が返されます。
+ 平均 - 3
+ 最小 - 1
+ 最大 - 5
+ 合計 - 15
+ サンプル数 - 5

`get-resource-metrics` AWS CLI コマンドの使用の詳細については、「[https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html)」を参照してください。

`--metric-queries` オプションでは、結果を取得する 1 つ以上のクエリを指定します。各クエリは、必須の `Metric` と、オプションの `GroupBy` および `Filter` パラメータから構成されます。`--metric-queries` オプションの指定の例を次に示します。

```
{
   "Metric": "string",
   "GroupBy": {
     "Group": "string",
     "Dimensions": ["string", ...],
     "Limit": integer
   },
   "Filter": {"string": "string"
     ...}
```

# AWS CLIPerformance Insights での の例
<a name="USER_PerfInsights.API.Examples"></a>

以下のセクションでは、Performance Insights の AWS Command Line Interface (AWS CLI) の詳細と AWS CLI の使用例について説明します。

**Topics**
+ [Performance Insights の AWS CLI の組み込みヘルプ](#USER_PerfInsights.API.CLI)
+ [カウンターメトリクスの取得](#USER_PerfInsights.API.Examples.CounterMetrics)
+ [上位の待機イベントに関する DB 平均負荷の取得](#USER_PerfInsights.API.Examples.DBLoadAverage)
+ [上位の SQL に関する DB 平均負荷の取得](#USER_PerfInsights.API.Examples.DBLoadAverageTop10SQL)
+ [SQL によってフィルタリングされた平均 DB ロードの取得](#USER_PerfInsights.API.Examples.DBLoadAverageFilterBySQL)
+ [SQL ステートメントの全文の取得](#USER_PerfInsights.API.Examples.GetDimensionKeyDetails)
+ [一定期間のパフォーマンス分析レポートの作成](#USER_PerfInsights.API.Examples.CreatePerfAnalysisReport)
+ [パフォーマンス分析レポートの取得](#USER_PerfInsights.API.Examples.GetPerfAnalysisReport)
+ [DB インスタンスのすべてのパフォーマンス分析レポートを一覧表示する](#USER_PerfInsights.API.Examples.ListPerfAnalysisReports)
+ [パフォーマンス分析レポートの削除](#USER_PerfInsights.API.Examples.DeletePerfAnalysisReport)
+ [パフォーマンス分析レポートにタグを追加する](#USER_PerfInsights.API.Examples.TagPerfAnalysisReport)
+ [パフォーマンス分析レポートのすべてのタグを一覧表示する](#USER_PerfInsights.API.Examples.ListTagsPerfAnalysisReport)
+ [パフォーマンス分析レポートからタグを削除する](#USER_PerfInsights.API.Examples.UntagPerfAnalysisReport)

## Performance Insights の AWS CLI の組み込みヘルプ
<a name="USER_PerfInsights.API.CLI"></a>

Performance Insights は、AWS CLI を使用して表示することができます。Performance Insights の AWS CLI コマンドのヘルプを表示するには、コマンドラインで次のように入力します。

```
aws pi help
```

AWS CLI がインストールされていない場合は、「*AWS CLI ユーザーガイド*」の「[AWS CLI のインストール](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)」でインストールの方法を確認してください。

## カウンターメトリクスの取得
<a name="USER_PerfInsights.API.Examples.CounterMetrics"></a>

以下のスクリーンショットは、AWS マネジメントコンソール における 2 つのカウンターメトリクスグラフを示します。

![\[カウンターメトリクスグラフ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf-insights-api-counters-charts.png)


以下の例では、2 つのカウンターメトリクスグラフを生成するために AWS マネジメントコンソール で使用するデータと同じデータを生成する方法を示します。

Linux、macOS、Unix の場合:

```
aws pi get-resource-metrics \
   --service-type RDS \
   --identifier db-ID \
   --start-time 2018-10-30T00:00:00Z \
   --end-time   2018-10-30T01:00:00Z \
   --period-in-seconds 60 \
   --metric-queries '[{"Metric": "os.cpuUtilization.user.avg"  },
                      {"Metric": "os.cpuUtilization.idle.avg"}]'
```

Windows の場合:

```
aws pi get-resource-metrics ^
   --service-type RDS ^
   --identifier db-ID ^
   --start-time 2018-10-30T00:00:00Z ^
   --end-time   2018-10-30T01:00:00Z ^
   --period-in-seconds 60 ^
   --metric-queries '[{"Metric": "os.cpuUtilization.user.avg"  },
                      {"Metric": "os.cpuUtilization.idle.avg"}]'
```

また、コマンドを作成しやすくするために、`--metrics-query` オプションにファイルを指定します。以下の例では、このオプション用に query.json と呼ばれるファイルを使用します。ファイルの内容は次のとおりです。

```
[
    {
        "Metric": "os.cpuUtilization.user.avg"
    },
    {
        "Metric": "os.cpuUtilization.idle.avg"
    }
]
```

ファイルを使用するには、次のコマンドを実行します。

Linux、macOS、Unix の場合:

```
aws pi get-resource-metrics \
   --service-type RDS \
   --identifier db-ID \
   --start-time 2018-10-30T00:00:00Z \
   --end-time   2018-10-30T01:00:00Z \
   --period-in-seconds 60 \
   --metric-queries file://query.json
```

Windows の場合:

```
aws pi get-resource-metrics ^
   --service-type RDS ^
   --identifier db-ID ^
   --start-time 2018-10-30T00:00:00Z ^
   --end-time   2018-10-30T01:00:00Z ^
   --period-in-seconds 60 ^
   --metric-queries file://query.json
```

前述の例では、各オプションに次の値を指定します。
+ `--service-type` - `RDS` for Amazon RDS
+ `--identifier` - DB インスタンスのリソース ID
+ `--start-time` および `--end-time` - クエリを実行する期間の ISO 8601 `DateTime` 値 (サポートされている複数の形式)

クエリは 1 時間の範囲で実行されます。
+ `--period-in-seconds` - `60` (1 分ごとのクエリ)
+ `--metric-queries` - 2 つのクエリの配列。それぞれ 1 つのメトリクスに対して使用されます。

  メトリクス名ではドットを使用してメトリクスを有用なカテゴリに分類します。最終の要素は関数になります。この例では、関数は、クエリの `avg` です。Amazon CloudWatch と同様に、サポートされている関数は、`min`、`max`、`total`、および `avg` です。

レスポンスは次の例のようになります。

```
{
    "Identifier": "db-XXX",
    "AlignedStartTime": 1540857600.0,
    "AlignedEndTime": 1540861200.0,
    "MetricList": [
        { //A list of key/datapoints 
            "Key": {
                "Metric": "os.cpuUtilization.user.avg" //Metric1
            },
            "DataPoints": [
                //Each list of datapoints has the same timestamps and same number of items
                {
                    "Timestamp": 1540857660.0, //Minute1
                    "Value": 4.0
                },
                {
                    "Timestamp": 1540857720.0, //Minute2
                    "Value": 4.0
                },
                {
                    "Timestamp": 1540857780.0, //Minute 3
                    "Value": 10.0
                }
                //... 60 datapoints for the os.cpuUtilization.user.avg metric
            ]
        },
        {
            "Key": {
                "Metric": "os.cpuUtilization.idle.avg" //Metric2
            },
            "DataPoints": [
                {
                    "Timestamp": 1540857660.0, //Minute1
                    "Value": 12.0
                },
                {
                    "Timestamp": 1540857720.0, //Minute2
                    "Value": 13.5
                },
                //... 60 datapoints for the os.cpuUtilization.idle.avg metric 
            ]
        }
    ] //end of MetricList
} //end of response
```

レスポンスには、`Identifier`、`AlignedStartTime`、`AlignedEndTime` があります。`--period-in-seconds` 値が `60` の場合、スタート時間および終了時間は、時間 (分) に調整されます。`--period-in-seconds` が `3600` の場合、スタート時間および終了時間は、時間 (時) に調整されます。

レスポンスの `MetricList` には、多数のエントリを含み、それぞれに `Key` および `DataPoints` エントリがあります。`DataPoint` にはそれぞれ、`Timestamp` および `Value` を含みます。クエリは 1 分ごとのデータが 1 時間以上実行されるため、`Datapoints` の各リストには、60 個のデータポイントがあります。これには、`Timestamp1/Minute1` や `Timestamp2/Minute2` から、`Timestamp60/Minute60` まで含まれます。

クエリは 2 つの異なるカウンターメトリクスを対象としているため、レスポンス `MetricList` には 2 つの要素があります。

## 上位の待機イベントに関する DB 平均負荷の取得
<a name="USER_PerfInsights.API.Examples.DBLoadAverage"></a>

以下の例は、スタックされたエリアチャートを生成するために AWS マネジメントコンソール で使用されるのと同じクエリです。この例では、上位 7 つの待機イベントに応じて負荷を分割し、最後の 1 時間で `db.load.avg` を取得します。コマンドは [カウンターメトリクスの取得](#USER_PerfInsights.API.Examples.CounterMetrics) と同じコマンドです。ただし、query.json ファイルには、次の内容が含まれます。

```
[
    {
        "Metric": "db.load.avg",
        "GroupBy": { "Group": "db.wait_event", "Limit": 7 }
    }
]
```

以下のコマンドを実行してください。

Linux、macOS、Unix の場合:

```
aws pi get-resource-metrics \
   --service-type RDS \
   --identifier db-ID \
   --start-time 2018-10-30T00:00:00Z \
   --end-time   2018-10-30T01:00:00Z \
   --period-in-seconds 60 \
   --metric-queries file://query.json
```

Windows の場合:

```
aws pi get-resource-metrics ^
   --service-type RDS ^
   --identifier db-ID ^
   --start-time 2018-10-30T00:00:00Z ^
   --end-time   2018-10-30T01:00:00Z ^
   --period-in-seconds 60 ^
   --metric-queries file://query.json
```

この例では、上位 7 つの待機イベントのうち `db.load.avg` と `GroupBy` のメトリクスを指定しています。この例の有効な値の詳細については、*Performance Insights の API リファレンス*の「[DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html)」を参照してください。

レスポンスは次の例のようになります。

```
{
    "Identifier": "db-XXX",
    "AlignedStartTime": 1540857600.0,
    "AlignedEndTime": 1540861200.0,
    "MetricList": [
        { //A list of key/datapoints 
            "Key": {
                //A Metric with no dimensions. This is the total db.load.avg
                "Metric": "db.load.avg"
            },
            "DataPoints": [
                //Each list of datapoints has the same timestamps and same number of items
                {
                    "Timestamp": 1540857660.0, //Minute1
                    "Value": 0.5166666666666667
                },
                {
                    "Timestamp": 1540857720.0, //Minute2
                    "Value": 0.38333333333333336
                },
                {
                    "Timestamp": 1540857780.0, //Minute 3
                    "Value": 0.26666666666666666
                }
                //... 60 datapoints for the total db.load.avg key
            ]
        },
        {
            "Key": {
                //Another key. This is db.load.avg broken down by CPU
                "Metric": "db.load.avg",
                "Dimensions": {
                    "db.wait_event.name": "CPU",
                    "db.wait_event.type": "CPU"
                }
            },
            "DataPoints": [
                {
                    "Timestamp": 1540857660.0, //Minute1
                    "Value": 0.35
                },
                {
                    "Timestamp": 1540857720.0, //Minute2
                    "Value": 0.15
                },
                //... 60 datapoints for the CPU key
            ]
        },
        //... In total we have 8 key/datapoints entries, 1) total, 2-8) Top Wait Events
    ] //end of MetricList
} //end of response
```

このレスポンスでは、`MetricList` の 8 つのエントリがあります。合計の `db.load.avg` のエントリが 1 つあり、上位 7 つの待機イベントのいずれかに従って分割された `db.load.avg` のエントリが 7 つあります。初期の例とは異なり、グループ化ディメンションがあったため、メトリクスのグループ化ごとに 1 つのキーが必要です。基本的なカウンターメトリクスのユースケースのように、メトリクスごとに 1 つのキーのみ使用することはできません。

## 上位の SQL に関する DB 平均負荷の取得
<a name="USER_PerfInsights.API.Examples.DBLoadAverageTop10SQL"></a>

以下の例では、上位 10 個の SQL ステートメント別に `db.wait_events` をグループ化します。SQL ステートメントには 2 つの異なるグループがあります。
+ `db.sql` - SQL のフルステートメント (例:`select * from customers where customer_id = 123` )
+ `db.sql_tokenized` - トークン分割された SQL ステートメント `select * from customers where customer_id = ?`()

データベースのパフォーマンスを分析するときは、パラメータが異なるだけの SQL ステートメントを 1 つの論理的な項目として検討すると便利です。そのため、クエリを実行する際、`db.sql_tokenized` を使用することができます。ただし、特に Explain Plan を確認したい場合は、パラメータ付きの完全な SQL ステートメントと、`db.sql` によるクエリのグループ化を調べる方が便利な場合があります。トークン分割化された SQL と完全 SQL の間には親子関係があり、複数の完全 SQL (子) が同じトークン分割化された SQL (親) の下にグループ化されています。

この例のコマンドは、[上位の待機イベントに関する DB 平均負荷の取得](#USER_PerfInsights.API.Examples.DBLoadAverage) のコマンドに似ています。ただし、query.json ファイルには、次の内容が含まれます。

```
[
    {
        "Metric": "db.load.avg",
        "GroupBy": { "Group": "db.sql_tokenized", "Limit": 10 }
    }
]
```

次の例では `db.sql_tokenized` を使用しています。

Linux、macOS、Unix の場合:

```
aws pi get-resource-metrics \
   --service-type RDS \
   --identifier db-ID \
   --start-time 2018-10-29T00:00:00Z \
   --end-time   2018-10-30T00:00:00Z \
   --period-in-seconds 3600 \
   --metric-queries file://query.json
```

Windows の場合:

```
aws pi get-resource-metrics ^
   --service-type RDS ^
   --identifier db-ID ^
   --start-time 2018-10-29T00:00:00Z ^
   --end-time   2018-10-30T00:00:00Z  ^
   --period-in-seconds 3600 ^
   --metric-queries file://query.json
```

この例では、1 時間の間隔 (秒) で 24 時間以上のクエリを実行します。

この例では、上位 7 つの待機イベントのうち `db.load.avg` と `GroupBy` のメトリクスを指定しています。この例の有効な値の詳細については、*Performance Insights の API リファレンス*の「[DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html)」を参照してください。

レスポンスは次の例のようになります。

```
{
    "AlignedStartTime": 1540771200.0,
    "AlignedEndTime": 1540857600.0,
    "Identifier": "db-XXX",

    "MetricList": [ //11 entries in the MetricList
        {
            "Key": { //First key is total
                "Metric": "db.load.avg"
            }
            "DataPoints": [ //Each DataPoints list has 24 per-hour Timestamps and a value
                {
                    "Value": 1.6964980544747081,
                    "Timestamp": 1540774800.0
                },
                //... 24 datapoints
            ]
        },
        {
            "Key": { //Next key is the top tokenized SQL  
                "Dimensions": {
                    "db.sql_tokenized.statement": "INSERT INTO authors (id,name,email) VALUES\n( nextval(?)  ,?,?)",
                    "db.sql_tokenized.db_id": "pi-2372568224",
                    "db.sql_tokenized.id": "AKIAIOSFODNN7EXAMPLE"
                },
                "Metric": "db.load.avg"
            },
            "DataPoints": [ //... 24 datapoints 
            ]
        },
        // In total 11 entries, 10 Keys of top tokenized SQL, 1 total key 
    ] //End of MetricList
} //End of response
```

このレスポンスの `MetricList` には 11 のエントリがあり (合計が 1 つと、トークン分割された上位 10 項目の SQL)、各エントリには、1 時間あたり 24 の `DataPoints` があります。

トークン分割された SQL の場合は、各ディメンションリストに 3 つのエントリがあります。
+ `db.sql_tokenized.statement` - トークン分割された SQL ステートメント。
+ `db.sql_tokenized.db_id ` - SQL の参照に使用されていたネイティブデータベース ID、または Performance Insights によって生成される合成 ID (ネイティブデータベース ID が利用できない場合)。この例では、`pi-2372568224` 合成 ID が返ります。
+ `db.sql_tokenized.id` - Performance Insights 内のクエリの ID。

  AWS マネジメントコンソール で、この ID はサポート ID と呼ばれます。ID は、データベースに関する問題のトラブルシューティングに役立つ、AWS サポートが調査できるデータであるため、この名前が付けられています。AWS は、データのセキュリティとプライバシーを非常に重視しており、ほとんどすべてのデータが AWS KMS キーで暗号化されて保存されます。そのため、このデータを AWS 内で見ることはできません。前の例では、`tokenized.statement` と `tokenized.db_id` の両方が暗号化されて保存されます。データベースに問題がある場合は、AWS サポートがサポート ID を参照して問題を解決できるようお手伝いします。

クエリを実行する際、`Group` で `GroupBy` を指定した方が便利な場合があります。ただし、返るデータを詳細に制御できるように、ディメンションのリストを指定します。例えば、必要なデータが `db.sql_tokenized.statement` のみの場合は、`Dimensions` 属性を query.json ファイルに追加することができます。

```
[
    {
        "Metric": "db.load.avg",
        "GroupBy": {
            "Group": "db.sql_tokenized",
            "Dimensions":["db.sql_tokenized.statement"],
            "Limit": 10
        }
    }
]
```

## SQL によってフィルタリングされた平均 DB ロードの取得
<a name="USER_PerfInsights.API.Examples.DBLoadAverageFilterBySQL"></a>

![\[SQL グラフでフィルタリングします。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf-insights-api-filter-chart.png)


上のイメージは、特定のクエリが選択されていることを示しています。上位の平均アクティブセッションのスタックされたエリアグラフはそのクエリを対象としています。クエリは、依然として上位 7 つの全体的な待機イベントを対象としていますが、レスポンスの値はフィルタリングされます。フィルタでは、特定のフィルタに一致するセッションのみが考慮されます。

この例に対応する API クエリは、[上位の SQL に関する DB 平均負荷の取得](#USER_PerfInsights.API.Examples.DBLoadAverageTop10SQL) のコマンドに似ています。ただし、query.json ファイルには、次の内容が含まれます。

```
[
 {
        "Metric": "db.load.avg",
        "GroupBy": { "Group": "db.wait_event", "Limit": 5  }, 
        "Filter": { "db.sql_tokenized.id": "AKIAIOSFODNN7EXAMPLE" }
    }
]
```

Linux、macOS、Unix の場合:

```
aws pi get-resource-metrics \
   --service-type RDS \
   --identifier db-ID \
   --start-time 2018-10-30T00:00:00Z \
   --end-time   2018-10-30T01:00:00Z \
   --period-in-seconds 60 \
   --metric-queries file://query.json
```

Windows の場合:

```
aws pi get-resource-metrics ^
   --service-type RDS ^
   --identifier db-ID ^
   --start-time 2018-10-30T00:00:00Z ^
   --end-time   2018-10-30T01:00:00Z ^
   --period-in-seconds 60 ^
   --metric-queries file://query.json
```

レスポンスは次の例のようになります。

```
{
    "Identifier": "db-XXX", 
    "AlignedStartTime": 1556215200.0, 
    "MetricList": [
        {
            "Key": {
                "Metric": "db.load.avg"
            }, 
            "DataPoints": [
                {
                    "Timestamp": 1556218800.0, 
                    "Value": 1.4878117913832196
                }, 
                {
                    "Timestamp": 1556222400.0, 
                    "Value": 1.192823803967328
                }
            ]
        }, 
        {
            "Key": {
                "Metric": "db.load.avg", 
                "Dimensions": {
                    "db.wait_event.type": "io", 
                    "db.wait_event.name": "wait/io/aurora_redo_log_flush"
                }
            }, 
            "DataPoints": [
                {
                    "Timestamp": 1556218800.0, 
                    "Value": 1.1360544217687074
                }, 
                {
                    "Timestamp": 1556222400.0, 
                    "Value": 1.058051341890315
                }
            ]
        }, 
        {
            "Key": {
                "Metric": "db.load.avg", 
                "Dimensions": {
                    "db.wait_event.type": "io", 
                    "db.wait_event.name": "wait/io/table/sql/handler"
                }
            }, 
            "DataPoints": [
                {
                    "Timestamp": 1556218800.0, 
                    "Value": 0.16241496598639457
                }, 
                {
                    "Timestamp": 1556222400.0, 
                    "Value": 0.05163360560093349
                }
            ]
        }, 
        {
            "Key": {
                "Metric": "db.load.avg", 
                "Dimensions": {
                    "db.wait_event.type": "synch", 
                    "db.wait_event.name": "wait/synch/mutex/innodb/aurora_lock_thread_slot_futex"
                }
            }, 
            "DataPoints": [
                {
                    "Timestamp": 1556218800.0, 
                    "Value": 0.11479591836734694
                }, 
                {
                    "Timestamp": 1556222400.0, 
                    "Value": 0.013127187864644107
                }
            ]
        }, 
        {
            "Key": {
                "Metric": "db.load.avg", 
                "Dimensions": {
                    "db.wait_event.type": "CPU", 
                    "db.wait_event.name": "CPU"
                }
            }, 
            "DataPoints": [
                {
                    "Timestamp": 1556218800.0, 
                    "Value": 0.05215419501133787
                }, 
                {
                    "Timestamp": 1556222400.0, 
                    "Value": 0.05805134189031505
                }
            ]
        }, 
        {
            "Key": {
                "Metric": "db.load.avg", 
                "Dimensions": {
                    "db.wait_event.type": "synch", 
                    "db.wait_event.name": "wait/synch/mutex/innodb/lock_wait_mutex"
                }
            }, 
            "DataPoints": [
                {
                    "Timestamp": 1556218800.0, 
                    "Value": 0.017573696145124718
                }, 
                {
                    "Timestamp": 1556222400.0, 
                    "Value": 0.002333722287047841
                }
            ]
        }
    ], 
    "AlignedEndTime": 1556222400.0
} //end of response
```

このレスポンスでは、query.json ファイルで指定されているトークン分割化された SQL AKIAIOSFODNN7EXAMPLE の割合に従って、値はすべてフィルタリングされます。キーは、フィルタなしのクエリとは異なる順序で表示されることもあります。これは、フィルタ処理された SQL に影響を与えるのは上位 5 つの待機イベントであるためです。

## SQL ステートメントの全文の取得
<a name="USER_PerfInsights.API.Examples.GetDimensionKeyDetails"></a>

次の例では、DB インスタンス `db-10BCD2EFGHIJ3KL4M5NO6PQRS5` の SQL ステートメントの全文を取得します。`--group` は `db.sql` であり、`--group-identifier` は `db.sql.id` です。この例では、*my-sql-id* は、`pi get-resource-metrics` または `pi describe-dimension-keys` を呼び出して取得した SQL ID を表します。

以下のコマンドを実行してください。

Linux、macOS、Unix の場合:

```
aws pi get-dimension-key-details \
   --service-type RDS \
   --identifier db-10BCD2EFGHIJ3KL4M5NO6PQRS5 \
   --group db.sql \
   --group-identifier my-sql-id \
   --requested-dimensions statement
```

Windows の場合:

```
aws pi get-dimension-key-details ^
   --service-type RDS ^
   --identifier db-10BCD2EFGHIJ3KL4M5NO6PQRS5 ^
   --group db.sql ^
   --group-identifier my-sql-id ^
   --requested-dimensions statement
```

この例では、ディメンションの詳細を使用できます。したがって、Performance Insights は、SQL ステートメントを切り捨てることなく、その全文を取得します。

```
{
    "Dimensions":[
    {
        "Value": "SELECT e.last_name, d.department_name FROM employees e, departments d WHERE e.department_id=d.department_id",
        "Dimension": "db.sql.statement",
        "Status": "AVAILABLE"
    },
    ...
    ]
}
```

## 一定期間のパフォーマンス分析レポートの作成
<a name="USER_PerfInsights.API.Examples.CreatePerfAnalysisReport"></a>

次の例では、`db-loadtest-0` データベースの `1682969503` 開始時間と `1682979503` 終了時間を使用してパフォーマンス分析レポートを作成します。

```
aws pi create-performance-analysis-report \
        --service-type RDS \
        --identifier db-loadtest-0 \
        --start-time 1682969503 \
        --end-time 1682979503 \
        --region us-west-2
```

レスポンスは、レポートの一意識別子 `report-0234d3ed98e28fb17` です。

```
{
   "AnalysisReportId": "report-0234d3ed98e28fb17"
}
```

## パフォーマンス分析レポートの取得
<a name="USER_PerfInsights.API.Examples.GetPerfAnalysisReport"></a>

次の例では、`report-0d99cc91c4422ee61` レポートについて分析レポートの詳細を取得します。

```
aws pi get-performance-analysis-report \
--service-type RDS \
--identifier db-loadtest-0 \
--analysis-report-id report-0d99cc91c4422ee61 \
--region us-west-2
```

レスポンスには、レポートのステータス、ID、時間の詳細、およびインサイトが表示されます。

```
        {
    "AnalysisReport": {
        "Status": "Succeeded", 
        "ServiceType": "RDS", 
        "Identifier": "db-loadtest-0", 
        "StartTime": 1680583486.584, 
        "AnalysisReportId": "report-0d99cc91c4422ee61", 
        "EndTime": 1680587086.584, 
        "CreateTime": 1680587087.139, 
        "Insights": [
           ... (Condensed for space)
        ]
    }
}
```

## DB インスタンスのすべてのパフォーマンス分析レポートを一覧表示する
<a name="USER_PerfInsights.API.Examples.ListPerfAnalysisReports"></a>

次の例は、`db-loadtest-0` データベースについて入手可能なすべてのパフォーマンス分析レポートを一覧表示します。

```
aws pi list-performance-analysis-reports \
--service-type RDS \
--identifier db-loadtest-0 \
--region us-west-2
```

レスポンスには、すべてのレポートがレポートの ID、ステータス、および時間の詳細とともに一覧表示されます。

```
{
    "AnalysisReports": [
        {
            "Status": "Succeeded", 
            "EndTime": 1680587086.584, 
            "CreationTime": 1680587087.139, 
            "StartTime": 1680583486.584, 
            "AnalysisReportId": "report-0d99cc91c4422ee61"
        }, 
        {
            "Status": "Succeeded", 
            "EndTime": 1681491137.914, 
            "CreationTime": 1681491145.973, 
            "StartTime": 1681487537.914, 
            "AnalysisReportId": "report-002633115cc002233"
        }, 
        {
            "Status": "Succeeded", 
            "EndTime": 1681493499.849, 
            "CreationTime": 1681493507.762, 
            "StartTime": 1681489899.849, 
            "AnalysisReportId": "report-043b1e006b47246f9"
        }, 
        {
            "Status": "InProgress", 
            "EndTime": 1682979503.0, 
            "CreationTime": 1682979618.994, 
            "StartTime": 1682969503.0, 
            "AnalysisReportId": "report-01ad15f9b88bcbd56"
        }
    ]
}
```

## パフォーマンス分析レポートの削除
<a name="USER_PerfInsights.API.Examples.DeletePerfAnalysisReport"></a>

次の例では、`db-loadtest-0` データベースの分析レポートを削除します。

```
aws pi delete-performance-analysis-report \
--service-type RDS \
--identifier db-loadtest-0 \
--analysis-report-id report-0d99cc91c4422ee61 \
--region us-west-2
```

## パフォーマンス分析レポートにタグを追加する
<a name="USER_PerfInsights.API.Examples.TagPerfAnalysisReport"></a>

次の例では、キー `name` と値 `test-tag` のタグを `report-01ad15f9b88bcbd56` レポートに追加します。

```
aws pi tag-resource \
--service-type RDS \
--resource-arn arn:aws:pi:us-west-2:356798100956:perf-reports/RDS/db-loadtest-0/report-01ad15f9b88bcbd56 \
--tags Key=name,Value=test-tag \
--region us-west-2
```

## パフォーマンス分析レポートのすべてのタグを一覧表示する
<a name="USER_PerfInsights.API.Examples.ListTagsPerfAnalysisReport"></a>

次の例では、`report-01ad15f9b88bcbd56` レポートのすべてのタグを一覧表示します。

```
aws pi list-tags-for-resource \
--service-type RDS \
--resource-arn arn:aws:pi:us-west-2:356798100956:perf-reports/RDS/db-loadtest-0/report-01ad15f9b88bcbd56 \
--region us-west-2
```

レスポンスには、レポートに追加されたすべてのタグの値とキーが一覧表示されます。

```
{
    "Tags": [
        {
            "Value": "test-tag", 
            "Key": "name"
        }
    ]
}
```

## パフォーマンス分析レポートからタグを削除する
<a name="USER_PerfInsights.API.Examples.UntagPerfAnalysisReport"></a>

次の例では、`report-01ad15f9b88bcbd56` レポートから `name` タグを削除します。

```
aws pi untag-resource \
--service-type RDS \
--resource-arn arn:aws:pi:us-west-2:356798100956:perf-reports/RDS/db-loadtest-0/report-01ad15f9b88bcbd56 \
--tag-keys name \
--region us-west-2
```

タグを削除した後、`list-tags-for-resource` API を呼び出しても、このタグは一覧に表示されません。

# AWS CloudTrail を使用した Performance Insights 呼び出しのログ記録
<a name="USER_PerfInsights.CloudTrail"></a>

Performance Insights は AWS CloudTrail サービスと連携して動作します。このサービスは、Performance Insights でユーザー、ロール、または AWS のサービスによって実行されたアクションを記録します。CloudTrail は、Performance Insights のすべての API コールをイベントとしてキャプチャします。このキャプチャには、Amazon RDS コンソールからのコールと、Performance Insights API オペレーションへのコードコールが含まれます。

証跡を作成すると、Performance Insights のイベントも含めて、Amazon S3 バケットへの CloudTrail イベントの継続的配信を有効にすることができます。追跡を設定しない場合でも、CloudTrail コンソールの [**イベント履歴**] で最新のイベントを表示できます。CloudTrail によって収集されたデータを使用して、多くの情報を判断できます。この情報には、Performance Insights に対するリクエスト、リクエスト元の IP アドレス、リクエスト者、リクエスト日時が含まれます。追加の詳細も含まれています。

CloudTrail の詳細については、[AWS CloudTrail ユーザーガイド](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)を参照してください。

## CloudTrail での Performance Insights 情報の使用
<a name="USER_PerfInsights.CloudTrail.service-name-info"></a>

AWS アカウントを作成すると、そのアカウントに対して CloudTrail が有効になります。Performance Insights でアクティビティが発生すると、そのアクティビティは、CloudTrail イベントとして AWS の他のサービスのイベントとともに、CloudTrail コンソールの [**イベント履歴**] に記録されます。AWS アカウントで最近のイベントを表示、検索、ダウンロードできます。詳細については、*AWS CloudTrail ユーザーガイド*の「[CloudTrail イベント履歴でのイベントの表示](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)」を参照してください。

Performance Insights のイベントなど、AWS アカウントのイベントを継続的に記録する場合は、証跡を作成します。*証跡*により、CloudTrail はログファイルを Amazon S3 バケットに配信できます。デフォルトでは、コンソールで証跡を作成すると、すべての AWS リージョンに証跡が適用されます。追跡では、AWS パーティション内のすべての AWS リージョンからのイベントをログに記録し、指定した Simple Storage Service (Amazon S3)バケットにログファイルを配信します。さらに、CloudTrail ログで収集したイベントデータをより詳細に分析し、それに基づいて対応するため、他の AWS サービスを構成できます。詳細については、*AWS CloudTrail ユーザーガイド*の次のトピックを参照してください。
+ [証跡の作成のための概要](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail がサポートするサービスと統合](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [CloudTrail 用 Amazon SNS 通知の構成](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [複数のリージョンから CloudTrail ログファイルを受け取る](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)および[複数のアカウントから CloudTrail ログファイルを受け取る](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)

すべての Performance Insights オペレーションは CloudTrail によってログに記録されます。また、[Performance Insights API リファレンス](https://docs.aws.amazon.com/performance-insights/latest/APIReference/Welcome.html)に記載されています。例えば、`DescribeDimensionKeys` オペレーションと `GetResourceMetrics` オペレーションへのコールに伴って、CloudTrail ログファイルにエントリが生成されます。

各イベントまたはログエントリには、誰がリクエストを生成したかという情報が含まれます。同一性情報は次の判断に役立ちます。
+ リクエストが、ルートと IAM ユーザー認証情報のどちらを使用して送信されたか。
+ リクエストがロールまたはフェデレーションユーザーの一時的なセキュリティ認証情報を使用して行われたかどうか。
+ リクエストが別の AWS サービスによって行われたかどうか。

詳細については、「[[CloudTrail userIdentity 要素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)」を参照してください。

## Performance Insights のログファイルのエントリ
<a name="USER_PerfInsights.CloudTrail.service-name-entries"></a>

[*トレイル*] は、指定した Simple Storage Service (Amazon S3) バケットにイベントをログファイルとして配信するように設定できます。CloudTrail ログファイルには、1 つ以上のログエントリがあります。*イベント*は、任意の送信元からの単一のリクエストを表します。各イベントには、リクエストされたオペレーション、オペレーションの日時、リクエストパラメータなどに関する情報が含まれます。CloudTrail ログファイルは、パブリック API コールの順序付けられたスタックトレースではないため、特定の順序では表示されません。

`GetResourceMetrics` オペレーションを示す CloudTrail ログエントリの例は、次のとおりです。

```
{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "IAMUser",
         "principalId": "AKIAIOSFODNN7EXAMPLE",
        "arn": "arn:aws:iam::123456789012:user/johndoe",
        "accountId": "123456789012",
        "accessKeyId": "AKIAI44QH8DHBEXAMPLE",
        "userName": "johndoe"
    },
    "eventTime": "2019-12-18T19:28:46Z",
    "eventSource": "pi.amazonaws.com",
    "eventName": "GetResourceMetrics",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "72.21.198.67",
    "userAgent": "aws-cli/1.16.240 Python/3.7.4 Darwin/18.7.0 botocore/1.12.230",
    "requestParameters": {
        "identifier": "db-YTDU5J5V66X7CXSCVDFD2V3SZM",
        "metricQueries": [
            {
                "metric": "os.cpuUtilization.user.avg"
            },
            {
                "metric": "os.cpuUtilization.idle.avg"
            }
        ],
        "startTime": "Dec 18, 2019 5:28:46 PM",
        "periodInSeconds": 60,
        "endTime": "Dec 18, 2019 7:28:46 PM",
        "serviceType": "RDS"
    },
    "responseElements": null,
    "requestID": "9ffbe15c-96b5-4fe6-bed9-9fccff1a0525",
    "eventID": "08908de0-2431-4e2e-ba7b-f5424f908433",
    "eventType": "AwsApiCall",
    "recipientAccountId": "123456789012"
}
```

# Performance Insights API とインターフェイス VPC エンドポイント (AWS PrivateLink)
<a name="pi-vpc-interface-endpoints"></a>

AWS PrivateLink を使用して、VPC と Amazon RDS Performance Insights 間にプライベート接続を作成できます。インターネットゲートウェイ、NAT デバイス、VPN 接続、または Direct Connect 接続を使用せずに、VPC 内にあるかのように Performance Insights にアクセスできます。VPC のインスタンスは、パブリック IP アドレスがなくても Performance Insights にアクセスできます。

このプライベート接続を確立するには、AWS PrivateLink を利用した*インターフェイスエンドポイント*を作成します。インターフェイスエンドポイントに対して有効にする各サブネットにエンドポイントネットワークインターフェイスを作成します。これらは、Performance Insights 宛てのトラフィックのエントリポイントとして機能するリクエスタ管理型ネットワークインターフェイスです。

詳細については、「*AWS PrivateLinkガイド*」の「[AWS PrivateLinkから AWS のサービスにアクセスする](https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-access-aws-services.html)」を参照してください。

## Performance Insights に関する考慮事項
<a name="vpc-endpoint-considerations"></a>

Performance Insights のインターフェイスエンドポイントを設定する前に、「*AWS PrivateLink ガイド*」の「[考慮事項](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html#considerations-interface-endpoints)」を確認してください。

Performance Insights は、インターフェイスエンドポイントを介したすべての API アクションの呼び出しをサポートしています。

デフォルトでは、Performance Insights への完全なアクセスは、インターフェイスエンドポイント経由で許可されます。インターフェイスエンドポイントを介した Performance Insights へのトラフィックを制御するには、セキュリティグループをエンドポイントネットワークインターフェイスに関連付けます。

## 利用可能な状況
<a name="rds-and-vpc-interface-endpoints-availability"></a>

Performance Insights API は現在、Performance Insights をサポートする AWS リージョン の VPC エンドポイントをサポートしています。Performance Insights の可用性の詳細については、「[Amazon RDS の Performance Insights でサポートされているリージョンと DB エンジン](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md) 」を参照してください。

## Performance Insights のインターフェイスエンドポイントの作成
<a name="vpc-endpoint-create"></a>

Amazon VPC コンソールまたは AWS Command Line Interface (AWS CLI) を使用して、Performance Insights のインターフェイスエンドポイントを作成できます。詳細については、「*AWS PrivateLink ガイド*」の「[インターフェイスエンドポイントを作成](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html#create-interface-endpoint-aws)」を参照してください。

以下のサービス名を使用して、Performance Insights のインターフェイスエンドポイントを作成します。

インターフェイスエンドポイントのプライベート DNS を有効にすると、デフォルトのリージョン DNS 名を使用して Performance Insights への API 要求を行うことができます。例えば、`pi.us-east-1.amazonaws.com`。

## Performance Insights API の VPC エンドポイントポリシーの作成
<a name="vpc-endpoint-policy"></a>

エンドポイントポリシーは、インターフェイスエンドポイントにアタッチできる IAM リソースです。デフォルトのエンドポイントポリシーでは、インターフェイスエンドポイントを介した Performance Insights へのフルアクセスが許可されています。VPC から Performance Insights に許可されるアクセスを制御するには、カスタムエンドポイントポリシーをインターフェイスエンドポイントにアタッチします。

エンドポイントポリシーは以下の情報を指定します。
+ アクションを実行できるプリンシパル (AWS アカウント、IAM ユーザー、IAM ロール)。
+ 実行可能なアクション。
+ このアクションを実行できるリソース。

詳細については、*AWS PrivateLink ガイド*の[Control access to services using endpoint policies (エンドポイントポリシーを使用してサービスへのアクセスをコントロールする)](https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-endpoints-access.html)を参照してください。

**例: Performance Insights アクションの VPC エンドポイントポリシー**  
以下は、カスタムエンドポイントポリシーの例です。このポリシーをインターフェイスエンドポイントにアタッチすると、すべてのリソースのすべてのプリンシパルについて、リストされている Performance Insights アクションへのアクセス権を付与します。

```
{
   "Statement":[
      {
         "Principal":"*",
         "Effect":"Allow",
         "Action":[
            "rds:CreatePerformanceAnalysisReport",
            "rds:DeletePerformanceAnalysisReport",
            "rds:GetPerformanceAnalysisReport"
         ],
         "Resource":"*"
      }
   ]
}
```

**例: 指定した AWS アカウントからのすべてのアクセスを拒否する VPC エンドポイントポリシー**  
以下の VPC エンドポイントポリシーは、AWS アカウント `123456789012` からリソースへのエンドポイントを使用したすべてのアクセスを拒否します。このポリシーは、他のアカウントからのすべてのアクションを許可します。

```
{
  "Statement": [
    {
      "Action": "*",
      "Effect": "Allow",
      "Resource": "*",
      "Principal": "*"
    },
    {
      "Action": "*",
      "Effect": "Deny",
      "Resource": "*",
      "Principal": { "AWS": [ "123456789012" ] }
     }
   ]
}
```

## Performance Insights の IP アドレス指定
<a name="pi-ip-addressing"></a>

IP アドレスは、VPC 内のリソースの相互通信と、インターネット経由でのリソースとの通信を可能にします。Performance Insights は、IPv4 と IPv6 の両方のアドレス指定プロトコルをサポートしています。デフォルトでは、Performance Insights と Amazon VPC は IPv4 アドレス設定プロトコルを使用します。この動作をオフにすることはできません。VPC の作成時には、IPv4 CIDR ブロック (プライベート IPv4 アドレスの範囲) を指定する必要があります。

オプションで、IPv6 CIDR ブロックを VPC とサブネットに割り当て、そのブロックからサブネットの RDS リソースに IPv6 アドレスを割り当てることができます。IPv6 プロトコルのサポートにより、サポートされる IP アドレスの数が増えます。IPv6 プロトコルを使用することで、インターネットの今後の成長に十分なアドレスを確保できます。新規および既存の RDS リソースは、VPC 内で IPv4 アドレスと IPv6 アドレスを使用できます。アプリケーションの異なる部分で使用される 2 つのプロトコル間のネットワークトラフィックの設定、保護、および変換を行うと、運用上のオーバーヘッドが発生する可能性があります。Amazon RDS リソースについては IPv6 プロトコルを標準化して、ネットワーク構成を簡素化できます。サービスエンドポイントとクォータの詳細については、「[Amazon リレーショナルデータベースサービスエンドポイントとクォータ](https://docs.aws.amazon.com/general/latest/gr/rds-service.html)」を参照してください。

Amazon RDS IP アドレス指定の詳細については、「[Amazon RDS IP アドレス指定](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html#USER_VPC.IP_addressing)」を参照してください。

# Amazon DevOps Guru for Amazon RDS でパフォーマンスの異常を分析する
<a name="devops-guru-for-rds"></a>

Amazon DevOps Guru は、開発者およびオペレーターがアプリケーションのパフォーマンスと可用性を向上させるためのフルマネージド型オペレーションサービスです。DevOps Guru は、運用上の問題の特定に関連するタスクをオフロードし、アプリケーションを改善するための推奨事項を迅速に実装できるようにします。詳細については、「[Amazon DevOps Guru ユーザーガイド](https://docs.aws.amazon.com/devops-guru/latest/userguide/welcome.html)」の「*Amazon DevOps Guru とは*」を参照してください。

DevOps Guru は、すべての Amazon RDS DB エンジンの既存の運用上の問題を検出し、分析し、推奨を行います。DevOps Guru for RDS は、 RDS for PostgreSQL データベースの Performance Insights メトリクスに機械学習を適用することで、この機能を拡張します。これらのモニタリング機能により、DevOps Guru for RDS はパフォーマンスのボトルネックを検出して診断し、具体的な修正措置を推奨できます。DevOps Guru for RDS は、 RDS for PostgreSQL データベースで問題が発生する前に問題条件を検出することもできます。

これらの推奨事項を RDS コンソールで表示できるようになりました。詳細については、「[Amazon RDS の推奨事項](monitoring-recommendations.md)」を参照してください。

次の動画は DevOps Guru for RDS の概要です。

[![AWS Videos](http://img.youtube.com/vi/N3NNYgzYUDA/0.jpg)](http://www.youtube.com/watch?v=N3NNYgzYUDA)


この主題の詳細については、[Amazon DevOps Guru for RDS の内部](https://aws.amazon.com/blogs/database/amazon-devops-guru-for-rds-under-the-hood/)を参照してください。

**Topics**
+ [DevOps Guru for RDS の利点](#devops-guru-for-rds.benefits)
+ [DevOps Guru for RDSはどのように機能しますか](#devops-guru-for-rds.how-it-works)
+ [RDS 用の DevOps Guru のセットアップ](#devops-guru-for-rds.configuring)

## DevOps Guru for RDS の利点
<a name="devops-guru-for-rds.benefits"></a>

 RDS for PostgreSQL データベースを担当していて、そのデータベースに影響を与えるイベントやリグレッションの発生を知らないことがあります。問題を知っても、なぜそれが発生しているのか、どう対処すべきかわからないこともあります。データベース管理者 (DBA) に問い合わせたり、サードパーティーツールに頼ったりするのではなく、DevOps Guru for RDS のレコメンデーションに従ってください。

DevOps Guru for RDS の詳細な分析により、次の利点が得られます。

**高速診断**  
DevOps Guru for RDS は、データベースのテレメトリを継続的にモニタリングおよび分析します。Performance Insights、拡張モニタリング、および Amazon CloudWatch は、データベースインスタンスのテレメトリーデータを収集します。DevOps Guru for RDS は、統計的な機械学習の技術を使用してこのデータをマイニングし、異常を検出します。テレメトリーデータの詳細については、、*Amazon RDS ユーザーガイド*の「[Amazon RDS での Performance Insights を使用したDB 負荷のモニタリング](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html)」および「[拡張モニタリングを使用した OS メトリクスのモニタリング](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html)」を参照してください。

**高速解像度**  
各異常はパフォーマンスの問題を特定し、調査または修正措置の方法を提案します。例えば、DevOps Guru for RDS では、特定の待機イベントの調査をお勧めすることがあります。または、データベース接続数を制限するよう、アプリケーションプールの設定のチューニングをお勧めすることもあります。これらのレコメンデーションに基づいて、マニュアルでトラブルシューティングを実行するよりも迅速にパフォーマンスの問題を解決できます。

**事前対応型インサイト**  
DevOps Guru for RDS は、リソースからのメトリクスを使用して、問題となる可能性のある動作を大きな問題になる前に検出します。例えば、データベースが使用するディスク上の一時テーブルの数が増え、パフォーマンスに影響を与え始めたことを検出できます。その場合、DevOps Guru は問題が大きくなる前に対処するのに役立つ推奨事項を提供します。

**Amazon エンジニアの深い知識と機械学習**  
パフォーマンス問題を検出し、ボトルネックの解決を支援するために、DevOps Guru for RDS は機械学習 (ML) と高度な数式に依存しています。Amazon データベースエンジニアは、数十万のデータベース管理の長年の経験をカプセル化した DevOps Guru for RDS の知見の開発に貢献しました。この集合的な知識を活かすことで、DevOps Guru for RDS はベストプラクティスを伝えることができます。

## DevOps Guru for RDSはどのように機能しますか
<a name="devops-guru-for-rds.how-it-works"></a>

DevOps Guru for RDS は、Amazon RDS Performance Insights から RDS for PostgreSQL データベースに関するデータを収集します。最も重要なメトリクスは`DBLoad`です。DevOps Guru for RDS は、Performance Insights メトリクスを消費し、機械学習を使用して分析し、ダッシュボードにインサイトを公開します。

*インサイト*は、DevOps Guru によって検出された関連する異常のコレクションです。

DevOps Guru for RDS では、*異常*とは、 RDS for PostgreSQL データベースの通常のパフォーマンスから逸脱したパターンのことです。

### 事前対応型インサイト
<a name="devops-guru-for-rds.how-it-works.insights.proactive"></a>

*プロアクティブインサイト*では、問題のある動作を発生前に知ることができます。異常と共に推奨事項と関連メトリクスも含まれるため、 RDS for PostgreSQL データベースの問題が大きな問題になる前に対処できます。これらのインサイトは、DevOps Guru ダッシュボードに発行されます。

例えば、DevOps Guru は、RDS for PostgreSQL データベースがディスク上に多数の一時テーブルを作成していることを検出する場合があります。対処しなければ、この傾向はパフォーマンス問題につながる可能性があります。各プロアクティブインサイトには、是正措置に関する推奨事項と、[Amazon DevOps Guru のプロアクティブインサイトによる RDS for PostgreSQL のチューニング](PostgreSQL.Tuning_proactive_insights.md) 内の関連トピックへのリンクが含まれています。詳細については、「Amazon DevOps Guru ユーザーガイド**」の「[Working with insights in DevOps Guru](https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-insights.html)」を参照してください。

### 事後対応型インサイト
<a name="devops-guru-for-rds.how-it-works.insights.reactive"></a>

*リアクティブインサイト*は、異常な動作を発生時に識別します。DevOps Guru for RDS が RDS for PostgreSQL DB インスタンスでパフォーマンス問題を発見すると、DevOps Guru ダッシュボードにリアクティブインサイトが発行されます。詳細については、「Amazon DevOps Guru ユーザーガイド**」の「[Working with insights in DevOps Guru](https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-insights.html)」を参照してください。

#### 因果異常
<a name="devops-guru-for-rds.how-it-works.anomalies.causal"></a>

*因果異常*は、リアクティブインサイト内のトップレベルの異常です。**データベースロード (DB ロード)**DevOps Guru for RDS の因果異常です。

異常は、深刻度レベルを**高**、**中**、**低**のいずれかに割り当てて、パフォーマンスへの影響を測定します。詳細については、「*Amazon DevOps Guru ユーザーガイド*」の「[DevOps Guru for RDS の主要な概念](https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-rds.overview.definitions.html)」を参照してください。

DevOps Guru が DB インスタンスで現在の異常を検出すると、RDS コンソールの**[Databases]** (データベース) ページにアラートが表示されます。コンソールは、過去 24 時間に発生した異常についても警告します。RDS コンソールから異常ページに移動するには、アラートメッセージ内のリンクを選択します。RDS コンソールでは、 RDS for PostgreSQL DB インスタンスのページでもアラートが表示されます。

#### コンテキスト異常
<a name="devops-guru-for-rds.how-it-works.anomalies.contextual"></a>

*コンテキスト異常*は、事後対応型インサイトに関連する**データベースロード (DB ロード)**での所見です。各コンテキスト異常は、調査が必要な特定の RDS for PostgreSQL のパフォーマンス問題を記述します。例えば、DevOps Guru for RDS は、CPU 容量の増加を検討したり、DB ロードに寄与している待機イベントを調査するよう推奨することがあります。

**重要**  
本稼働インスタンスの修正前に、各変更の影響を完全に把握できるように、テストインスタンスでの変更のテストをお勧めします。このようにして、変更の影響を理解します。

詳細については、*Amazon DevOps Guru ユーザーガイド*の「[Analyzing anomalies in Amazon RDS](https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-rds.analyzing.html)」(Amazon RDS の異常を分析する) を参照してください。

## RDS 用の DevOps Guru のセットアップ
<a name="devops-guru-for-rds.configuring"></a>

DevOps Guru for Amazon RDS が RDS for PostgreSQL データベースのインサイトを発行できるようにするには、以下のタスクを実行します。

**Topics**
+ [DevOps Guru for RDS の IAM アクセスポリシーの設定](#devops-guru-for-rds.configuring.access)
+ [RDS for PostgreSQL DB インスタンスの Performance Insights をオンにする](#devops-guru-for-rds.configuring.performance-insights)
+ [DevOps Guru をオンにしてリソースカバレッジを指定する](#devops-guru-for-rds.configuring.coverage)

### DevOps Guru for RDS の IAM アクセスポリシーの設定
<a name="devops-guru-for-rds.configuring.access"></a>

DevOps Guru からのアラートを RDS コンソールに表示するには、AWS Identity and Access Management (IAM) ユーザーまたはロールに次のいずれかのポリシーが必要です。
+ AWS マネージドポリシー `AmazonDevOpsGuruConsoleFullAccess`
+ AWS 管理ポリシー `AmazonDevOpsGuruConsoleReadOnlyAccess` および次のいずれかのポリシーが必要です。
  + AWS マネージドポリシー `AmazonRDSFullAccess`
  + `pi:GetResourceMetrics` と `pi:DescribeDimensionKeys` を含むカスタマー管理ポリシー

詳細については、「[Performance Insights 用のアクセスポリシーの設定](USER_PerfInsights.access-control.md)」を参照してください。

### RDS for PostgreSQL DB インスタンスの Performance Insights をオンにする
<a name="devops-guru-for-rds.configuring.performance-insights"></a>

DevOps Guru for RDS は、データの Performance Insights に依存しています。Performance Insights がなければ、DevOps Guru は異常を公開しますが、詳細な分析と推奨事項は含まれません。

RDS for PostgreSQL DB インスタンスを作成または変更するときに、Performance Insights をオンにすることができます。詳細については、「[Amazon RDS の Performance Insights の有効化と無効化](USER_PerfInsights.Enabling.md)」を参照してください。

### DevOps Guru をオンにしてリソースカバレッジを指定する
<a name="devops-guru-for-rds.configuring.coverage"></a>

DevOps Guru をオンにして、次のいずれかの方法で RDS for PostgreSQL データベースをモニタリングできます。

**Topics**
+ [RDS コンソールで DevOps Guru をオンにする](#devops-guru-for-rds.configuring.coverage.rds-console)
+ [RDS for PostgreSQL リソースを DevOps Guru コンソールに追加する](#devops-guru-for-rds.configuring.coverage.guru-console)
+ [CloudFormation を使用して RDS for PostgreSQL リソースを追加する](#devops-guru-for-rds.configuring.coverage.cfn)

#### RDS コンソールで DevOps Guru をオンにする
<a name="devops-guru-for-rds.configuring.coverage.rds-console"></a>

Amazon RDS コンソールで複数のパスを取得して DevOps Guru をオンにすることができます。

**Topics**
+ [RDS for PostgreSQL データベースを作成するときに DevOps Guru をオンにする](#devops-guru-for-rds.configuring.coverage.rds-console.create)
+ [通知バナーから DevOps Guru をオンにする](#devops-guru-for-rds.configuring.coverage.rds-console.existing)
+ [DevOps Guru をオンにしたときのアクセス許可エラーへの応答](#devops-guru-for-rds.configuring.coverage.rds-console.error)

##### RDS for PostgreSQL データベースを作成するときに DevOps Guru をオンにする
<a name="devops-guru-for-rds.configuring.coverage.rds-console.create"></a>

作成ワークフローには、データベースの DevOps Guru カバレッジを有効にする設定が含まれています。**本番稼働用**テンプレートを選択した場合、この設定はデフォルトでオンになっています。

**RDS for PostgreSQL データベースを作成するときに DevOps Guru をオンにするには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. 「[DB インスタンスの作成](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating)」で、モニタリング設定を選択する手順まで (ただしその手順は含まない) の手順を行います。

1. **[Monitoring]** (モニタリング) で、**[Turn on Performance Insights]** (Performance Insights をオンにする) を選択します。DevOps Guru for RDS で、パフォーマンスの異常の詳細な分析を提供するには、[Performance Insights] (パフォーマンスインサイト) をオンにする必要があります。

1. **[Turn on DevOps Guru]** (DevOps Guru をオンにする) を選択します。  
![\[DB インスタンスを作成するときに DevOps Guru をオンにする\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/devops-guru-enable-create.png)

1. DevOps Guru がそれをモニタリングできるように、データベースのタグを作成します。以下の操作を実行します。
   + **[Tag key]** (タグキー) のテキストフィールドで、**Devops-Guru-** で始まる名前を入力します。
   + **[Tag value]** (タグ値) のテキストフィールドで、任意の値を入力します。例えば、 RDS for PostgreSQL データベースの名前として **rds-database-1** と入力した場合、タグ値として **rds-database-1** も入力することができます。

   タグの詳細については、「*Amazon DevOps Guru ユーザーガイド*」の「[タグを使用して DevOps Guru アプリケーションのリソースを特定する](https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-resource-tags.html)」を参照してください。

1. 「[DB インスタンスの作成](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating)」の残りのステップを行います。

##### 通知バナーから DevOps Guru をオンにする
<a name="devops-guru-for-rds.configuring.coverage.rds-console.existing"></a>

リソースが DevOps Guru の対象外である場合、Amazon RDS は次の場所のバナーで通知します。
+ DB クラスターインスタンスの**[Monitoring]** (モニタリング) タブ
+ Performance Insights ダッシュボード

![\[DevOps Guru バナー\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/devops-guru-enable-banner.png)


**RDS for PostgreSQL データベースについて DevOps Guru をオンにするには**

1. バナーで、**[Turn on DevOps Guru for RDS]** (DevOps Guru for RDS をオンにする) を選択します。

1. タグのキー名と値を入力します。タグの詳細については、「[Amazon DevOps Guru ユーザーガイド](https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-resource-tags.html)」の「*タグを使用して DevOps Guru アプリケーションのリソースを特定する*」を参照してください。  
![\[RDS コンソールで DevOps Guru をオンにします\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/devops-guru-turn-on.png)

1. **[DevOps Guru をオンにする]** を選択します。

##### DevOps Guru をオンにしたときのアクセス許可エラーへの応答
<a name="devops-guru-for-rds.configuring.coverage.rds-console.error"></a>

データベースを作成するときに RDS コンソールから DevOps Guru をオンにすると、RDS にアクセス許可がないことについて次のバナーが表示されることがあります。

![\[アクセス許可欠落エラーがあるバナー\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/devops-guru-permissions-error.png)


**アクセス許可エラーに応答するには**

1. IAM ユーザーまたはロールにユーザー管理ロール `AmazonDevOpsGuruConsoleFullAccess` を付与します。詳細については、「[DevOps Guru for RDS の IAM アクセスポリシーの設定](#devops-guru-for-rds.configuring.access)」を参照してください。

1. RDS コンソールを開きます。

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

1. 先ほど作成したクラスターで DB インスタンスを選択します。

1. スイッチを選択して、**[DevOps Guru for RDS]** をオンにします。  
![\[スイッチを選択して [DevOps Guru for RDS] をオンにする\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/devops-guru-pi-toggle-off.png)

1. タグ値を選択します。詳細については、「[Amazon DevOps Guru ユーザーガイド](https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-resource-tags.html)」の「*タグを使用して DevOps Guru アプリケーションのリソースを特定する*」を参照してください。  
![\[Amazon RDS コンソールで DevOps Guru をオンにする\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/devops-guru-turn-on.png)

1. **[DevOps Guru をオンにする]** を選択します。

#### RDS for PostgreSQL リソースを DevOps Guru コンソールに追加する
<a name="devops-guru-for-rds.configuring.coverage.guru-console"></a>

DevOps Guru コンソールで DevOps Guru リソースカバレッジを指定できます。「*Amazon DevOps Guru ユーザーガイド*」の「[DevOps Guru リソースカバレッジを指定する](https://docs.aws.amazon.com/devops-guru/latest/userguide/choose-coverage.html)」で説明されている手順に従います。分析リソースを編集する場合は、以下のオプションのいずれかを選択します。
+ RDS for PostgreSQL データベースも含め、AWS アカウント とリージョンでサポートされているすべてのリソースを分析するには、**[すべてのアカウントリソース]** を選択します。
+ 選択したスタック内の RDS for PostgreSQL データベースを分析するには、**[CloudFormation スタック]** を選択します。詳細については、「*Amazon DevOps Guru ユーザーガイド*」の「[AWS CloudFormation スタックを使用して DevOps Guru アプリケーション内のリソースを識別する](https://docs.aws.amazon.com//devops-guru/latest/userguide/working-with-cfn-stacks.html)」を参照してください。
+ タグ付けした RDS for PostgreSQL データベースを分析するには、**[タグ]** を選択します。詳細については、「*Amazon DevOps Guru ユーザーガイド*」の「[タグを使用して DevOps Guru アプリケーションのリソースを特定する](https://docs.aws.amazon.com/devops-guru/latest/userguide/working-with-resource-tags.html)」を参照してください。

詳細については、「*Amazon DevOps Guru ユーザーガイド*」の 「[Amazon DevOps Guru の有効化](https://docs.aws.amazon.com/devops-guru/latest/userguide/getting-started-enable-service.html)」を参照してください。

#### CloudFormation を使用して RDS for PostgreSQL リソースを追加する
<a name="devops-guru-for-rds.configuring.coverage.cfn"></a>

タグを使用して、 RDS for PostgreSQL リソースのカバレッジを CloudFormation テンプレートに追加できます。次の手順では、 RDS for PostgreSQL DB インスタンスと DevOps Guru スタックの両方についての CloudFormation テンプレートがあることを前提としています。

**CloudFormation タグを使用して RDS for PostgreSQL DB インスタンスを指定するには**

1. DB インスタンスの CloudFormation テンプレートで、キーと値のペアを使用してタグを定義します。

   次の例では、値 `my-db-instance1` を RDS for PostgreSQL DB インスタンスの `Devops-guru-cfn-default` に割り当てます。

   ```
   MyDBInstance1:
     Type: "AWS::RDS::DBInstance"
     Properties:
       DBInstanceIdentifier: my-db-instance1
       Tags:
         - Key: Devops-guru-cfn-default
           Value: devopsguru-my-db-instance1
   ```

1. DevOps Guru スタックの CloudFormation テンプレートで、リソースコレクションフィルターに同じタグを指定します。

   次の例では、タグ値 `my-db-instance1` を持つリソースをカバーするように DevOps Guru を設定します。

   ```
   DevOpsGuruResourceCollection:
     Type: AWS::DevOpsGuru::ResourceCollection
     Properties:
       ResourceCollectionFilter:
         Tags:
           - AppBoundaryKey: "Devops-guru-cfn-default"
             TagValues:
             - "devopsguru-my-db-instance1"
   ```

   次の例では、アプリケーション境界 `Devops-guru-cfn-default` 内のすべてのリソースを対象としています。

   ```
   DevOpsGuruResourceCollection:
     Type: AWS::DevOpsGuru::ResourceCollection
     Properties:
       ResourceCollectionFilter:
         Tags:
           - AppBoundaryKey: "Devops-guru-cfn-default"
             TagValues:
             - "*"
   ```

詳細については、「*CloudFormation ユーザーガイド*」の「[AWS::DevOpsGuru::ResourceCollection](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-devopsguru-resourcecollection.html)」と「[AWS::RDS::DBInstance](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-rds-dbinstance.html)」を参照してください。

# 拡張モニタリングを使用した OS メトリクスのモニタリング
<a name="USER_Monitoring.OS"></a>

Enhanced Monitoring を使用すると、DB インスタンスのオペレーティングシステムをリアルタイムでモニタリングできます。さまざまなプロセスまたはスレッドが CPU をどのように使用しているかを確認するには、Enhanced Monitoring メトリクスが役立ちます。

**Topics**
+ [Enhanced Monitoring の概要](#USER_Monitoring.OS.overview)
+ [拡張モニタリングの設定と有効化](USER_Monitoring.OS.Enabling.md)
+ [RDS コンソールでの OS メトリクスの表示](USER_Monitoring.OS.Viewing.md)
+ [CloudWatch Logs を使用した OS メトリクスの表示](USER_Monitoring.OS.CloudWatchLogs.md)

## Enhanced Monitoring の概要
<a name="USER_Monitoring.OS.overview"></a>

Amazon RDS には、DB インスタンスが実行されているオペレーティングシステム (OS) のリアルタイムのメトリクスが用意されています。RDS DB インスタンスのすべてのシステムメトリクスとプロセス情報をコンソールに表示できます。各インスタンスでモニタリングするメトリクスを管理し、要件に応じてダッシュボードをカスタマイズできます。拡張モニタリングメトリクスの説明については、「[拡張モニタリングの OS メトリクス](USER_Monitoring-Available-OS-Metrics.md)」を参照してください。

RDS は、拡張モニタリングのメトリクスを Amazon CloudWatch Logs アカウントに配信します。CloudWatch Logs から CloudWatch のメトリクスフィルタを作成し、CloudWatch ダッシュボードにグラフを表示できます。選択したモニタリングシステムで CloudWatch Logs からの拡張モニタリング JSON 出力を使用できます。詳細については、Amazon RDS に関するよくある質問の「[拡張モニタリング](https://aws.amazon.com/rds/faqs/#Enhanced_Monitoring)」を参照してください。

**Topics**
+ [拡張モニタリングの可用性](#USER_Monitoring.OS.Availability)
+ [CloudWatch と拡張モニタリングのメトリクスの相違点](#USER_Monitoring.OS.CloudWatchComparison)
+ [Enhanced Monitoring メトリクスの保持](#USER_Monitoring.OS.retention)
+ [拡張モニタリングのコスト](#USER_Monitoring.OS.cost)

### 拡張モニタリングの可用性
<a name="USER_Monitoring.OS.Availability"></a>

拡張モニタリングは、次のデータベースエンジンに使用できます。
+ Db2
+ MariaDB
+ Microsoft SQL Server
+ MySQL
+ Oracle
+ PostgreSQL

### CloudWatch と拡張モニタリングのメトリクスの相違点
<a name="USER_Monitoring.OS.CloudWatchComparison"></a>

*ハイパーバイザー*は、仮想マシン (VM) を作成して実行します。ハイパーバイザーを使用すると、メモリと CPU を仮想的に共有することで、1 つのインスタンスで複数のゲスト VM をサポートできます。CloudWatch は DB インスタンスのハイパーバイザーから CPU 使用率のメトリクスを収集します。対照的に、Enhanced Monitoring は DB インスタンス上のエージェントからメトリクスを収集します。

ハイパーバイザーレイヤーで少量の処理が実行されるため、CloudWatch と Enhanced Monitoring 測定値の間に違いが見つかることがあります。DB インスタンスがより小さなインスタンスクラスを使用している場合、その違いはより大きくなる可能性があります。このシナリオでは、1 つの物理インスタンス上のハイパーバイザー層によってより多くの仮想マシン (VM) が管理されている可能性があります。

拡張モニタリングメトリクスの説明については、「[拡張モニタリングの OS メトリクス](USER_Monitoring-Available-OS-Metrics.md)」を参照してください。Amazon CloudWatch メトリクスの詳細については、「*[Amazon CloudWatch ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)*」を参照してください。

### Enhanced Monitoring メトリクスの保持
<a name="USER_Monitoring.OS.retention"></a>

デフォルトでは、Enhanced Monitoring メトリクスは CloudWatch Logs で 30 日間保存されます。この保持期間は、通常の CloudWatch メトリクスとは異なります。

メトリクスが CloudWatch Logs に保存される時間の長さを変更するには、CloudWatch コンソールの `RDSOSMetrics` ロググループの保存期間を変更します。詳細については、*Amazon CloudWatch Logs User Guide*の「[CloudWatch ログでのログデータ保管期間の変更](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#SettingLogRetention)」を参照してください。

### 拡張モニタリングのコスト
<a name="USER_Monitoring.OS.cost"></a>

拡張モニタリングのメトリクスは、CloudWatch メトリクスではなく CloudWatch Logs に保存されます。拡張モニタリングのコストは次の要因によって異なります。
+ 拡張モニタリングの課金は、Amazon CloudWatch Logs に指定されているデータ転送とストレージの量を超えた場合にのみ発生します。CloudWatch Logs のデータ転送料金とストレージ料金に基づいて料金が決まります。
+ RDS インスタンスに対して転送される情報の量は、拡張モニタリング機能に対して定義された詳細度に正比例します。モニタリング間隔を短くすると、OS メトリクスのレポート回数が増え、モニタリングコストが高くなります。コストを管理するには、アカウント内のインスタンスごとに異なる詳細度を設定します。
+ 拡張モニタリングの使用コストは、拡張モニタリングが有効になっている各 DB インスタンスに適用されます。多数の DB インスタンスをモニタリングすると、少数の DB インスタンスをモニタリングするよりもコストが高くなります。
+ 複数のコンピューティング集中型のワークロードをサポートする DB インスタンスでは、レポートする OS プロセスアクティビティが増え、拡張モニタリングのコストがより高くなります。

料金の詳細については、「[Amazon CloudWatch の料金](https://aws.amazon.com/cloudwatch/pricing/)」を参照してください。

# 拡張モニタリングの設定と有効化
<a name="USER_Monitoring.OS.Enabling"></a>

拡張モニタリングを使用するには、IAM ロールを作成し、拡張モニタリングを有効にする必要があります。

**Topics**
+ [拡張モニタリング用の IAM ロールの作成](#USER_Monitoring.OS.Enabling.Prerequisites)
+ [拡張モニタリングのオンとオフを切り替える](#USER_Monitoring.OS.Enabling.Procedure)
+ [「混乱した代理」問題からの保護](#USER_Monitoring.OS.confused-deputy)

## 拡張モニタリング用の IAM ロールの作成
<a name="USER_Monitoring.OS.Enabling.Prerequisites"></a>

拡張モニタリングには、CloudWatch Logs に OS メトリクスの情報を送るためのアクセス権限が必要です。AWS Identity and Access Management (IAM) ロールを使用して、Enhanced Monitoring に必要なアクセス許可を付与します。このロールは、拡張モニタリングを有効にする際に作成することも、事前に作成しておくこともできます。

**Topics**
+ [拡張モニタリングを有効にしたときの IAM ロールの作成](#USER_Monitoring.OS.Enabling.Prerequisites.creating-role-automatically)
+ [拡張モニタリングを有効にする前の IAM ロールの作成](#USER_Monitoring.OS.Enabling.Prerequisites.creating-role-manually)

### 拡張モニタリングを有効にしたときの IAM ロールの作成
<a name="USER_Monitoring.OS.Enabling.Prerequisites.creating-role-automatically"></a>

RDS コンソールで拡張モニタリングを有効にすると、Amazon RDS は必要な IAM ロールを作成できます。ロールの名前は `rds-monitoring-role` です。RDS は、指定済み DB インスタンス、リードレプリカ、またはマルチ AZ DB クラスターに対してこのロールを使用します。

**拡張モニタリングを有効にするときに、IAM ロールを作成するには**

1. [拡張モニタリングのオンとオフを切り替える](#USER_Monitoring.OS.Enabling.Procedure) の手順を行います。

1. ロールを選択する手順で、[**モニタリングロール**] を [**デフォルト**] に設定します。

### 拡張モニタリングを有効にする前の IAM ロールの作成
<a name="USER_Monitoring.OS.Enabling.Prerequisites.creating-role-manually"></a>

拡張モニタリングを有効にする前に、必要なロールを作成できます。拡張モニタリングを有効にする場合は、新しいロールの名前を指定します。AWS CLI または RDS API を使用して拡張モニタリングを有効にする場合は、この必要なロールを作成する必要があります。

拡張モニタリングを有効にするユーザーには、`PassRole` アクセス許可を付与する必要があります。詳細については、*IAM ユーザーガイド*の「[AWS サービスにロールを渡すアクセス許可をユーザーに許可する](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html)」の「例 2」を参照してください。<a name="USER_Monitoring.OS.IAMRole"></a>

**Amazon RDS 拡張モニタリング用の IAM ロールを作成するには**

1. [IAM コンソール](https://console.aws.amazon.com/iam/home?#home) ([https://console.aws.amazon.com](https://console.aws.amazon.com/)) を開きます。

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

1. [**ロールの作成**] を選択します。

1. [**AWS のサービス**] タブを選択し、サービスのリストから [**RDS**] を選択します。

1. **[RDS - Enhanced Monitoring]** (RDS - 拡張モニタリング)、**[Next]** (次へ) の順に選択します。

1. **[Permissions policies]** (アクセス許可ポリシー) に **[AmazonRDSEnhancedMonitoringRole]** が表示されていることを確認し、**[Next]** (次へ) を選択します。

1. [**ロール名**] に、ロールの名前を入力します。例えば、「**emaccess**」と入力します。

   ロールの信頼されたエンティティは、AWS サービス**monitoring.rds.amazonaws.com** です。

1. [**ロールの作成**] を選択してください。

## 拡張モニタリングのオンとオフを切り替える
<a name="USER_Monitoring.OS.Enabling.Procedure"></a>

AWS マネジメントコンソール、AWS CLI、または RDS API を使用して拡張モニタリングを管理できます。DB インスタンスごとに、メトリクス収集の詳細度を別々に設定できます。

### コンソール
<a name="USER_Monitoring.OS.Enabling.Procedure.Console"></a>

DB インスタンス、マルチ AZ DB クラスター、もしくはリードレプリカの作成時、または DB インスタンスもしくはマルチ AZ DB クラスターの変更時に、拡張モニタリングをオンにすることができます。拡張モニタリングをオンにするように DB インスタンスを変更した場合は、変更を有効にするために DB インスタンスを再起動する必要はありません。

RDS コンソールの [**データベース**] ページで、次のいずれかのアクションを行ううと、拡張モニタリングをオンにすることができます。
+ **DB インスタンスまたはマルチ AZ DB クラスターを作成する** – [**データベースを作成**] を選択します。
+ [**リードレプリカの作成**] – [**アクション**]、[**リードレプリカの作成**] の順にクリックします。
+ **[DB インスタンスまたはマルチ AZ DB クラスターを変更する]** – **[変更]** を選択します。

**RDS コンソールで拡張モニタリングのオンとオフを切り替えるには**

1. [**その他の設定**] までスクロールします。

1. **[モニタリング]** で、DB インスタンス、またはリードレプリカに対し、**[拡張モニタリングを有効にする]** をクリックします。

1. [**ロールの作成**] プロパティで、Amazon CloudWatch Logs との通信を Amazon RDS に許可するために作成した IAM ロールに設定するか、[**デフォルト**] を選択して、RDS によって `rds-monitoring-role` という名前でロールが作成されるようにします。

1. **[詳細度]** プロパティを、DB インスタンス、またはリードレプリカのメトリクスが収集される間隔 (秒単位) に設定します。[**詳細度**] プロパティは、`1`、`5`、`10`、`15`、`30`、`60` のいずれかの値に設定できます。

   RDS コンソールは最速で 5 秒ごとに更新されます。RDS コンソールで詳細度を 1 秒に設定しても、メトリクスはやはり 5 秒ごとに更新されます。1 秒ごとにメトリクスの更新を取得するには、CloudWatch Logs を使用します。

### AWS CLI
<a name="USER_Monitoring.OS.Enabling.Procedure.CLI"></a>

AWS CLI を使用して拡張モニタリングをオンにするには、次のコマンドで `--monitoring-interval` オプションを `0` 以外の値に設定し、`--monitoring-role-arn` オプションを [拡張モニタリング用の IAM ロールの作成](#USER_Monitoring.OS.Enabling.Prerequisites) で作成したロールに設定します。
+ [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)
+ [create-db-instance-read-replica](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance-read-replica.html)
+ [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html)
+ [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) (マルチ AZ DB クラスター)
+ [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) (マルチ AZ DB クラスター)

`--monitoring-interval` オプションにより、拡張モニタリングのメトリクスが収集される時間点の間隔 (秒単位) が指定されます。オプションの有効な値は、`0`、`1`、`5`、`10`、`15`、`30`、および `60` です。

AWS CLI を使用して拡張モニタリングをオフにするには、これらのコマンドで `--monitoring-interval` オプションを `0` に設定します。

**Example**  
次の例では、DB インスタンスの拡張モニタリングをオンに切り替えています。  
Linux、macOS、Unix の場合:  

```
aws rds modify-db-instance \
    --db-instance-identifier mydbinstance \
    --monitoring-interval 30 \
    --monitoring-role-arn arn:aws:iam::123456789012:role/emaccess
```
Windows の場合:  

```
aws rds modify-db-instance ^
    --db-instance-identifier mydbinstance ^
    --monitoring-interval 30 ^
    --monitoring-role-arn arn:aws:iam::123456789012:role/emaccess
```

**Example**  
次の例では、マルチ AZ DB クラスターの拡張モニタリングをオンに切り替えています。  
Linux、macOS、Unix の場合:  

```
aws rds modify-db-cluster \
    --db-cluster-identifier mydbcluster \
    --monitoring-interval 30 \
    --monitoring-role-arn arn:aws:iam::123456789012:role/emaccess
```
Windows の場合:  

```
aws rds modify-db-cluster ^
    --db-cluster-identifier mydbcluster ^
    --monitoring-interval 30 ^
    --monitoring-role-arn arn:aws:iam::123456789012:role/emaccess
```

### RDS API
<a name="USER_Monitoring.OS.Enabling.Procedure.API"></a>

RDS API を使用して拡張モニタリングをオンにするには、`MonitoringInterval` パラメータに `0` 以外の値を設定し、`MonitoringRoleArn` パラメータを [拡張モニタリング用の IAM ロールの作成](#USER_Monitoring.OS.Enabling.Prerequisites) で作成したロールに設定します。次のアクションでこれらのパラメータを設定します。
+ [CreateDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html)
+ [CreateDBInstanceReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstanceReadReplica.html)
+ [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html)
+ [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) (マルチ AZ DB クラスター)
+ [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) (マルチ AZ DB クラスター)

`MonitoringInterval` パラメータにより、拡張モニタリングのメトリクスが収集される時間点の間隔 (秒単位) が指定されます。有効な値は、`0`、`1`、`5`、`10`、`15`、`30`、`60` です。

RDS API を使用して拡張モニタリングをオフにするには、`MonitoringInterval` に `0` を設定します。

## 「混乱した代理」問題からの保護
<a name="USER_Monitoring.OS.confused-deputy"></a>

混乱した代理問題は、アクションを実行する許可を持たないエンティティが、より特権のあるエンティティにアクションを実行するように強制できるセキュリティの問題です。AWS では、サービス間でのなりすましによって、混乱した代理問題が発生する場合があります。サービス間でのなりすましは、1 つのサービス (*呼び出し元サービス*) が、別のサービス (*呼び出し対象サービス*) を呼び出すときに発生する可能性があります。呼び出し元サービスは、本来ならアクセスすることが許可されるべきではない方法でその許可を使用して、別のお客様のリソースに対する処理を実行するように操作される場合があります。これを防ぐために、AWS には、アカウント内のリソースへのアクセス権が付与されたサービスプリンシパルですべてのサービスのデータを保護するために役立つツールが用意されています。詳細については、「[「混乱した代理」問題](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html)」を参照してください。

リソースに関して、Amazon RDS から別のサービスに付与できるアクセス許可を制限する場合は、拡張モニタリングロール用の信頼ポリシー内で、`aws:SourceArn` および `aws:SourceAccount` のグローバル条件コンテキストキーを使用することをお勧めします。これら両方のグローバル条件コンテキストキーを使用する場合、アカウント ID は同じものを使用する必要があります。

混乱した代理問題から保護するための最も効果的な方法は、リソースの完全な ARN を指定して `aws:SourceArn` グローバル条件コンテキストキーを使用することです。Amazon RDS の場合は、`aws:SourceArn` に `arn:aws:rds:Region:my-account-id:db:dbname` を設定します。

次の例では、「混乱した代理」問題を防ぐために、信頼ポリシー内で `aws:SourceArn` および `aws:SourceAccount` のグローバル条件コンテキストを使用しています。

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "monitoring.rds.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringLike": {
          "aws:SourceArn": "arn:aws:rds:Region:my-123456789012:db:dbname"
        },
        "StringEquals": {
          "aws:SourceAccount": "my-123456789012"
        }
      }
    }
  ]
}
```

------

# RDS コンソールでの OS メトリクスの表示
<a name="USER_Monitoring.OS.Viewing"></a>

拡張モニタリングによってレポートされた OS のメトリクスを RDS コンソールで表示するには、[**モニタリング**] の [**拡張モニタリング**] を選択します。

次の例は、拡張モニタリングのページを示しています。拡張モニタリングメトリクスの説明については、「[拡張モニタリングの OS メトリクス](USER_Monitoring-Available-OS-Metrics.md)」を参照してください。

![\[[ダッシュボード] ビュー\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/metrics1.png)


一部の DB インスタンスでは、DB インスタンスのデータストレージボリュームに複数のディスクを使用します。このような DB インスタンスの [**物理デバイス**] グラフには、それぞれのディスクのメトリクスが表示されます。例えば、次のグラフには、4 つのディスクのメトリクスが表示されています。

![\[複数のディスクを含むグラフ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/enhanced-monitoring-multiple-disks.png)


**注記**  
現在、[**物理デバイス**] グラフは、Microsoft SQL Server DB インスタンスでは使用できません。

集約された **[ファイルシステム]** に関するグラフを表示する場合、(すべてのデータベースファイルとログが保存されている) `rdsfilesys/rdsdbdata*` ファイルシステムに **[rdsdbdata\$1]** デバイスが関連付けられます。**[rootfilesys]** デバイスは `/` ファイルシステム (root と呼ばれる) に関連付けられています。ここで、オペレーティングシステムに関するファイルは保存されます。追加のストレージボリュームを使用する場合は、ボリューム固有の情報の `rdsdbdata2`、`rdsdbdata3`、および `rdsdbdata4` ボリュームメトリクスを表示します。

集約された **[ディスク I/O]** グラフを表示している場合、**[rdsdbdata]** デバイスはプライマリ `/rdsdbdata` ストレージボリュームに関連付けられます。追加のストレージボリュームを使用する場合は、ボリューム固有の情報の `rdsdbdata2`、`rdsdbdata3`、および `rdsdbdata4` ボリュームメトリクスを表示します。[filesystem] デバイスは /ファイルシステム (root と呼ばれる) に関連付けられています。ここで、オペレーティングシステムに関するファイルは保存されます。

デバイス名 **[rdsdev]** は廃止されました。**[rdsdev]** デバイスはプライマリ `/rdsdbdata` ストレージボリュームにのみ関連し、追加のストレージボリュームからのメトリクスは含まれません。

![\[ファイルシステムの使用状況を示すグラフ\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/enhanced-monitoring-filesystem.png)


DB インスタンスがマルチ AZ 配置の場合は、プライマリ DB インスタンスとそのマルチ AZ スタンバイレプリカの OS メトリクスを表示できます。[**拡張モニタリング**] ビューで、[**プライマリ**] を選択してプライマリ DB インスタンスの OS メトリクスを表示するか、[**セカンダリ**] を選択してスタンバイレプリカの OS メトリクスを表示します。

![\[拡張モニタリングでプライマリまたはセカンダリを選択する\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/enhanced-monitoring-primary-secondary.png)


マルチ AZ 配置については、「[Amazon RDS でのマルチ AZ 配置の設定と管理](Concepts.MultiAZ.md)」を参照してください。

**注記**  
現在、マルチ AZ スタンバイレプリカの OS メトリクスを表示することは、MariaDB インスタンスではサポートされていません。

DB インスタンスで実行中のプロセスの詳細を確認する場合は、[**モニタリング**] の [**OS プロセスリスト**] を選択します。

[**プロセスリスト**] ビューは次のように表示されます。

![\[[プロセスリスト] ビュー\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/metrics2.png)


[**プロセスリスト**] ビューに表示される拡張モニタリングのメトリクスは以下のように整理されます。
+ [**RDS child processes**] – DB インスタンスをサポートする RDS プロセス (Amazon Aurora DB クラスターの場合は `aurora`、MySQL DB インスタンスの場合は `mysqld` など) の概要を表示します。プロセスのスレッドは親プロセスの下にネストされて表示されます。プロセスのスレッドには CPU 使用率のみが表示されます。他のメトリクスはプロセスのすべてのスレッドで同じであるためです。コンソールには最大 100 個のプロセスとスレッドが表示されます。結果は、プロセスとスレッドを消費している上位の CPU とメモリの組み合わせです。プロセスとスレッドが 50 個よりも多い場合、コンソールではカテゴリ別に上位 50 個の消費元が表示されます。この表示は、パフォーマンスに最大の影響を与えているプロセスを特定するために役立ちます。
+ [**RDS プロセス**] – RDS DB インスタンスをサポートするために必要な RDS 管理エージェント、診断モニタリングプロセス、その他の AWS プロセスによって使用されているリソースの概要を表示します。
+ [**OS processes**] – 一般的にパフォーマンスに最小の影響を与えているカーネルとシステムプロセスの概要を表示します。

各プロセスに対して表示される項目は次のとおりです。
+ **VIRT** – プロセスの仮想サイズを表示します。
+ **RES** – プロセスが使用する実際の物理メモリを表示します。
+ [**CPU%**] – プロセスで使用されている合計 CPU 帯域幅のパーセンテージを表示します。
+ [**MEM%**] – プロセスで使用されている合計メモリのパーセンテージを表示します。

RDS コンソールに表示するモニタリングデータは、Amazon CloudWatch Logs から取得されます。また、DB インスタンスのメトリクスも CloudWatch Logs からログストリームとして取得できます。詳細については、「[CloudWatch Logs を使用した OS メトリクスの表示](USER_Monitoring.OS.CloudWatchLogs.md)」を参照してください。

以下の実行中は拡張モニタリングメトリクスは返されません: 
+ DB インスタンスのフェイルオーバー。
+ DB インスタンスのインスタンスクラスの変更 (コンピューティングのスケール)。

拡張モニタリングのメトリクスは DB インスタンスの再起動中も返されます。これはデータベースエンジンのみが再起動するためです。オペレーティングシステムのメトリクスは、引き続き報告されます。

# CloudWatch Logs を使用した OS メトリクスの表示
<a name="USER_Monitoring.OS.CloudWatchLogs"></a>

DB インスタンスまたはマルチ AZ DB クラスターの拡張モニタリングを有効にした後、CloudWatch Logs を使用してそのメトリクスを表示できます。各ログストリームは、モニタリング中の 1 つの DB インスタンスまたは DB クラスターを表します。ログストリーム識別子は DB インスタンスまたは DB クラスターのリソース識別子 (`DbiResourceId`) です。

**拡張モニタリングのログデータを表示するには**

1. CloudWatch コンソール ([https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)) を開きます。

1. 必要に応じて、DB インスタンスまたはマルチ AZ DB クラスターが存在する AWS リージョン を選択します。詳細については、*Amazon Web Services 全般のリファレンス*の「[リージョンとエンドポイント](https://docs.aws.amazon.com/general/latest/gr/index.html?rande.html)」を参照してください。

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

1. ロググループのリストから [**RDSOSMetrics**] を選択します。

   マルチ AZ DB インスタンス配置では、名前に `-secondary` が追加されたログファイルは、マルチ AZ スタンバイレプリカ用です。  
![\[マルチ AZ スタンバイレプリカログファイル\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/enhanced-monitoring-cloudwatch-secondary.png)

1. ログストリームのリストから、表示するログストリームを選択します。

# Amazon RDS のメトリクスリファレンス
<a name="metrics-reference"></a>

このリファレンスでは、Amazon CloudWatch、Performance Insights、および Enhanced Monitoring に関する Amazon RDS メトリクスが説明されています。

**Topics**
+ [Amazon RDS の Amazon CloudWatch メトリクス](rds-metrics.md)
+ [Amazon RDS の Amazon CloudWatch ディメンション](dimensions.md)
+ [Amazon RDS Performance Insights の Amazon CloudWatch メトリクス](USER_PerfInsights.Cloudwatch.md)
+ [Performance Insights カウンターメトリクス](USER_PerfInsights_Counters.md)
+ [Performance Insights の SQL 統計](sql-statistics.md)
+ [拡張モニタリングの OS メトリクス](USER_Monitoring-Available-OS-Metrics.md)

# Amazon RDS の Amazon CloudWatch メトリクス
<a name="rds-metrics"></a>

Amazon CloudWatch メトリクスは、Amazon RDS インスタンスとクラスターのパフォーマンスとヘルスに関するインサイトを提供し、システム動作をモニタリングしてデータ主導の意思決定を行うことができます。これらのメトリクスは、リソースの使用率、データベースアクティビティ、運用効率を追跡するのに役立ち、インスタンスのパフォーマンスを可視化します。

このリファレンスでは、Amazon RDS で使用できる特定のメトリクスの概要と、データベースのパフォーマンスの最適化、問題のトラブルシューティング、高可用性の確保のためにそれらのメトリクスを解釈して使用する方法について説明します。

Amazon RDS は、`AWS/RDS` および `AWS/Usage` 名前空間で、Amazon CloudWatch にメトリクスを発行します。

**Topics**
+ [Amazon RDS の Amazon CloudWatch インスタンスレベルのメトリクス](#rds-cw-metrics-instance)
+ [Amazon RDS の Amazon CloudWatch 使用状況メトリクス](#rds-metrics-usage)

## Amazon RDS の Amazon CloudWatch インスタンスレベルのメトリクス
<a name="rds-cw-metrics-instance"></a>

Amazon CloudWatch の `AWS/RDS` 名前空間には、次のインスタンスレベルのメトリクスが含まれます。

**注記**  
Amazon RDS コンソールには、Amazon CloudWatch に送信された単位とは異なる単位でメトリクスが表示される場合があります。例えば、Amazon RDS コンソールにはメトリクスがメガバイト (MB) で表示されますが、Amazon CloudWatch にはメトリクスはバイト単位で送信されます。


| メトリクス | 説明 | Applies to | 単位 | 
| --- | --- | --- | --- | 
| `BinLogDiskUsage` |  バイナリログが占めるディスク容量。リードレプリカを含む MySQL および MariaDB インスタンスで自動バックアップが有効になっている場合、バイナリログが作成されます。  |  MariaDB MySQL  |  バイト  | 
| `BurstBalance` |  汎用 SSD (gp2) のバーストバケット I/O クレジットの利用可能パーセント。  |  すべて  |  割合 (%)  | 
| `CheckpointLag` |  直近のチェックポイントからの時間。  |    |  [秒]  | 
|  `ConnectionAttempts`  |  成功したかどうかを問わず、インスタンスへの接続を試行した回数。  |  MySQL  |  カウント  | 
| `CPUUtilization` |  CPU 使用率。  |  すべて  |  割合 (%)  | 
| `CPUCreditUsage` | CPU 使用率に関してインスタンスで消費される CPU クレジットの数。1 CPUクレジットは、1 分間 100％ の使用率で実行される 1 つの vCPU、または vCPU、使用率、時間の同等の組み合わせに相当します。例えば、2 分間 50％ の使用率で実行されている 1 つの vCPU、または 2 分間 25％ の使用率で実行されている 2 つの vCPU があるとします。このメトリクスは、db.t2、db.t3、および db.t4g インスタンスにのみ適用されます。 T DB インスタンスクラスは、開発サーバーおよびテストサーバー、またはその他の本稼働以外のサーバーにのみ使用することをお勧めします。T インスタンスクラスの詳細については、「[DB インスタンスクラスタイプ](Concepts.DBInstanceClass.Types.md)」を参照してください。 CPU クレジットメトリクスは、5 分間隔でのみ利用可能です。5 分を超える期間を指定する場合は、`Average` 統計の代わりに `Sum` 統計を使用します。 |    |  クレジット (vCPU 分)  | 
| `CPUCreditBalance` | インスタンスが起動または開始後に蓄積した獲得 CPU クレジットの数。T2 スタンダードの場合、`CPUCreditBalance` には蓄積された起動クレジットの数も含まれます。クレジットは獲得後にクレジット残高に蓄積され、消費されるとクレジット残高から削除されます。クレジット残高にはインスタンスサイズによって決まる上限があります。制限に到達すると、獲得された新しいクレジットはすべて破棄されます。T2 スタンダードの場合、起動クレジットは制限に対してカウントされません。`CPUCreditBalance` のクレジットは、インスタンスがそのベースライン CPU 使用率を超えてバーストするために消費できます。インスタンスが実行中の場合、`CPUCreditBalance` のクレジットは期限切れになりません。インスタンスが停止すると、`CPUCreditBalance` は保持されず、蓄積されたすべてのクレジットが失われます。CPU クレジットメトリクスは、5 分間隔でのみ利用可能です。このメトリクスは、db.t2、db.t3、および db.t4g インスタンスにのみ適用されます。 T DB インスタンスクラスは、開発サーバーおよびテストサーバー、またはその他の本稼働以外のサーバーにのみ使用することをお勧めします。T インスタンスクラスの詳細については、「[DB インスタンスクラスタイプ](Concepts.DBInstanceClass.Types.md)」を参照してください。 起動クレジットは Amazon RDS でも Amazon EC2 と同じように機能します。詳細については、「*Linux インスタンス向け Amazon Elastic Compute Cloud ユーザーガイド*」の「[起動クレジット](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-standard-mode-concepts.html#launch-credits)」を参照してください。 |    |  クレジット (vCPU 分)  | 
| `CPUSurplusCreditBalance` |  `CPUCreditBalance` 値がゼロの場合に unlimited インスタンスによって消費された余剰クレジットの数。 `CPUSurplusCreditBalance` 値は獲得した CPU クレジットによって支払われます。余剰クレジットの数が、24 時間にインスタンスが獲得できるクレジットの最大数を超えている場合、最大数を超えて消費された余剰クレジットに対しては料金が発生します。 CPU クレジットメトリクスは5 分間隔でのみ利用可能です。  |  すべて  |  クレジット (vCPU 分)   | 
| `CPUSurplusCreditsCharged` |  獲得 CPU クレジットにより支払われないために追加料金が発生した、消費された余剰クレジットの数。 消費された余剰クレジットは以下のいずれかの状況に当てはまると料金が発生します。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/rds-metrics.html) CPU クレジットメトリクスは5 分間隔でのみ利用可能です。  |  すべて  |  クレジット (vCPU 分)  | 
| `DatabaseConnections` |  データベースインスタンスへのクライアントネットワーク接続の数。 データベースセッションの数は、メトリクスが示す値よりも多くなることがあります。これは、メトリクス値には以下が含まれないためです。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/rds-metrics.html)  |  すべて  |  カウント  | 
| `DiskQueueDepth` |  未処理のディスク I/O アクセス (読み取り/書き込みリクエスト) の数。  |  すべて  |  カウント  | 
| `DiskQueueDepthLogVolume` |  未処理のログボリュームディスク I/O アクセス (読み取り/書き込みリクエスト) の数。  |  [専用ログボリューム](USER_PIOPS.dlv.md)が有効になっている DB インスタンス  |  カウント  | 
| `EBSByteBalance%` |  RDS データベースのバーストバケットに残っているスループットクレジットの割合。このメトリクスは基本モニタリング専用です。 メトリクス値は、データベースファイルを含むボリュームのみではなく、ルートボリュームを含むすべてのボリュームのスループットに基づいています。 このメトリクスをサポートするインスタンスサイズを確認するには、「*Amazon EC2 ユーザーガイド*」 の「[デフォルトで最適化された EBS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-optimized.html#current)」の表で、アスタリスク (\$1) の付いたインスタンスサイズを参照してください。`Sum` 統計はこのメトリクスに該当しません。  |  すべて  |  割合 (%)  | 
| `EBSIOBalance%` |  RDS データベースのバーストバケットに残っている I/O クレジットの割合。このメトリクスは基本モニタリング専用です。 メトリック値は、データベースファイルを含むボリュームのみではなく、ルートボリュームを含むすべてのボリュームの IOPS に基づいています。 このメトリクスをサポートするインスタンスサイズを確認するには、「Amazon EC2 ユーザーガイド」の「[Amazon EBS 最適化インスタンスタイプ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-optimized.html)」を参照してください。**`Sum` 統計は、このメトリクスに該当しません。 このメトリクスは `BurstBalance` とは異なります。このメトリクスの使用方法については、[Amazon EBS で最適化されたインスタンスバースト機能によるアプリケーションのパフォーマンスの向上とコスト削減](https://aws.amazon.com/blogs/compute/improving-application-performance-and-reducing-costs-with-amazon-ebs-optimized-instance-burst-capability/)を参照してください。  |  すべて  |  割合 (%)  | 
| `FailedSQLServerAgentJobsCount` |  直近 1 分間に失敗した Microsoft SQL Server エージェントジョブの数。  |  Microsoft SQL Server  |  1 分あたりのカウント  | 
| `FreeableMemory` |  使用可能な RAM の容量。 MariaDB、MySQL、Oracle、および PostgreSQL DB インスタンスの場合、このメトリクスは `MemAvailable` の `/proc/meminfo` フィールドの値を報告します。  |  すべて  |  バイト  | 
| `FreeLocalStorage` |  使用できるローカルストレージスペースの量。 このメトリクスは、NVMe SSD インスタンスストアボリュームを持つ DB インスタンスクラスにのみ適用されます。NVMe SSD インスタンスストアボリュームを使用する Amazon EC2 インスタンスについては、[インスタンスストアボリューム](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html#instance-store-volumes)を参照してください。同等の RDS DB インスタンスクラスには同じインスタンスストアボリュームがあります。例えば、db.m6gd および db.r6gd DB インスタンスクラスには NVMe SSD インスタンスストアボリュームがあります。  |    |  バイト  | 
| `FreeLocalStoragePercent` |  使用できるローカルストレージスペースのパーセンテージ。 このメトリクスは、NVMe SSD インスタンスストアボリュームを持つ DB インスタンスクラスにのみ適用されます。NVMe SSD インスタンスストアボリュームを使用する Amazon EC2 インスタンスについては、[インスタンスストアボリューム](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html#instance-store-volumes)を参照してください。同等の RDS DB インスタンスクラスには同じインスタンスストアボリュームがあります。例えば、db.m6gd および db.r6gd DB インスタンスクラスには NVMe SSD インスタンスストアボリュームがあります。  |    |  割合 (%)  | 
| `FreeStorageSpace` |  使用可能なストレージ領域の容量。  |  すべて  |  バイト  | 
| `FreeStorageSpaceLogVolume` |  ログボリュームで使用可能なストレージスペースの容量。  |  [専用ログボリューム](USER_PIOPS.dlv.md)が有効になっている DB インスタンス  |  バイト  | 
| `IamDbAuthConnectionRequests` |  DB インスタンスへの IAM 認証を使用した接続リクエストの数。  |  すべて  |  カウント  | 
| `MaximumUsedTransactionIDs` |  最大使用済みトランザクション ID 数。  |  PostgreSQL  |  カウント  | 
| `NetworkReceiveThroughput` |  モニタリングとレプリケーションに使用する顧客データベーストラフィックと Amazon RDS トラフィックの両方を含む、DB インスタンスの受信ネットワークトラフィック。  |  すべて  |  1 秒あたりのバイト数  | 
| `NetworkTransmitThroughput` |  モニタリングとレプリケーションに使用する顧客データベーストラフィックと Amazon RDS トラフィックの両方を含む、DB インスタンスの送信ネットワークトラフィック。  |  すべて  |  1 秒あたりのバイト数  | 
| `OldestLogicalReplicationSlotLag` |  Amazon RDS の遅延サイズは、ソースデータベースでトランザクションをコミットする時刻と、RDS がレプリカデータベースにトランザクションを適用する時刻の差を示します。  |  PostgreSQL  |  バイト  | 
| `OldestReplicationSlotLag` |  受信した先行書き込み (WAL) データに関して最も遅延の長いレプリカの遅延サイズ。  |  PostgreSQL  |  バイト  | 
| `ReadIOPS` |  1 秒あたりのディスク読み取り I/O オペレーションの平均回数。  |  すべて  |  1 秒あたりのカウント数  | 
| `ReadIOPSLocalStorage` |  1秒あたりのローカルストレージへのディスク読み取りI / O操作の平均数。 このメトリクスは、NVMe SSD インスタンスストアボリュームを持つ DB インスタンスクラスにのみ適用されます。NVMe SSD インスタンスストアボリュームを使用する Amazon EC2 インスタンスについては、[インスタンスストアボリューム](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html#instance-store-volumes)を参照してください。同等の RDS DB インスタンスクラスには同じインスタンスストアボリュームがあります。例えば、db.m6gd および db.r6gd DB インスタンスクラスには NVMe SSD インスタンスストアボリュームがあります。  |    |  1 秒あたりのカウント数  | 
| `ReadIOPSLogVolume` |  ログボリュームに対して 1 秒あたりのディスク読み取り I/O オペレーションの平均回数。  |  [専用ログボリューム](USER_PIOPS.dlv.md)が有効になっている DB インスタンス  |  1 秒あたりのカウント数  | 
| `ReadLatency` |  1 回のディスク I/O 操作にかかる平均時間。  |  すべて  |  秒  | 
| `ReadLatencyLocalStorage` |  ローカルストレージのディスクI / O操作ごとにかかる平均時間。 このメトリクスは、NVMe SSD インスタンスストアボリュームを持つ DB インスタンスクラスにのみ適用されます。NVMe SSD インスタンスストアボリュームを使用する Amazon EC2 インスタンスについては、[インスタンスストアボリューム](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html#instance-store-volumes)を参照してください。同等の RDS DB インスタンスクラスには同じインスタンスストアボリュームがあります。例えば、db.m6gd および db.r6gd DB インスタンスクラスには NVMe SSD インスタンスストアボリュームがあります。  |    |  秒  | 
| `ReadLatencyLogVolume` |  ログボリュームに対して 1 回のディスク I/O オペレーションにかかる平均時間。  |  [専用ログボリューム](USER_PIOPS.dlv.md)が有効になっている DB インスタンス  |  秒  | 
| `ReadThroughput` |  1 秒あたりのディスクからの平均読み取りバイト数。  |  すべて  |  1 秒あたりのバイト数  | 
| `ReadThroughputLocalStorage` |  ローカルストレージ用にディスクから読み取られた1秒あたりの平均バイト数。 このメトリクスは、NVMe SSD インスタンスストアボリュームを持つ DB インスタンスクラスにのみ適用されます。NVMe SSD インスタンスストアボリュームを使用する Amazon EC2 インスタンスについては、[インスタンスストアボリューム](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html#instance-store-volumes)を参照してください。同等の RDS DB インスタンスクラスには同じインスタンスストアボリュームがあります。例えば、db.m6gd および db.r6gd DB インスタンスクラスには NVMe SSD インスタンスストアボリュームがあります。  |    |  1 秒あたりのバイト数  | 
| `ReadThroughputLogVolume` |  ログボリュームに対して 1 秒あたりのディスクからの平均読み取りバイト数。  |  [専用ログボリューム](USER_PIOPS.dlv.md)が有効になっている DB インスタンス  |  1 秒あたりのバイト数  | 
| `ReplicaLag` |  リードレプリカの設定では、ソース DB インスタンスからリードレプリカ DB インスタンスまでの遅れ時間。MariaDB、Microsoft SQL Server、MySQL、Oracle、および PostgreSQL のリードレプリカに適用されます。 マルチ AZ の DB クラスターでは、ライター DB インスタンスの最新のトランザクションと、リーダー DB インスタンスで最後に適用されたトランザクションとの時間の差。  |    |  秒  | 
| `ReplicationChannelLag` |  マルチソースレプリカ設定の場合、マルチソースレプリカの特定のチャネルがソース DB インスタンスから遅れる時間。詳細については、「[マルチソースレプリケーションチャネルのモニタリング](mysql-multi-source-replication.md#mysql-multi-source-replication-monitoring)」を参照してください。  |  MySQL  |  秒  | 
| `ReplicationSlotDiskUsage` |  レプリケーションスロットファイルで使用されているディスク容量。  |  PostgreSQL  |  バイト  | 
| `SwapUsage` |  DB インスタンスで使用するスワップ領域の量。  |  MariaDB MySQL Oracle PostgreSQL  |  バイト  | 
| `TempDbAvailableDataSpace` |  tempdb の使用可能なデータスペースの量と tempdb が配置されているボリューム。 このメトリクスを使用して、tempdb データスペースの可用性をモニタリングし、それに応じて容量を計画します。値が小さい場合は、ストレージを増加するか、tempdb を頻繁に使用するクエリを最適化する必要が生じることがあります。  | SQL Server | バイト | 
| `TempDbAvailableLogSpace` |  tempdb の使用可能なログスペースの量と tempdb が配置されているボリューム。 このメトリクスを使用して、tempdb ログスペースの可用性をモニタリングし、トランザクションログが満杯状態になるのを防止します。大規模なトランザクションや高い同時実行性によって大量のログアクティビティが生成されるワークロードに不可欠です。  | SQL Server | バイト | 
| `TempDbDataFileUsage` |  tempdb で使用されているデータファイルの割合。このメトリクスは、ファイルが増加する可能性を考慮しません。 このメトリクスを使用して、tempdb データファイルの使用率をモニタリングし、潜在的なパフォーマンスのボトルネックを特定します。値が大きい場合は、大きな一時オブジェクトの作成や tempdb サイズの増加をもたらすクエリの最適化が必要になることがあります。  | SQL Server | 割合 (%) | 
| `TempDbLogFileUsage` |  tempdb で使用されているログファイルの割合。このメトリクスは、ファイルが増加する可能性を考慮しません。 このメトリクスを使用して、tempdb ログファイルの使用率をモニタリングし、パフォーマンスの問題を防止します。値が大きい場合は、長時間稼働のトランザクションや過剰なログ記録アクティビティにより、データベース全体のパフォーマンスが影響を受けている可能性があります。  | SQL Server | 割合 (%) | 
| `TransactionLogsDiskUsage` |  トランザクションログで使用されているディスク容量。  |  PostgreSQL  |  バイト  | 
| `TransactionLogsGeneration` |  1 秒あたりに生成されるトランザクションログのサイズ。  |  PostgreSQL  |  1 秒あたりのバイト数  | 
| `WriteIOPS` |  1 秒あたりのディスク書き込み I/O オペレーションの平均回数。  |  すべて  |  1 秒あたりのカウント数  | 
| `WriteIOPSLocalStorage` |  ローカルストレージでの 1 秒あたりのディスク書き込み I/O 操作の平均回数。 このメトリクスは、NVMe SSD インスタンスストアボリュームを持つ DB インスタンスクラスにのみ適用されます。NVMe SSD インスタンスストアボリュームを使用する Amazon EC2 インスタンスについては、[インスタンスストアボリューム](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html#instance-store-volumes)を参照してください。同等の RDS DB インスタンスクラスには同じインスタンスストアボリュームがあります。例えば、db.m6gd および db.r6gd DB インスタンスクラスには NVMe SSD インスタンスストアボリュームがあります。  |    |  1 秒あたりのカウント数  | 
| `WriteIOPSLogVolume` |  ログボリュームに対する 1 秒あたりのディスク書き込み I/O オペレーションの平均回数。  |  [専用ログボリューム](USER_PIOPS.dlv.md)が有効になっている DB インスタンス  |  1 秒あたりのカウント数  | 
| `WriteLatency` |  1 回のディスク I/O 操作にかかる平均時間。  |  すべて  |  秒  | 
| `WriteLatencyLocalStorage` |  ローカルストレージのディスク I/O 操作ごとにかかる平均時間。 このメトリクスは、NVMe SSD インスタンスストアボリュームを持つ DB インスタンスクラスにのみ適用されます。NVMe SSD インスタンスストアボリュームを使用する Amazon EC2 インスタンスについては、[インスタンスストアボリューム](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html#instance-store-volumes)を参照してください。同等の RDS DB インスタンスクラスには同じインスタンスストアボリュームがあります。例えば、db.m6gd および db.r6gd DB インスタンスクラスには NVMe SSD インスタンスストアボリュームがあります。  |    |  秒  | 
| `WriteLatencyLogVolume` |  ログボリュームに対して 1 回のディスク I/O オペレーションにかかる平均時間。  |  [専用ログボリューム](USER_PIOPS.dlv.md)が有効になっている DB インスタンス  |  秒  | 
| `WriteThroughput` |  1 秒あたりのディスクへの平均書き込みバイト数。  |  すべて  |  1 秒あたりのバイト数  | 
| `WriteThroughputLogVolume` |  ログボリュームに対して 1 秒あたりのディスクへの平均書き込みバイト数。  |  [専用ログボリューム](USER_PIOPS.dlv.md)が有効になっている DB インスタンス  |  1 秒あたりのバイト数  | 
| `WriteThroughputLocalStorage` |  ローカルストレージのためにディスクに書き込まれる1秒あたりの平均バイト数。 このメトリクスは、NVMe SSD インスタンスストアボリュームを持つ DB インスタンスクラスにのみ適用されます。NVMe SSD インスタンスストアボリュームを使用する Amazon EC2 インスタンスについては、[インスタンスストアボリューム](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/InstanceStorage.html#instance-store-volumes)を参照してください。同等の RDS DB インスタンスクラスには同じインスタンスストアボリュームがあります。例えば、db.m6gd および db.r6gd DB インスタンスクラスには NVMe SSD インスタンスストアボリュームがあります。  |    |  1 秒あたりのバイト数  | 

## Amazon RDS の Amazon CloudWatch 使用状況メトリクス
<a name="rds-metrics-usage"></a>

Amazon CloudWatch の `AWS/Usage` 名前空間には、Amazon RDS サービスクォータのアカウントレベルの使用状況メトリクスが含まれています。CloudWatch では、すべての AWS リージョン の使用状況メトリクスを自動的に収集します。

詳細については、*Amazon CloudWatch ユーザーガイド*の「[Amazon CloudWatch 使用状況メトリクスの使用](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Usage-Metrics.html)」を参照してください。クォータの詳細については、*Service Quotas ユーザーガイド*の [Amazon RDS のクォータと制約](CHAP_Limits.md) および [クォータの引き上げのリクエスト](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html)を参照してください。


| メトリクス | 説明 | 単位\$1 | 
| --- | --- | --- | 
| AllocatedStorage |  すべての DB インスタンスの合計ストレージ この合計では、一時的な移行インスタンスは除外されます。  |  Gigabytes  | 
| AuthorizationsPerDBSecurityGroup |  AWS アカウント の DB セキュリティグループあたりの進入ルールの数。使用される値は、アカウントの DB セキュリティグループ内の進入ルールの最大数です。アカウント内の他の DB セキュリティグループでは、進入ルールの数が少ない場合があります。  |  カウント  | 
| CustomEndpointsPerDBCluster |  AWS アカウントの DB クラスターあたりのカスタムエンドポイントの数。使用される値は、アカウントの DB クラスター内のカスタムエンドポイントの最大数です。アカウントの他の DB クラスターでは、カスタムエンドポイントの数が少ない場合があります。  |  カウント  | 
| CustomEngineVersions |  AWS アカウントの Amazon RDS Custom のカスタムエンジンバージョン (CEV) の数。  |  カウント  | 
| DBClusterParameterGroups |  AWS アカウント の DB クラスターパラメータグループの数。カウントでは、デフォルトのパラメータグループは除外されます。  |  カウント  | 
| DBClusterRoles |  AWS アカウントの DB クラスターあたりの関連付けられた AWS Identity and Access Management (IAM) ロールの数。使用される値は、アカウント内の DB クラスターに関連付けられた IAM ロールの最大数です。アカウントの他の DB クラスターでは、関連付けられた IAM ロールの数がより少ない場合があります。  |  カウント  | 
| DBClusters |  AWS アカウント の Amazon Aurora DB クラスターの数。  |  カウント  | 
| DBInstanceRoles |  AWS アカウントの DB インスタンスあたりの関連付けられた AWS Identity and Access Management (IAM) ロールの数。使用される値は、アカウント内の DB インスタンスに関連付けられた IAM ロールの最大数です。アカウント内の他の DB インスタンスは、関連付けられた IAM ロールの数がより少ない場合があります。  |  カウント  | 
| DBInstances |  AWS アカウント の DB インスタンスの数。  |  カウント  | 
| DBParameterGroups |  AWS アカウント の DB パラメータグループの数。カウントでは、デフォルトの DB パラメータグループは除外されます。  |  カウント  | 
| DBSecurityGroups |  AWS アカウント 内のセキュリティグループの数。カウントでは、デフォルトのセキュリティグループおよびデフォルトの VPC セキュリティグループは除外されます。  |  カウント  | 
| DBSubnetGroups  |  AWS アカウント の DB サブネットグループの数。カウントでは、デフォルトのサブネットグループは除外されます。  |  カウント  | 
| EventSubscriptions | AWS アカウントのイベント通知サブスクリプションの数。 | カウント | 
| Integrations | AWS アカウントの Amazon Redshift とのゼロ ETL 統合の数。 | カウント | 
| ManualClusterSnapshots |  AWS アカウント にある、手動で作成された DB クラスタースナップショットの数。このカウントでは、無効なスナップショットは除外されます。  |  カウント  | 
| ManualSnapshots |  AWS アカウント にある、手動で作成された DB スナップショットの数。このカウントでは、無効なスナップショットは除外されます。  |  カウント  | 
| OptionGroups |  AWS アカウント 内のオプショングループの数。カウントでは、デフォルトのオプショングループは除外されます。  |  カウント  | 
| Proxies |  AWS アカウントの RDS プロキシの数。  |  カウント  | 
| ReadReplicasPerMaster |  アカウントの DB インスタンスあたりのリードレプリカの数。使用される値は、アカウント内の DB インスタンスのリードレプリカの最大数です。アカウントの他の DB インスタンスでは、リードレプリカの数がより少ない場合があります。  |  カウント  | 
| ReservedDBInstances |  AWS アカウント の予約済み DB インスタンスの数。カウントでは、使用停止または拒否されたインスタンスは除外されます。  |  カウント  | 
| SubnetsPerDBSubnetGroup |  AWS アカウントの DB サブネットグループあたりのサブネットの数。アカウント内の DB サブネットグループのサブネットの最大数。アカウントの他の DB サブネットグループでは、サブネットの数がより少ない場合があります。  |  カウント  | 

**注記**  
Amazon RDS は、使用状況メトリクスのユニットを CloudWatch に発行しません。ユニットはドキュメントにのみ表示されます。

# Amazon RDS の Amazon CloudWatch ディメンション
<a name="dimensions"></a>

次の表に示す任意のディメンションを使用して、Amazon RDS  メトリックスデータをフィルタリングができます。


|  ディメンション  |  以下で要求されたデータをフィルタリングします。 | 
| --- | --- | 
|  DBInstanceIdentifier  |  特定の DB インスタンス。  | 
|  DatabaseClass  |  データベースクラスのすべてのインスタンス。例えば、`db.r5.large` というデータベースクラスに属するすべてのインスタンスのメトリクスを集計できます。  | 
|  EngineName  |  特定されたエンジン名のみ。例えば、メトリクスを組み合わせて、`postgres` というエンジン名を有する全インスタンスを抽出することができます。  | 
|  SourceRegion  |  指定されたリージョンのみ。例えば、`us-east-1` リージョンのすべての DB インスタンスのメトリクスを集計できます。  | 
|  DbInstanceIdentifier, VolumeName  |  1 つのインスタンスのボリュームあたりのメトリクス。 RDS は、複数のストレージボリュームのメトリクスをキャプチャします。  | 

**注記**  
追加のストレージボリュームを使用している場合は、`DBInstanceIdentifier` ディメンションの下にストレージメトリクスの集計が表示されます。ボリュームごとのストレージメトリクスを表示するには、`DbInstanceIdentifier, VolumeName` ディメンションを使用します。

# Amazon RDS Performance Insights の Amazon CloudWatch メトリクス
<a name="USER_PerfInsights.Cloudwatch"></a>

Performance Insights はメトリクスを自動的に Amazon CloudWatch に発行します。Performance Insights から同じデータに対してクエリを実行できますが、CloudWatch にメトリクスを含めると、CloudWatch アラームを追加しやすくなります。また、既存の CloudWatch ダッシュボードにメトリクスを追加しやすくなります。


| メトリクス | 説明 | 
| --- | --- | 
|  DBLoad  |  データベースのアクティブセッション数。通常、アクティブセッションの平均数に関するデータを使用します。Performance Insights で、このデータは `db.load.avg` としてクエリされます。  | 
|  DBLoadCPU  |  待機イベントタイプが CPU であるアクティブセッションの数。Performance Insights で、このデータは、待機イベントタイプ `db.load.avg` でフィルタ処理された `CPU` としてクエリされます。  | 
|  DBLoadNonCPU  |  待機イベントタイプが CPU でないアクティブセッションの数。  | 
| DBLoadRelativeToNumVCPUs |  データベースの仮想 CPU 数に対する DB 負荷の比率。  | 

**注記**  
これらのメトリクスは、DB インスタンスにロードがある場合にのみ CloudWatch に公開されます。

これらのメトリクスは、CloudWatch コンソール、AWS CLI、または CloudWatch API を使用して調査できます。特別な Metric Math 関数を使用して、他の Performance Insights カウンターメトリクスを調べることもできます。詳細については、「[CloudWatch での他の Performance Insights カウンターメトリクスのクエリ](#USER_PerfInsights.Cloudwatch.ExtraMetrics)」を参照してください。

例えば、`DBLoad` メトリクスの統計情報は、[get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html) コマンドを実行して取得できます。

```
aws cloudwatch get-metric-statistics \
    --region us-west-2 \
    --namespace AWS/RDS \
    --metric-name DBLoad  \
    --period 60 \
    --statistics Average \
    --start-time 1532035185 \
    --end-time 1532036185 \
    --dimensions Name=DBInstanceIdentifier,Value=db-loadtest-0
```

次のコマンドでは、以下のような出力が生成されます。

```
{
		"Datapoints": [
		{
		"Timestamp": "2021-07-19T21:30:00Z",
		"Unit": "None",
		"Average": 2.1
		},
		{
		"Timestamp": "2021-07-19T21:34:00Z",
		"Unit": "None",
		"Average": 1.7
		},
		{
		"Timestamp": "2021-07-19T21:35:00Z",
		"Unit": "None",
		"Average": 2.8
		},
		{
		"Timestamp": "2021-07-19T21:31:00Z",
		"Unit": "None",
		"Average": 1.5
		},
		{
		"Timestamp": "2021-07-19T21:32:00Z",
		"Unit": "None",
		"Average": 1.8
		},
		{
		"Timestamp": "2021-07-19T21:29:00Z",
		"Unit": "None",
		"Average": 3.0
		},
		{
		"Timestamp": "2021-07-19T21:33:00Z",
		"Unit": "None",
		"Average": 2.4
		}
		],
		"Label": "DBLoad"
		}
```

CloudWatch の詳細については、*Amazon CloudWatch ユーザーガイド*の「[Amazon CloudWatch とは](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)」を参照してください。

## CloudWatch での他の Performance Insights カウンターメトリクスのクエリ
<a name="USER_PerfInsights.Cloudwatch.ExtraMetrics"></a>

**注記**  
Database Insights のアドバンストモードを有効にすると、Amazon RDS は Performance Insights カウンターメトリクスを Amazon CloudWatch に発行します。Database Insights では、`DB_PERF_INSIGHTS` Metric Math 関数を使用する必要はありません。CloudWatch Database Insights ダッシュボードを使用して、Performance Insights カウンターメトリクスの検索、クエリ、アラームの設定を行うことができます。

CloudWatch から RDS Performance Insights メトリクスのクエリ、アラーム、グラフを実行できます。CloudWatch の `DB_PERF_INSIGHTS` Metric Math 関数を使用して、DB インスタンスに関する情報にアクセスできます。この関数を使用すると、CloudWatch に直接レポートされない Performance Insights メトリクスを使用して、新しい時系列を作成できます。

新しい Metric Math 関数を使用するには、CloudWatch コンソールの **[メトリクスの選択]** 画面の **[数式を追加]** ドロップダウンメニューをクリックします。これを使用して、Performance Insights メトリクス、または CloudWatch と Performance Insights メトリクス (1 分未満のメトリクスの高解像度アラームなど) の組み合わせに関するアラームとグラフを作成できます。[https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-data.html](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-data.html) リクエストに Metric Math 式を含めることで、プログラムでこの関数を使用することもできます。詳細については、「[Metric Math 構文と関数](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html#metric-math-syntax-functions-list)」および「[AWS データベースから Performance Insights カウンターメトリクスのアラームを作成する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_alarm_database_performance_insights.html)」を参照してください。

# Performance Insights カウンターメトリクス
<a name="USER_PerfInsights_Counters"></a>

カウンターメトリクスは、Performance Insights ダッシュボードのオペレーティングシステムとデータベースのパフォーマンスメトリクスのことです。カウンターメトリクスを DB ロードと関連付けることで、パフォーマンスの問題を特定して分析できます。メトリクス値を取得するには、統計関数をメトリクスに追加する必要があります。例えば、`os.memory.active` メトリクスでサポートされている関数は、`.avg`、`.min`、`.max`、`.sum`、および `.sample_count` です。

カウンターメトリクスは 1 分に 1 回収集されます。OS メトリクスの収集は、拡張モニタリングがオンかオフかによって異なります。拡張モニタリングがオフになっている場合、OS メトリックは 1 分に 1 回収集されます。拡張モニタリングがオンになっている場合、選択した期間の OS メトリックが収集されます。拡張モニタリングのオンまたはオフの詳細については、[拡張モニタリングのオンとオフを切り替える](USER_Monitoring.OS.Enabling.md#USER_Monitoring.OS.Enabling.Procedure) を参照してください。

**Topics**
+ [Performance Insights オペレーティングシステムのカウンター](#USER_PerfInsights_Counters.OS)
+ [Amazon RDS for MariaDB および MySQL の Performance Insights カウンター](#USER_PerfInsights_Counters.MySQL)
+ [Amazon RDS for Microsoft SQL Server の Performance Insights カウンター](#USER_PerfInsights_Counters.SQLServer)
+ [Amazon RDS for Oracle の Performance Insights カウンター](#USER_PerfInsights_Counters.Oracle)
+ [Amazon RDS for PostgreSQL の Performance Insights カウンター](#USER_PerfInsights_Counters.PostgreSQL)

## Performance Insights オペレーティングシステムのカウンター
<a name="USER_PerfInsights_Counters.OS"></a>

次のオペレーティングシステムカウンターは、`os` のプレフィックスが付き、RDS for SQL Server 以外のすべての RDS エンジン では、Performance Insights で使用できます。

DB インスタンスで使用可能なカウンターメトリクスのリストについて、`ListAvailableResourceMetrics` API を使用できます。詳細については、「Amazon RDS Performance Insights API リファレンスガイド」の「[ListAvailableResourceMetics](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListAvailableResourceMetrics)」を参照してください。


| Counter | タイプ | 単位 | メトリクス | 説明 | 
| --- | --- | --- | --- | --- | 
| アクティブ | メモリ | Kilobytes | os.memory.active | 割り当てられたメモリの量 (キロバイト単位)。 | 
| バッファ | メモリ | Kilobytes | os.memory.buffers | ストレージデバイスへの書き込み前に I/O バッファリングリクエストに使用されたメモリの量 (キロバイト単位)。 | 
| キャッシュ済み | メモリ | Kilobytes | os.memory.cached | ファイルシステムベースの I/O のキャッシュに使用されたメモリの量 (キロバイト単位)。 | 
| DB キャッシュ | メモリ | バイト | os.memory.db.cache |  tmpfs (shmem) を含めて、データベースプロセスがページキャッシュに使用したメモリの量 (バイト単位)。  | 
| DB レジデントセットサイズ | メモリ | バイト | os.memory.db.residentSetSize |  tmpfs (shmem) を含めずに、データベースプロセスが匿名キャッシュとスワップキャッシュに使用したメモリの量 (バイト単位)。  | 
| DB スワップ | メモリ | バイト | os.memory.db.swap |   データベースプロセスがスワップに使用したメモリの量 (バイト単位)。  | 
| ダーティ | メモリ | Kilobytes | os.memory.dirty | 変更されたがストレージ内のその関連データブロックに書き込まれなかった RAM 内のメモリページの量 (キロバイト単位)。 | 
| 空き | メモリ | Kilobytes | os.memory.free | 未割り当てのメモリの量 (キロバイト単位)。 | 
| huge ページ (空き) | メモリ | ページ | os.memory.hugePagesFree | 空き huge ページの数。huge ページは Linux カーネルの機能です。 | 
| huge ページ (予約) | メモリ | ページ | os.memory.hugePagesRsvd | コミットされた huge ページの数。 | 
| huge ページサイズ | メモリ | Kilobytes | os.memory.hugePagesSize | 各 huge ページユニットのサイズ (キロバイト単位)。 | 
| huge ページ (余剰) | メモリ | ページ | os.memory.hugePagesSurp | 使用可能な huge ページの余剰数/合計数。 | 
| huge ページ (合計) | メモリ | ページ | os.memory.hugePagesTotal | huge ページの合計数。 | 
| 非アクティブ | メモリ | Kilobytes | os.memory.inactive | 最も使用されていないメモリページの量 (キロバイト単位)。 | 
| マップ済み | メモリ | Kilobytes | os.memory.mapped | プロセスアドレス空間内でメモリマップされているファイルシステムの内容の合計量 (キロバイト単位)。 | 
| メモリ不足キルカウント | メモリ | Kills | os.memory.outOfMemoryKillCount |  前回の収集間隔で発生した OOM キルの数。  | 
| ページテーブル | メモリ | Kilobytes | os.memory.pageTables | ページテーブルが使用中のメモリの量 (キロバイト単位)。 | 
| スラブ | メモリ | Kilobytes | os.memory.slab | 再利用可能なカーネルデータ構造体の量 (キロバイト単位)。 | 
| Total | メモリ | Kilobytes | os.memory.total | メモリの合計量 (キロバイト単位)。 | 
| 書き戻し | メモリ | Kilobytes | os.memory.writeback | バックアップストレージにまだ書き込み中の RAM 内のダーティページの量 (キロバイト単位)。 | 
| ゲスト | CPU 使用率 | 割合 (%) | os.cpuUtilization.guest | ゲストプログラムが使用中の CPU の使用率。 | 
| アイドル状態 | CPU 使用率 | 割合 (%) | os.cpuUtilization.idle | アイドル状態の CPU の使用率。 | 
| irq | CPU 使用率 | 割合 (%) | os.cpuUtilization.irq | ソフトウェア割り込みが使用中の CPU の使用率。 | 
| Nice | CPU 使用率 | 割合 (%) | os.cpuUtilization.nice | 最も低い優先順位で実行されているプログラムが使用中の CPU の使用率。 | 
| Steal | CPU 使用率 | 割合 (%) | os.cpuUtilization.steal | 他の仮想マシンが使用中の CPU の使用率。 | 
| システム | CPU 使用率 | 割合 (%) | os.cpuUtilization.system | カーネルが使用中の CPU の使用率。 | 
| Total | CPU 使用率 | 割合 (%) | os.cpuUtilization.total | 使用中の CPU の合計使用率。この値は nice 値を含みます。 | 
| ユーザー | CPU 使用率 | 割合 (%) | os.cpuUtilization.user | ユーザープログラムが使用中の CPU の使用率。 | 
| Wait | CPU 使用率 | 割合 (%) | os.cpuUtilization.wait | I/O アクセスを待機中の CPU の未使用率。 | 
|  読み取り IO PS  | ディスク IO | 1 秒あたりのリクエスト |  os.diskIO.<devicename>.readIOsPS  | 読み取りオペレーションの 1 秒あたりの数。 | 
|  書き込み IO PS  | ディスク IO | 1 秒あたりのリクエスト |  os.diskIO.<devicename>.writeIOsPS  | 書き込みオペレーションの 1 秒あたりの数。 | 
|  平均キュー長さ | ディスク IO | リクエスト |  os.diskIO.<devicename>.avgQueueLen  | I/O デバイスのキューで待機中のリクエストの数。 | 
|  平均リクエストサイズ  | ディスク IO | リクエスト |  os.diskIO.<devicename>.avgReqSz  | I/O デバイスのキューで待機中のリクエストの数。 | 
|  待機中  | ディスク IO | ミリ秒 |  os.diskIO.<devicename>.await  | リクエストへの応答に必要なミリ秒数 (キュー時間とサービス時間を含む)。 | 
|  読み取り IO PS  | ディスク IO | リクエスト |  os.diskIO.<devicename>.readIOsPS  | 読み取りオペレーションの 1 秒あたりの数。 | 
|  読み取り KB  | ディスク IO | Kilobytes |  os.diskIO.<devicename>.readKb  | 読み取りの合計キロバイト数。 | 
|  読み取り KB PS  | ディスク IO | KB/秒 |  os.diskIO.<devicename>.readKbPS  | 読み取りの 1 秒あたりのキロバイト数。 | 
|  Rrqm PS  | ディスク IO | 1 秒あたりのリクエスト |  os.diskIO.<devicename>.rrqmPS  | キューに入れられてマージされた読み取りリクエストの 1 秒あたりの数。 | 
|  TPS  | ディスク IO | 1 秒あたりのトランザクション |  os.diskIO.<devicename>.tps  | I/O トランザクションの 1 秒あたりの数。 | 
|  使用率  | ディスク IO | 割合 (%) |  os.diskIO.<devicename>.util  | リクエスト発行中の CPU 時間の消費率。 | 
|  書き込み KB  | ディスク IO | Kilobytes |  os.diskIO.<devicename>.writeKb  | 書き込みの合計キロバイト数。 | 
|  書き込み KB PS  | ディスク IO | KB/秒 |  os.diskIO.<devicename>.writeKbPS  | 書き込みの 1 秒あたりのキロバイト数。 | 
|  Wrqm PS  | ディスク IO | 1 秒あたりのリクエスト |  os.diskIO.<devicename>.wrqmPS  | キューに入れられてマージされた書き込みリクエストの 1 秒あたりの数。 | 
| ブロック | タスク | タスク | os.tasks.blocked | ブロックされているタスクの数。 | 
| 実行中 | タスク | タスク | os.tasks.running | 実行中のタスクの数。 | 
| Sleeping | タスク | タスク | os.tasks.sleeping | スリープ中のタスクの数。 | 
| 停止 | タスク | タスク | os.tasks.stopped | 停止中のタスクの数。 | 
| Total | タスク | タスク | os.tasks.total | タスクの合計数。 | 
| ゾンビ | タスク | タスク | os.tasks.zombie | アクティブな親タスクの非アクティブな子タスクの数。 | 
| 1 | 負荷平均分 | プロセス | os.loadAverageMinute.one | 過去 1 分間に CPU 時間をリクエストしたプロセスの数。 | 
| 15 | 負荷平均分 | プロセス | os.loadAverageMinute.fifteen | 過去 15 分間に CPU 時間をリクエストしたプロセスの数。 | 
| Five | 負荷平均分 | プロセス | os.loadAverageMinute.five | 過去 5 分間に CPU 時間をリクエストしたプロセスの数。 | 
| キャッシュ済み | スワップ | Kilobytes | os.swap.cached | キャッシュメモリとして使用されたスワップメモリの量 (キロバイト単位)。 | 
| 空き | スワップ | Kilobytes | os.swap.free | 空きスワップメモリの量 (キロバイト単位)。 | 
| In (中にある) | スワップ | Kilobytes | os.swap.in | ディスクからスワップされたメモリの量 (キロバイト単位)。 | 
| Out | スワップ | Kilobytes | os.swap.out | ディスクにスワップされたメモリの量 (キロバイト単位)。 | 
| Total | スワップ | Kilobytes | os.swap.total |  使用可能なスワップメモリの合計量 (キロバイト単位)。  | 
| 最大ファイル数 | ファイルシステム | ファイル | os.fileSys.maxFiles | すべてのストレージボリュームにわたってファイルシステム用に作成できるファイルの最大数。 | 
| 使用済みファイル | ファイルシステム | ファイル | os.fileSys.usedFiles | すべてのストレージボリュームにわたるファイルシステム内のファイルの数。 | 
| 使用済みファイルパーセント | ファイルシステム | ファイル | os.fileSys.usedFilePercent | すべてのストレージボリュームで使用可能なファイルの割合。 | 
| 使用率 | ファイルシステム | 割合 (%) | os.fileSys.usedPercent | すべてのストレージボリュームにわたってファイルシステムが使用中のディスク領域の割合。 | 
| 使用済み | ファイルシステム | Kilobytes | os.fileSys.used | すべてのストレージボリュームにわたってファイルシステム内のファイルが使用中のディスク領域の量 (キロバイト単位)。 | 
| Total | ファイルシステム | Kilobytes | os.fileSys.total | すべてのストレージボリュームにわたるファイルシステムに使用できるディスク領域の合計 (キロバイト単位)。 | 
| 最大ファイル数 | ファイルシステム | ファイル | os.fileSys.<volumeName>.maxFiles | ストレージボリューム用に作成できるファイルの最大数。 | 
| 使用済みファイル | ファイルシステム | ファイル | os.fileSys.<volumeName>.usedFiles | ストレージボリューム内のファイルの数。 | 
| 使用済みファイルパーセント | ファイルシステム | ファイル | os.fileSys.<volumeName>.usedFilePercent | すべてのストレージボリュームで使用中の使用可能なファイルの割合。 | 
| 使用率 | ファイルシステム | 割合 (%) | os.fileSys.<volumeName>.usedPercent | ストレージボリュームが使用中のディスク領域の割合。 | 
| 使用済み | ファイルシステム | Kilobytes | os.fileSys.<volumeName>.used | ストレージボリューム内のファイルが使用中のディスク領域の量 (キロバイト単位)。 | 
| Total | ファイルシステム | Kilobytes | os.fileSys.<volumeName>.total | ストレージボリューム内で利用可能なディスク容量の合計 (キロバイト単位)。 | 
| 受信 | Network | 1 秒あたりのバイト数 | os.network.rx | 1 秒あたりの受信バイト数。 | 
| 送信 | Network | 1 秒あたりのバイト数 | os.network.tx | 1 秒あたりのアップロードバイト数。 | 
| ACU 使用率 | General | 割合 (%) | os.general.acuUtilization |  設定された最大容量のうち、現在の容量の割合。  | 
| 最大構成 ACU | General | ACU | os.general.maxConfiguredAcu |  ユーザーが設定した Aurora 容量ユニット (ACU 数) での最大容量。  | 
| 最小構成 ACU | General | ACU | os.general.minConfiguredAcu |  ユーザーが設定した最小容量 (ACU 数)。  | 
| Num VCPU | General | vCPU | os.general.numVCPUs | DB インスタンスの仮想 CPU (vCPU) の数。 | 
| サーバーレスデータベース容量 | General | ACU | os.general.serverlessDatabaseCapacity |  ACU 内の DB インスタンスの現在の容量。  | 

## Amazon RDS for MariaDB および MySQL の Performance Insights カウンター
<a name="USER_PerfInsights_Counters.MySQL"></a>

以下のデータベースカウンターは、Amazon RDS for MariaDB および MySQL の Performance Insights で利用できます。

**Topics**
+ [RDS for MariaDB および RDS for MySQL のネイティブカウンター](#USER_PerfInsights_Counters.MySQL.Native)
+ [Amazon RDS for MariaDB および MySQL の非ネイティブカウンター](#USER_PerfInsights_Counters.MySQL.NonNative)

### RDS for MariaDB および RDS for MySQL のネイティブカウンター
<a name="USER_PerfInsights_Counters.MySQL.Native"></a>

ネイティブメトリクスは、Amazon RDS ではなく、データベースエンジンによって定義されます。これらのネイティブメトリクスの定義については、MySQL ドキュメントの「[Server Status Variables](https://dev.mysql.com/doc/refman/8.0/en/server-status-variables.html)」(8.0 の場合) および「[「Server Status Variables](https://dev.mysql.com/doc/refman/8.4/en/server-status-variables.html)」(8.4 の場合) を参照してください。


| Counter | タイプ | 単位 | メトリクス | 
| --- | --- | --- | --- | 
| Com\$1analyze | SQL | 1 秒あたりのクエリ数 | db.SQL.Com\$1analyze | 
| Com\$1optimize | SQL | 1 秒あたりのクエリ数 | db.SQL.Com\$1optimize | 
| Com\$1select | SQL | 1 秒あたりのクエリ数 | db.SQL.Com\$1select | 
| 接続 | SQL | MySQL サーバーへの 1 分あたりの接続試行回数 (成功の是非) | db.Users.Connections | 
| Innodb\$1rows\$1deleted | SQL | 1 秒あたりの行数 | db.SQL.Innodb\$1rows\$1deleted | 
| Innodb\$1rows\$1inserted | SQL | 1 秒あたりの行数 | db.SQL.Innodb\$1rows\$1inserted | 
| Innodb\$1rows\$1read | SQL | 1 秒あたりの行数 | db.SQL.Innodb\$1rows\$1read | 
| Innodb\$1rows\$1updated | SQL | 1 秒あたりの行数 | db.SQL.Innodb\$1rows\$1updated | 
| Select\$1full\$1join | SQL | 1 秒あたりのクエリ数 | db.SQL.Select\$1full\$1join | 
| Select\$1full\$1range\$1join | SQL | 1 秒あたりのクエリ数 | db.SQL.Select\$1full\$1range\$1join | 
| Select\$1range | SQL | 1 秒あたりのクエリ数 | db.SQL.Select\$1range | 
| Select\$1range\$1check | SQL | 1 秒あたりのクエリ数 | db.SQL.Select\$1range\$1check | 
| Select\$1scan | SQL | 1 秒あたりのクエリ数 | db.SQL.Select\$1scan | 
| Slow\$1queries | SQL | 1 秒あたりのクエリ数 | db.SQL.Slow\$1queries | 
| Sort\$1merge\$1passes | SQL | 1 秒あたりのクエリ数 | db.SQL.Sort\$1merge\$1passes | 
| Sort\$1range | SQL | 1 秒あたりのクエリ数 | db.SQL.Sort\$1range | 
| Sort\$1rows | SQL | 1 秒あたりのクエリ数 | db.SQL.Sort\$1rows | 
| Sort\$1scan | SQL | 1 秒あたりのクエリ数 | db.SQL.Sort\$1scan | 
| Questions | SQL | 1 秒あたりのクエリ数 | db.SQL.Questions | 
| Innodb\$1row\$1lock\$1time | ロック | ミリ秒 (平均) | db.Locks.Innodb\$1row\$1lock\$1time | 
| Table\$1locks\$1immediate | ロック | 1 秒あたりのリクエスト | db.Locks.Table\$1locks\$1immediate | 
| Table\$1locks\$1waited | ロック | 1 秒あたりのリクエスト | db.Locks.Table\$1locks\$1waited | 
| Aborted\$1clients | ユーザー | 接続 | db.Users.Aborted\$1clients | 
| Aborted\$1connects | ユーザー | 接続 | db.Users.Aborted\$1connects | 
| max\$1connections | Users | Connections | db.User.max\$1connections | 
| Threads\$1created | ユーザー | 接続 | db.Users.Threads\$1created | 
| Threads\$1running | ユーザー | 接続 | db.Users.Threads\$1running | 
| Innodb\$1data\$1writes | I/O | 1 秒あたりのオペレーション数 | db.IO.Innodb\$1data\$1writes | 
| Innodb\$1dblwr\$1writes | I/O | 1 秒あたりのオペレーション数 | db.IO.Innodb\$1dblwr\$1writes | 
| Innodb\$1log\$1write\$1requests | I/O | 1 秒あたりのオペレーション数 | db.IO.Innodb\$1log\$1write\$1requests | 
| Innodb\$1log\$1writes | I/O | 1 秒あたりのオペレーション数 | db.IO.Innodb\$1log\$1writes | 
| Innodb\$1pages\$1written | I/O | 1 秒あたりのページ数 | db.IO.Innodb\$1pages\$1written | 
| Created\$1tmp\$1disk\$1tables | Temp | 1 秒あたりのテーブル数 | db.Temp.Created\$1tmp\$1disk\$1tables | 
| Created\$1tmp\$1tables | Temp | 1 秒あたりのテーブル数 | db.Temp.Created\$1tmp\$1tables | 
| Innodb\$1buffer\$1pool\$1pages\$1data | Cache | ページ | db.Cache.Innodb\$1buffer\$1pool\$1pages\$1data | 
| Innodb\$1buffer\$1pool\$1pages\$1total | Cache | ページ | db.Cache.Innodb\$1buffer\$1pool\$1pages\$1total | 
| Innodb\$1buffer\$1pool\$1read\$1requests | Cache | 1 秒あたりのページ数 | db.Cache.Innodb\$1buffer\$1pool\$1read\$1requests | 
| Innodb\$1buffer\$1pool\$1reads | Cache | 1 秒あたりのページ数 | db.Cache.Innodb\$1buffer\$1pool\$1reads | 
| Opened\$1tables | Cache | テーブル | db.Cache.Opened\$1tables | 
| Opened\$1table\$1definitions | Cache | テーブル | db.Cache.Opened\$1table\$1definitions | 
| Qcache\$1hits | Cache | クエリ | db.Cache.Qcache\$1hits | 

### Amazon RDS for MariaDB および MySQL の非ネイティブカウンター
<a name="USER_PerfInsights_Counters.MySQL.NonNative"></a>

非ネイティブカウンターメトリクスは、Amazon RDS で定義されているカウンターです。非ネイティブメトリクスは、特定のクエリで取得するメトリクスである場合があります。非ネイティブメトリクスは派生メトリクスである場合もあります。この場合は、複数のネイティブカウンターが比率、ヒット率、またはレイテンシーの計算で使用されます。


| Counter | タイプ | 単位 | メトリクス | 説明 | 定義 | 
| --- | --- | --- | --- | --- | --- | 
| innodb\$1buffer\$1pool\$1hits | Cache | reads | db.Cache.innoDB\$1buffer\$1pool\$1hits | InnoDB がバッファプールから満たすことができる読み取りの数。 | innodb\$1buffer\$1pool\$1read\$1requests - innodb\$1buffer\$1pool\$1reads | 
| innodb\$1buffer\$1pool\$1hit\$1rate | Cache | 割合 (%) | db.Cache.innoDB\$1buffer\$1pool\$1hit\$1rate | InnoDB がバッファプールから満たすことができる読み取りの割合 (%)。 | 100 \$1 innodb\$1buffer\$1pool\$1read\$1requests / (innodb\$1buffer\$1pool\$1read\$1requests \$1 innodb\$1buffer\$1pool\$1reads) | 
| innodb\$1buffer\$1pool\$1usage | Cache | 割合 (%) | db.Cache.innoDB\$1buffer\$1pool\$1usage |  データ (ページ) を含む InnoDB バッファプールの割合 (%)。  圧縮テーブルを使用すると、この値は変動します。詳細については、MySQL ドキュメントの「[Server Status Variables](https://dev.mysql.com/doc/refman/8.0/en/server-status-variables.html)」(8.0 の場合) および「[Server Status Variables](https://dev.mysql.com/doc/refman/8.4/en/server-status-variables.html)」(8.4 の場合) で、`Innodb_buffer_pool_pages_data` および `Innodb_buffer_pool_pages_total` に関する情報を参照してください。   | Innodb\$1buffer\$1pool\$1pages\$1data / Innodb\$1buffer\$1pool\$1pages\$1total \$1 100.0 | 
| query\$1cache\$1hit\$1rate | Cache | 割合 (%) | db.Cache.query\$1cache\$1hit\$1rate | MySQL 結果セットキャッシュ (クエリキャッシュ) ヒット率。 | Qcache\$1hits / (QCache\$1hits \$1 Com\$1select) \$1 100 | 
| innodb\$1datafile\$1writes\$1to\$1disk | I/O | writes | db.IO.innoDB\$1datafile\$1writes\$1to\$1disk | ディスクに対する InnoDB データファイル書き込みの数 (ダブル書き込みおよび REDO ログ書き込みオペレーションを除く)。 | Innodb\$1data\$1writes - Innodb\$1log\$1writes - Innodb\$1dblwr\$1writes | 
| innodb\$1rows\$1changed | SQL | Rows | db.SQL.innodb\$1rows\$1changed | InnoDB の行オペレーションの合計数。 | db.SQL.Innodb\$1rows\$1inserted \$1 db.SQL.Innodb\$1rows\$1deleted \$1 db.SQL.Innodb\$1rows\$1updated | 
| active\$1transactions | トランザクション | トランザクション | db.Transactions.active\$1transactions | アクティブトランザクションの合計数。 | SELECT COUNT(1) AS active\$1transactions FROM INFORMATION\$1SCHEMA.INNODB\$1TRX | 
| trx\$1rseg\$1history\$1len | トランザクション | なし | db.Transactions.trx\$1rseg\$1history\$1len | マルチバージョン同時実行制御を実装するために InnoDB トランザクションシステムによって管理される、コミットされたトランザクションの UNDO ログページのリスト。undo ログレコードの詳細については、MySQL ドキュメントの「[InnoDB Multi-Versioning](https://dev.mysql.com/doc/refman/8.0/en/innodb-multi-versioning.html)」(8.0 の場合) および「[InnoDB Multi-Versioning](https://dev.mysql.com/doc/refman/8.4/en/innodb-multi-versioning.html)」(8.4 の場合) を参照してください。 | SELECT COUNT AS trx\$1rseg\$1history\$1len FROM INFORMATION\$1SCHEMA.INNODB\$1METRICS WHERE NAME='trx\$1rseg\$1history\$1len'  | 
| innodb\$1deadlocks | ロック | ロック | db.Locks.innodb\$1deadlocks | デッドロックの合計数。 | SELECT COUNT AS innodb\$1deadlocks FROM INFORMATION\$1SCHEMA.INNODB\$1METRICS WHERE NAME='lock\$1deadlocks' | 
| innodb\$1lock\$1timeouts | ロック | ロック | db.Locks.innodb\$1lock\$1timeouts | タイムアウトしたロックの総数。 | SELECT COUNT AS innodb\$1lock\$1timeouts FROM INFORMATION\$1SCHEMA.INNODB\$1METRICS WHERE NAME='lock\$1timeouts' | 
| innodb\$1row\$1lock\$1waits | ロック | ロック | db.Locks.innodb\$1row\$1lock\$1waits | 行ロックを待機した合計数。 | SELECT COUNT AS innodb\$1row\$1lock\$1waits FROM INFORMATION\$1SCHEMA.INNODB\$1METRICS WHERE NAME='lock\$1row\$1lock\$1waits' | 

## Amazon RDS for Microsoft SQL Server の Performance Insights カウンター
<a name="USER_PerfInsights_Counters.SQLServer"></a>

以下のデータベースカウンターは、RDS for Microsoft SQL Server の Performance Insights で利用できます。

### RDS for Microsoft SQL Server のネイティブカウンター
<a name="USER_PerfInsights_Counters.SQLServer.Native"></a>

ネイティブメトリクスは、Amazon RDS ではなく、データベースエンジンによって定義されます。これらのネイティブメトリクスの定義は、Microsoft SQL Server ドキュメントの「[SQL Server オブジェクトを使用する](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/use-sql-server-objects?view=sql-server-2017)」にあります。


| Counter | タイプ | 単位 | メトリクス | 
| --- | --- | --- | --- | 
| 転送されたレコード | [アクセス方法](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-access-methods-object?view=sql-server-2017) | 1 秒あたりのレコード数 | db.Access Methods.Forwarded Records | 
| ページ分割 | [アクセス方法](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-access-methods-object?view=sql-server-2017) | 1 秒あたりの分割数 | db.Access Methods.Page Splits | 
| バッファキャッシュヒット率 | [バッファマネージャー](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-buffer-manager-object?view=sql-server-2017) | Ratio | db.Buffer Manager.Buffer cache hit ratio | 
| ページの平均寿命 | [バッファマネージャー](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-buffer-manager-object?view=sql-server-2017) | 寿命 (秒) | db.Buffer Manager.Page life expectancy | 
| ページ検索 | [バッファマネージャー](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-buffer-manager-object?view=sql-server-2017) | 1 秒あたりの検索数 | db.Buffer Manager.Page lookups | 
| ページの読み取り | [バッファマネージャー](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-buffer-manager-object?view=sql-server-2017) | 1 秒あたりの読み取り数 | db.Buffer Manager.Page reads | 
| ページの書き込み | [バッファマネージャー](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-buffer-manager-object?view=sql-server-2017) | 1 秒あたりの書き込み数 | db.Buffer Manager.Page writes | 
| アクティブなトランザクション | [データベース](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-databases-object?view=sql-server-2017) | トランザクション | db.Databases.Active Transactions (\$1Total) | 
| フラッシュされたログバイト | [データベース](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-databases-object?view=sql-server-2017) | 1 秒あたりのフラッシュされたバイト数 | db.Databases.Log Bytes Flushed (\$1Total) | 
| ログフラッシュ待機 | [データベース](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-databases-object?view=sql-server-2017) | 1 秒あたりの待機数 | db.Databases.Log Flush Waits (\$1Total) | 
| ログフラッシュ | [データベース](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-databases-object?view=sql-server-2017) | 1 秒あたりのフラッシュ | db.Databases.Log Flushes (\$1Total) | 
| 書き込みトランザクション | [データベース](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-databases-object?view=sql-server-2017) | 1 秒あたりのトランザクション | db.Databases.Write Transactions (\$1Total) | 
| ブロックされたプロセス | [一般的な統計](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-general-statistics-object?view=sql-server-2017) | ブロックされたプロセス | db.General Statistics.Processes blocked | 
| ユーザー接続 | [一般的な統計](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-general-statistics-object?view=sql-server-2017) | 接続 | db.General Statistics.User Connections | 
| ラッチ待機 | [ラッチ](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-latches-object?view=sql-server-2017) | 1 秒あたりの待機数 | db.Latches.Latch Waits | 
| デッドロックの数。 | [ロック](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-locks-object?view=sql-server-2017) | 1 秒あたりのデッドロック数 | db.Locks.Number of Deadlocks (\$1Total) | 
| 保留中のメモリ許可 | [メモリマネージャー](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-memory-manager-object?view=sql-server-2017) | メモリ許可 | db.Memory Manager.Memory Grants Pending | 
| バッチリクエスト | [SQL 統計](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-sql-statistics-object?view=sql-server-2017) | 1 秒あたりのリクエスト | db.SQL Statistics.Batch Requests | 
| SQL コンピレーション | [SQL 統計](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-sql-statistics-object?view=sql-server-2017) | 1 秒あたりのコンパイル数 | db.SQL Statistics.SQL Compilations | 
| SQL 再コンパイル | [SQL 統計](https://docs.microsoft.com/en-us/sql/relational-databases/performance-monitor/sql-server-sql-statistics-object?view=sql-server-2017) | 1 秒あたりの再コンパイル数 | db.SQL Statistics.SQL Re-Compilations | 

## Amazon RDS for Oracle の Performance Insights カウンター
<a name="USER_PerfInsights_Counters.Oracle"></a>

以下のデータベースカウンターは、RDS for Oracle の Performance Insights で利用できます。

### RDS for Oracle のネイティブカウンター
<a name="USER_PerfInsights_Counters.Oracle.Native"></a>

ネイティブメトリクスは、Amazon RDS ではなく、データベースエンジンによって定義されます。これらのネイティブメトリクスの定義については、Oracle ドキュメントの「[統計の説明](https://docs.oracle.com/en/database/oracle/oracle-database/12.2/refrn/statistics-descriptions-2.html#GUID-2FBC1B7E-9123-41DD-8178-96176260A639)」を参照してください。

**注記**  
`CPU used by this session` カウンターメトリクスでは、値を使いやすくするために、単位はネイティブのセンチ秒からアクティブセッションに変換されました。例えば、DB ロードグラフの CPU 送信は、CPU の需要を表します。カウンターメトリクス `CPU used by this session` は、Oracle セッションで使用される CPU の容量を表します。CPU 送信と `CPU used by this session` カウンターメトリクスを比較することができます。CPU の需要が使用する CPU より高い場合、セッションは、CPU 時間待ちます。


| Counter | タイプ | 単位 | メトリクス | 
| --- | --- | --- | --- | 
| このセッションで使用される CPU | ユーザー | アクティブなセッション | このセッションで使用される db.User.CPU | 
| クライアントとの間の SQL\$1Net ラウンドトリップ | ユーザー | 1 秒あたりのラウンドトリップ | クライアントとの間の db.User.SQL ラウンドトリップ | 
| SQL\$1Net 経由でクライアントから受信したバイト数 | ユーザー | 1 秒あたりのバイト数 | SQL\$1Net 経由でクライアントから受信した db.User. バイト数 | 
| ユーザーコミット | ユーザー | 1 秒あたりのコミット数 | db.User.user コミット | 
| ログオン累積数 | ユーザー | 1 秒あたりのログオン数 | db.User.logons 累積合計 | 
| ユーザーの呼び出し | ユーザー | 1 秒あたりの呼び出し数 | db.User.user 呼び出し | 
| SQL\$1Net からクライアントに送信されるデータ (バイト) | ユーザー | 1 秒あたりのバイト数 | SQL\$1Net からクライアントに送信される db.User. バイト数 | 
| ユーザーのロールバック | ユーザー | 1 秒あたりのロールバック数 | db.User.user ロールバック | 
| 再実行サイズ | 再実行 | 1 秒あたりのバイト数 | db.Redo.redo サイズ | 
| 分析数 (合計) | SQL | 1 秒あたりの分析数 | db.SQL.parse count (合計) | 
| 分析数 (ハード) | SQL | 1 秒あたりの分析数 | db.SQL.parse count (ハード) | 
| 取得したテーブルスキャン行 | SQL | 1 秒あたりの行数 | 取得した db.SQL. テーブルスキャン行 | 
| ソート (メモリ) | SQL | 1 秒あたりのソート | db.SQL.sorts (メモリ) | 
| ソート (ディスク) | SQL | 1 秒あたりのソート | db.SQL.sorts (ディスク) | 
| ソート (行) | SQL | 1 秒あたりのソート | db.SQL.sorts (行) | 
| 物理的な読み取りバイト | Cache | 1 秒あたりのバイト数 | db.Cache.physical 読み取りバイト数 | 
| DB ブロック取得 | Cache | 1 秒あたりのブロック数 | db.Cache.db ブロック取得数 | 
| DBWR チェックポイント | Cache | 1 分あたりのチェックポイント数 | db.Cache.DBWR チェックポイント | 
| 物理的な読み取り | Cache | 1 秒あたりの読み取り数 | db.Cache.physical 読み取り数 | 
| キャッシュからの一貫した取得数 | Cache | 1 秒あたりの取得数 | db.Cache.consistent キャッシュからの取得数 | 
| キャッシュからの DB ブロックの取得数 | Cache | 1 秒あたりの取得数 | db.Cache.db キャッシュからのブロック取得数 | 
| 整合性のある取得数 | Cache | 1 秒あたりの取得数 | db.Cache.consistent 取得数 | 

## Amazon RDS for PostgreSQL の Performance Insights カウンター
<a name="USER_PerfInsights_Counters.PostgreSQL"></a>

以下のデータベースカウンターは、Amazon RDS for PostgreSQL の Performance Insights で利用できます。

**Topics**
+ [Amazon RDS for PostgreSQL のネイティブカウンター](#USER_PerfInsights_Counters.PostgreSQL.Native)
+ [Amazon RDS for PostgreSQL の非ネイティブカウンター](#USER_PerfInsights_Counters.PostgreSQL.NonNative)

### Amazon RDS for PostgreSQL のネイティブカウンター
<a name="USER_PerfInsights_Counters.PostgreSQL.Native"></a>

ネイティブメトリクスは、Amazon RDS ではなく、データベースエンジンによって定義されます。これらのネイティブメトリクスの定義については、PostgreSQL の「[統計情報の表示](https://www.postgresql.org/docs/current/monitoring-stats.html#MONITORING-STATS-VIEWS)」を参照してください。


| Counter | タイプ | 単位 | メトリクス | 
| --- | --- | --- | --- | 
| blks\$1hit | Cache | 1 秒あたりのブロック数 | db.Cache.blks\$1hit | 
| buffers\$1alloc | Cache | 1 秒あたりのブロック数 | db.Cache.buffers\$1alloc | 
| buffers\$1checkpoint | Checkpoint | 1 秒あたりのブロック数 | db.Checkpoint.buffers\$1checkpoint | 
| checkpoint\$1sync\$1time | Checkpoint | チェックポイントあたりのミリ秒数 | db.Checkpoint.checkpoint\$1sync\$1time | 
| checkpoint\$1write\$1time | Checkpoint | チェックポイントあたりのミリ秒数 | db.Checkpoint.checkpoint\$1write\$1time | 
| checkpoints\$1req | Checkpoint | 1 分あたりのチェックポイント数 | db.Checkpoint.checkpoints\$1req | 
| checkpoints\$1timed | Checkpoint | 1 分あたりのチェックポイント数 | db.Checkpoint.checkpoints\$1timed | 
| maxwritten\$1clean | Checkpoint | 1 分あたりの Bgwriter の完全停止数  | db.Checkpoint.maxwritten\$1clean | 
| deadlocks | Concurrency | 1 分あたりのデッドロック数 | db.Concurrency.deadlocks | 
| blk\$1read\$1time | I/O | Milliseconds | db.IO.blk\$1read\$1time | 
| blks\$1read | I/O | 1 秒あたりのブロック数 | db.IO.blks\$1read | 
| buffers\$1backend | I/O | 1 秒あたりのブロック数 | db.IO.buffers\$1backend | 
| buffers\$1backend\$1fsync | I/O | 1 秒あたりのブロック数 | db.IO.buffers\$1backend\$1fsync | 
| buffers\$1clean | I/O | 1 秒あたりのブロック数 | db.IO.buffers\$1clean | 
| tup\$1deleted | SQL | 1 秒あたりのタプル数 | db.SQL.tup\$1deleted | 
| tup\$1fetched | SQL | 1 秒あたりのタプル数 | db.SQL.tup\$1fetched | 
| tup\$1inserted | SQL | 1 秒あたりのタプル数 | db.SQL.tup\$1inserted | 
| tup\$1returned | SQL | 1 秒あたりのタプル数 | db.SQL.tup\$1returned | 
| tup\$1updated | SQL | 1 秒あたりのタプル数 | db.SQL.tup\$1updated | 
| temp\$1bytes | Temp | 1 秒あたりのバイト数 | db.Temp.temp\$1bytes | 
| temp\$1files | Temp | 1 分あたりのファイル数 | db.Temp.temp\$1files | 
| xact\$1commit | トランザクション | 1 秒あたりのコミット数 | db.Transactions.xact\$1commit | 
| xact\$1rollback | トランザクション | 1 秒あたりのロールバック数 | db.Transactions.xact\$1rollback | 
| numbackends | ユーザー | 接続 | db.User.numbackends | 
| archived\$1count | ログ先行書き込み (WAL) | 1 分あたりのファイル数 | db.WAL.archived\$1count | 

### Amazon RDS for PostgreSQL の非ネイティブカウンター
<a name="USER_PerfInsights_Counters.PostgreSQL.NonNative"></a>

非ネイティブカウンターメトリクスは、Amazon RDS で定義されているカウンターです。非ネイティブメトリクスは、特定のクエリで取得するメトリクスである場合があります。非ネイティブメトリクスは派生メトリクスである場合もあります。この場合は、複数のネイティブカウンターが比率、ヒット率、またはレイテンシーの計算で使用されます。


| Counter | タイプ | 単位 | メトリクス | 説明 | 定義 | 
| --- | --- | --- | --- | --- | --- | 
| checkpoint\$1sync\$1latency | Checkpoint | db.Checkpoint.checkpoint\$1sync\$1latency |  | チェックポイント処理でファイルをディスクに同期する部分に費やした合計時間。 | checkpoint\$1sync\$1time / (checkpoints\$1timed \$1 checkpoints\$1req) | 
| checkpoint\$1write\$1latency | Checkpoint | db.Checkpoint.checkpoint\$1write\$1latency | チェックポイント処理でファイルをディスクに書き込む部分に費やした合計時間。 | checkpoint\$1write\$1time / (checkpoints\$1timed \$1 checkpoints\$1req) | 
| read\$1latency | I/O | db.IO.read\$1latency | このインスタンスのバックエンドでデータファイルブロックの読み取りに費やした時間。 | blk\$1read\$1time / blks\$1read | 
| idle\$1in\$1transaction\$1aborted\$1count | State | セッション | db.state.idle\$1in\$1transaction\$1aborted\$1count | idle in transaction (aborted) 状態のセッションの数。 | 該当しない | 
| idle\$1in\$1transaction\$1count | State | セッション | db.state.idle\$1in\$1transaction\$1count | idle in transaction 状態のセッションの数。 | 該当しない | 
| idle\$1in\$1transaction\$1max\$1time | State | 秒 | db.state.idle\$1in\$1transaction\$1max\$1time | idle in transaction 状態で実行されている最も長いトランザクションの時間を秒単位で表します。 | 該当しない | 
| active\$1transactions | トランザクション | トランザクション | db.Transactions.active\$1transactions | アクティブなトランザクションの数。 | 該当しない | 
| blocked\$1transactions | トランザクション | トランザクション | db.Transactions.blocked\$1transactions | ブロックされたトランザクションの数。 | 該当しない | 
| oldest\$1active\$1logical\$1replication\$1slot\$1xid\$1age | トランザクション | db.Transactions.oldest\$1active\$1logical\$1replication\$1slot\$1xid\$1age | アクティブな論理レプリケーションスロット内の最も古いトランザクションの経過時間。 詳細については、「[論理レプリケーションスロット](Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Resolving_Identifiableblockers.md#Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Logical_replication_slot)」を参照してください。 | – | 
| oldest\$1inactive\$1logical\$1replication\$1slot\$1xid\$1age | トランザクション | db.Transactions.oldest\$1inactive\$1logical\$1replication\$1slot\$1xid\$1age | 非アクティブな論理レプリケーションスロット内の最も古いトランザクションの経過時間。 詳細については、「[論理レプリケーションスロット](Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Resolving_Identifiableblockers.md#Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Logical_replication_slot)」を参照してください。 | – | 
| oldest\$1prepared\$1transaction\$1xid\$1age | トランザクション | db.Transactions.oldest\$1prepared\$1transaction\$1xid\$1age | 最も古い準備済みトランザクションの経過時間。 詳細については、「[準備済みトランザクション](Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Resolving_Identifiableblockers.md#Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Prepared_transaction)」を参照してください。 | – | 
| oldest\$1running\$1transaction\$1xid\$1age | トランザクション | db.Transactions.oldest\$1running\$1transaction\$1xid\$1age | 最も古い実行中トランザクションの経過時間。 最も古い実行中のアクティブなトランザクションについては「[アクティブなステートメント](Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Resolving_Identifiableblockers.md#Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Active_statement)」を、最も古い実行中のアイドル状態のトランザクションについては「[トランザクションでのアイドル状態](Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Resolving_Identifiableblockers.md#Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Idle_in_transaction)」を参照してください。 | – | 
| oldest\$1hot\$1standby\$1feedback\$1xid\$1age | トランザクション | db.Transactions.oldest\$1hot\$1standby\$1feedback\$1xid\$1age | `hot_standby_feedback` が有効になっているリードレプリカで実行されている最も古いトランザクションの経過時間。 詳細については、「[リードレプリカ](Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Resolving_Identifiableblockers.md#Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.Read_replicas)」を参照してください。 | – | 
| max\$1used\$1xact\$1ids | トランザクション | トランザクション | db.Transactions.max\$1used\$1xact\$1ids | バキューム処理されていないトランザクションの数。 | 該当しない | 
| max\$1connections | Users | Connections | db.User.max\$1connections | max\$1connections パラメータで設定された DB インスタンスに許可される接続の最大数。 | 該当しない | 
| archive\$1failed\$1count | WAL | 1 分あたりのファイル数 | db.WAL.archive\$1failed\$1count | WAL ファイルのアーカイブに失敗した 1 分あたりのファイル数。 | 該当しない | 

# Performance Insights の SQL 統計
<a name="sql-statistics"></a>

*SQL 統計*は、Performance Insights によって収集される SQL クエリに関するパフォーマンス関連のメトリックです。Performance Insights は、クエリが実行中の 1 秒ごとおよび SQL 呼び出しごとに統計を収集します。SQL 統計は、選択した時間範囲の平均です。

SQL ダイジェストは、特定のパターンを持つすべてのクエリの複合体ですが、必ずしも同じリテラル値を持つ必要はありません。ダイジェストは、リテラル値を疑問符に置き換えます。例えば、`SELECT * FROM emp WHERE lname= ?` と指定します。このダイジェストは、次の子クエリで構成されます。

```
SELECT * FROM emp WHERE lname = 'Sanchez'
SELECT * FROM emp WHERE lname = 'Olagappan'
SELECT * FROM emp WHERE lname = 'Wu'
```

すべてのエンジンは、ダイジェストクエリの SQL 統計をサポートしています。

この機能のリージョン、DB エンジン、およびインスタンスクラスのサポート情報については、「[Amazon RDS DB エンジン、リージョン、およびインスタンスクラスでサポートされている Performance Insights 機能](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport)」を参照してください。

**Topics**
+ [MariaDB および MySQL のSQL統計](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL.md)
+ [Amazon RDS for Oracle の SQL 統計](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.Oracle.md)
+ [Amazon RDS for SQL Server の SQL 統計](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.SQLServer.md)
+ [RDS PostgreSQL での SQL 統計](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL.md)

# MariaDB および MySQL のSQL統計
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL"></a>

MariaDB、および MySQLは、ダイジェストレベルでのみSQL 統計を収集します。ステートメントレベルでは、統計は表示されません。

**Topics**
+ [MariaDB および MySQL の Digest 統計](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL.truncation)
+ [MariaDB および MySQL の秒単位の統計データ](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL.per-second)
+ [MariaDB および MySQL の呼び出しごとの統計データ](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL.truncation.per-call)
+ [MariaDB および MySQL のプライマリ統計情報](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL.primary)

## MariaDB および MySQL の Digest 統計
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL.truncation"></a>

Performance Insightsは、`events_statements_summary_by_digest` テーブルから SQL ダイジェスト統計を収集します。`events_statements_summary_by_digest`テーブルは、データベースによって管理されます。

ダイジェストテーブルには削除ポリシーはありません。テーブルがいっぱいになると、AWS マネジメントコンソール に次のメッセージが表示されます。

```
Performance Insights is unable to collect SQL Digest statistics on new queries because the table events_statements_summary_by_digest is full. 
Please truncate events_statements_summary_by_digest table to clear the issue. Check the User Guide for more details.
```

このような状況では、MariaDB および MySQL 、はSQL クエリを追跡しません。この問題に対処するため、Performance Insights は、次の条件の両方が満たされた場合に、ダイジェストテーブルを自動的に切り捨てます。
+ テーブルがいっぱいの場合、
+ Performance Insights は、Performance Schema を自動的に管理します。

  自動管理の場合、`performance_schema` パラメータを `0` に設定する必要があります。[**Source (ソース)**] を `user` に設定しないでください。Performance Insights がパフォーマンススキーマを自動的に管理していない場合は、[Amazon RDS for MariaDB または MySQL における Performance Insights のPerformance Schema の概要](USER_PerfInsights.EnableMySQL.md) を参照してください。

AWS CLI で、[describe-db-pameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html) コマンドを実行し、パラメータ値のソースをチェックします。

## MariaDB および MySQL の秒単位の統計データ
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL.per-second"></a>

次の SQL 統計は、MariaDB および MySQL DB インスタンスで使用できます。


| メトリクス | Unit | 
| --- | --- | 
| db.sql\$1tokenized.stats.count\$1star\$1per\$1sec | 1 秒あたりの呼び出し数 | 
| db.sql\$1tokenized.stats.sum\$1timer\$1wait\$1per\$1sec | 1 秒あたりの平均レイテンシー (ミリ秒) | 
| db.sql\$1tokenized.stats.sum\$1select\$1full\$1join\$1per\$1sec | 1 秒ごとに完全結合を選択 | 
| db.sql\$1tokenized.stats.sum\$1select\$1range\$1check\$1per\$1sec | 1 秒ごとに範囲チェックを選択 | 
| db.sql\$1tokenized.stats.sum\$1select\$1scan\$1per\$1sec | 1 秒ごとにスキャンを選択 | 
| db.sql\$1tokenized.stats.sum\$1sort\$1merge\$1passes\$1per\$1sec | 1 秒ごとにマージパスを並べ替え | 
| db.sql\$1tokenized.stats.sum\$1sort\$1scan\$1per\$1sec | 1 秒あたりの並べ替えスキャン数 | 
| db.sql\$1tokenized.stats.sum\$1sort\$1range\$1per\$1sec | 1 秒ごとの並べ替え範囲 | 
| db.sql\$1tokenized.stats.sum\$1sort\$1rows\$1per\$1sec | 1 秒あたりの行の並べ替え | 
| db.sql\$1tokenized.stats.sum\$1rows\$1affected\$1per\$1sec | 1 秒あたりの影響を受ける行数 | 
| db.sql\$1tokenized.stats.sum\$1rows\$1examined\$1per\$1sec | 1 秒あたりの検査される行数 | 
| db.sql\$1tokenized.stats.sum\$1rows\$1sent\$1per\$1sec | 1 秒あたりに送信される行数 | 
| db.sql\$1tokenized.stats.sum\$1created\$1tmp\$1disk\$1tables\$1per\$1sec | 1 秒ごとに作成されるテンポラリディスクテーブル | 
| db.sql\$1tokenized.stats.sum\$1created\$1tmp\$1tables\$1per\$1sec | 1 秒ごとに作成されるテンポラリテーブル | 
| db.sql\$1tokenized.stats.sum\$1lock\$1time\$1per\$1sec | 1 秒あたりのロック時間 (ミリ秒) | 

## MariaDB および MySQL の呼び出しごとの統計データ
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL.truncation.per-call"></a>

以下のメトリクスは、SQL ステートメントの呼び出しごとの統計を提供します。


| メトリクス | 単位 | 
| --- | --- | 
| db.sql\$1tokenized.stats.sum\$1timer\$1wait\$1per\$1call | 呼び出しごとの平均レイテンシー (ミリ秒)  | 
| db.sql\$1tokenized.stats.sum\$1select\$1full\$1join\$1per\$1call | コールごとに完全結合を選択 | 
| db.sql\$1tokenized.stats.sum\$1select\$1range\$1check\$1per\$1call | コールごとに範囲チェックを選択 | 
| db.sql\$1tokenized.stats.sum\$1select\$1scan\$1per\$1call | コールごとにスキャンを選択 | 
| db.sql\$1tokenized.stats.sum\$1sort\$1merge\$1passes\$1per\$1call | コールごとにマージパスを並べ替え | 
| db.sql\$1tokenized.stats.sum\$1sort\$1scan\$1per\$1call | コールごとに並べ替えスキャン | 
| db.sql\$1tokenized.stats.sum\$1sort\$1range\$1per\$1call | コールごとの並べ替え範囲 | 
| db.sql\$1tokenized.stats.sum\$1sort\$1rows\$1per\$1call | 呼び出しごとの行の並べ替え | 
| db.sql\$1tokenized.stats.sum\$1rows\$1affected\$1per\$1call | コールごとに影響を受ける行数 | 
| db.sql\$1tokenized.stats.sum\$1rows\$1examined\$1per\$1call | コールごとに検査される行数 | 
| db.sql\$1tokenized.stats.sum\$1rows\$1sent\$1per\$1call | コールごとに送信される行数 | 
| db.sql\$1tokenized.stats.sum\$1created\$1tmp\$1disk\$1tables\$1per\$1call | コールごとに作成されたテンポラリディスクテーブル数 | 
| db.sql\$1tokenized.stats.sum\$1created\$1tmp\$1tables\$1per\$1call | コールごとに作成されたテンポラリテーブル数 | 
| db.sql\$1tokenized.stats.sum\$1lock\$1time\$1per\$1call | 呼び出しごとのロック時間 (ミリ秒) | 

## MariaDB および MySQL のプライマリ統計情報
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.MySQL.primary"></a>

次の SQL 統計は、MariaDB および MySQL DB インスタンスで使用できます。


| メトリクス | 単位 | 
| --- | --- | 
| db.sql\$1tokenized.stats.count\$1star | 通話 | 
| db.sql\$1tokenized.stats.sum\$1timer\$1wait | 待機時間 (ミリ秒単位) | 
| db.sql\$1tokenized.stats.sum\$1select\$1full\$1join | 完全結合を選択する | 
| db.sql\$1tokenized.stats.sum\$1select\$1range\$1check | 範囲チェックを選択する | 
| db.sql\$1tokenized.stats.sum\$1select\$1scan | スキャンの選択 | 
| db.sql\$1tokenized.stats.sum\$1sort\$1merge\$1passes | マージパスの並べ替え | 
| db.sql\$1tokenized.stats.sum\$1sort\$1scan | スキャンの並べ替え | 
| db.sql\$1tokenized.stats.sum\$1sort\$1range | 並べ替え範囲 | 
| db.sql\$1tokenized.stats.sum\$1sort\$1rows | 行のソート | 
| db.sql\$1tokenized.stats.sum\$1rows\$1affected | 影響を受けた行 | 
| db.sql\$1tokenized.stats.sum\$1rows\$1examined | 検査された行 | 
| db.sql\$1tokenized.stats.sum\$1rows\$1sent | 送信された行 | 
| db.sql\$1tokenized.stats.sum\$1created\$1tmp\$1disk\$1tables | 作成されたテンポラリディスクテーブル数 | 
| db.sql\$1tokenized.stats.sum\$1created\$1tmp\$1tables | 作成されたテンポラリテーブル | 
| db.sql\$1tokenized.stats.sum\$1lock\$1time | ロック時間 (ミリ秒単位) | 

# Amazon RDS for Oracle の SQL 統計
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.Oracle"></a>

Amazon RDS for Oracle は、ステートメントレベルとダイジェストレベルの両方で SQL 統計を収集します。ステートメントレベルでは、ID 列は`V$SQL.SQL_ID`の値を表します。ダイジェストレベルでは、ID 列には`V$SQL.FORCE_MATCHING_SIGNATURE`の値が表示されます。

ダイジェストレベルで ID が`0`の場合、Oracle データベースはこのステートメントが再利用に適していないと判断しました。この場合、子の SQL ステートメントは異なるダイジェストに属している可能性があります。ただし、ステートメントは初期に収集された SQL ステートメントに関する `digest_text` の中にグループ化されています。

**Topics**
+ [Oracle の秒単位の統計](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.Oracle.per-second)
+ [Oracleのコールごとの統計情報](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.Oracle.per-call)
+ [Oracle のプライマリ統計](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.Oracle.primary)

## Oracle の秒単位の統計
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.Oracle.per-second"></a>

次のメトリクスは、Oracle SQL クエリの秒単位の統計を提供します。


| メトリクス | 単位 | 
| --- | --- | 
| db.sql.stats.executions\$1per\$1sec | 1 秒あたりの実行回数 | 
| db.sql.stats.elapsed\$1time\$1per\$1sec | 平均アクティブ実行 (AAE) | 
| db.sql.stats.rows\$1processed\$1per\$1sec | 1 秒あたりに処理される行 | 
| db.sql.stats.buffer\$1gets\$1per\$1sec | 1 秒あたりのバッファ取得数 | 
| db.sql.stats.physical\$1read\$1requests\$1per\$1sec | 1 秒あたりの物理的な読み取り数 | 
| db.sql.stats.physical\$1write\$1requests\$1per\$1sec | 1 秒あたりの物理的な書き込み数 | 
| db.sql.stats.total\$1sharable\$1mem\$1per\$1sec | 1 秒あたりの共有可能なメモリの合計数 (バイト単位)  | 
| db.sql.stats.cpu\$1time\$1per\$1sec | 1 秒あたりの CPU 時間 (ミリ秒) | 

次のメトリクスは、Oracle SQL ダイジェストクエリの秒単位の統計を提供します。


| メトリクス | 単位 | 
| --- | --- | 
| db.sql\$1tokenized.stats.executions\$1per\$1sec | 1 秒あたりの実行回数 | 
| db.sql\$1tokenized.stats.elapsed\$1time\$1per\$1sec | 平均アクティブ実行 (AAE) | 
| db.sql\$1tokenized.stats.rows\$1processed\$1per\$1sec | 1 秒あたりに処理される行 | 
| db.sql\$1tokenized.stats.buffer\$1gets\$1per\$1sec | 1 秒あたりのバッファ取得数 | 
| db.sql\$1tokenized.stats.physical\$1read\$1requests\$1per\$1sec | 1 秒あたりの物理的な読み取り数 | 
| db.sql\$1tokenized.stats.physical\$1write\$1requests\$1per\$1sec | 1 秒あたりの物理的な書き込み数 | 
| db.sql\$1tokenized.stats.total\$1sharable\$1mem\$1per\$1sec | 1 秒あたりの共有可能なメモリの合計数 (バイト単位)  | 
| db.sql\$1tokenized.stats.cpu\$1time\$1per\$1sec | 1 秒あたりの CPU 時間 (ミリ秒) | 

## Oracleのコールごとの統計情報
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.Oracle.per-call"></a>

以下のメトリクスは、Oracle SQL ステートメントの呼び出しごとの統計を提供します。


| メトリクス | 単位 | 
| --- | --- | 
| db.sql.stats.elapsed\$1time\$1per\$1exec | 実行ごとの経過時間(ミリ秒)  | 
| db.sql.stats.rows\$1processed\$1per\$1exec | 実行ごとに処理される行 | 
| db.sql.stats.buffer\$1gets\$1per\$1exec | 実行ごとのバッファ取得数 | 
| db.sql.stats.physical\$1read\$1requests\$1per\$1exec | 実行ごとの物理的読み取り数 | 
| db.sql.stats.physical\$1write\$1requests\$1per\$1exec | 実行ごとの物理的書き込み数 | 
| db.sql.stats.total\$1sharable\$1mem\$1per\$1exec | 実行ごとの共有可能なメモリの合計(バイト単位) | 
| db.sql.stats.cpu\$1time\$1per\$1exec | 実行ごとの CPU 時間(ミリ秒) | 

以下のメトリクスは、Oracle SQL ダイジェストクエリの呼び出しごとの統計を提供します。


| メトリクス | 単位 | 
| --- | --- | 
| db.sql\$1tokenized.stats.elapsed\$1time\$1per\$1exec | 実行ごとの経過時間(ミリ秒)  | 
| db.sql\$1tokenized.stats.rows\$1processed\$1per\$1exec | 実行ごとに処理される行 | 
| db.sql\$1tokenized.stats.buffer\$1gets\$1per\$1exec | 実行ごとのバッファ取得数 | 
| db.sql\$1tokenized.stats.physical\$1read\$1requests\$1per\$1exec | 実行ごとの物理的読み取り数 | 
| db.sql\$1tokenized.stats.physical\$1write\$1requests\$1per\$1exec | 実行ごとの物理的書き込み数 | 
| db.sql\$1tokenized.stats.total\$1sharable\$1mem\$1per\$1exec | 実行ごとの共有可能なメモリの合計(バイト単位) | 
| db.sql\$1tokenized.stats.cpu\$1time\$1per\$1exec | 実行ごとの CPU 時間(ミリ秒) | 

## Oracle のプライマリ統計
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.Oracle.primary"></a>

次のメトリクスは、Oracle SQL クエリのプライマリ統計を提供します。


| メトリクス | 単位 | 
| --- | --- | 
| db.sql.stats.executions | 実行の回数  | 
| db.sql.stats.elapsed\$1time | 経過時間 (ミリ秒単位) | 
| db.sql.stats.rows\$1processed | 処理された行  | 
| db.sql.stats.buffer\$1gets | バッファ取得数  | 
| db.sql.stats.physical\$1read\$1requests | 物理的な読み取り  | 
| db.sql.stats.physical\$1write\$1requests | 物理的な書き込み数  | 
| db.sql.stats.total\$1sharable\$1mem | 共有可能なメモリの合計 (バイト単位)  | 
| db.sql.stats.cpu\$1time | CPU 時間 (ミリ秒単位) | 

次のメトリクスは、Oracle SQL ダイジェストクエリのプライマリ統計を提供します。


| メトリクス | 単位 | 
| --- | --- | 
| db.sql\$1tokenized.stats.executions | 実行の回数 | 
| db.sql\$1tokenized.stats.elapsed\$1time | 経過時間 (ミリ秒単位) | 
| db.sql\$1tokenized.stats.rows\$1processed | 処理された行 | 
| db.sql\$1tokenized.stats.buffer\$1gets | バッファ取得数 | 
| db.sql\$1tokenized.stats.physical\$1read\$1requests | 物理的な読み取り | 
| db.sql\$1tokenized.stats.physical\$1write\$1requests | 物理的な書き込み数 | 
| db.sql\$1tokenized.stats.total\$1sharable\$1mem | 共有可能なメモリの合計 (バイト単位)  | 
| db.sql\$1tokenized.stats.cpu\$1time | CPU 時間 (ミリ秒単位) | 

# Amazon RDS for SQL Server の SQL 統計
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.SQLServer"></a>

Amazon RDS for SQL Server は、ステートメントレベルとダイジェストレベルの両方で SQL 統計を収集します。ステートメントレベルの場合、ID 列は `sql_handle` の値を表します。ダイジェストレベルの場合、ID 列は `query_hash` の値を示します。

SQL Server はいくつかのステートメントで `query_hash` として NULL 値を返します。例えば、ALTER INDEX、CHECKPOINT、UPDATE STATISTICS、COMMIT TRANSACTION、FETCH NEXT FROM Cursor、およびいくつかの INSERT ステートメント、SELECT @<variable>、条件ステートメント、実行可能なストアドプロシージャが該当します。この場合、`sql_handle` 値は、そのステートメントのダイジェストレベルで ID として表示されます。

**Topics**
+ [SQL Server の秒単位の統計](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.SQLServer.per-second)
+ [SQL Server の呼び出し単位の統計](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.SQLServer.per-call)
+ [SQL Server のプライマリ統計](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.SQLServer.primary)

## SQL Server の秒単位の統計
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.SQLServer.per-second"></a>

以下のメトリクスは、SQL Server の SQL クエリの秒単位の統計を提供します。


| メトリクス | 単位 | 
| --- | --- | 
| db.sql.stats.execution\$1count\$1per\$1sec | 1 秒あたりの実行回数 | 
| db.sql.stats.total\$1elapsed\$1time\$1per\$1sec | 1 秒あたりの合計経過時間 | 
| db.sql.stats.total\$1rows\$1per\$1sec | 1 秒あたりの処理された行の合計数 | 
| db.sql.stats.total\$1logical\$1reads\$1per\$1sec | 1 秒あたりの論理読み取りの合計数 | 
| db.sql.stats.total\$1logical\$1writes\$1per\$1sec | 1 秒あたりの論理書き込みの合計数 | 
| db.sql.stats.total\$1physical\$1reads\$1per\$1sec | 1 秒あたりの物理読み取りの合計数 | 
| db.sql.stats.total\$1worker\$1time\$1per\$1sec | 合計 CPU 時間 (ミリ秒単位) | 

以下のメトリクスは、SQL Server の SQL ダイジェストクエリの秒単位の統計を示します。


| メトリクス | 単位 | 
| --- | --- | 
| db.sql\$1tokenized.stats.execution\$1count\$1per\$1sec | 1 秒あたりの実行数 | 
| db.sql\$1tokenized.stats.total\$1elapsed\$1time\$1per\$1sec | 1 秒あたりの合計経過時間 | 
| db.sql\$1tokenized.stats.total\$1rows\$1per\$1sec | 1 秒あたりの処理された行の合計数 | 
| db.sql\$1tokenized.stats.total\$1logical\$1reads\$1per\$1sec | 1 秒あたりの論理読み取りの合計数 | 
| db.sql\$1tokenized.stats.total\$1logical\$1writes\$1per\$1sec | 1 秒あたりの論理書き込みの合計数 | 
| db.sql\$1tokenized.stats.total\$1physical\$1reads\$1per\$1sec | 1 秒あたりの物理読み取りの合計数 | 
| db.sql\$1tokenized.stats.total\$1worker\$1time\$1per\$1sec | 合計 CPU 時間 (ミリ秒単位) | 

## SQL Server の呼び出し単位の統計
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.SQLServer.per-call"></a>

以下のメトリクスは、SQL Server の SQL ステートメントの呼び出しあたりの統計を示します。


| メトリクス | 単位 | 
| --- | --- | 
| db.sql.stats.total\$1elapsed\$1time\$1per\$1call | 実行あたりの合計経過時間 (ミリ秒) | 
| db.sql.stats.total\$1rows\$1per\$1call | 実行あたりの処理された行の合計数 | 
| db.sql.stats.total\$1logical\$1reads\$1per\$1call | 実行あたりの論理読み取りの合計数 | 
| db.sql.stats.total\$1logical\$1writes\$1per\$1call | 実行あたりの論理書き込みの合計数 | 
| db.sql.stats.total\$1physical\$1reads\$1per\$1call | 実行あたりの物理読み取りの合計数 | 
| db.sql.stats.total\$1worker\$1time\$1per\$1call | 実行あたりの合計 CPU 時間 (ミリ秒単位) | 

以下のメトリクスは、SQL Server の SQLダイジェストクエリの呼び出しあたりの統計を示します。


| メトリクス | 単位 | 
| --- | --- | 
| db.sql\$1tokenized.stats.total\$1elapsed\$1time\$1per\$1call | 実行あたりの合計経過時間 | 
| db.sql\$1tokenized.stats.total\$1rows\$1per\$1call | 実行あたりの処理された行の合計数 | 
| db.sql\$1tokenized.stats.total\$1logical\$1reads\$1per\$1call | 実行あたりの論理読み取りの合計数 | 
| db.sql\$1tokenized.stats.total\$1logical\$1writes\$1per\$1call | 実行あたりの論理書き込みの合計数 | 
| db.sql\$1tokenized.stats.total\$1physical\$1reads\$1per\$1call | 実行あたりの物理読み取りの合計数  | 
| db.sql\$1tokenized.stats.total\$1worker\$1time\$1per\$1call | 実行あたりの合計 CPU 時間 (ミリ秒単位) | 

## SQL Server のプライマリ統計
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.SQLServer.primary"></a>

以下のメトリクスは、SQL Server の SQL クエリのプライマリ統計を示します。


| メトリクス | 単位 | 
| --- | --- | 
| db.sql.stats.execution\$1count | 実行の回数 | 
| db.sql.stats.total\$1elapsed\$1time | 合計経過時間 (ミリ秒単位) | 
| db.sql.stats.total\$1rows | 処理された行の合計数 | 
| db.sql.stats.total\$1logical\$1reads | 論理読み取りの合計数 | 
| db.sql.stats.total\$1logical\$1writes | 論理書き込みの合計数 | 
| db.sql.stats.total\$1physical\$1reads | 物理読み取りの合計数 | 
| db.sql.stats.total\$1worker\$1time | 合計 CPU 時間 (ミリ秒単位) | 

以下のメトリクスは、SQL Server の SQLダイジェストクエリのプライマリ統計を示します。


| メトリクス | 単位 | 
| --- | --- | 
| db.sql\$1tokenized.stats.execution\$1count | 実行の回数 | 
| db.sql\$1tokenized.stats.total\$1elapsed\$1time | 合計経過時間 (ミリ秒単位) | 
| db.sql\$1tokenized.stats.total\$1rows | 処理された行の合計数 | 
| db.sql\$1tokenized.stats.total\$1logical\$1reads | 論理読み取りの合計数 | 
| db.sql\$1tokenized.stats.total\$1logical\$1writes | 論理書き込みの合計数 | 
| db.sql\$1tokenized.stats.total\$1physical\$1reads | 物理読み取りの合計数 | 
| db.sql\$1tokenized.stats.total\$1worker\$1time | 合計 CPU 時間 (ミリ秒単位) | 

# RDS PostgreSQL での SQL 統計
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL"></a>

Performance Insights は、SQL 呼び出しごとおよびクエリが実行中の 1 秒ごとに SQL 統計を収集します。RDS for PostgreSQL は SQL 統計をダイジェストレベルでのみ収集します。ステートメントレベルでは、統計は表示されません。

RDS for PostgreSQL のダイジェストレベルの統計の詳細については、以下を参照してください。

**Topics**
+ [RDS PostgreSQL でのダイジェスト統計](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL.digest)
+ [RDS PostgreSQL での秒単位のダイジェスト統計](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL.per-second)
+ [RDS PostgreSQL のコールごとのダイジェスト統計](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL.per-call)
+ [RDS PostgreSQL でのプライマリ統計](#USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL.primary)

## RDS PostgreSQL でのダイジェスト統計
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL.digest"></a>

SQL ダイジェストの統計を表示するには、RDS PostgreSQL が `pg_stat_statements` ライブラリをロードする必要があります。PostgreSQL 11 以降と互換性のある PostgreSQL DB インスタンスでは、このライブラリはデフォルトでロードされます。PostgreSQL 10 以前と互換性のある PostgreSQL DB インスタンスでは、このライブラリをマニュアルで有効にします。手動で有効にするには、DB インスタンスに関連付けられた DB パラメータグループの `shared_preload_libraries` に `pg_stat_statements` を追加します。次に DB インスタンスを再起動します。詳細については、「[Amazon RDS のパラメータグループ](USER_WorkingWithParamGroups.md)」を参照してください。

**注記**  
Performance Insights は、切り捨てられない `pg_stat_activity` 内のクエリの統計のみを収集できます。デフォルトでは、PostgreSQL データベースは 1,024 バイトより長い問い合わせを切り捨てます。問い合わせサイズを増やすには、DB インスタンスに関連付けられた DB パラメータグループの `track_activity_query_size` パラメータを変更します。このパラメータを変更した場合は、DB インスタンスの再起動が必要です。

## RDS PostgreSQL での秒単位のダイジェスト統計
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL.per-second"></a>

PostgreSQL DB インスタンスでは、次の SQL ダイジェストの統計を使用できます。


| メトリクス | 単位 | 
| --- | --- | 
| db.sql\$1tokenized.stats.calls\$1per\$1sec | 1 秒あたりの呼び出し数 | 
| db.sql\$1tokenized.stats.rows\$1per\$1sec | 1 秒あたりの行数 | 
| db.sql\$1tokenized.stats.total\$1time\$1per\$1sec | 1 秒あたりの平均アクティブ実行 (AAE) | 
| db.sql\$1tokenized.stats.shared\$1blks\$1hit\$1per\$1sec | 1 秒あたりのブロックヒット数 | 
| db.sql\$1tokenized.stats.shared\$1blks\$1read\$1per\$1sec | 1 秒あたりのブロック読み取り数 | 
| db.sql\$1tokenized.stats.shared\$1blks\$1dirtied\$1per\$1sec | 1 秒あたりのダーティになったブロック数 | 
| db.sql\$1tokenized.stats.shared\$1blks\$1written\$1per\$1sec | 1 秒あたりのブロック書き込み数 | 
| db.sql\$1tokenized.stats.local\$1blks\$1hit\$1per\$1sec | 1 秒あたりのローカルブロックヒット数 | 
| db.sql\$1tokenized.stats.local\$1blks\$1read\$1per\$1sec | 1 秒あたりのローカルブロック読み取り数 | 
| db.sql\$1tokenized.stats.local\$1blks\$1dirtied\$1per\$1sec | 1 秒あたりのダーティになったローカルブロック数 | 
| db.sql\$1tokenized.stats.local\$1blks\$1written\$1per\$1sec | 1 秒あたりのローカルブロック書き込み数 | 
| db.sql\$1tokenized.stats.temp\$1blks\$1written\$1per\$1sec | 1 秒あたりの一時的な書き込み数 | 
| db.sql\$1tokenized.stats.temp\$1blks\$1read\$1per\$1sec | 1 秒あたりの一時的な読み取り数 | 
| db.sql\$1tokenized.stats.blk\$1read\$1time\$1per\$1sec | 1 秒あたりの平均的な同時読み取り数 | 
| db.sql\$1tokenized.stats.blk\$1write\$1time\$1per\$1sec | 1 秒あたりの平均的な同時書き込み数 | 

## RDS PostgreSQL のコールごとのダイジェスト統計
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL.per-call"></a>

以下のメトリクスは、SQL ステートメントの呼び出しごとの統計を提供します。


| メトリクス | 単位 | 
| --- | --- | 
| db.sql\$1tokenized.stats.rows\$1per\$1call | 呼び出しごとの行数 | 
| db.sql\$1tokenized.stats.avg\$1latency\$1per\$1call | 呼び出しごとの平均レイテンシー (ミリ秒) | 
| db.sql\$1tokenized.stats.shared\$1blks\$1hit\$1per\$1call | 呼び出しごとのブロックヒット数 | 
| db.sql\$1tokenized.stats.shared\$1blks\$1read\$1per\$1call | 呼び出しごとのブロック読み取り数 | 
| db.sql\$1tokenized.stats.shared\$1blks\$1written\$1per\$1call | 呼び出しごとのブロック書き込み数 | 
| db.sql\$1tokenized.stats.shared\$1blks\$1dirtied\$1per\$1call | 呼び出しあたりのダーティになったブロック数 | 
| db.sql\$1tokenized.stats.local\$1blks\$1hit\$1per\$1call | 呼び出しあたりのローカルブロックヒット数 | 
| db.sql\$1tokenized.stats.local\$1blks\$1read\$1per\$1call | 呼び出しあたりのローカルブロック読み取り数 | 
| db.sql\$1tokenized.stats.local\$1blks\$1dirtied\$1per\$1call | 呼び出しあたりのダーティになったローカルブロック数 | 
| db.sql\$1tokenized.stats.local\$1blks\$1written\$1per\$1call | 呼び出しあたりのローカルブロック書き込み数 | 
| db.sql\$1tokenized.stats.temp\$1blks\$1written\$1per\$1call | 呼び出しあたりのテンポラリブロック書き込み数 | 
| db.sql\$1tokenized.stats.temp\$1blks\$1read\$1per\$1call | 呼び出しあたりのテンポラリブロック読み取り数 | 
| db.sql\$1tokenized.stats.blk\$1read\$1time\$1per\$1call | 呼び出しごとの読み取り時間 (ミリ秒) | 
| db.sql\$1tokenized.stats.blk\$1write\$1time\$1per\$1call | 呼び出しごとの書き込み時間 (ミリ秒) | 

## RDS PostgreSQL でのプライマリ統計
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.PostgreSQL.primary"></a>

PostgreSQL DB インスタンスでは、次の SQL の統計を使用できます。


| メトリクス | 単位 | 
| --- | --- | 
| db.sql\$1tokenized.stats.calls | 通話  | 
| db.sql\$1tokenized.stats.rows | Rows  | 
| db.sql\$1tokenized.stats.total\$1time | 合計時間 (ミリ秒単位) | 
| db.sql\$1tokenized.stats.shared\$1blks\$1hit | ブロックヒット  | 
| db.sql\$1tokenized.stats.shared\$1blks\$1read | ブロック読み取り数  | 
| db.sql\$1tokenized.stats.shared\$1blks\$1dirtied | ダーティになったブロック数  | 
| db.sql\$1tokenized.stats.shared\$1blks\$1written | ブロック書き込み数  | 
| db.sql\$1tokenized.stats.local\$1blks\$1hit | ローカルブロックヒット数  | 
| db.sql\$1tokenized.stats.local\$1blks\$1read | ロジカルブロックヒット数  | 
| db.sql\$1tokenized.stats.local\$1blks\$1dirtied | ダーティになったローカルブロック | 
| db.sql\$1tokenized.stats.local\$1blks\$1written | ローカルブロック書き込み数  | 
| db.sql\$1tokenized.stats.temp\$1blks\$1written | 一時的な書き込み数  | 
| db.sql\$1tokenized.stats.temp\$1blks\$1read | 一時的な読み取り数  | 
| db.sql\$1tokenized.stats.blk\$1read\$1time | 平均的な同時読み取り数 (ミリ秒単位) | 
| db.sql\$1tokenized.stats.blk\$1write\$1time | 平均的な同時書き込み数 (ミリ秒単位) | 

これらのメトリクスの詳細については、PostgreSQL ドキュメントの「[pg\$1stat\$1statements](https://www.postgresql.org/docs/current/pgstatstatements.html)」を参照してください。

# 拡張モニタリングの OS メトリクス
<a name="USER_Monitoring-Available-OS-Metrics"></a>

Amazon RDS には、DB インスタンスが実行されているオペレーティングシステム (OS) のリアルタイムのメトリクスが用意されています。RDS は、拡張モニタリングのメトリクスを Amazon CloudWatch Logs アカウントに配信します。以下の表では、Amazon CloudWatch Logs で使用できる OS メトリクスを示しています。



**Topics**
+ [Db2、MariaDB、MySQL、Oracle、および PostgreSQL の OS メトリクス](#USER_Monitoring-Available-OS-Metrics-RDS)
+ [Microsoft SQL Server の OS メトリクス](#USER_Monitoring-Available-OS-Metrics-RDS.SQLServer)

## Db2、MariaDB、MySQL、Oracle、および PostgreSQL の OS メトリクス
<a name="USER_Monitoring-Available-OS-Metrics-RDS"></a>

RDS は、`rdsdbdata` のディスクメトリクスと、OS に存在する追加のストレージボリュームを収集します。CloudWatch Logs で OS メトリクスを表示するには、「[CloudWatch Logs を使用した OS メトリクスの表示](USER_Monitoring.OS.CloudWatchLogs.md)」を参照してください。

<a name="cloudwatch-os-metrics"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/USER_Monitoring-Available-OS-Metrics.html)

## Microsoft SQL Server の OS メトリクス
<a name="USER_Monitoring-Available-OS-Metrics-RDS.SQLServer"></a>

RDS は、`rdsdbdata` のディスクメトリクスと、OS に存在する追加のストレージボリュームを収集します。CloudWatch Logs で OS メトリクスを表示するには、「[CloudWatch Logs を使用した OS メトリクスの表示](USER_Monitoring.OS.CloudWatchLogs.md)」を参照してください。

<a name="cloudwatch-sql-server-metrics"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/USER_Monitoring-Available-OS-Metrics.html)