Migrar cuotas de API de métricas globales a métricas regionales


En este documento se describen las métricas de cuota de las APIs regionales y el límite de cada métrica. También se describe cómo actualizar los paneles de control, las políticas de alertas y las consultas de Cloud Monitoring para usar las métricas regionales.

Métricas de cuotas de APIs regionales

Las APIs regionales de Compute Engine que usaban las métricas de cuota global se han migrado para usar las métricas regionales. Las APIs globales siguen usando las métricas y los límites de cuota globales. Consulta los límites de frecuencia de la API para las métricas globales.

Para obtener más información sobre los métodos que usan las métricas regionales y los límites, consulta Límites de frecuencia de llamadas de la API para métricas regionales.

En la siguiente tabla se enumeran todas las métricas que se han migrado de las métricas de cuota de API global a las métricas regionales:

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

Las siguientes métricas no tienen ninguna API global. Si haces referencia a estas métricas en los paneles de control, las alertas o las consultas de Cloud Monitoring, debes migrar estas métricas a las métricas regionales correspondientes.

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

Las siguientes métricas no tienen ninguna API regional o zonal. Por lo tanto, no es necesario hacer ningún cambio para migrar la cuota de la API regional.

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

Migrar métricas de Cloud Monitoring

Cuando migres de las métricas de cuota de API actuales a las métricas de cuota de API regionales, deberás actualizar manualmente los paneles de control, las alertas y las consultas de Cloud Monitoring para que usen métricas regionales.

Actualizar el panel de control de Cloud Monitoring para usar las métricas regionales

Para cambiar una política de alertas que monitoriza una métrica de cuota de API global a una métrica regional, haz lo siguiente:

  1. En la Google Cloud consola, selecciona Monitorización.
  2. En el panel de navegación, selecciona Paneles.
  3. Selecciona el panel de control que quieras editar para usar una métrica regional.
  4. Haz clic en Editar panel de control.
  5. Edita el filtro que corresponda a la métrica que quieras migrar:

    1. En el campo Filtro, selecciona quota_metric.
    2. En el campo Comparador, selecciona =~.
    3. En el campo Valor, especifique el nombre de la métrica de la cuota de la API regional. Por ejemplo, el filtro quota_metric =~ compute.googleapis.com/read_requests.* usa una expresión regular para buscar todos los datos de serie temporal que usen la métrica de cuota compute.googleapis.com/read_requests.*.

      Edite el valor de filtro para usar una métrica regional.

      Para obtener más información sobre las métricas, consulta Límites de frecuencia de la API para métricas regionales.

    4. Haz clic en Hecho para guardar los cambios.

    5. Opcional: Si quiere ver el uso de la cuota por región, despliegue el encabezado Agrupado y seleccione location en el campo Agrupar por.

  6. Haz clic en Cerrar editor.

Actualizar las políticas de alertas de Cloud Monitoring para usar las métricas de cuota de la API regional

Para cambiar una política de alertas que monitoriza una métrica de cuota de API global a una métrica regional, haz lo siguiente:

  1. En la Google Cloud consola, selecciona Monitorización.
  2. En el panel de navegación, selecciona Alertas. En la página Alertas se muestran paneles con información de resumen, incidentes y políticas de alertas.
  3. Haz clic en la política de alertas que quieras editar para usar una métrica regional.
  4. Haga clic en Editar para modificar la política.
  5. Edita el filtro que corresponda a la métrica que quieras migrar:

    1. En el campo Filtro, selecciona quota_metric.
    2. En el campo Comparador, selecciona =~.
    3. En el campo Valor, especifique el nombre de la métrica de la cuota de la API regional. Por ejemplo, el filtro quota_metric =~ compute.googleapis.com/read_requests.* usa una expresión regular para buscar todos los datos de serie temporal que usen la métrica de cuota compute.googleapis.com/read_requests.*.

      Edita la alerta para usar una métrica regional.

      Para obtener más información sobre las métricas, consulta Límites de frecuencia de la API para métricas regionales.

    4. Haz clic en Hecho para guardar los cambios en el filtro.

    5. Opcional: Si quieres recibir alertas por región para la métrica regional, expande el encabezado En todas las series temporales y selecciona location en el campo Agrupar series temporales por.

  6. Haz clic en Guardar política.

Actualizar las consultas de Cloud Monitoring para usar las métricas de cuota regionales

Para cambiar la métrica de cuota en una política de alertas basada en MQL o en un gráfico de un panel de control, usa el editor de consultas y edita el filtro de consulta. Consulta Usar el editor de consultas.

Abre el editor de consultas y edita el filtro de la métrica de consulta, como se muestra en el siguiente ejemplo:

Expresión regular de la métrica de cuota regional

También puedes agrupar la alerta por ubicación mediante la operación group-by:

Agrupar las alertas por ubicación