服务限制（配额）Recommender

服务限制 Recommender 会按组织中的项目分析服务配额的用量，并提供建议，以帮助您识别可能接近其配额限制的资源。

概览

配额限制旨在帮助您管理资源并防止出现不可预见的用量高峰，但它们可能非常复杂，难以跟踪和管理。服务限制 Recommender 会分析配额利用率，并为您提供以下功能，以帮助您在问题出现之前发现潜在的瓶颈：

• 用于查看利用率较高的配额的建议
• 针对每个利用率较高的配额的用量数据分析

主动监控配额建议并采取相应措施，这有助于降低配额用尽的风险。除了每天更新一次的建议之外，您还可以为任何需要实时监控的配额使用 Cloud Monitoring 设置配额用量提醒。

运作方式

服务限制 Recommender 会分析过去 30 天内针对速率配额、分配配额和并发配额的用量。如果在这 30 天内的任何时间点利用率达到当前限制的 80%，系统都会生成一个建议。

注意：服务限制 Recommender 会针对除以下配额之外的所有配额生成数据分析和建议：

• 针对项目、位置或时间以外的维度指定的配额（例如“每个组织”“每个文件夹”“每个用户”“每个资源”或“每个 VPC”配额）
• Google 搜索索引和 YouTube 配额
• IAM 配额 ServiceAccountsPerProject（在新创建项目或尚未广泛使用项目的情况下）

价格

请参阅 Recommender 价格。

准备工作

您必须先执行以下操作，然后才能查看数据分析和建议：

• 您必须启用 Recommender API。 您只需在单个结算项目上启用该 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 导出建议。

控制台

1. 转到 Recommendation Hub。另请参阅 Recommendation Hub 使用入门。

   转到 Recommendation Hub

2. 在查看和管理配额利用率卡片中，点击查看全部。

   注意：您必须拥有正确的 IAM 权限（上文所述）才能查看建议。如果您拥有正确的权限，但页面未显示任何建议，则表示项目没有任何配额利用率满足建议的条件。

gcloud

如要使用 gcloud 查看建议和数据分析，请按以下步骤操作。如需了解详情，请参阅使用 API - 数据分析和使用 API - 建议。

推荐

1. 如需列出启用了 Recommender API 的项目的建议，请运行以下命令：

     gcloud recommender recommendations list \
     --project=PROJECT_ID \
     --location=LOCATION \
     --recommender=google.resourcemanager.serviceLimit.Recommender
   

   替换以下内容：

   • PROJECT_ID：项目 ID。
   • LOCATION：Cloud 区域或可用区。如果配额类型不是基于区域或可用区定义的，则属于“全球”位置。
   注意：如果该命令未返回任何建议，则表示项目没有任何配额利用率满足建议的条件。

2. 如需在使用启用了 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 区域或可用区。如果配额类型不是基于区域或可用区定义的，则属于“全球”位置。

注意：您可以在 list 命令末尾附加 --format=yaml 标志末尾，以扩展建议的详细信息。

数据分析

类似的一组命令可用于列出数据分析。只需对上述每个命令进行两次修改即可：

• 运行 gcloud recommender insights list 而不运行 gcloud recommender recommendations list。
• 传递 --insight-type=google.resourcemanager.serviceLimit.Insight 而不传递 --recommender=google.resourcemanager.serviceLimit.Recommender。

例如，如需列出给定项目的数据分析，请运行以下命令：

    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 的临时访问权限。

注意：如果您尚不熟悉调用 Google Cloud API 的身份验证前提条件，请参阅身份验证概览。

推荐

1. 如需列出启用了 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 调用未返回任何建议，则表示项目没有任何配额利用率满足建议的条件。

2. 如需在使用启用了 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 区域或可用区。如果配额类型不是基于区域或可用区定义的，则属于“全球”位置。

数据分析

类似的一组命令可用于列出数据分析。只需将网址中的 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 Export

建议和数据分析也可以批量导出到 BigQuery 表中。如需了解详情，请参阅 BigQuery 导出文档。