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 que está junto a 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 las selecciones previas. 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 la etiqueta 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 de 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 de 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étricas 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 especificada 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 mostrados de una métrica si especificas criterios de filtro, de modo que solo se usen series temporales que cumplan con un conjunto de criterios. Los filtros quitan algunos datos del gráfico mediante la exclusión de las series temporales que no cumplen con los criterios de filtro. De esta forma, se reduce la cantidad de líneas del gráfico que muestra esta métrica, lo que puede mejorar el rendimiento del gráfico.

Puedes proporcionar varios criterios de filtro. En el gráfico correspondiente, solo se muestran las series temporales que cumplen con todos los criterios, un AND lógico.

Cuando haces clic en el campo Filtro, aparece un panel que contiene listas de criterios para filtrar. En términos generales, puedes filtrar por grupo de recursos, nombre, etiqueta de recurso y etiqueta de métrica.

La siguiente captura de pantalla muestra las etiquetas de filtro conocidas para un proyecto:

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 aparecieron; estos criterios de filtro no aparecerán en la lista de selección, pero puedes especificar manualmente filtros que sabes que serán válidos en el futuro.

Después de elegir una etiqueta para 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 de igualdad, = y =~, y otro par correspondiente a la desigualdad, != y !=~. El segundo elemento de cada par toma una expresión regular como valor. La igualdad simple, =, es el valor predeterminado.

Comparadores de filtros

Debajo de la lista de operadores de comparación hay una lista de los valores disponibles. En la siguiente captura de pantalla, se muestran los nombres de las zonas del proyecto:

Algunos valores de filtro ya propagados

En el campo Valor (Value), puedes seleccionar uno de los elementos de 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:

    Usa una string de filtro

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

  • Si seleccionas =~ o !=~, podrás usar una expresión regular en el valor. Por ejemplo, la expresión regular us-central1-.* coincide con cualquier zona us-central1:

    Filtra con regexps

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

    Filtra con más regexps

Puedes especificar varios criterios de filtro y usar la misma etiqueta muchas 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.:

Usa varios filtros

Agrupación

Puedes reducir la cantidad de datos que se muestran para una métrica si combinas datos de series temporales similares.

Al igual que el filtrado, la agrupación reduce la cantidad de datos que manipulas. El filtrado funciona mediante la exclusión de algunas series temporales, y la agrupación funciona mediante la identificación de conjuntos de series temporales que cumplen con algún criterio y, luego, la combinación o la agregación de los miembros de los conjuntos.

La agrupación se realiza en función de las etiquetas. Cuando haces clic en el campo Agrupar por (Group By), obtienes las mismas etiquetas que están disponibles para el filtrado.

La opción Agrupar por (Group By) te permite agrupar series temporales por etiquetas de recursos y métricas y, luego, combinar los datos dentro de esos grupos. Esto crea una serie temporal única y nueva para cada combinación de valores agrupados, y esta representa a todos los miembros del grupo.

Por ejemplo, supongamos que deseas examinar la carga de registro, pero solo a nivel regional, es decir, el número de entradas de servidores específicos no es de tu interés. Puedes agrupar series temporales por zona y, luego, representar el total, el promedio o alguna otra medida para cada zona.

Con la opción Agrupar por (Group By), se elige una función de agregación predeterminada según el tipo de datos que se agrupan, pero puedes cambiar esta selección. Consulta Agregación para obtener información sobre otras opciones.

La siguiente captura de pantalla muestra una agrupación por zona. La opción sum en Agregador (Aggregator) es la opción predeterminada.

Agrupa series temporales

Esto crea una serie temporal nueva para cada zona, con valores calculados a partir de la suma de todos los valores de las series temporales individuales de esa zona.

También puedes agrupar por varias etiquetas. Cuando agrupas por varias etiquetas, obtienes una serie temporal para cada combinación de etiquetas. El orden en el que especificas las etiquetas no importa.

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

  1. Quitar las etiquetas de agrupación
  2. Volver a establecer el método de agregación en none

Agregación

La opción Agregador (Aggregator) te permite combinar series temporales mediante funciones comunes. De esta manera, se reducen la cantidad de líneas en el gráfico que muestra la métrica, lo que puede mejorar el rendimiento del gráfico.

Haz clic en el campo Agregador para ver una lista de las opciones de agregación disponibles. Estas son las funciones, o reductores, que se pueden usar para combinar las series temporales.

Las funciones de reducción disponibles dependen del tipo de valores que capture la métrica, pero suelen incluir opciones como media, máxima o mínima, desviación estándar, valores de percentil variados, etcétera. Para obtener más información sobre estas dependencias, consulta Métricas, series temporales y recursos.

Cuando se usa sin la agrupación, la función de reducción se aplica en todas las series temporales seleccionadas y las combina con una sola serie temporal que consiste en la media, la suma o cualquier otra medida calculada para todas las series temporales. Cuando se usa con la agrupación, la función se aplica a la serie temporal dentro de cada grupo.

Para obtener más información sobre la agregación, consulta Aggregation en la referencia de la API.

La opción Agrupar por aplica de forma automática la agregación para calcular estadísticas dentro de cada grupo. Las líneas en un gráfico de Agrupar por ya representan agregaciones. Con la opción Agrupar por (Group by), se elige una función de agregación predeterminada según el tipo de datos que se agrupan, pero puedes cambiar esta selección.

También puedes aplicar la agregación a un conjunto de series temporales que hayas filtrado. Al igual que con las series temporales sin filtrar, la agregación de series temporales filtradas reducirá todas las líneas a solo una que refleje la función de agregación elegida, a menos que también uses la agrupación.

Existen otras opciones para seleccionar una métrica. Estas opciones tienen valores predeterminados, pero puedes exponerlas y anular esos valores. Para ver las opciones adicionales, haz clic en Mostrar opciones avanzadas.

Alineación

Una serie temporal es un conjunto de datos en orden temporal. Alinear una serie temporal constituye la división de los datos en intervalos de tiempo regulares: el período de alineación. Se deben alinear varias series temporales antes de poder combinarlas.

La alineación es un requisito para la agregación en series temporales, y se aplica a cada una de estas series de forma individual. Debido a que la alineación es un requisito para representar los datos, Monitoring lo hace de forma automática, mediante el uso de valores predeterminados. Puedes anular estos valores predeterminados mediante las opciones de alineación: Alineador (Aligner) y Período de alineación (Alignment Period):

Campos de opciones de alineación

Período de alineación: Determina la cantidad de tiempo que toma subdividir la serie temporal. Por ejemplo, puedes dividir una serie temporal en fragmentos de un minuto o de una hora. Los datos de cada período se resumen para que un solo valor represente ese período. El período de alineación predeterminado es de un minuto.

Aunque puedes establecer el intervalo de alineación para tus datos, las series temporales pueden volver a alinearse cuando cambias el intervalo de tiempo que aparece en un gráfico o cuando cambias el nivel de zoom.

Alineador (Aligner): Es una función que determina cómo resumir los datos en cada período de alineación. Los alineadores incluyen la suma, la media, etcétera. Las opciones válidas de alineador dependen de la clase y el tipo de datos de métrica que almacena una serie temporal. Es decir, la elección del alineador depende de la MetricKind y del ValueType de la serie temporal.

Algunos alineadores ordenan los datos y los convierten de una categoría o tipo de métrica a otro. Para obtener más información sobre los alineadores disponibles, consulta Aligner en la referencia de la API.

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

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, estas descripciones 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 sean de utilidad. Puedes usar este campo a fin de crear una plantilla para las descripciones.

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

  • Texto sin formato
  • Variables que representan etiquetas en tu serie temporal. Las etiquetas disponibles dependen de la serie temporal que representes en el gráfico, pero la sintaxis de la variable por lo general se parece a esta: ${resource.labels.project_id}. La notación ${} hace que la variable se evalúe en tu descripción

Si solo proporcionas texto, las descripciones de la serie temporal del gráfico serán idénticas. El uso de variables te permite extraer valores de etiquetas de la serie temporal y colocarlos en la descripción.

Si conoces los nombres de las variables, puedes ingresarlos de forma manual en el campo de la plantilla. También puedes seleccionar variables para las etiquetas disponibles mediante el widget + Agregar un filtro (+ Add a filter) que aparece en el campo. Este enfoque garantiza que la sintaxis de la variable sea correcta.

En la siguiente captura de pantalla, se muestra una plantilla que consta de una string y una sola variable:

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 que tiene el encabezado Nombre (Name). Los valores también aparecen en la tarjeta emergente.

En la siguiente captura de pantalla, se muestran los valores de Nombre (Name) y la tarjeta emergente que resulta de la plantilla:

Descripciones generadas a partir de una plantilla

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