服务限制(配额)Recommender

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

概览

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

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

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

运作方式

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

价格

请参阅 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. 查看和管理配额利用率卡片中,点击查看全部

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 区域或可用区。如果配额类型未按区域或可用区定义,则配额类型将属于“全球”位置。

数据分析

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

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

建议

  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 区域或可用区。如果配额类型未按区域或可用区定义,则配额类型将属于“全球”位置。
  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 Export 文档