Usa métricas de cuota

En esta página, se describe cómo crear políticas y gráficos de alertas para supervisar o ver el uso de cuotas. Para obtener información general sobre las cuotas, incluida la información sobre las cuotas de asignación y las cuotas, consulta Trabaja con cuotas.

Para todas las políticas y gráficos de alertas de esta página, el recurso supervisado es consumer_quota. Las métricas de este recurso son un subconjunto de las métricas de serviceruntime.

  • Para obtener definiciones sobre los términos “indicador”, “delta” y “acumulativo”, consulta Tipos de métricas.
  • Si deseas obtener detalles sobre los campos que se usan para combinar series temporales, consulta Aligner y Reducer.

Información sobre las cuotas del consumidor

Para ver el uso de la cuota de una cuota específica, debes filtrar las series temporales por un valor específico de la etiqueta quota_metric. En el ejemplo en esta sección, se ilustra cómo identificar el valor correcto para esta etiqueta con el análisis de los datos de series temporales. A fin de determinar el valor de esta etiqueta para una cuota de API específica, puedes usar el siguiente procedimiento:

  1. En Google Cloud Console, ve a la página Cuotas de la administración de identidades y accesos:

    Ir a Cuotas

  2. Ubica la cuota de interés y, luego, haz clic en Todas las cuotas.

  3. Si un servicio admite métricas de cuotas, se mostrará un campo Métrica de cuota y se mostrará el valor de la etiqueta quota_metric para esta API. En la siguiente captura de pantalla, se muestra que el valor de la etiqueta quota_metric para la cuota de subredes de la API de Compute Engine es compute.googleapis.com/subnetworks:

    Ejemplo de una página de detalles de métricas de cuota.

    Si un servicio no admite métricas de cuotas, no se mostrará un campo Quota Metric (Métrica de cuota).

Ejemplo

El objetivo es crear un gráfico que muestre, por región, la cuota de almacenamiento en disco total de Compute Engine.

  1. En Google Cloud Console, selecciona Cloud Monitoring y, luego, el Explorador de métricas.

  2. Configura el Explorador de métricas para mostrar el uso de la cuota de asignación mediante la configuración del tipo de recurso en Cuota del consumidor (Consumer Quota) y la configuración del tipo de métrica en Uso de cuota de asignación (Allocation quota usage):

    Seleccionar cuota del consumidor.

    El gráfico muestra el uso de cuota de asignación como un gráfico de barras para el período de seis semanas. Cuando observas la leyenda, puedes ver que el gráfico muestra el uso de cuota para varios servicios.

    Si usas la API de Cloud Monitoring, el valor del filtro equivalente es el siguiente:

    metric.type="serviceruntime.googleapis.com/quota/allocation/usage" resource.type="consumer_quota"
    
  3. Para limitar la visualización al servicio de Compute Engine, agrega el filtro service = "compute.googleapis.com":

    Filtra la cuota del consumidor por servicio de procesamiento.

    Ahora, la tabla temporal muestra las series temporales para el uso de cuota asignado a las cuotas de Compute Engine. La leyenda muestra el valor de la etiqueta quota_metric para cada serie temporal que se muestra. Este valor identifica la cuota específica. Por ejemplo, compute.googleapis.com/disks_total_storage identifica que la serie temporal es para la cuota de almacenamiento total del disco de Compute Engine. En el gráfico, solo se muestra el uso de cuota de aquellas que tienen un uso registrado. Por ejemplo, si un proyecto no tiene recursos de Compute Engine, este filtro dará como resultado un gráfico sin datos.

    Si usas la API de Cloud Monitoring, el valor del filtro equivalente es el siguiente:

    metric.type="serviceruntime.googleapis.com/quota/allocation/usage" resource.type="consumer_quota" resource.label.service="compute.googleapis.com"
    
  4. Para crear un gráfico que muestre el uso total de la cuota de almacenamiento en disco total de Compute Engine, agrega el filtro quota_metric = "compute.googleapis.com/disks_total_storage":

    Filtra la cuota del consumidor por métrica de cuota.

    Si usas la API de Cloud Monitoring, el valor del filtro equivalente es el siguiente:

    metric.type="serviceruntime.googleapis.com/quota/allocation/usage" resource.type="consumer_quota" metric.label.quota_metric="compute.googleapis.com/disks_total_storage"
    
  5. En el gráfico anterior, se muestran series temporales para las regiones us-centra1 y us-east1, y para varias zonas, incluida la zona us-central1-a. Para mostrar solo el uso de cuota por región, agrega un filtro basado en la etiqueta location. En este ejemplo, en el que ambas regiones tienen el prefijo us- y terminan con 1, un filtro que usa una expresión regular, location =~"^us.*1$", funciona bien:

    Filtra por métrica de cuota y región.

Con las cuotas del consumidor, el valor de la etiqueta quota_metric identifica el servicio y el uso específico de la cuota que se supervisa. Puedes usar esa información para crear gráficos o políticas de alertas que supervisan una métrica de cuota específica.

Ejemplos de políticas de alertas

Una política de alertas es una recopilación de información de condiciones y notificaciones:

  • Una condición describe lo que se supervisa, cómo se deben combinar los datos de las series temporales para ese recurso y cuándo se debe generar una alerta. Una política de alertas debe especificar al menos una condición.
  • El canal de notificaciones especifica quién recibirá la notificación y cómo se le notificará cuando se produzca una alerta. Por ejemplo, puedes configurar la política de alertas para enviar un correo electrónico a una persona específica o a un grupo de personas.

En el resto de esta sección, cada subsección incluye una representación JSON de una política de alertas. Si la política se puede crear con Google Cloud Console, también se incluyen dos tablas:

  • En la primera tabla, se describe qué se supervisa y cómo se deben combinar los datos.
  • En la segunda tabla, se describe cuándo se debe generar una alerta.

Los valores de estas tablas se pueden usar para configurar una condición de política de alertas.

Alertas sobre la proporción entre el uso y el límite de la cuota

Puedes crear una política de alertas a fin de que te notifique si la proporción de uso de la cuota con respecto al límite de la cuota para cualquier servicio en tu proyecto de Google Cloud supera el 80%. Solo puedes crear este tipo de política con la API de Cloud Monitoring.

Usa la API de Cloud Monitoring

Puedes crear esta política de alertas con el método de la API alertPolicies.create. Puedes invocar la API de Cloud Monitoring directamente, con la herramienta de línea de comandos de gcloud o con las bibliotecas cliente. Para obtener más información, consulta Crea políticas.

Para obtener más información sobre cómo representar políticas de alertas en JSON o YAML, consulta Políticas de ejemplo.

Combinar los límites de las cuotas podría no ser significativo si las cuotas se aplican a los recursos en ubicaciones diferentes. Por lo tanto, deseas que estas políticas filtren o agrupen las series temporales por ubicación. Esta política de ejemplo, que supervisa la forma en que se calcula la proporción del uso de la cuota de la API de administración de identidades y accesos al límite de la cuota, no incluye el filtrado por ubicación porque esta cuota solo tiene una ubicación, global.


{
    "combiner": "OR",
    "conditions": [
      {
        "conditionThreshold": {
          "filter": "metric.type=\"serviceruntime.googleapis.com/quota/allocation/usage\" resource.type=\"consumer_quota\" resource.label.\"service\"=\"iam.googleapis.com\"",
          "aggregations": [
            {
              "alignmentPeriod": "86400s",
              "crossSeriesReducer": "REDUCE_SUM",
              "groupByFields": [
                "metric.label.quota_metric"
              ],
              "perSeriesAligner": "ALIGN_NEXT_OLDER"
            }
          ],
          "denominatorFilter": "metric.type=\"serviceruntime.googleapis.com/quota/limit\" resource.type=\"consumer_quota\" resource.label.\"service\"=\"iam.googleapis.com\"",
          "denominatorAggregations" : [
            {
              "alignmentPeriod": "86400s",
              "crossSeriesReducer": "REDUCE_SUM",
              "groupByFields": [
                "metric.label.quota_metric"
              ],
              "perSeriesAligner": "ALIGN_NEXT_OLDER"
            }
          ],
          "comparison": "COMPARISON_GT",
          "duration": "60s",
          "thresholdValue": 0.8,
          "trigger": {
            "count": 1
          }
        },
        "displayName": "Ratio quota usage for iam.googleapis.com by label.quota_metric [SUM]",
      }
    ],
    "displayName": "Ratio quota usage to limit",
    "enabled": true,
  }

Alertas de errores quota/exceeded

Puedes crear una política de alertas que te notifique si algún servicio del proyecto de Google Cloud informa un error de cuota excedida. Puedes crear este tipo de política con Google Cloud Console o mediante la API de Cloud Monitoring.

Usa Google Cloud Console

El resto del contenido de esta subsección corresponde al diálogo de condiciones de una política de alertas.

Completa el diálogo Destino con la configuración de la siguiente tabla. En esta configuración se especifica que deseas supervisar los datos de serie temporal de la métrica de serviceruntime /quota/exceeded para todos los servicios de tu proyecto de Google Cloud y que deseas agrupar los datos por el límite de cuota.

Panel Objetivo
Campo

Valor
Tipo de recurso Ingresa consumer_quota
Métrica Selecciona serviceruntime.googleapis.com/quota/exceeded
Filtro

Agregue un filtro para que el gráfico solo muestre datos del servicio que quiera supervisar. Por ejemplo, para supervisar el servicio de administración de identidades y accesos, agrega el filtro de follaje: service = iam.googleapis.com.

Cuando el campo de filtro está vacío, todos los datos de métricas disponibles se incluyen en el gráfico.

Agrupar por

Selecciona quota_metric.

Esta opción agrupa los datos mediante el tipo de nombre de quota_metric.

Agregador

Selecciona sum.

El campo de agregación se establece automáticamente en sum cuando se agrupan los datos. Esta configuración define cómo se combinan los datos en las series temporales individuales.

de Compromiso Selecciona 1 m
Agregación avanzada Alineador: count true

Esta métrica es de tipo GAUGE, lo que significa que cada dato de la serie temporal es una medición instantánea. El tipo de valor es BOOL. Un valor de true indica que se superó la cuota.

Para esta métrica, la configuración del alineador de count true y count es equivalente.

Completa el diálogo Configuration con la siguiente configuración. Esta configuración hace que la política de alertas cree una alerta si la cantidad de errores superados en la cuota excede el valor de 0 durante 1 m. Aquí se selecciona un valor de 0 porque los errores superados en la cuota son inesperados y por un indicador de que se debe aumentar una cuota o que se deben modificar un servicio para reducir las solicitudes a la API. Se recomienda usar un umbral más alto.

Campo del panel
Configuración

Valor
Condition triggers if Any time series violates
Condition is above
Threshold 0
For 1 millón

Usa la API de Cloud Monitoring

Puedes crear esta política de alertas con el método de la API alertPolicies.create. Puedes invocar la API de Cloud Monitoring directamente, con la herramienta de línea de comandos de gcloud o con las bibliotecas cliente. Para obtener más información, consulta Crea políticas.

Para obtener más información sobre cómo representar políticas de alertas en JSON o YAML, consulta Políticas de ejemplo.

A continuación, se muestra una representación de esta política de alertas en formato JSON.


{
    "combiner": "OR",
    "conditions": [
      {
        "conditionThreshold": {
          "aggregations": [
            {
              "alignmentPeriod": "60s",
              "crossSeriesReducer": "REDUCE_SUM",
              "groupByFields": [
                "metric.label.quota_metric"
              ],
              "perSeriesAligner": "ALIGN_COUNT_TRUE"
            }
          ],
          "comparison": "COMPARISON_GT",
          "duration": "60s",
          "filter": "metric.type=\"serviceruntime.googleapis.com/quota/exceeded\" resource.type=\"consumer_quota\"",
          "trigger": {
            "count": 1
          }
        },
        "displayName": "Quota exceeded error by label.quota_metric SUM",
      }
    ],
    "displayName": "Quota exceeded policy",
  }

Alertas sobre el quota/allocation/usage absoluto

Puedes crear una política de alertas a fin de que te notifique si el uso de la cuota de asignación para un servicio específico en tu proyecto de Google Cloud supera un umbral especificado por el usuario. Puedes crear este tipo de política con Google Cloud Console o mediante la API de Cloud Monitoring.

Usa Google Cloud Console

El resto del contenido de esta subsección corresponde al diálogo de condiciones de una política de alertas.

Completa el diálogo Destino con la configuración de la siguiente tabla. En esta configuración se especifica que deseas supervisar los datos de serie temporal de la métrica de serviceruntime /quota/allocation/usage para un servicio de tu proyecto de Google Cloud y que deseas agrupar los datos por el límite de cuota.

Panel Objetivo
Campo

Valor
Tipo de recurso Ingresa consumer_quota
Métrica Selecciona serviceruntime.googleapis.com/quota/allocation/usage
Filtro

Agregue un filtro para que el gráfico solo muestre datos del servicio que quiera supervisar. Por ejemplo, para supervisar el servicio de administración de identidades y accesos, agrega el filtro de follaje: service = iam.googleapis.com.

Cuando el campo de filtro está vacío, todos los datos de métricas disponibles se incluyen en el gráfico.

Agrupar por

Selecciona quota_metric.

Esta opción agrupa los datos mediante el tipo de nombre de quota_metric.

Agregador

Selecciona sum.

El campo de agregación se establece automáticamente en sum cuando se agrupan los datos. Esta configuración define cómo se combinan los datos en las series temporales individuales.

de Compromiso Selecciona 1440 m

El período coincide con el intervalo de muestreo para esta métrica.

Agregación avanzada Alineador: next older

El alineador se establece en next older para incluir el valor medido de esta métrica de GAUGE.

Completa el diálogo Configuration mediante la siguiente configuración. Esta configuración hace que la política de alertas cree una alerta si el valor de la serie temporal supera los 2.5 durante 1,440 m. El valor de 1,440 m coincide con el período de alineación. Se seleccionó el valor de 2.5 para este ejemplo, ya que es un poco más alto que el valor normal del sistema de prueba. Debes seleccionar el umbral en función del servicio que supervisas en combinación con el rango de valores esperado para la métrica.

Campo del panel
Configuración

Valor
Condition triggers if Any time series violates
Condition is above
Threshold 2.5
For 1,440 millones

Usa la API de Cloud Monitoring

Puedes crear esta política de alertas con el método de la API alertPolicies.create. Puedes invocar la API de Cloud Monitoring directamente, con la herramienta de línea de comandos de gcloud o con las bibliotecas cliente. Para obtener más información, consulta Crea políticas.

Para obtener más información sobre cómo representar políticas de alertas en JSON o YAML, consulta Políticas de ejemplo.

A continuación, se muestra una representación de esta política de alertas en formato JSON.


{
    "combiner": "OR",
    "conditions": [
      {
        "conditionThreshold": {
          "aggregations": [
            {
              "alignmentPeriod": "86400s",
              "crossSeriesReducer": "REDUCE_SUM",
              "groupByFields": [
                "metric.label.quota_metric"
              ],
              "perSeriesAligner": "ALIGN_NEXT_OLDER"
            }
          ],
          "comparison": "COMPARISON_GT",
          "duration": "84600s",
          "filter": "metric.type=\"serviceruntime.googleapis.com/quota/allocation/usage\" resource.type=\"consumer_quota\" resource.label.\"service\"=\"iam.googleapis.com\"",
          "thresholdValue": 2.5,
          "trigger": {
            "count": 1
          }
        },
        "displayName": "Allocation quota usage for iam.googleapis.com by label.quota_metric SUM",
      }
    ],
    "displayName": "Absolute quota usage policy",
  }

Ejemplos de gráficos

En los gráficos, se muestran datos de series temporales. Puedes usar el Explorador de métricas para crear un gráfico. Con el Explorador de métricas, puedes descartar el gráfico cuando ya no lo necesites o puedas guardarlo en un panel. En la vista del panel, puedes agregar un gráfico a este.

Para crear un gráfico, especifica qué deseas ver y cómo deseas ver esos datos. El resto de esta sección contiene las opciones de configuración que se pueden usar para crear gráficos. También puedes usar la configuración del cuadro de diálogo Destino de una política de alertas para crear un gráfico.

Uso máximo en intervalos para quota/allocation/usage

Para ver los datos de series temporales para la métrica serviceruntime quota/allocation/usage, para todos los servicios de tu proyecto de Google Cloud, donde los datos se agrupan por el nombre de la métrica de cuota y el valor máximo de la métrica en un intervalo de 25 horas, usa la siguiente configuración:

Panel Objetivo
Campo

Valor
Tipo de recurso Ingresa consumer_quota
Métrica Selecciona serviceruntime.googleapis.com/quota/allocation/usage
Filtro

Agregue un filtro para que el gráfico solo muestre datos del servicio que quiera supervisar. Por ejemplo, para supervisar el servicio de administración de identidades y accesos, agrega el filtro de flujo: service = iam.googleapis.com.

Cuando el campo de filtro está vacío, todos los datos de métricas disponibles se incluyen en el gráfico.

Agrupar por

Selecciona quota_metric.

Esta opción agrupa los datos mediante el tipo de nombre de quota_metric.

Agregador

Selecciona sum.

El campo de agregación se establece automáticamente en sum cuando se agrupan los datos. Esta configuración define cómo se combinan los datos en las series temporales individuales.

de Compromiso Selecciona 1500 m

El período, 25 horas, es un poco más largo que el intervalo de muestreo para esta métrica.

Agregación avanzada Alineador: max
Agregador secundario:sum

El alineador está configurado para mostrar el valor máximo de la métrica que se midió durante el período de alineación. El agregador secundario combina las series temporales para los diferentes servicios en una sola serie temporal.

Series temporales de quota/rate/net_usage

Para ver los datos de las series temporales de la métrica de serviceruntime quota/rate/net_usage, para todos los servicios de tu proyecto de Google Cloud, en los cuales los datos se agrupan por el nombre de la métrica de cuota y se muestra la frecuencia de uso, usa la siguiente configuración:

Panel Objetivo
Campo

Valor
Tipo de recurso Ingresa consumer_quota
Métrica Selecciona serviceruntime.googleapis.com/quota/rate/net_usage
Filtro

Agregue un filtro para que el gráfico solo muestre datos del servicio que quiera supervisar. Por ejemplo, para supervisar el servicio de administración de identidades y accesos, agrega el filtro de follaje: service = iam.googleapis.com.

Cuando el campo de filtro está vacío, todos los datos de métricas disponibles se incluyen en el gráfico.

Agrupar por

Selecciona quota_metric.

Esta opción agrupa los datos mediante el tipo de nombre de quota_metric.

Agregador

Selecciona sum.

El campo de agregación se establece automáticamente en sum cuando se agrupan los datos. Esta configuración define cómo se combinan los datos en las series temporales individuales.

de Compromiso Selecciona 1 m

El período de 1 minuto coincide con el intervalo de muestreo de esta métrica.

Agregación avanzada Alineador: rate

Si configuras el alineador con el valor de rate, los valores almacenados en la serie temporal de esta métrica DELTA se convierten en una nueva serie temporal que almacena los datos de tarifas. El eje Y del gráfico tiene las unidades de cuota por segundo.

Series temporales de quota/limit

Para ver los datos de las series temporales de la métrica de serviceruntime quota/limit, para todos los servicios de tu proyecto de Google Cloud, en el que los datos se agregan durante 25 horas, usa la siguiente configuración:

Panel Objetivo
Campo

Valor
Tipo de recurso Ingresa consumer_quota
Métrica Selecciona serviceruntime.googleapis.com/quota/limit
Filtro

Agregue un filtro para que el gráfico solo muestre datos del servicio que quiera supervisar. Por ejemplo, para supervisar el servicio de administración de identidades y accesos, agrega el filtro de follaje: service = iam.googleapis.com.

Cuando el campo de filtro está vacío, todos los datos de métricas disponibles se incluyen en el gráfico.

Agrupar por Dejar en blanco.
Agregador none
Período Selecciona 1500 m
Agregación avanzada Alineador: next older

El alineador se establece en next older para mostrar el valor medido de esta métrica de GAUGE. El período de alineación, 25 horas, es apenas mayor que el intervalo de muestreo de esta métrica.