Selecciona métricas cuando uses el Explorador de métricas

En este documento, se describe cómo configurar un gráfico temporal que muestra los datos de series temporales que recopila tu proyecto. El Explorador de métricas solo puede mostrar datos numéricos de series temporales.

Selecciona los datos que se mostrarán

Existen diferentes formas de especificar la serie temporal que se mostrará cuando uses el Explorador de métricas:

  • Una interfaz controlada por menú en la que puedes especificar series temporales seleccionando un tipo de recurso, un tipo de métrica y filtros. La interfaz controlada por menú te proporciona tus opciones válidas, ya que elimina la necesidad de conocer una sintaxis específica y te permite graficar varios tipos de métricas:

    • Un tipo de métrica identifica las mediciones que se recopilarán de un recurso. En este, se incluye una descripción de lo que se mide y cómo se interpretan las mediciones. A veces, nos referimos al tipo de métrica como métrica. Un ejemplo de métrica es el uso de CPU. Para obtener información conceptual, consulta Tipos de métricas.

    • Un tipo de recurso especifica desde qué recurso se capturan los datos de métrica. A veces, el tipo de recurso se denomina tipo de recurso supervisado o recurso. Un ejemplo de un recurso es una instancia de máquina virtual (VM) de Compute Engine. Para obtener información conceptual, consulta Recursos supervisados.

  • Una interfaz de lenguaje de consulta de Monitoring (MQL) en la que puedes especificar series temporales ingresando declaraciones de MQL. La interfaz de MQL admite un Editor de consultas con verificación de sintaxis.

    En este documento, no se describe cómo usar MQL. Para obtener información sobre la sintaxis MQL, consulta Introducción al lenguaje de consulta de Monitoring (MQL).

    Debido a que MQL es más expresivo que las otras interfaces, una consulta de MQL que ingresas se descarta cuando cambias a una interfaz diferente.

  • Una interfaz de texto en la que se especifican series temporales mediante el ingreso de un filtro de Monitoring. Los filtros de supervisión deben usarse cuando las series temporales que quieres representar no se pueden representar con el modelo de recursos y métricas. Por ejemplo, para contar la cantidad de procesos que se ejecutan en una VM, debes ingresar un filtro de Monitoring. Para obtener más información, consulta Modo de filtro directo.

    Debido a que los filtros de Monitoring pueden describir series temporales que no se pueden representar con el recurso y el modelo de métrica, es posible que se descarte la configuración cuando cambies a una interfaz diferente.

Interfaces controladas por menú

Para usar menús a fin de especificar series temporales para mostrar, haz lo siguiente:

  1. En Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Explorador de métricas.

  3. Selecciona la pestaña Configuración:

    1. Expande el menú Seleccionar una métrica.

    2. Para reducir la cantidad de opciones que se muestran en el menú, ingresa el nombre de la métrica o el recurso en la barra de filtro de (opcional). Por ejemplo, si ingresas util, puedes restringir el menú para que se muestren entradas que incluyan util. Las entradas se muestran cuando pasan una prueba que no distingue entre mayúsculas y minúsculas.

      Para ver una lista de todas las métricas, incluso aquellas sin datos recientes, configura el botón de activación Mostrar solo las métricas y los recursos activos como inhabilitado. De forma predeterminada, este botón de activación está habilitado, por lo que en los menús solo se muestran las métricas y los recursos con datos.

    3. En el menú Recurso, selecciona el recurso desde el que se capturan los datos de la métrica.

      Cuando una métrica no se escribe en un recurso, selecciona Sin especificar.

    4. En el menú Categoría de la métrica, selecciona la categoría de la métrica.

      Por lo general, la categoría es el primer término que sigue al prefijo de las métricas. Por ejemplo, para la métrica compute.googleapis.com/instance/utilization, la categoría es instance.

    5. En el menú Métrica, seleccione la métrica que desea incluir en el gráfico.

    6. Haga clic en Apply.

    Por ejemplo, para graficar el uso de CPU de una máquina virtual, puedes hacer lo siguiente:

    1. Ingresa util en la barra de filtros.
    2. En el menú Recursos, selecciona Instancia de VM.
    3. En el menú Categorías de métricas, selecciona Instancia.
    4. En el menú Métricas, selecciona Utilización de CPU y, luego, haz clic en Aplicar.

    Después de seleccionar el tipo de recurso y la métrica, el gráfico muestra todas las series temporales disponibles para ese par. En la siguiente captura de pantalla, se muestra un gráfico después de que se seleccionan el tipo de recurso y la métrica:

    Muestra un gráfico con una métrica seleccionada.

    El gráfico anterior contiene más datos que se pueden mostrar. Los gráficos se limitan a 300 líneas visibles. El gráfico indica que hay demasiados datos para mostrar y sugiere usar el modo de valores atípicos, lo que reduce en gran medida la cantidad de datos para mostrar. Para acceder a los controles de modo de valores atípicos, haz clic en Configuración. Si deseas obtener más información, consulta Cómo configurar las opciones de vistas.

    También puedes usar las opciones de filtrado y agregación para reducir la cantidad de datos representados. Estas técnicas aumentan la utilidad de los gráficos para los diagnósticos y análisis, y mejoran el rendimiento y la respuesta de la interfaz de usuario en sí misma.

  4. (Opcional) Agrega filtros para restringir las series temporales que se muestran. Para obtener más información, consulta Filtra los datos incluidos en el gráfico.

Modo de filtro directo

Usa el modo de filtro directo cuando te interese graficar alguna de las siguientes acciones:

  • Un objetivo de nivel de servicio (SLO)
  • El recuento de procesos que se ejecutan en máquinas virtuales (VM).
  • Una métrica personalizada para la que todavía no tienes datos.

El modo de filtro directo te permite ingresar una expresión que Monitoring usa para identificar las series temporales que se supervisarán. Las expresiones que ingresas en el modo de filtro directo a veces se denominan filtros de métricas o filtros de Monitoring. Por ejemplo, la siguiente expresión da como resultado un gráfico que muestra un recuento de los procesos cuyo nombre incluye nginx:

 select_process_count("monitoring.regex.full_match(\".*nginx.*\")")
 resource.type="gce_instance"

También puedes usar los filtros de Monitoring para identificar las series temporales por su tipo de recurso y métrica. La siguiente expresión da como resultado un gráfico que muestra el recuento de entradas de registro para todas las instancias de máquina virtual de Google Cloud en la zona us-east1-b:

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

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

  1. En Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Explorador de métricas.
  3. Selecciona la pestaña Configuración.
  4. Haz clic en Ayuda en el menú Seleccionar una métrica y, luego, selecciona Direct Filter Mode.

    En la página, se muestra un cuadro de texto. Si seleccionaste un tipo de recurso, una métrica o filtros antes de cambiar al modo de filtro directo, esa configuración se muestra en el cuadro de texto.

  5. Ingresa una expresión de filtro de Monitoring en el cuadro de texto. Para obtener información sobre la sintaxis, consulta los siguientes documentos:

    Cuando usas el modo de filtro directo y no hay datos disponibles que cumplan con el filtro, se muestra un error. Los mensajes de error comunes incluyen Chart definition invalid y No data is available for the selected timeframe.

Para volver a la interfaz controlada por menú, haga clic en Modo estándar.

Filtra los datos del gráfico

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. Cuando aplicas filtros, puedes reducir la cantidad de líneas en el gráfico, lo que puede mejorar el rendimiento del gráfico.

El resto de esta sección se aplica a la configuración de un gráfico cuando se utiliza una interfaz controlada por menú. Esta sección no se aplica a las configuraciones de MQL y Monitoring, que incluyen declaraciones de filtro.

Cuando proporcionas varios criterios de filtrado, el gráfico correspondiente muestra solo las series temporales que cumplen con todos los criterios, un AND lógico. Por lo general, puedes filtrar por grupo de recursos, por nombre, por etiqueta de recurso, por zona y por etiqueta de métricas.

Para agregar un filtro cuando uses la pestaña Configuración, haz clic en Agregar filtro y especifica la etiqueta de filtro, la comparación y el valor o rango de valores:

  1. Haz clic en Etiqueta y selecciona una entrada del menú.

    Para buscar una etiqueta específica, puedes usar la barra de desplazamiento o ingresar texto en el área de texto Filtro. Cuando ingresas el texto, el menú solo enumera las entradas que contienen el texto ingresado.

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

    Ejemplo de una lista de etiquetas de filtro.

  2. Haz clic en Comparación y, luego, selecciona una entrada del menú. Puedes elegir entre cuatro operadores: igual, =, diferente, !=, coincidencia de expresión regular, =~, y expresión regular que no coincide, !=~:

    Lista de comparadores de filtros.

  3. Haz clic en Validate y, luego, realiza una de las siguientes acciones:

    • Para una comparación directa, = o !=, selecciona el valor en el menú o ingresa uno y haz clic en Listo. Los valores ingresados pueden ser valores simples, como us-central1-a, o puedes crear una string de filtro que comience con starts_with o ends_with. Por ejemplo, para mostrar los datos de cualquier zona us-central1, puedes ingresar la string de filtro starts_with("us-central1"). Consulta Filtros de supervisión para obtener más información sobre las strings de filtro.

      Debido a que las entradas de menú se derivan de la serie temporal recibida, cuando un recurso supervisado no genera datos para la métrica seleccionada, debes ingresar un valor para la etiqueta.

      En la captura de pantalla siguiente, se muestra el menú de valor para un proyecto en particular cuando se selecciona la etiqueta del recurso zone:

      Ejemplo de una lista de etiquetas de filtro.

    • Para una comparación de expresiones regulares, =~ o !=~, ingresa una expresión regular RE2 en el campo Valor y haz clic en Listo. Por ejemplo, la expresión regular us-central1-.* coincide con todas las zonas us-central1:

      Para hacer coincidir cualquier zona de EE. UU. que termine con “a”, puedes usar la expresión regular ^us.*.a$.

      No puedes usar expresiones regulares para filtrar la etiqueta de recurso project_id.

      Por ejemplo, para ver solo las series temporales de una de las zonas us-central1, aplica un filtro zone="starts_with("us-central1")" o zone=~"us-central1.*":

      Se muestra una serie temporal filtrada

Puedes especificar varios criterios de filtro y usar la misma etiqueta varias veces. Estas capacidades te permiten especificar un filtro para un rango de valores. Se deben cumplir todos los criterios de, filtro, ya que constituyen un AND lógico. Por ejemplo, la siguiente es una configuración que puedes usar con las strings de filtro starts_with y ends_with para mostrar solo las zonas “a” en EE. UU.:

Ejemplo mediante varios filtros

Elige cómo mostrar los datos del gráfico

En la sección, se explica cómo mostrar los datos seleccionados mediante la configuración de los campos de agregación. La agregación consiste en la alineación de los datos dentro de una serie temporal y la combinación de diferentes series temporales. Para obtener una explicación detallada de la agregación, consulta Filtrado y agregación: manipula series temporales.

Series temporales de grupos

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 todos los datos de 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. El tipo de datos que se muestra determina el agregador predeterminado; 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.

Por ejemplo, si el campo Agrupar por se configura como user_labels.version y el agregador se establece en sum, hay una serie temporal para cada valor de la etiqueta 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, el agregador se aplica al conjunto de series temporales que tienen los mismos valores para las etiquetas seleccionadas.

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.

Quita las condiciones de agrupación

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

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

Alinea series temporales

La alineación es el proceso de conversión de los datos de la serie temporal que recibe Monitoring en una nueva serie temporal que tiene datos en intervalos fijos. El proceso de alineación consiste en recopilar todos los datos recibidos en un período fijo, aplicar una función para combinar esos datos y asignar una marca de tiempo al resultado. Esa función podría calcular el promedio de todas las muestras o podría extraer el máximo de todas las muestras.

El Período de alineación especifica el intervalo mínimo que se usará para alinear datos de series temporales. Cuando hay demasiados datos para representar en el período de visualización seleccionado, el período de alineación aumenta de forma automática para que se represente cada dato. La configuración predeterminada para este campo es de un minuto.

El campo del alineador especifica el atributo que se usa para combinar todos los datos en un período de alineación. La mayoría de los alineadores realizan funciones matemáticas comunes. Por ejemplo, si seleccionas min, el dato alineado es el mínimo de todos los datos dentro del período de alineación.

Por ejemplo, considera una métrica con un período de muestreo de un minuto. Si se configura un gráfico a fin de que muestre 1 hora de datos, el gráfico puede mostrar los 60 datos. Si el período de alineación se establece en 10 minutes, el gráfico muestra 6 datos. Cuando el campo Alineador tiene un valor media, cada punto del gráfico es el promedio de todos los puntos en un período de alineación. Sin embargo, si ahora configuras el gráfico para que muestre una semana de datos, significa que hay demasiados puntos para mostrar en el gráfico, por lo que el período se modifica automáticamente. En este ejemplo, el período de alineación modificado es de una hora.

Si bien la mayoría de los alineadores realizan funciones matemáticas comunes, algunos realizan acciones más complicadas:

  • Siguiente más antiguo: Para conservar solo la muestra más reciente dentro de un período de alineación, usa el alineador siguiente más antiguo. Este alineador se suele usar con verificaciones de tiempo de actividad y es una buena opción cuando solo te interesa el valor más reciente.

    Este alineador solo es válido para las métricas de indicador.

  • Percentil: Para mostrar una métrica de distribución en un tipo de trazado de gráfico de líneas, un gráfico de áreas apiladas o un gráfico de barras apiladas, debes seleccionar el percentil de la distribución que se mostrará. Una forma de especificar este percentil es seleccionar un alineador del percentil. Puedes seleccionar los percentiles 5, 50, 95 y 99. Los datos alineados se determina mediante el cálculo del percentil especificado mediante todos los datos del período de alineación.

    Este alineador solo es válido para las métricas de indicador y delta cuando tienen un tipo de datos de distribución.

  • Delta: Para convertir una métrica acumulativa o una delta en una métrica delta con una muestra por período de alineación, usa este alineador. Este alineador puede generar la interpolación de datos. Para ver un ejemplo, consulta Categorías, tipos y conversiones.

    Este alineador solo es válido para métricas acumulativas y delta.

  • Rate: Para convertir una métrica acumulativa o delta en una métrica del indicador, usa este alineador. Si eliges este alineador, puedes pensar en la serie temporal que se transforma como con un alineador delta y, luego, dividir por el período de alineación. Por ejemplo, si la unidad de la serie temporal original es MiB y la unidad del período de alineación es segundo, el gráfico tiene una unidad de MiB por segundo. Para obtener más información, consulta Categorías, tipos y conversiones.

    Este alineador solo es válido para métricas acumulativas y delta.

Para obtener más información sobre los alineadores disponibles, consulta Aligner en la referencia de la API.

Para ver o modificar la función de alineación, haga clic en Mostrar opciones avanzadas.

En la siguiente captura de pantalla, se ilustra el uso de CPU de las instancias de VM de Compute Engine en un proyecto de Google Cloud en particular. En esta imagen, los campos de alineación tienen los valores predeterminados: el alineador está configurado como mean y el período de alineación como 1 minute:

Uso de CPU de las instancias de VM mediante la configuración de alineación predeterminada

A modo de comparación, en la siguiente captura de pantalla, se muestra el efecto del cambio del período de alineación de 1 minute a 5 minutes:

Uso de CPU de las instancias de VM mediante el valor predeterminado con un período de alineación de 5 minutos

Cuando aumentas el período, el gráfico resultante tiene menos puntos, que disminuye de 60 puntos por serie temporal a 10 puntos por serie temporal. Cada punto del gráfico se calcula mediante el promedio de los puntos de serie temporal de un período de alineación. Si aumentas el período de alineación, se promedian más puntos y esto tiene un efecto de fluidez en los datos del trazado.

Agregación secundaria

Cuando tienes varias series temporales que ya representan agregaciones, puedes reducir todas las series temporales del gráfico a una sola serie temporal si eliges un Agregador secundario. Por ejemplo, si agrupas datos por zona, tu gráfico mostrará una serie temporal para cada zona. Para crear un gráfico con una sola serie temporal, usa los campos de agregación secundaria.

Para ver o modificar la configuración de agregación secundaria, haz clic en Mostrar opciones avanzadas.

En la siguiente captura de pantalla, se muestran varias series temporales que resultan de la agrupación de un conjunto de datos filtrados. El uso de la agrupación requiere agregación; cada grupo de líneas se agrega a una. En la siguiente captura de pantalla, se muestran series temporales agrupadas por zona:

Se muestra una serie temporal filtrada que se agrupa por zona.

En la siguiente captura de pantalla, se muestra el resultado de usar la agregación secundaria para encontrar el valor medio en las series temporales agrupadas:

Se muestra una agregación secundaria aplicada al ejemplo anterior.

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 información sobre la herramienta 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. Si deseas compilar una plantilla para las descripciones, usa este campo.

Para acceder a la plantilla de leyenda de un gráfico, selecciona la pestaña Avanzada del panel de configuración de Cloud Console. La plantilla de leyenda aparece en el encabezado Opciones adicionales.

Puedes ingresar texto y plantillas sin formato en el campo Plantilla de leyenda. Cuando agregas una plantilla, debes agregar una expresión que se evalúa cuando se muestra la leyenda.

Para agregar un filtro, haz lo siguiente:

  • Haz clic en Insertar una plantilla.
  • Selecciona una entrada del menú. Después de seleccionar una entrada, se agrega automáticamente una plantilla. Por ejemplo, si seleccionas response_code, se agregará la plantilla ${resource.labels.zone}.

Por ejemplo, la siguiente captura de pantalla muestra una plantilla de leyenda que contiene texto sin formato y la expresión ${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 y en la información sobre la herramienta:

Descripciones generadas a partir de una plantilla

Puedes configurar la plantilla de leyenda para que incluya varias strings de texto y plantillas; sin embargo, el espacio de visualización disponible en la información sobre la herramienta es limitado.

¿Qué sigue?