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

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

Métricas de cuota de APIs regionales

Las APIs regionales de Compute Engine que usaban las métricas de cuota globales se migran para usar las métricas regionales. Las APIs globales continúan usando las métricas y los límites de cuota globales. Consulta los límites de frecuencia de la API para métricas globales.

Si deseas 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 la API para métricas regionales.

En la siguiente tabla, se enumeran todas las métricas que se migran de las métricas de cuota de APIs globales a las regionales:

Métrica de cuota global de las APIs Métrica de cuota regional de las APIs
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

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

Métrica de cuota global de las APIs Métrica de cuota regional de las APIs
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

Las siguientes métricas no tienen ninguna API regional o zonal. Por lo tanto, no se requieren cambios para la migración de la cuota regional de APIs.

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

Migra las métricas de Cloud Monitoring

Cuando migras de las métricas de cuota de API existentes a las métricas de cuota de APIs regionales, debes actualizar de forma manual los paneles, las alertas y las consultas de Cloud Monitoring para usar las métricas regionales.

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

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

  1. En la consola de Google Cloud, selecciona Monitoring:
  2. En el panel de navegación, selecciona Paneles.
  3. Selecciona el panel que deseas editar para usar una métrica regional.
  4. Haz clic en Editar panel.

  5. Edita el filtro que corresponde a la métrica que deseas migrar:

    1. En el campo Filtro, selecciona quota_metric.
    2. En el campo Comparator, selecciona =~.

    3. En el campo Valor, especifica el nombre de la métrica para la cuota de API regional. Por ejemplo, el filtro quota_metric =~ compute.googleapis.com/read_requests.* usa una expresión regular para hacer coincidir todos los datos de series temporales que usan la métrica de cuota compute.googleapis.com/read_requests.*.

      Edita el valor del filtro para usar una métrica regional.

      Si deseas 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 Listo para guardar los cambios.

    5. Opcional: Si deseas ver el uso de la cuota por región, expande el encabezado Agrupado y selecciona location en el campo Agrupar por.

  6. Haz clic en Cerrar editor.

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

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

  1. En la consola de Google Cloud, selecciona Monitoring:
  2. En el panel de navegación, selecciona Alertas. La página Alertas muestra paneles que enumeran información de resumen, incidentes y políticas de alertas.
  3. Haz clic en la política de alertas que deseas editar para usar una métrica regional.
  4. Haz clic en Editar para modificar la política.

  5. Edita el filtro que corresponde a la métrica que deseas migrar:

    1. En el campo Filtro, selecciona quota_metric.
    2. En el campo Comparator, selecciona =~.

    3. En el campo Valor, especifica el nombre de la métrica para la cuota de API regional. Por ejemplo, el filtro quota_metric =~ compute.googleapis.com/read_requests.* usa una expresión regular para hacer coincidir todos los datos de series temporales que usan la métrica de cuota compute.googleapis.com/read_requests.*.

      Edita la alerta para usar una métrica regional.

      Si deseas 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 Listo para guardar los cambios en el filtro.

    5. Opcional: Si deseas establecer una alerta por región para la métrica regional, expande el encabezado Entre series temporales y selecciona location en el campo Agrupar series temporales por.

  6. Haz clic en Guardar política.

Actualiza 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 en un panel, usa el Editor de consultas y edita el filtro de consulta. Consulta Usa 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 para la métrica de cuota regional

De manera opcional, puedes agrupar la alerta en función de una ubicación mediante la operación group-by:

Agrupa por ubicación