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 consola de Google Cloud .

    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 milioperaciones.
  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 tu cuota, sigue estos pasos:

  1. En la consola de Google Cloud , ve a Monitoring.
    Ir a Monitoring
  2. Si el Explorador de métricas se muestra 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 restringir la búsqueda.
  5. Para ver la cuota de solicitudes simultáneas de Data Boost, sigue estos pasos:
    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 milioperaciones, sigue estos pasos:

    1. En la lista, selecciona Cuota del consumidor > Cuota > Uso de la 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 Visualización, en Tipo de widget, selecciona Gráfico de barras apiladas.

Supervisa los errores y límites de 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 milisegundos de operaciones 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.

Establece 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 en particular. Para hacerlo, sigue estos pasos:

  1. Sigue las instrucciones que se indican en Crea políticas de alertas de umbral 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 limitar la búsqueda.
  3. Para establecer una alerta sobre el uso de la cuota de solicitudes simultáneas de Data Boost, haz lo siguiente:

    1. En la lista Selecciona una métrica, elige 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 deseas recibir una notificación cuando la cantidad de solicitudes simultáneas alcance el 80% del máximo, ingresa 160 en el campo Valor de umbral.

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

    1. En la lista Selecciona una métrica, elige Cuota del consumidor > Cuota > Uso de la 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 1000000 y deseas recibir una notificación cuando las milioperaciones de solicitud alcancen el 80% del límite, ingresa 800000 en el campo Valor de umbral.

Cómo controlar los errores de cuota

Si la tasa de errores de cuota excedida es alta, cuando uses 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 mayor. Es posible que tu carga de trabajo esté limitada por la cuota de solicitudes simultáneas de Data Boost o por la cuota de milioperaciones. Es posible que debas aumentar tu cuota de milioperaciones después de aumentar la cuota de solicitudes simultáneas.

Bloquea a una principal para que no consuma recursos de Data Boost

Si una principal excede de forma constante la cantidad de recursos de Data Boost que se espera que consuma, puedes bloquearla para que no use los recursos de Data Boost revocando el permiso spanner.databases.useDataBoost de Identity and Access Management (IAM) de la 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?