Use métricas de quotas de API simplificadas no Cloud Monitoring

Este documento descreve como usar as métricas de quota da API Compute Engine simplificadas nos seus painéis de controlo, políticas de alerta e consultas do Cloud Monitoring.

Métricas de quota da API simplificadas

Para melhorar a deteção e a capacidade de gestão da quota da API Compute Engine, Google Cloud reduziu o número de métricas de quota consolidando as métricas em menos grupos de quotas. Estas métricas de quota simplificadas também oferecem limites mais elevados para cada grupo de quotas.

A tabela seguinte lista todas as métricas de quotas da API simplificadas que consolidam as métricas de quotas da API existentes:

Métricas de quotas da API existentes Métrica de quota da API simplificada
compute.googleapis.com/list_requests Read requests per minute
compute.googleapis.com/global_reads
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_read_requests
compute.googleapis.com/default
Métrica de quota 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 quota existente para métodos globais que criam, modificam ou eliminam recursos do Compute Engine.		 Mutation requests per minute
compute.googleapis.com/global_writes
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_region
compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests_per_region
compute.googleapis.com/default_per_region
Métrica de quota existente 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_region
compute.googleapis.com/default_per_region
Métrica de quota existente para métodos regionais e zonais que criam, modificam ou eliminam 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_region
compute.googleapis.com/cache_invalidation_requests Cache invalidation requests per minute
compute.googleapis.com/global_cache_invalidation_requests

Use métricas simplificadas no Cloud Monitoring

Para monitorizar a utilização da API Compute Engine em comparação com as métricas da API simplificadas, adicione filtros para estas métricas nos painéis de controlo, alertas e consultas do Cloud Monitoring.

Use as métricas simplificadas nos painéis de controlo do Cloud Monitoring

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

  1. Na Google Cloud consola, aceda a Monitorização:

    Aceder a Monitorização

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

  3. Selecione o painel de controlo que quer editar para usar uma métrica simplificada.

  4. Clique em Editar painel de controlo e adicione um widget.

  5. Adicione um filtro que corresponda à métrica que quer monitorizar:

    1. No campo Filtro, selecione quota_metric.
    2. No campo Comparador, selecione =.
    3. No campo Valor, especifique o nome da métrica para a quota 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éries cronológicas que usam a métrica de quota compute.googleapis.com/global_reads.

  6. Para aplicar as alterações ao painel de controlo, na barra de ferramentas, clique em Aplicar.

Use as métricas de quotas da API simplificadas nas políticas de alerta do Cloud Monitoring

Para criar uma política de alerta para monitorizar a utilização de uma métrica de quota da API simplificada, faça o seguinte:

  1. Na Google Cloud consola, aceda a Monitorização:

    Aceder a Monitorização

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

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

  4. Selecione um filtro que corresponda à métrica que quer monitorizar:

    1. No campo Filtro, selecione quota_metric.
    2. No campo Comparador, selecione =.
    3. No campo Valor, especifique o nome da métrica para a quota 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éries cronológicas que usam a métrica de quota compute.googleapis.com/global_reads.
    4. Clique em Concluído para guardar as alterações no filtro.

  5. Clique em Guardar política.

Também pode usar o Google Cloud fornecedor do Terraform para criar políticas de alerta no seu Google Cloud projeto. Para mais informações, consulte o artigo Crie políticas de alerta com o Terraform.

Use métricas de quota simplificadas em consultas do Cloud Monitoring

Para usar a métrica de quota simplificada numa política de alerta baseada em PromQL ou num gráfico num painel de controlo, use o editor de consultas e edite o filtro de consulta. Consulte o artigo Use o editor de código para o PromQL. Abra o editor de consultas e adicione o filtro, conforme mostrado no seguinte exemplo:

   sum(rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
   quota_metric=~"compute.googleapis.com/global_reads"}[${__interval}]))