Migrar cotas de API de métricas globais para métricas regionais

Neste documento, descrevemos as métricas de cota das APIs regionais e o limite de cada uma. Também descrevemos como atualizar seus painéis de do Cloud Monitoring, políticas de alertas e consultas para usar as métricas regionais.

Métricas de cota da API regional

As APIs regionais do Compute Engine que usavam as métricas de cota global são migradas para usar as métricas regionais. As APIs globais continuam usando as métricas globais e os limites de cotas. Consulte Limites de taxa de API para métricas globais.

Para mais informações sobre os métodos que usam as métricas regionais e os limites, consulte Limites de taxa de API para métricas regionais.

A tabela a seguir lista todas as métricas migradas das métricas de cota global da API para métricas regionais:

Métrica global de cota da API Métrica regional de cota da API
compute.googleapis.com/default compute.googleapis.com/default_per_region BETA
compute.googleapis.com/read_requests compute.googleapis.com/read_requests_per_region BETA
compute.googleapis.com/list_requests compute.googleapis.com/list_requests_per_region BETA
compute.googleapis.com/operation_read_requests compute.googleapis.com/operation_read_requests_per_region BETA
compute.googleapis.com/heavy_weight_read_requests compute.googleapis.com/heavy_weight_read_requests_per_region BETA
compute.googleapis.com/heavy_weight_write_requests compute.googleapis.com/heavy_weight_write_requests_per_region BETA
compute.googleapis.com/global_resource_write_requests compute.googleapis.com/global_resource_write_requests_per_region BETA

As métricas a seguir não têm APIs globais. Se você estiver fazendo referência a essas métricas nos painéis, alertas ou consultas do Cloud Monitoring, é necessário migrar essas métricas para as métricas regionais correspondentes.

Métrica global de cota da API Métrica regional de cota da API
compute.googleapis.com/simulate_maintenance_event_requests compute.googleapis.com/simulate_maintenance_event_requests_per_region BETA
compute.googleapis.com/instance_list_referrers_requests compute.googleapis.com/instance_list_referrers_requests_per_region BETA
compute.googleapis.com/get_serial_port_output_requests compute.googleapis.com/get_serial_port_output_requests_per_region BETA
compute.googleapis.com/network_endpoint_write_requests compute.googleapis.com/network_endpoint_write_requests_per_region BETA
compute.googleapis.com/network_endpoint_list_requests compute.googleapis.com/network_endpoint_list_requests_per_region BETA

As métricas a seguir não têm APIs regionais ou zonais. Portanto, nenhuma mudança é necessária para a migração da cota regional da API.

  • compute.googleapis.com/project_set_common_instance_metadata_requests
  • compute.googleapis.com/license_insert_requests

Migrar métricas do Cloud Monitoring

Ao migrar das métricas existentes de cota de API para as métricas regionais de cota de API, atualize manualmente os painéis, alertas e consultas do Cloud Monitoring para usar métricas regionais.

Atualizar o painel do Cloud Monitoring para usar as métricas regionais

Para alterar uma política de alertas que monitora uma métrica global de cota de API para uma métrica regional, faça o seguinte:

  1. No console do Google Cloud, selecione Monitoring:
  2. No painel de navegação, selecione Painéis.
  3. Selecione o painel que você quer editar para usar uma métrica regional.
  4. Clique em Editar painel.

  5. Edite o filtro que corresponda à métrica que você quer migrar:

    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 regional da API. Por exemplo, o filtro quota_metric =~ compute.googleapis.com/read_requests.* 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/read_requests.*.

      Edite o valor do filtro para usar uma métrica regional.

      Para mais informações sobre as métricas, consulte Limites de taxa de API para métricas regionais.

    4. Clique em Concluído para salvar as mudanças.

    5. Opcional: se você quiser ver o uso da cota por região, expanda o cabeçalho Agrupado e selecione location no campo Agrupar por.

  6. Clique em Fechar editor.

Atualizar as políticas de alertas do Cloud Monitoring para usar as métricas regionais de cota da API

Para alterar uma política de alertas que monitora uma métrica global de cota de API para uma métrica regional, faça o seguinte:

  1. No console do Google Cloud, selecione 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 na política de alertas que você quer editar para usar uma métrica regional.
  4. Clique em Editar para modificar a política.

  5. Edite o filtro que corresponda à métrica que você quer migrar:

    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 regional da API. Por exemplo, o filtro quota_metric =~ compute.googleapis.com/read_requests.* 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/read_requests.*.

      Edite o alerta para usar uma métrica regional.

      Para mais informações sobre as métricas, consulte Limites de taxa de API para métricas regionais.

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

    5. Opcional: se você quiser alertas por região para a métrica regional, expanda o cabeçalho Em toda a série temporal e selecione location no grupo de séries temporais por campo.

  6. Clique em Salvar política.

Atualizar as consultas do Cloud Monitoring para usar as métricas regionais de cota

Para alterar a métrica de cota em uma política de alertas baseada em MQL ou 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 edite o filtro da métrica, conforme mostrado no exemplo a seguir:

Expressão regular para métrica regional de cota

Também é possível agrupar o alerta com base no local usando a operação group-by:

Agrupamento por local