Supervisa y administra el uso de la cuota de Data Boost

Spanner Data Boost está sujeto a cuotas que limitan la cantidad de llamadas ExecuteStreamingSQL y StreamingRead simultáneas que se ejecutan por proyecto y por región. Cuando la cantidad de solicitudes simultáneas supera la cuota, las solicitudes fallan con errores RESOURCE_EXHAUSTED.

Comprueba tu cuota

Para verificar la cuota de simultaneidad en tu proyecto, sigue estos pasos:

  1. Ve a la página Cuotas en la Google Cloud consola.

    Ir a Cuotas

  2. En el campo Filtro, ingresa databoost. En la lista, selecciona una de las siguientes opciones:

    • DataBoostQuotaPerProjectPerRegion para ver la cuota de solicitudes simultáneas de Data Boost.
    • DataBoostMilliQuotaPerProjectPerRegion para ver la cuota de solicitudes simultáneas de Data Boost en operaciones de milisegundos.
  3. En la tabla resultante, busca tu región y consulta el límite para esa región.

Supervisa el uso de la cuota

Para supervisar el uso de la cuota, sigue estos pasos:

  1. En la Google Cloud consola, ve a Monitoring.
    Ir a Monitoring
  2. Si el Explorador de métricas aparece en el menú de navegación, selecciónalo. De lo contrario, haz clic en Recursos y, luego, selecciona Explorador de métricas.
  3. En la parte superior de la página, selecciona un intervalo de tiempo.
  4. En la lista desplegable Métrica, en el campo Filtrar por nombre de recurso o métrica , ingresa consumer y presiona Enter para acotar la búsqueda.
  5. Para ver la cuota de solicitudes simultáneas de Data Boost, haz lo siguiente:
    1. En la lista, selecciona Cuota del consumidor > Cuota > Uso de cuota simultánea y, luego, haz clic en Aplicar.
    2. Haz clic en + AGREGAR FILTRO para crear un filtro.
    3. En la lista desplegable Etiqueta 1, selecciona quota_metric.
    4. En el campo de texto Valor 1, ingresa o selecciona spanner.googleapis.com/data_boost_quota.
  6. Para ver la cuota de solicitudes simultáneas de Data Boost en operaciones de milisegundos, haz lo siguiente:

    1. En la lista, selecciona Cuota del consumidor > Cuota > Uso de cuota de frecuencia y, luego, haz clic en Aplicar.
    2. Haz clic en + AGREGAR FILTRO para crear un filtro.
    3. En la lista desplegable Etiqueta 1, selecciona quota_metric.
    4. En el campo de texto Valor 1, ingresa o selecciona spanner.googleapis.com/data_boost_milli_quota.

    El Explorador de métricas muestra un gráfico de líneas del uso de la cuota por región.

  7. Opcional: En Mostrar, para Tipo de widget, selecciona Gráfico de barras apiladas.

Supervisa los errores y los límites de la cuota

Para supervisar los errores de cuota debido a la cuota de solicitudes simultáneas de Data Boost, sigue estos pasos:

  1. En el Explorador de métricas, selecciona la métrica Cuota del consumidor > Cuota > Error de cuota excedida.

  2. Agrega un filtro para quota_metric igual a spanner.googleapis.com/data_boost_quota.

Para supervisar el límite de la cuota de operaciones de milisegundos de solicitudes simultáneas de Data Boost, sigue estos pasos:

  1. En el Explorador de métricas, selecciona la métrica Cuota del consumidor > Cuota > Límite de cuota.

  2. Agrega un filtro para quota_metric igual a spanner.googleapis.com/data_boost_milli_quota.

Configura una alerta para el uso de Data Boost

Puedes crear una política de alertas que te notifique cuando la cantidad de consultas particionadas simultáneas que solicitan Data Boost (llamadas ExecuteStreamingSQL y StreamingRead simultáneas) por proyecto y por región supere un umbral determinado. Para ello, sigue estos pasos:

  1. Sigue las instrucciones que se indican en Crea políticas de alertas de límite de métrica.
  2. En la lista desplegable Seleccionar una métrica, en el campo Filtrar por nombre de recurso o métrica, ingresa consumer y presiona Enter para acotar la búsqueda.
  3. Para configurar una alerta sobre el uso de la cuota de solicitudes simultáneas de Data Boost, haz lo siguiente:

    1. En la lista Seleccionar una métrica , selecciona Cuota del consumidor > Cuota > Uso de cuota simultánea y, luego, haz clic en Aplicar.
    2. En la sección Agregar filtros, haz clic en Agregar un filtro para crear un filtro.
    3. En la lista desplegable Filtro, selecciona quota_metric.
    4. En el campo de texto Valor, ingresa o selecciona spanner.googleapis.com/data_boost_quota y haz clic en Listo.
    5. Continúa con la creación de una política de alertas y establece el umbral en un porcentaje de la cuota.

    Por ejemplo, si la cuota predeterminada es 200 y quieres recibir una notificación cuando la cantidad de solicitudes simultáneas alcance el 80% del máximo, ingresa 160 en el campo Valor del umbral.

  4. Para configurar una alerta sobre el uso de la cuota de operaciones de milisegundos de solicitudes simultáneas de Data Boost, haz lo siguiente:

    1. En la lista Seleccionar una métrica , selecciona Cuota del consumidor > Cuota > Uso de cuota de frecuencia y, luego, haz clic en Aplicar.
    2. En la sección Agregar filtros, haz clic en Agregar un filtro para crear un filtro.
    3. En la lista desplegable Filtro, selecciona quota_metric.
    4. En el campo de texto Valor, ingresa o selecciona spanner.googleapis.com/data_boost_milli_quota y haz clic en Listo.
    5. Continúa con la creación de una política de alertas y establece el umbral en un porcentaje de la cuota.

    Por ejemplo, si la cuota predeterminada es 1,000,000 y quieres recibir una notificación cuando las operaciones de milisegundos de la solicitud alcancen el 80% del límite, ingresa 800,000 en el campo Valor del umbral.

Controla los errores de cuota

Si la tasa de errores de cuota excedida es alta cuando usas Dataflow con Data Boost, te recomendamos que ajustes la cantidad máxima de trabajadores en tu trabajo de Dataflow para evitar exceder la cuota de Data Boost. También puedes solicitar una cuota más alta. Es posible que tu carga de trabajo esté limitada por la cuota de solicitudes simultáneas de Data Boost o por la cuota de operaciones de milisegundos. Es posible que debas aumentar tu cuota de operaciones de milisegundos después de aumentar la cuota de solicitudes simultáneas.

Impide que un principal consuma recursos de Data Boost

Si un principal excede constantemente la cantidad de recursos de Data Boost que se puede esperar que consuma de manera razonable, puedes impedir que el principal use los recursos de Data Boost revocando el permiso spanner.databases.useDataBoost de Identity and Access Management (IAM) del principal. Puedes automatizar la revocación del permiso configurando el canal de notificaciones de una alerta como un webhook que invoca una Cloud Function. Para obtener más información, consulta los siguientes temas:

¿Qué sigue?