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

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

Métricas de cuota de API simplificadas

Para mejorar la capacidad de administración y el descubrimiento 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 cuota. Estas métricas de cuota simplificadas también ofrecen límites más altos para cada grupo de cuotas.

Métricas de cuota de API heredadas y simplificadas

En la siguiente tabla, se enumeran las métricas de cuota de la API heredada y sus métricas equivalentes simplificadas:

Métricas de cuota de API heredadas Métrica de cuota de API simplificada
compute.googleapis.com/list_requests compute.googleapis.com/global_reads
Solicitudes de lectura por minuto
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_read_requests
compute.googleapis.com/default
Es la métrica de cuota heredada 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
Es la métrica de cuota heredada para los métodos globales que crean, modifican o borran recursos de Compute Engine.		 compute.googleapis.com/global_writes
Solicitudes de mutación 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
Solicitudes de lectura por minuto, por región
compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests_per_region
compute.googleapis.com/default_per_region
Es la métrica de cuota heredada para los 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 compute.googleapis.com/writes_per_region
Solicitudes de mutación por minuto y por región
compute.googleapis.com/default_per_region
Es una métrica de cuota heredada para los 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 compute.googleapis.com/recommend_locations_per_region
Solicitudes de RegionInstances RecommendLocations por minuto por región
compute.googleapis.com/cache_invalidation_requests compute.googleapis.com/global_cache_invalidation_requests
Solicitudes de invalidación de caché por minuto

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

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

Crea un panel que use métricas simplificadas de cuotas de la API

Para crear un panel que use métricas simplificadas, 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. Haz clic en Crea un panel personalizado.

  4. En la barra de herramientas del panel, haz clic en Agregar widget y selecciona un tipo de widget (por ejemplo, Gráfico de líneas). Se abrirá la página Configurar widget.

  5. En la sección Seleccionar una métrica, haz lo siguiente:

    1. Selecciona Consumer Quota para el recurso.
    2. Selecciona Quota para la categoría de métrica.
    3. Selecciona Uso de cuota de frecuencia para la métrica y, luego, haz clic en Aplicar.

  6. En la sección Agregar filtro, usa el filtro quota_metric y selecciona la métrica de cuota de API simplificada correspondiente. Para encontrar la métrica simplificada, consulta Métricas de cuotas de API heredadas y simplificadas.

  7. Haz clic en Aplicar para agregar el widget al panel.

  8. En la barra de herramientas, haz clic en Guardar para guardar el panel.

Cómo modificar un panel que usa una métrica de cuota heredada

Para actualizar un panel que contiene una métrica heredada, 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. Abre el panel que contiene el gráfico que necesita una actualización.

  4. Haz clic en Editar.

  5. Busca el widget que quieres actualizar y edítalo.

  6. En la sección Selecciona una métrica, actualiza el filtro que contiene la métrica heredada:

    1. En el campo Filtro, selecciona quota_metric.
    2. En el campo Valor, actualiza el valor actual a la métrica de cuota de API simplificada correspondiente. Para encontrar el reemplazo de tu métrica heredada, consulta Métricas de cuota de la API heredadas y simplificadas. Por ejemplo, cambia compute.googleapis.com/read_requests a compute.googleapis.com/global_reads.

  7. Para aplicar los cambios, haz clic en Aplicar.

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

Para supervisar el uso de la API de Compute Engine en comparación con las métricas simplificadas de la API, agrega filtros para estas métricas en tus políticas de alertas de Cloud Monitoring.

Crea una política de alertas que use métricas de cuota de la API simplificadas

Para crear una política de alertas que use métricas simplificadas, 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.

  3. Haz clic en Crear política.

  4. En la sección Seleccionar una métrica, haz lo siguiente:

    1. Selecciona Consumer Quota para el recurso.
    2. Selecciona Quota para la categoría de métrica.
    3. Selecciona Uso de cuota de frecuencia para la métrica y, luego, haz clic en Aplicar.

  5. En la sección Agregar filtro, usa el filtro quota_metric y selecciona la métrica de cuota de API simplificada correspondiente. Para encontrar la métrica simplificada, consulta Métricas de cuotas de API heredadas y simplificadas.

  6. Configura la condición, los canales de notificaciones y la documentación según sea necesario.

  7. Haz clic en Guardar política.

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

Modifica una política de alertas que usa una métrica de cuota heredada

Para actualizar una política de alertas existente que usa una métrica de cuota heredada, 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. Para editar una política existente, haz clic en su nombre en Políticas.

  4. En la sección Selecciona una métrica, actualiza el filtro que contiene la métrica heredada:

    1. En el campo Filtro, selecciona quota_metric.
    2. En el campo Valor, actualiza el valor a la métrica de cuota de API simplificada correspondiente. Para encontrar el reemplazo de tu métrica heredada, consulta Métricas de cuota de la API heredadas y simplificadas. Por ejemplo, cambia compute.googleapis.com/read_requests a compute.googleapis.com/global_reads.

  5. Haz clic en Listo para guardar los cambios en el filtro.

  6. Haz clic en Guardar política.

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

Para actualizar una política de alertas basada en PromQL o un gráfico en un panel, usa el Editor de consultas y edita el filtro de consulta. Para obtener más información, consulta Usa el editor de código para PromQL.

Para actualizar tu consulta, reemplaza el nombre de la métrica heredada en el filtro quota_metric por el nombre de la métrica simplificada correspondiente.

Ejemplo 1:

Consulta que usa una métrica heredada:

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

Consulta modificada con la métrica simplificada:

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

Ejemplo 2:

Consulta que usa una métrica heredada:

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 con la métrica simplificada:

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