Trabajar con cuotas

En Google Cloud, el uso de recursos está limitado por cuotas que los propietarios de proyectos deben cumplir. Estas cuotas restringen el uso que se puede hacer de los recursos en los proyectos de Google Cloud. Las cuotas se utilizan para limitar el uso de los recursos de dos formas distintas:

  • Cuotas de frecuencia; por ejemplo, las solicitudes a API diarias. Estas cuotas se restablecen transcurrido el tiempo especificado, como un minuto o un día.
  • Cuotas de asignación, como el número de máquinas virtuales o balanceadores de carga que utiliza tu proyecto. Aunque estas cuotas no se restablecen con el tiempo, debes liberarlas expresamente cuando ya no quieras usar el recurso; por ejemplo, eliminando cualquier clúster de GKE.

Las cuotas se aplican por diversos motivos; por ejemplo, para evitar que se produzcan picos de uso imprevistos y proteger así a la comunidad de usuarios de Google Cloud. Además, estas cuotas te ayudan a la hora de gestionar recursos. Por ejemplo, te permiten fijar tus propios límites de uso del servicio dentro de las cuotas que ofrece Google mientras desarrollas y pruebas tus aplicaciones. El límite de cada cuota viene expresado en recursos contabilizables, desde solicitudes diarias enviadas a una API al número de balanceadores de carga que utilice tu aplicación.

No todos los proyectos presentan las mismas cuotas para los mismos servicios. Si, por ejemplo, utilizas una cuenta de prueba gratuita en la plataforma, es posible que tengas una cuota muy limitada. Dispondrás de cuotas más elevadas para determinados servicios únicamente si habilitas la facturación en el proyecto en el que trabajes, y podrán ir aumentando conforme se amplíe el uso que haces de Google Cloud. Además, si lo necesitas, podrás solicitar un aumento de cuota y configurar la monitorización y las alertas en Cloud Monitoring. De esta forma, recibirás avisos si se producen comportamientos irregulares en el uso de las cuotas o si estas se agotan.

Es posible que las anulaciones de cuota que apliquen el propietario del servicio o del proyecto, o el administrador de la cuota, afecten a los límites correspondientes que se han establecido en tu cuenta. Consulta este artículo sobre el modelo de cuota de servicio para informarte sobre cómo se calculan los límites de cuota.

En esta página se detalla cómo trabajar con cuotas en tus proyectos; por ejemplo, para encontrar y modificar tus límites de cuota, solicitar un aumento de cuotas y monitorizar su uso. Encontrarás información sobre cómo visualizar otras métricas de uso de las API aquí.

Visualizar las cuotas

La consola de Google Cloud te permite ver los límites de cuota actuales de dos maneras:

  • A través de la página Cuotas, que ofrece una lista del uso y los límites de las cuotas correspondientes a todo tu proyecto

  • A través de la consola, que ofrece información sobre las cuotas relativa a una API en concreto e incluye el uso de los recursos en el tiempo

Puedes consultar los límites de cuota de manera programática a través de la API de Uso de Servicio.

Además, algunos servicios ofrecen acceso a información sobre las cuotas y el uso de recursos a través de una línea de comandos. Por ejemplo, Compute Engine permite acceder a información de las cuotas a través de gcloud compute.

Encontrarás información sobre cómo monitorizar el uso de cuotas y configurar alertas relacionadas con ellas en la sección que explica la monitorización de métricas de cuotas.

Ver las cuotas de todos los proyectos

Para consultar las cuotas (el uso y los límites de cuotas) de todos los recursos de tu proyecto, haz lo siguiente:

  1. Ve a la página Cuotas de la consola de Cloud en IAM y administración.
  2. Cuando lo hagas, se mostrará la página Cuotas del proyecto en cuestión, en la que se recoge un elemento de línea para cada tipo de cuota que hay disponible en cada servicio. Si quieres ver las cuotas de otro proyecto, selecciónalo en la lista de proyectos o crea uno.
  3. Puedes ordenar y filtrar los resultados para encontrar la información que necesitas:

    • Utiliza los filtros Servicio, Nombre del límite, Estado de la cuota, ID de servicio o Métrica, situados en la parte superior de la página, para acotar la lista según esos criterios.
    • De forma predeterminada, la lista se ordena por Estado de la cuota (los servicios de cada estado se muestran en orden alfabético) de manera que muestra en primera posición la cuota más utilizada para que te resulte más fácil ver qué límites están cerca de superarse. Para cambiar el orden y que se muestre la cuota menos utilizada en primer lugar, selecciona la flecha Estado de la cuota. También puedes organizar la lista por nombre del Servicio y por Nombre del límite en orden alfabético ascendente o descendente.
  4. Selecciona un elemento de la lista para ver los límites y el uso que tiene actualmente en el panel de cuotas:

    • El valor Límite es el límite actual de la cuota que Google establece de forma predeterminada. Si quieres definir un límite más bajo, consulta el procedimiento pertinente en la sección Limitar el uso. Si una cuota concreta no está sujeta a los límites predeterminados de Google, el límite se muestra con el estado Ilimitado. Los valores de uso que aparecen debajo del límite te indican cuánto te falta para superarlo.
    • El valor Uso actual tiene un significado ligeramente distinto en función del tipo de cuota. En cuanto a la cuota de asignación, tu uso actual es la parte del recurso que estás utilizando en la actualidad. En el caso de la cuota de frecuencia diaria, se trata del uso realizado hasta el momento en el día actual, y en el de la cuota de frecuencia por minuto o por 100 segundos, del uso medio durante las últimas 24 horas.
    • El valor Pico en 7 días muestra el pico de uso durante los últimos siete días.

    Para las cuotas regionales o por zonas, el panel de cuotas mostrará estos valores de cada región o zona.

Para las cuotas regionales o por zonas, puedes hacer clic en Todas las cuotas de un elemento concreto de la lista para ver una página de resumen que muestra la utilización por región o por zona. También puedes hacer clic en un nombre de servicio de la lista para consultar información detallada sobre las cuotas específicas de la API, como se describe más adelante.

Encontrarás más información sobre las cuotas de cada servicio y su significado en la documentación correspondiente. Por ejemplo, las cuotas de Compute Engine aparecen detalladas en la página Cuotas de recursos.

Cuotas específicas de una API

Para visualizar datos más detallados sobre cuotas de una API en concreto, incluido el uso en el tiempo, visita la página de cuotas de la API de la consola de Cloud. Dependiendo de la API en cuestión, estos límites podrían incluir solicitudes por día, por minuto y por minuto y usuario. Algunas API definen límites muy bajos hasta que la facturación se habilite en tu proyecto.

Para visualizar los límites actuales de una API en concreto, puedes hacer lo siguiente:

También puedes hacerlo de esta otra forma, si lo prefieres:

  1. Ve al panel de control de APIs y servicios de la consola de Cloud.
  2. En la lista de proyectos, selecciona o crea un proyecto.
  3. Haz clic en el nombre de la API que te interese.
  4. Haz clic en Cuotas.

Los nombres de las cuotas de la API que hayas elegido se muestran en la página Cuotas. Puedes ampliar cada cuota para consultar el uso detallado a lo largo del tiempo, así como tu límite actual. De manera predeterminada, los límites que se muestran son los que impone Google; si quieres definir un límite más bajo, consulta el procedimiento pertinente en la sección Limitar el uso. Si una cuota concreta no está sujeta a los límites predeterminados de Google, el límite se muestra con el estado Ilimitado.

No todas las cuotas se muestran en la página de cuotas específica de una API. Por ejemplo, las solicitudes destinadas a la API de Compute Engine tienen una página de cuotas específica de la API, pero en ella no se recoge el uso de recursos de computación de Compute Engine (cuota de asignación). Además, si utilizas el servicio en varias ubicaciones, la página de cuotas específica de la API no muestra límites de cuotas regionales o zonales ni su uso. Para acceder a una lista exhaustiva de las cuotas de tu proyecto (donde también puedes filtrar los resultados por ubicación), ve a la página Cuotas del proyecto en cuestión.

Gestionar las cuotas con la consola de Cloud

En función del uso que hagas de los recursos, puedes ajustar al alza o a la baja los límites de cuotas de tu proyecto. En esta sección se describe cómo cambiar los límites de cuota.

Solicitar un aumento de cuota

Podrás solicitar el cambio de cuota de la mayoría de los servicios facturables que tengan un límite de cuota de la siguiente manera:

  1. En la página Cuotas, utiliza las casillas para seleccionar una o varias cuotas que editar y, a continuación, haz clic en EDITAR CUOTAS. Para poder hacer clic en las casillas, la facturación debe estar habilitada en el proyecto.
  2. En el panel Editar cuotas de la derecha, rellena los campos Nombre, Correo electrónico y Teléfono del formulario con tus datos y, a continuación, haz clic en Siguiente.
  3. En el mismo panel, selecciona el servicio en cuestión para desplegar la vista y, a continuación, modifica sus cuotas según el límite que quieras solicitar. Por último, haz clic en Listo.
  4. Repite este procedimiento para modificar las cuotas de todos los servicios seleccionados.
    • Los servicios que muestran un icono de alerta () no se han modificado aún o tienen algún campo vacío.
    • Si quieres añadir más cuotas para editarlas, selecciónalas en la lista situada a la izquierda.
    • Haz clic en el icono de eliminación () para quitar servicios del panel Editar cuotas.
  5. Cuando hayas terminado de modificar las cuotas, haz clic en Enviar solicitud.

Las solicitudes de cuotas de Google Cloud se suelen procesar con rapidez; concretamente, en un plazo de 2 días laborables. El equipo de asistencia de Google Cloud te enviará una confirmación por correo electrónico. Si necesitas más asistencia, responde a ese correo. Sin embargo, se puede tardar más en aprobar los grandes aumentos de cuotas.

Limitar el uso

Quizás te interese limitar el uso de un recurso en concreto definiendo tus propios límites de cuotas. Por ejemplo, puedes fijar límites de solicitudes diarias para evitar cobros por sobrepasar los límites de uso gratuito. La forma más sencilla de limitar las cuotas es modificar los límites en la página de cuotas específica de la API.

  1. Ve a la página de cuotas de la consola de Cloud correspondiente a la API cuyo uso quieras limitar.
  2. Cuando estés en la línea de la cuota que quieras cambiar, haz clic en el icono de edición () y, a continuación, escribe el total que prefieras para la cuota, respetando el límite que Google haya especificado.
  3. Haz clic en Guardar para guardar los cambios.

Si quieres limitar una cuota que no aparece en esta página o fijar un límite superior al máximo, debes modificar tus límites siguiendo el proceso de edición de cuotas que se describe en la sección Solicitar un aumento de cuota.

Gestionar las cuotas a través de la API de Uso de Servicio

Con la API de Uso de Servicio, puedes limitar el uso de cuota y consultar tus límites de cuota (siempre y cuando pertenezcan a APIs y servicios de Google Cloud gestionados a través de Uso de Servicio). Si necesitas más información sobre Uso de Servicio, consulta los siguientes recursos:

La API de Uso de Servicio no puede usarse para solicitar un aumento de cuota. Para ello, debes usar la consola de Cloud.

Monitorizar y recibir alertas sobre métricas de cuotas

Además de consultar información básica de las cuotas en la consola de Cloud, en Google Cloud puedes monitorizar el uso, los límites y los errores de cuotas con mayor profundidad mediante la API y la interfaz de Cloud Monitoring, así como visualizar métricas de las cuotas mediante el explorador de métricas. Estas métricas sirven para crear paneles de control y alertas personalizados que te permitan monitorizar el uso de cuotas en el tiempo y recibir alertas cuando, por ejemplo, estés a punto de alcanzar el límite de una cuota.

Cloud Monitoring admite una gama amplia de métricas, que podrás combinar con filtros y agregaciones para obtener perspectivas nuevas y útiles del uso que haces de las cuotas. Por ejemplo, puedes combinar una métrica del número de usos de una cuota de asignación con un filtro quota_metric en nombres de TPU de Cloud.

Para visualizar las métricas de un recurso monitorizado con el explorador de métricas, haz lo siguiente:

  1. En la consola de Google Cloud, ve a Monitoring, o bien haz clic en el siguiente botón:
    Ir a Monitoring.
  2. En el panel de navegación de Monitoring, haz clic en  Explorador de métricas.
  3. Comprueba que Metric (Métrica) sea la pestaña seleccionada.
  4. Haz clic en el cuadro Find resource type and metric (Buscar tipo de recurso y métrica) y, a continuación, selecciona los nombres del recurso y de la métrica en el menú o escríbelos. Utiliza la siguiente información para rellenar los campos de este cuadro de texto:
    1. En Resource (Recurso), selecciona o introduce Consumer Quota (Cuota de consumidor).
    2. En Metric (Métrica), selecciona o introduce Allocation quota usage (Uso de la cuota de asignación) para monitorizar ese tipo de cuota. Si quieres monitorizar la cuota de frecuencia, selecciona o introduce Rate quota usage (Uso de la cuota de frecuencia).
  5. Utiliza los menús Filter (Filtrar), Group By (Agrupar por) y Aggregator (Agregador) para modificar cómo se muestran los datos. Por ejemplo, puedes agrupar por etiquetas de recurso o métrica. Para obtener más información, consulta cómo seleccionar métricas.

Del mismo modo, si quieres comprobar límites de cuotas o errores de cuotas superadas, selecciona Consumer Quota (Cuota de consumidor) como tipo de recurso y, a continuación, selecciona Quota limit (Límite de cuota) o Quota exceeded error (Error de cuota superada).

Una vez que hayas encontrado la información de uso de cuotas que buscabas, otra utilidad de Cloud Monitoring es crear paneles de control y alertas personalizados que te ayudan a seguir monitorizando la aplicación y a garantizar su solidez. Encontrarás información sobre cómo hacer esto en las páginas siguientes:

Consulta el artículo sobre cómo usar métricas de cuotas de la documentación de Cloud Monitoring para obtener más información y ver ejemplos comunes de políticas de alertas específicas para cuotas.

Encontrarás información detallada sobre las métricas de cuotas en la guía de referencia de Cloud Monitoring.

Errores de cuota

Si tu proyecto supera una cuota determinada durante el uso de un servicio, la plataforma suele devolver un error.

Por lo general, Google Cloud devuelve un código de error HTTP 429 si utilizas HTTP/REST para acceder al servicio o un código de error ResourceExhausted si utilizas gRPC. La forma en que se te muestra este error depende del servicio.

A través de Cloud Monitoring, puedes identificar la cuota relacionada con el error y, posteriormente, crear alertas personalizadas que se activen al recibir errores de cuotas, tal y como se describe en el apartado sobre cómo monitorizar las métricas de cuotas.