Configura una métrica de destino

En esta página, se describe cómo usar la herramienta de selección de métricas a fin de especificar una métrica de destino para una política de alertas. El gráfico al lado de la región de Destino te brinda unos comentarios visuales sobre los datos capturados por el destino.

La región de destino usa el mismo selector de métricas que se usa en el Explorador de métricas y para crear gráficos. Si ya estás familiarizado con él, puedes omitir esta página.

Selecciona una métrica

Para seleccionar una métrica, usa el campo Buscar tipo de recurso y métrica a fin de elegir un tipo de recurso y un tipo de métrica. Puedes especificarlos en cualquier orden. Para empezar, haz clic en el campo. Esto muestra una o dos listas, según cualquier selección previa. Las listas se indican mediante encabezados, Tipos de recursos (Resource types) y Métricas (Metrics), como se ve en la siguiente captura de pantalla:

Listas de búsqueda para seleccionar métricas y recursos

Puedes seleccionar una entrada de las siguientes dos maneras:

  • Selecciona las entradas de las listas.

  • Ingresa un filtro de métrica. Para ingresar un filtro de métrica, sigue estos pasos:

    1. Junto a Buscar tipo de recurso y métrica, haz clic en Ayuda .
    2. Haz clic en Modo de filtro directo en el panel de ayuda.

      Cuando el Modo de filtro directo está habilitado, la opción Buscar tipo de recurso y métrica se reemplaza por un cuadro de texto editable con el encabezado Tipo de recurso, métrica y filtro (Resource type, metric, and filter):

      Se muestra el modo de filtro directo.

      Si realizaste selecciones para un tipo de recurso, una métrica o un filtro antes de seleccionar el Modo de filtro directo, esa configuración se usará para completar previamente el cuadro de texto Tipo de recurso, métrica y filtro (Resource type, metric, and filter).

    3. Ingresa un filtro de métrica en el cuadro de texto Tipo de recurso, métrica y filtro (Resource type, metric, and filter). El filtro debe incluir un tipo de métrica y de recurso. También puedes incluir filtros de etiquetas. Para obtener información sobre la gramática del filtro, consulta Filtros de supervisión.

      Por ejemplo, para mostrar las entradas de registro de todas las instancias de VM de Google Cloud en la zona us-east1-b, ingresa lo siguiente:

      metric.type="logging.googleapis.com/log_entry_count" resource.type="gce_instance" resource.label."zone"="us-east1-b"
      

      Si usaste el modo de filtro directo para configurar gráficos o políticas de alertas y no hay datos disponibles, en el gráfico se mostrará un mensaje de error. El mensaje de error exacto depende del filtro que ingresaste. Por ejemplo, un mensaje típico es Chart definition invalid. Es posible que también veas el mensaje No data is available for the selected time frame.

Si te desplazas sobre un elemento en cualquiera de las listas, aparece información sobre la herramienta que muestra el contenido en el descriptor del elemento. Para obtener información sobre los descriptores de tipos de métrica o recursos supervisados, consulta la lista de métricas o la lista de recursos supervisados.

Cuando se selecciona al menos un tipo de recurso y un par de métricas, el gráfico muestra todas las series temporales disponibles y los elementos adicionales aparecen debajo de la métrica específica en la pestaña Métrica (Metric). En la siguiente captura de pantalla, se muestra la pestaña Métrica después de que se especificó una métrica:

Se muestran las opciones de selección adicionales.

Filtros

Puedes reducir la cantidad de datos que se representarán si especificas criterios de filtro, aplicas agregación o usas el modo de valores atípicos. Los filtros garantizan que solo se usen series temporales que cumplan con un conjunto de criterios. Si aplicas filtros, habrá menos líneas en el gráfico y esto puede mejorar su rendimiento.

Si proporcionas varios criterios de filtrado, el gráfico correspondiente solo mostrará las series temporales que cumplan con todos los criterios, un AND lógico.

En Google Cloud Console, para agregar un filtro, haz clic en el campo Filtro. Esto abre un panel que contiene listas de los criterios por los que puedes filtrar. Por ejemplo, puedes filtrar por grupo de recursos, por nombre, por etiqueta de recurso, por zona y por etiqueta de métrica.

En la siguiente captura de pantalla, se muestran las etiquetas de filtro comunes para una métrica específica:

Listas de etiquetas de filtro ya propagadas

Puedes seleccionar de las listas o escribir para buscar coincidencias. Además, puedes crear filtros para los datos que aún no han aparecido, estos criterios de filtro no aparecerán en la lista de selección, pero puedes especificar manualmente los filtros que sabes que serán válidos en el futuro.

Después de elegir una etiqueta en la cual filtrar, debes especificar el resto del filtro: Un valor o rango de valores y una comparación.

Por ejemplo, en la siguiente captura de pantalla, se muestra un filtro en la etiqueta de recurso zone. El campo Filtro (Filter) admite un par de operadores de comparación para la igualdad, = y =~, y otro correspondiente a la desigualdad, != y !=~. El segundo elemento de cada par toma una expresión regular como un valor. La igualdad simple, =, es el valor predeterminado.

Lista de comparadores de filtros.

Debajo de la lista de operadores de comparación hay una lista de los valores disponibles. La siguiente captura de pantalla muestra los nombres de las zonas en el proyecto:

Ejemplo de algunos valores de filtro prepropagados.

Para el campo Valor, puedes seleccionar uno de los elementos en la lista desplegable o puedes ingresar una expresión que coincida con varios elementos:

  • Si usas una comparación directa, = o !=, puedes crear una string de filtro como starts_with. Por ejemplo, la string de filtro starts_with("us-central") coincide con cualquier zona us-central:

    Ejemplo de cómo usar una string de filtro.

    Consulta Filtros de supervisión para obtener más información sobre las strings de filtro.

  • Si seleccionas =~ o !=~, ingresa una expresión regular RE2 como valor. Por ejemplo, la expresión regular us-central1-.* coincide con cualquier zona us-central1:

    Ejemplo de filtrado con expresiones regulares

    La expresión regular ^us.*.a$ coincide con cualquier zona de EE.UU. que termine con “a”:

    Ejemplo de filtrado de zonas mediante el uso de expresiones regulares.

Puedes especificar varios criterios de filtro y usar la misma etiqueta varias veces. Esto te permite especificar un filtro para un rango de valores. Para agregar filtros adicionales, haz clic en Agregar un filtro (Add a filter) cerca de la parte inferior del campo de filtro. Por el momento, se deben cumplir todos los criterios de filtro, ya que constituyen un AND lógico. Por ejemplo, puedes usar las strings de filtro starts_with y ends_with para mostrar solo las zonas “a” en EE.UU.:

Ejemplo mediante varios filtros

Si se utilizan los filtros zone="starts_with("asia-east1")" o zone=~"asia-east1.*" en su lugar, solo se mostrarán las series temporales con los datos de una de las zonas asia-east1:

Se muestra una serie temporal filtrada

Agregación

Después de seleccionar las series temporales, el siguiente paso es especificar las opciones de agregación. La agregación consiste en alinear las series temporales individuales y, luego, combinar las series temporales alineadas. Para obtener una explicación detallada de la agregación, consulta Filtrado y agregación: manipula series temporales.

Alinea datos

La alineación es el proceso de convertir los datos de la serie temporal recibidos por Monitoring en una nueva serie temporal con datos extraídos por un período fijo. El proceso de alineación consiste en recopilar todos los datos recibidos en un intervalo de longitud fija, aplicar una función para combinar esos datos y asignar una marca de tiempo al resultado. Esa función de combinación podría calcular el promedio de todas las muestras o podría extraer el máximo de todas las muestras. Para obtener un análisis general de alineación, consulta Alineación: regularización dentro de la serie.

Cuando creas una condición en una política de alertas, debes especificar los parámetros de alineación. Si usas Google Cloud Console, después de seleccionar el tipo de recurso y la métrica en la condición de alerta, varios campos adicionales y un botón titulado Mostrar opciones avanzadas son exhibidas:

Visualización del campo de período.

Período: El período es un intervalo retrospectivo desde un punto en el tiempo específico. Por ejemplo, si el período es de cinco minutos, a la 1:00 p.m., las muestras recibidas entre las 12:55 p.m. y la 1:00 p.m. están alineadas. A la 1:01 p.m., las muestras recibidas entre las 12:56 p.m. y la 1:01 p.m. están alineadas. En el contexto de las políticas de alertas, el período de alineación se puede ver como una ventana deslizante que observa el pasado. Para ver un análisis más completo sobre este campo, consulta El período de alineación y la duración.

Para ver las opciones de agregación restantes, haz clic en Mostrar opciones avanzadas:

Visualización de las opciones avanzadas.

Alineador: El campo del alineador especifica el atributo que se usa para combinar todos los datos en un período de alineación. Para obtener más información sobre los alineadores disponibles, consulta Aligner en la referencia de la API. Algunos alineadores ordenan los datos y los convierten de una categoría o tipo de métrica a otro. Para obtener una explicación detallada, consulta Clases, tipos y conversiones.

Combina series temporales

Puedes reducir la cantidad de datos que se muestran de una métrica si combinas diferentes series temporales. Para combinar varias series temporales, por lo general, debes especificar una agrupación y una función. La agrupación se realiza mediante valores de etiqueta. La función define cómo se combinan todas las series temporales de un grupo en una nueva serie temporal.

Para agregar una agrupación, haz clic en el texto en el cuadro de texto Agrupar por y, luego, elige una opción del menú. El menú se construye de forma dinámica según los datos de series temporales para el recurso y la métrica que seleccionaste. La agrupación y el filtrado usan el mismo conjunto de etiquetas.

Cuando agregas la primera etiqueta, ocurre lo siguiente:

  • Se selecciona un agregador. La función seleccionada está determinada por el tipo de datos que se muestran. Sin embargo, puedes cambiar esta función.
  • El agregador determina cómo se combinan las series temporales que tienen el mismo valor de etiqueta en una sola serie temporal.
  • El gráfico muestra una serie temporal para cada valor de la etiqueta que aparece en el cuadro de texto Agrupar por.

Si agrupas por varias etiquetas, el agregador combina las series temporales que tienen el mismo valor para las etiquetas especificadas.

Si no especificas una opción de agrupación y especificas un agregador, esa función se aplica a todas las series temporales seleccionadas y genera una sola serie temporal.

En la siguiente captura de pantalla, se muestra una agrupación por user_labels.version con el agregador en el valor predeterminado de sum:

Ejemplo de configuración de agrupación

Esta selección da como resultado una serie temporal para cada valor de user_labels.version. Los datos de cada serie temporal se calculan a partir de la suma de todos los valores de una serie temporal individual de una versión específica:

Se muestran las series temporales agrupadas por user_labels.version

Puedes agrupar por varias etiquetas. Cuando tienes varias opciones de agrupación, las series temporales se agrupan por cada combinación de valores de etiqueta, y el agregador se aplica a cada grupo. En el gráfico resultante, se muestra una serie temporal para cada combinación de valores de etiqueta. No importa el orden en que especifiques las etiquetas.

Por ejemplo, en la siguiente captura de pantalla, se muestra la agrupación por user_labels.version y por system_labels.machine_image:

Se muestran las series temporales agrupadas por imagen de máquina y versión

Como se ilustra, si agrupas mediante ambas etiquetas, obtienes una serie temporal para cada par de valores. El hecho de que obtengas una serie temporal por cada combinación de etiquetas significa que esta técnica puede crear fácilmente más datos de los que puedes utilizar en un solo gráfico.

Cuando especificas la agrupación o si seleccionas un agregador, la serie temporal representada solo contiene las etiquetas obligatorias, como el identificador del proyecto, y las etiquetas que especifica la agrupación.

Para quitar un grupo por condición, debes hacer lo siguiente:

  1. Quita las etiquetas agrupadas.
  2. Configura el agregador como none.

Agregación secundaria

Cuando tienes varias series temporales que ya representan agregaciones, como los ejemplos en los que se ilustra la opción Agrupar por, puedes agregarlas mediante la selección de un Agregador secundario (Secondary Aggregator):

Campo para la agregación secundaria

La agregación secundaria reduce todas las series temporales del gráfico a una sola serie temporal.

Plantilla de leyenda

En Cloud Console, si expandes las opciones de agregación haciendo clic en Mostrar opciones avanzadas, además de mostrar los campos para el alineador, el período de alineación y el agregador secundario, se muestra un campo de Plantilla de leyenda.

Se muestra la ubicación del campo de la plantilla de leyenda.

El campo Plantilla de leyenda te permite personalizar una descripción de la serie temporal de tu gráfico. Estas descripciones aparecen en la tarjeta emergente del gráfico y en la leyenda del gráfico en la columna Nombre.

De forma predeterminada, las descripciones de a leyenda se crean para ti a partir de los valores de las diferentes etiquetas de tu serie temporal. Debido a que el sistema selecciona las etiquetas, es posible que los resultados no te resulten útiles. Puedes usar este campo a fin de crear una plantilla para las descripciones.

El campo Plantilla de leyenda (Legend Template) acepta lo siguiente:

  • Filtros que hacen referencia a etiquetas en tus series temporales. A fin de ver todos los filtros disponibles para tus series temporales, haz clic en Agregar un filtro. Después de seleccionar un filtro, se agrega al cuadro de texto y se representa como una expresión como ${resource.labels.zone}. Cuando se evalúa la expresión, se extrae el valor de las etiquetas de una serie temporal y se inserta en la leyenda.

  • Texto sin formato Si solo proporcionas texto, las descripciones de la serie temporal en el gráfico serán idénticas. Sin embargo, puedes combinar texto y filtros.

Por ejemplo, en la siguiente captura de pantalla, se muestra una plantilla que consta de una string de texto sin formato y la expresión de filtro ${resource.labels.zone}:

Una plantilla para una descripción simple

En la leyenda del gráfico, los valores generados a partir de la plantilla aparecen en una columna con el encabezado Nombre (Name) y en la tarjeta emergente:

Descripciones generadas a partir de una plantilla

Puedes crear plantillas que usen varias strings y filtros, pero el espacio de visualización disponible en la tarjeta emergente es limitado.