このページでは、Cloud SQL インスタンスのメモリ不足（OOM）最適化の Recommender について説明します。これは、過去 7 日間に OOM イベントが多く発生したインスタンスを検出するのに役立つ機能です。
この Recommender では、OOM イベントが多く発生したインスタンスが検出され、そのようなインスタンスを最適化してパフォーマンスを高めるための推奨事項が提示されます。推奨事項は毎日生成されます。
料金
Cloud SQL の OOM 最適化の Recommender は、標準の Recommender の料金ティアに含まれています。
始める前に
推奨事項と分析情報を表示するには、事前に次の操作を行う必要があります。
- 分析情報と推奨事項を表示、操作する権限を取得するには、必要な Identity and Access Management（IAM）ロールがあることを確認してください。
IAM ロールの詳細については、IAM の基本ロールと事前定義ロールのリファレンスとプロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。タスク ロール 推奨事項を表示する recommender.cloudsqlViewerまたはcloudsql.viewerのいずれかのロール。推奨事項を適用する recommender.cloudsqlAdmin、cloudsql.editor、cloudsql.adminのいずれかのロール。 -
Enable the Recommender API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles.
インスタンスの OOM 最適化の推奨事項を一覧取得する
インスタンスの OOM 最適化の推奨事項を一覧取得するには、 Cloud de Confiance コンソール、gcloud CLI、または Recommender API を使用します。
コンソール
インスタンスのパフォーマンスに関する推奨事項を一覧取得するには、
Cloud de Confiance コンソールで、次の操作を行います。
- Cloud SQL の [インスタンス] ページに移動します。
- [問題を調査し、推奨事項に従い対策を行うことで、インスタンスの健全性を向上させます] バナーの [詳細を表示] をクリックします。
または、次の方法を行います。
[Active Assist] に移動します。おすすめハブで推奨事項を探して適用するもご覧ください。
[すべての推奨事項] カードで [パフォーマンス] をクリックします。
gcloud CLI
gcloud CLI を使用してインスタンスの OOM 最適化の推奨事項を一覧表示するには、次のように gcloud recommender recommendations list コマンドを実行します。
gcloud recommender recommendations list \ --project=PROJECT_ID \ --location=LOCATION \ --recommender=google.cloudsql.instance.PerformanceRecommender \ --filter=recommenderSubtype=MYSQL_FREQUENT_OUT_OF_MEMORY_BEST_PRACTICE
次のように置き換えます。
PROJECT_ID: プロジェクト ID。LOCATION: インスタンスが配置されているリージョン（us-central1など）。
API
Recommendations API を使用してインスタンスの OOM 最適化の推奨事項を一覧表示するには、次のように recommendations.list メソッドを呼び出します。
GET https://recommender.googleapis.com/v1/projects/PROJECT-ID/locations/LOCATION/recommenders/google.cloudsql.instance.PerformanceRecommender/recommendations
次のように置き換えます。
PROJECT_ID: プロジェクト ID。LOCATION: インスタンスが配置されているリージョン（us-central1など）。
Recommender は、OOM イベントの頻度が高いインスタンスを検出すると、それらをテーブルに一覧表示します。各行には、インスタンス名、簡単な推奨事項、現在のマシンタイプ、推奨マシンタイプ、ロケーション、最終更新日が表示されます。
分析情報と詳細な推奨事項を表示する
OOM の最適化が必要なインスタンスに関する分析情報と詳細な推奨事項を表示するには、 Cloud de Confiance コンソール、gcloud CLI、または Recommender API を使用します。
コンソール
次のいずれかを行います。
[パフォーマンスに関する推奨事項] ページで、[パフォーマンスに関する推奨事項] カードをクリックして [頻繁なメモリ不足に対するベスト プラクティス] をクリックします。推奨事項のパネルが表示されます。このパネルには、インスタンスの分析情報と詳細な推奨事項が含まれています。
[インスタンス] ページで、[頻繁なメモリ不足に関するベスト プラクティス] をクリックします。インスタンスのリストには、推奨事項が適用されるインスタンスのみが表示されます。
gcloud CLI
OOM の最適化が必要なインスタンスに関する分析情報と詳細な推奨事項を表示するには、次のように gcloud recommender insights list コマンドを実行します。
gcloud recommender insights list \ --project=PROJECT-ID \ --location=LOCATION \ --insight-type=google.cloudsql.instance.PerformanceInsight \ --filter=insightSubtype=MYSQL_FREQUENT_OUT_OF_MEMORY
次のように置き換えます。
PROJECT_ID: プロジェクト ID。LOCATION: インスタンスが配置されているリージョン（us-central1など）。
API
Recommendations API を使用して OOM の最適化が必要なインスタンスに関する分析情報と詳細な推奨事項を表示するには、次のように insights.list メソッドを呼び出します。
GET https://recommender.googleapis.com/v1/projects/PROJECT-ID/locations/LOCATION/insightTypes/google.cloudsql.instance.PerformanceInsight/insights
次のように置き換えます。
PROJECT_ID: プロジェクト ID。LOCATION: インスタンスが配置されているリージョン（us-central1など）。
推奨事項を適用する
推奨事項を慎重に評価し、以下のいずれかを行います。
- 詳細については、メモリ使用量が多いインスタンスを最適化するをご覧ください。
- 推奨事項を閉じて強調を解除し、グレー表示するには、[閉じる] をクリックします。
- 推奨事項を適用または拒否せずにパネルを閉じるには、[キャンセル] をクリックします。