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

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

Métricas de cota de API simplificadas

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

Métricas de cota de API legadas e simplificadas

A tabela a seguir lista as métricas de cota da API legada e as métricas equivalentes simplificadas:

Métricas de cota da API legada Métrica simplificada de cota da API
compute.googleapis.com/list_requests compute.googleapis.com/global_reads
Solicitações de leitura por minuto
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_read_requests
compute.googleapis.com/default
Métrica de cota legada 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 legada para métodos globais que criam, modificam ou excluem recursos do Compute Engine.		 compute.googleapis.com/global_writes
Solicitações de mutação por minuto
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 compute.googleapis.com/reads_per_region
Solicitações de leitura por minuto e por região
compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests_per_region
compute.googleapis.com/default_per_region
Métrica de cota legada 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 compute.googleapis.com/writes_per_region
Solicitações de mutação por minuto e por região
compute.googleapis.com/default_per_region
Métrica de cota legada 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 compute.googleapis.com/recommend_locations_per_region
Solicitações RegionInstances RecommendLocations por minuto e região
compute.googleapis.com/cache_invalidation_requests compute.googleapis.com/global_cache_invalidation_requests
Solicitações de invalidação de cache por minuto

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

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

Criar um painel que usa métricas simplificadas de cota da API

Para criar um painel que usa métricas simplificadas, faça o seguinte:

  1. No console do Google Cloud , acesse Monitoring:

    Acessar Monitoring

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

  3. Clique em Criar painel personalizado.

  4. Na barra de ferramentas do painel, clique em Adicionar widget e selecione um tipo de widget (por exemplo, Gráfico de linhas). A página Configurar widget é aberta.

  5. Na seção Selecionar uma métrica, faça o seguinte:

    1. Selecione Cota do consumidor para o recurso.
    2. Selecione Quota como a categoria da métrica.
    3. Selecione Uso da cota de taxa para a métrica e clique em Aplicar.

  6. Na seção Adicionar filtro, use o filtro quota_metric e selecione a métrica de cota da API simplificada correspondente. Para encontrar a métrica simplificada, consulte Métricas de cota de API legadas e simplificadas.

  7. Clique em Aplicar para adicionar o widget ao painel.

  8. Na barra de ferramentas, clique em Salvar para salvar o painel.

Modificar um painel que usa uma métrica de cota legada

Para atualizar um painel que contém uma métrica legada, faça o seguinte:

  1. No console do Google Cloud , acesse Monitoring:

    Acessar Monitoring

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

  3. Abra o painel que contém o gráfico a ser atualizado.

  4. Clique em Editar.

  5. Encontre o widget que você quer atualizar e edite-o.

  6. Na seção Selecionar uma métrica, atualize o filtro que contém a métrica legada:

    1. No campo Filtro, selecione quota_metric.
    2. No campo Valor, atualize o valor atual para a métrica de cota de API simplificada correspondente. Para encontrar a substituição da sua métrica legada, consulte Métricas de cota de API legadas e simplificadas. Por exemplo, mude compute.googleapis.com/read_requests para compute.googleapis.com/global_reads.

  7. Para aplicar as mudanças, clique em Aplicar.

Usar as métricas simplificadas de cota da API nas políticas de alertas do 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 nas suas políticas de alertas do Cloud Monitoring.

Criar uma política de alertas que use métricas simplificadas de cota da API

Para criar uma política de alertas que use métricas simplificadas, faça o seguinte:

  1. No console do Google Cloud , acesse Monitoring:

    Acessar Monitoring

  2. No painel de navegação, selecione Alertas.

  3. Clique em Criar política.

  4. Na seção Selecionar uma métrica, faça o seguinte:

    1. Selecione Cota do consumidor para o recurso.
    2. Selecione Quota como a categoria da métrica.
    3. Selecione Uso da cota de taxa para a métrica e clique em Aplicar.

  5. Na seção Adicionar filtro, use o filtro quota_metric e selecione a métrica de cota da API simplificada correspondente. Para encontrar a métrica simplificada, consulte Métricas de cota de API legadas e simplificadas.

  6. Configure a condição, os canais de notificação e a documentação conforme necessário.

  7. Clique em Salvar política.

Você também pode usar o provedor do Terraform Google Cloud para criar políticas de alertas no seu projetoGoogle Cloud . Para mais informações, consulte Criar políticas de alertas com o Terraform.

Modificar uma política de alertas que usa uma métrica de cota legada

Para atualizar uma política de alertas que usa uma métrica de cota legada, faça o seguinte:

  1. No console do Google Cloud , acesse 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. Para editar uma política, clique no nome dela em Políticas.

  4. Na seção Selecionar uma métrica, atualize o filtro que contém a métrica legada:

    1. No campo Filtro, selecione quota_metric.
    2. No campo Valor, atualize o valor para a métrica de cota de API simplificada correspondente. Para encontrar a substituição da sua métrica legada, consulte Métricas de cota de API legadas e simplificadas. Por exemplo, mude compute.googleapis.com/read_requests para compute.googleapis.com/global_reads.

  5. Clique em Concluído para salvar as alterações no filtro.

  6. Clique em Salvar política.

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

Para atualizar uma política de alertas baseada em PromQL ou um gráfico em um painel, use o Editor de consultas e edite o filtro de consulta. Para mais informações, consulte Usar o editor de código para PromQL.

Para atualizar a consulta, substitua o nome da métrica legada no filtro quota_metric pelo nome da métrica simplificada correspondente.

Exemplo 1:

Consulta que usa uma métrica legada:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/read_requests"}[1m])

Consulta modificada usando métrica simplificada:

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

Exemplo 2:

Consulta que usa uma métrica legada:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/heavy_weight_write_requests_per_region"}[1m])

Consulta modificada usando métrica simplificada:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/writes_per_region"}[1m])