サービス上限（割り当て）Recommender

サービス上限 Recommender は、組織内のプロジェクトごとのサービス割り当ての使用状況を分析し、割り当ての上限に近づく可能性があるリソースを特定するための推奨事項を提供します。

概要

割り当ての上限は、リソースを管理する際や、使用量の予期しない急増からユーザーを保護するために設けられていますが、追跡と管理が複雑になる場合があります。サービス上限 Recommender は、割り当ての使用率を分析し、次の機能を提供します。これにより、問題になる前に潜在的なボトルネックを検出できます。

使用率が高い割り当てを確認するための推奨事項
使用率が高い割り当ての使用状況に関する分析情報

割り当ての推奨事項を積極的にモニタリングして対策を講じることで、割り当て不足のリスクを軽減できます。1 日に 1 回更新される推奨事項に加えて、リアルタイムモニタリングが必要になる可能性がある割り当てについては、Cloud Monitoring を使用して割り当て使用量のアラートを設定できます。

仕組み

サービス上限 Recommender は、過去 30 日間のレート、割り当て、同時割り当て数の使用状況を分析します。30 日間の特定の時点で使用率が現在の上限の 80% に達した場合、推奨事項が生成されます。

料金

Recommender の料金をご覧ください。

始める前に

分析情報と推奨事項を表示する前に、次のことを行う必要があります。

Recommender API を有効にする必要があります。1 つのプロジェクトで API を有効にします。gcloud / API の --billing-project 機能を実行すると、同じプロジェクトを使用して他のプロジェクトの推奨事項と分析情報を調べることができます。
必要なロールのいずれかが割り当てられていることを確認します。

説明	ロール
レコメンデーションを表示	`recommender.serviceLimitViewer`
推奨事項の表示と更新	`recommender.serviceLimitAdmin`

これらのロールにより、分析情報と推奨事項にアクセスできる一連の権限が付与されます。ロールの詳細については、ロールについてと IAM の権限の付与をご覧ください。

透明性とコントロールセンターで、すべてのサービス上限の分析情報と推奨事項をオプトアウトすることもできます。オプトアウトの設定を変更するには、dataprocessing.admin IAM ロールが必要です。オプトアウトの詳細については、分析情報と推奨事項のオプトアウトをご覧ください。

Recommender ID

サービス上限（割り当て）Recommender ID と分析情報タイプは次のとおりです。

google.resourcemanager.serviceLimit.Recommender
google.resourcemanager.serviceLimit.Insight

必要な IAM 権限

サービス上限の推奨事項と分析情報のリストにアクセスするには、次の権限が必要です。

recommender.resourcemanagerServiceLimitRecommendations.get
recommender.resourcemanagerServiceLimitRecommendations.list
recommender.resourcemanagerServiceLimitInsights.get
recommender.resourcemanagerServiceLimitInsights.list

推奨事項と分析情報を更新するには（たとえば、推奨事項を退けるため）、次の権限が必要です。

recommender.resourcemanagerServiceLimitRecommendations.update
recommender.resourcemanagerServiceLimitInsights.update

サービス上限（割り当て）の推奨事項の表示

どのお客様も Cloud コンソール、gcloud、Recommender API から分析情報と推奨事項にアクセスできます。

スタンダード、エンハンスト、プレミアムのいずれかのサポートパッケージをご利用のお客様は、BigQuery を介した推奨事項のエクスポートもご利用になれます。

コンソール

[おすすめハブ] に移動します。おすすめハブのスタートガイドもご覧ください。

おすすめハブに移動
[割り当ての使用率の確認と管理] カードで、[すべて表示] をクリックします。

注: 推奨事項を表示するには、正しい IAM 権限が必要です（上記を参照）。適切な権限があり、ページに推奨事項が表示されない場合は、そのプロジェクトには推奨事項の条件を満たす割り当て使用率がありません。

gcloud

gcloud を使用して推奨事項と分析情報を確認する手順は次のとおりです。詳細については、API の使用 - 分析情報と API の使用 - 推奨事項をご覧ください。

推奨事項

Recommender API を有効にしたプロジェクトについて推奨事項を一覧表示するには、次のコマンドを実行します。
```
  gcloud recommender recommendations list \
  --project=PROJECT_ID \
  --location=LOCATION \
  --recommender=google.resourcemanager.serviceLimit.Recommender
```
次のように置き換えます。
- PROJECT_ID: プロジェクト ID。
- LOCATION: Cloud のリージョンまたはゾーン。割り当てタイプがリージョンまたはゾーンベースで定義されていない場合は、「グローバル」ロケーションに分類されます。
注: このコマンドから推奨事項が返されない場合、そのプロジェクトには、推奨事項の条件を満たす割り当ての使用率がありません。
前の手順のように Recommender API を有効にしたプロジェクトを使用して、別のプロジェクトの推奨事項を一覧表示するには、次のコマンドを実行します。
```
  gcloud recommender recommendations list \
  --billing-project=BILLING_PROJECT_ID \
  --project=PROJECT_ID \
  --location=LOCATION \
  --recommender=google.resourcemanager.serviceLimit.Recommender
```
次のように置き換えます。
- BILLING_PROJECT_ID: Recommender API で有効にしたプロジェクトの ID（これは前の手順で示したものと同じ PROJECT_ID になります）。
- PROJECT_ID: 推奨事項を表示する別のプロジェクトの ID。
- LOCATION: Cloud のリージョンまたはゾーン。割り当てタイプがリージョンまたはゾーンベースで定義されていない場合は、「グローバル」ロケーションに分類されます。

分析情報

同様のコマンドセットを使用して、分析情報を一覧表示できます。上記の各コマンドに次の 2 つの変更を加えるだけです。

gcloud recommender recommendations list ではなく、gcloud recommender insights list を実行します。
--recommender=google.resourcemanager.serviceLimit.Recommender ではなく --insight-type=google.resourcemanager.serviceLimit.Insight を渡します。

たとえば、特定のプロジェクトの分析情報を一覧表示するには、次のコマンドを実行します。

    gcloud recommender insights list 

    --project=PROJECT_ID 

    --location=LOCATION 

    --insight-type=google.resourcemanager.serviceLimit.Insight

次のように置き換えます。

PROJECT_ID: プロジェクト ID。
LOCATION: Cloud のリージョンまたはゾーン。割り当てタイプがリージョンまたはゾーンベースで定義されていない場合は、「グローバル」ロケーションに分類されます。

API

推奨事項と分析情報を表示するには、curl を使用して Recommender API にリクエストを送信します。コマンドラインからリクエストを承認するには、OAuth アクセストークンを使用します。OAuth アクセストークンは、API への一時的なアクセスを許可する文字列です。

推奨事項

Recommender API を有効にしたプロジェクトについて推奨事項を一覧表示するには、次のコマンドを実行します。
```
curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/\
recommenders/google.resourcemanager.serviceLimit.Recommender/recommendations"
```
次のように置き換えます。
- PROJECT_ID: プロジェクト ID。
- LOCATION: Cloud のリージョンまたはゾーン。割り当てタイプがリージョンまたはゾーンベースで定義されていない場合は、「グローバル」ロケーションに分類されます。
注: この API 呼び出しから推奨事項が返されない場合、そのプロジェクトには、推奨事項の条件を満たす割り当ての使用率がありません。
前の手順のように Recommender API を有効にしたプロジェクトを使用して、別のプロジェクトの推奨事項を一覧表示するには、次のコマンドを実行します。
```
curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)"  \
-H "x-goog-user-project: BILLING_PROJECT_ID" \
"https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/\
recommenders/google.resourcemanager.serviceLimit.Recommender/recommendations"
```
次のように置き換えます。
- BILLING_PROJECT_ID: Recommender API で有効にしたプロジェクトの ID（これは前の手順で示したものと同じ PROJECT_ID になります）。
- PROJECT_ID: 推奨事項を表示する別のプロジェクトの ID。
- LOCATION: Cloud のリージョンまたはゾーン。割り当てタイプがリージョンまたはゾーンベースで定義されていない場合は、「グローバル」ロケーションに分類されます。

分析情報

同様のコマンドセットを使用して、分析情報を一覧表示できます。URL 内の recommenders/google.resourcemanager.serviceLimit.Recommender/recommendations を insightTypes/google.resourcemanager.serviceLimit.Insight/insights に置き換えるだけです。

たとえば、特定のプロジェクトの分析情報を一覧表示するには、次のコマンドを実行します。

  curl 

 -H "Authorization: Bearer $(gcloud auth print-access-token)" 

 "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/

 insightTypes/google.resourcemanager.serviceLimit.Insight/insights"

次のように置き換えます。

PROJECT_ID: プロジェクト ID。
LOCATION: Cloud のリージョンまたはゾーン。割り当てタイプがリージョンまたはゾーンベースで定義されていない場合は、「グローバル」ロケーションに分類されます。

BigQuery へのエクスポート

推奨事項と分析情報は、BigQuery テーブルに一括でエクスポートすることもできます。詳しくは、BigQuery Export に関するドキュメントをご覧ください。