Usar métricas simplificadas de cota de API no Cloud Monitoring

Neste documento, descrevemos como usar as métricas de cota da API Compute Engine simplificada nos painéis, políticas de alerta e consultas do Cloud Monitoring.

Métricas de cota da API simplificada

Para melhorar a detectabilidade e a capacidade de gerenciamento da cota da API Compute Engine, Google Cloud reduziu o número de métricas de cota, consolidando-as em menos grupos de cota. Essas métricas de cota simplificadas também oferecem limites mais altos para cada grupo de cota.

A tabela a seguir lista todas as métricas de cota da API simplificadas que consolidam as métricas de cota da API atuais:

Métricas de cota da API atuais Métrica de cota da API simplificada
compute.googleapis.com/list_requests Read requests per minute
compute.googleapis.com/global_readsBETA
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_read_requests
compute.googleapis.com/default
Métrica de cota existente para métodos que listam recursos do Compute Engine.
compute.googleapis.com/get_macsec_config_requests
compute.googleapis.com/license_verification_requests
compute.googleapis.com/default
Métrica de cota atual para métodos globais que criam, modificam ou excluem recursos do Compute Engine.		 Mutation requests per minute
compute.googleapis.com/global_writesBETA
compute.googleapis.com/global_resource_write_requests
compute.googleapis.com/heavy_weight_write_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_delete_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_create_requests
compute.googleapis.com/address_move_requests
compute.googleapis.com/project_set_common_instance_metadata_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_announce_requests
compute.googleapis.com/license_insert_requests
compute.googleapis.com/heavy_weight_read_requests_per_region Read requests per minute per region
compute.googleapis.com/reads_per_regionBETA
compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests_per_region
compute.googleapis.com/default_per_region
Medição de cota para métodos regionais e zonais que listam recursos do Compute Engine.
compute.googleapis.com/license_verification_requests_per_region
compute.googleapis.com/instance_list_referrers_requests_per_region
compute.googleapis.com/operation_read_requests_per_region
compute.googleapis.com/network_endpoint_list_requests_per_region
compute.googleapis.com/regional_network_endpoint_list_requests_per_region
compute.googleapis.com/get_serial_port_output_requests_per_region
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_write_requests_per_region Mutation requests per minute per region
compute.googleapis.com/writes_per_regionBETA
compute.googleapis.com/default_per_region
Métrica de cota atual para métodos regionais e zonais que criam, modificam ou excluem recursos do Compute Engine.
compute.googleapis.com/global_resource_write_requests_per_region
compute.googleapis.com/network_endpoint_write_requests_per_region
compute.googleapis.com/regional_network_endpoint_write_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_create_requests_per_region
compute.googleapis.com/address_move_requests_per_region
compute.googleapis.com/simulate_maintenance_event_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_delete_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_announce_requests_per_region
compute.googleapis.com/recommend_locations_requests_per_region RegionInstances RecommendLocations requests per minute per region
compute.googleapis.com/recommend_locations_per_regionBETA
compute.googleapis.com/cache_invalidation_requests Cache invalidation requests per minute
compute.googleapis.com/global_cache_invalidation_requestsBETA

Usar métricas simplificadas no Cloud Monitoring

Para monitorar o uso da API Compute Engine em relação às métricas simplificadas da API, adicione filtros para essas métricas nos painéis, alertas e consultas do Cloud Monitoring.

Usar as métricas simplificadas nos painéis do Cloud Monitoring

Para usar uma métrica de cota simplificada nos painéis, faça o seguinte:

  1. No Console do Google Cloud, acesse o Monitoring:

    Acessar Monitoring

  2. No painel de navegação, selecione Painéis.

  3. Selecione o painel que você quer editar para usar uma métrica simplificada.

  4. Clique em Editar painel e adicione um widget.

  5. Adicione um filtro que corresponda à métrica que você quer monitorar:

    1. No campo Filtro, selecione quota_metric.
    2. No campo Comparador, selecione =.
    3. No campo Valor, especifique o nome da métrica para a cota da API. Por exemplo, o filtro quota_metric = compute.googleapis.com/global_reads usa uma expressão regular para corresponder a todos os dados de série temporal que usam a métrica de cota compute.googleapis.com/global_reads.

  6. Para aplicar as mudanças ao painel, clique em Aplicar na barra de ferramentas.

Usar as métricas de cota da API simplificadas nas políticas de alertas do Cloud Monitoring

Para criar uma política de alertas que monitore o uso de uma métrica de cota de API simplificada, faça o seguinte:

  1. No Console do Google Cloud, acesse o Monitoring:

    Acessar Monitoring

  2. No painel de navegação, selecione Alertas. A página "Alertas" exibe painéis que listam informações resumidas, incidentes e políticas de alertas.

  3. Clique em Criar política para adicionar uma política de alertas.

  4. Selecione um filtro que corresponda à métrica que você quer monitorar:

    1. No campo Filtro, selecione quota_metric.
    2. No campo Comparador, selecione =.
    3. No campo Valor, especifique o nome da métrica para a cota simplificada. Por exemplo, o filtro quota_metric = compute.googleapis.com/global_reads usa uma expressão regular para corresponder a todos os dados de série temporal que usam a métrica de cota compute.googleapis.com/global_reads.
    4. Clique em Concluído para salvar as alterações no filtro.

  5. Clique em Salvar política.

Também é possível usar o Google Cloud provedor Terraform para criar políticas de alertas no seu projeto do Google Cloud. Para mais informações, consulte Criar políticas de alertas com o Terraform.

Usar métricas de cota simplificadas nas consultas do Cloud Monitoring

Para usar a métrica de cota simplificada em uma política de alertas baseada em MQL ou PromQL ou em um gráfico em um painel, use o Editor de consultas e edite o filtro de consulta. Consulte Como usar o Editor de consultas. Abra o editor de consultas e adicione o filtro, conforme mostrado nos exemplos a seguir: MQL: 

  fetch consumer_quota
   | metric 'serviceruntime.googleapis.com/quota/rate/net_usage'
   | filter (metric.quota_metric =~ 'compute.googleapis.com/global_reads')
   | align rate(1m)
   | every 1m
   | group_by [], [value_net_usage_aggregate: aggregate(value.net_usage)]
Observação: o MQL será descontinuado em 22 de julho de 2025. Use o PromQL para criar seus painéis. Para mais informações, consulte Descontinuação da MQL. PromQL: 
   sum(rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", 

   quota_metric=~"compute.googleapis.com/globalreads"}[${_interval}]))