Usa métricas simplificadas de cuota de API en Cloud Monitoring


En este documento, se describe cómo usar las métricas de cuota simplificadas de la API de Compute Engine en tus paneles, políticas de alertas y consultas de Cloud Monitoring.

Métricas simplificadas de cuota de API

Para mejorar la visibilidad y la capacidad de administración de la cuota de la API de Compute Engine, Google Cloud redujo la cantidad de métricas de cuota consolidando las métricas en menos grupos de cuotas. Estas métricas de cuota simplificadas también ofrecen límites más altos para cada grupo de cuota.

En la siguiente tabla, se enumeran todas las métricas de cuota de API simplificadas que consolidan las métricas de cuota de API existentes:

Métricas de cuota de APIs existentes Métrica de cuota de API simplificada
compute.googleapis.com/list_requests Read requests per minute
compute.googleapis.com/global_readsBETA
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_read_requests
compute.googleapis.com/default
Métrica de cuota existente para los métodos que enumeran recursos de Compute Engine.
compute.googleapis.com/get_macsec_config_requests
compute.googleapis.com/license_verification_requests
compute.googleapis.com/default
Métrica de cuota existente para métodos globales que crean, modifican o borran recursos de Compute Engine.
Mutation requests per minute
compute.googleapis.com/global_writesBETA
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_regionBETA
compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests_per_region
compute.googleapis.com/default_per_region
Métrica de cuota existente para métodos regionales y zonales que enumeran recursos de 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_regionBETA
compute.googleapis.com/default_per_region
Métrica de cuota existente para métodos regionales y zonales que crean, modifican o borran recursos de 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_regionBETA
compute.googleapis.com/cache_invalidation_requests Cache invalidation requests per minute
compute.googleapis.com/global_cache_invalidation_requestsBETA

Usa métricas simplificadas en Cloud Monitoring

Para supervisar el uso de la API de Compute Engine en función de las métricas simplificadas de la API, agrega filtros para estas métricas en tus paneles, alertas y consultas de Cloud Monitoring.

Usa las métricas simplificadas en los paneles de Cloud Monitoring

Para usar una métrica de cuota simplificada en los paneles, haz lo siguiente:

  1. En la consola de Google Cloud, ve a Monitoring.

    Ir a Monitoring

  2. En el panel de navegación, selecciona Paneles.

  3. Selecciona el panel que deseas editar para usar una métrica simplificada.

  4. Haz clic en Editar panel y agrega un widget.

  5. Agrega un filtro que corresponda a la métrica que deseas supervisar:

    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. Por ejemplo, el filtro quota_metric = compute.googleapis.com/global_reads usa una expresión regular para hacer coincidir todos los datos de series temporales que usan la métrica de cuota compute.googleapis.com/global_reads.
  6. Para aplicar los cambios en el panel, en la barra de herramientas, haz clic en Aplicar.

Usa las métricas de cuota de la API simplificadas en las políticas de alertas de Cloud Monitoring

Para crear una política de alertas que supervise el uso de una métrica de cuota de la API simplificada, haz lo siguiente:

  1. En la consola de Google Cloud, ve a Monitoring.

    Ir a 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 Crear política para agregar una política de alertas.

  4. Selecciona un filtro que corresponda a la métrica que deseas supervisar:

    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 simplificada. Por ejemplo, el filtro quota_metric = compute.googleapis.com/global_reads usa una expresión regular para hacer coincidir todos los datos de series temporales que usan la métrica de cuota compute.googleapis.com/global_reads.
    4. Haz clic en Listo para guardar los cambios en el filtro.
  5. Haz clic en Guardar política.

También puedes usar el Google Cloud Proveedor de Terraform para crear políticas de alertas en tu proyecto de Google Cloud. Para obtener más información, consulta Crea políticas de alertas con Terraform.

Usa métricas de cuota simplificadas en las consultas de Cloud Monitoring

Para usar la métrica de cuota simplificada en una política de alertas basada en MQL o PromQL, 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 agrega el filtro como se muestra en los siguientes ejemplos: MQL:

  fetch consumer_quota
   | metric 'serviceruntime.googleapis.com/quota/rate/net_usage'
   | filter (metric.quota_metric =~ 'compute.googleapis.com/global_reads')
   | align rate(1m)
   | every 1m
   | group_by [], [value_net_usage_aggregate: aggregate(value.net_usage)]
Nota: Los MQL dejarán de estar disponibles el 22 de julio de 2025. Usa PromQL para compilar tus paneles. Para obtener más información, consulta Baja de MQL. PromQL:
   sum(rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", 
quota_metric=~"compute.googleapis.com/globalreads"}[${_interval}]))