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 recopilados por tu proyecto. El Explorador de métricas solo puede mostrar datos numéricos de series temporales.

Selecciona los datos que se mostrarán

Para configurar qué series temporales mostrar en un gráfico, puedes crear una consulta mediante selecciones en los menús o escribir una consulta. Cuando escribes una consulta, seleccionas tu lenguaje de consulta y, luego, usas un editor de consultas o una interfaz basada en texto:

  • Las consultas del lenguaje de consulta de Monitoring (MQL) especifican las series temporales y cómo se agrupan y alinean esas series temporales. La interfaz de MQL es compatible con un editor de código con sugerencias y verificación de sintaxis.

    Por lo general, no es posible convertir consultas de MQL en formularios que puedan usar las otras interfaces. Las consultas no guardadas se descartan cuando cambias a la pestaña MQL o desde ella.

  • Las consultas de Prometheus Query Language (PromQL) especifican series temporales y cómo se agrupan y alinean esas series temporales. La interfaz de PromQL admite un editor con sugerencias.

    Por lo general, no es posible convertir consultas de PromQL en formularios que puedan usar las otras interfaces. Las consultas no guardadas se descartan cuando cambias hacia o desde la pestaña de PromQL.

  • Las consultas del filtro de supervisión especifican las series temporales, pero no incluyen declaraciones de agrupación ni de alineación.

    Cualquier serie temporal en la que Monitoring puede graficar se puede especificar con un filtro de Monitoring. Por ejemplo, para graficar la cantidad de procesos que se ejecutan en una VM, debes usar un filtro de Monitoring que especifique una función.

    No siempre es posible convertir un filtro de Monitoring al formato requerido por otras interfaces. Por lo tanto, es posible que se descarte tu consulta si cambias a una interfaz diferente.

Por lo general, las consultas especifican un tipo de métrica, un tipo de recurso y filtran:

  • 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. Un tipo de métrica a veces se conoce como una métrica. Un ejemplo de una métrica es “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 la métrica. El tipo de recurso a veces 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.

Las consultas de MQL y PromQL incluyen declaraciones de agrupación y alineación. Sin embargo, cuando escribes un filtro de Monitoring o usas menús para seleccionar las series temporales que se representarán en el gráfico, puedes establecer la configuración de agrupación y alineación con menús.

Crear consultas con menús

La configuración predeterminada es compilar consultas mediante el uso de menús. Por lo general, si seleccionas una métrica y un filtro y, luego, cambias a una interfaz diferente, tus selecciones se conservarán y se volverá a formatear para esa interfaz. Es decir, una consulta construida con menús se puede convertir en una consulta de MQL.

Para regresar de las otras interfaces a la interfaz basada en menús, selecciona Builder. Sin embargo, se descarta la consulta. Es decir, una consulta de MQL no se puede convertir en un formulario equivalente basado en menús.

Para crear tu consulta con menús, haz lo siguiente:

  1. En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Explorador de métricas:

    Ir al Explorador de métricas

  2. En la barra de herramientas del panel de consultas, haz lo siguiente:

    1. En el elemento Métrica, expande el menú Seleccionar una métrica.

    2. Opcional: Para reducir la cantidad de opciones que se muestran en el menú, ingresa el nombre de la métrica o del recurso en la barra de filtros . Por ejemplo, cuando ingresas util, restringes el menú para mostrar entradas que incluyan util. Las entradas se muestran cuando pasan una prueba "contiene" que no distingue mayúsculas de minúsculas.

      Para ver una lista de todas las métricas, incluso aquellas sin datos recientes, habilita el botón de activación Mostrar solo recursos y métricas activos. De forma predeterminada, en los menús solo se muestran las métricas y los recursos con datos.

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

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

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

      La categoría suele ser el primer término que sigue al dominio del servicio. Si usas el tipo de métrica compute.googleapis.com/instance/utilization de Compute Engine como ejemplo, el dominio de servicio es compute.googleapis.com y la categoría es instance.

    5. En el menú Métricas, selecciona la métrica que quieres representar.

    6. Haz clic en Aplicar.

    Por ejemplo, para graficar el uso de CPU de una máquina virtual de Compute Engine, haz lo siguiente:

    1. Ingresa util en la barra de filtros .
    2. En el menú Recursos activos, selecciona Instancia de VM.
    3. En el menú Categorías de métricas, selecciona Instancia.
    4. En el menú Métricas, selecciona Uso 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:

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

    El gráfico anterior contiene más datos de los que se pueden mostrar; los gráficos tienen un límite de 50 líneas que se pueden mostrar. El gráfico indica que hay demasiados datos para mostrar. Para reducir la cantidad de datos, en la barra de herramientas de consultas, usa el elemento Ordenar y limitar. Para obtener más información, consulta Cómo mostrar valores atípicos.

    También puedes usar las opciones de filtrado y agregación para reducir la cantidad de datos incluidos en el gráfico. Estas técnicas permiten que los gráficos sean más útiles para el diagnóstico y el análisis, y aumentan el rendimiento y la capacidad de respuesta de la propia interfaz de usuario.

  3. Opcional: Agrega filtros para restringir las series temporales que se muestran. En la siguiente sección, se describen las opciones de filtrado.

  4. Opcional: Configura cómo se agrupan y alinean las series temporales. Para obtener más información, consulta Elige cómo mostrar los datos del gráfico.

Filtra los datos del gráfico

Puedes reducir la cantidad de datos que se graficar si especificas criterios de filtro, aplicas agregación o ordenas las series temporales que coinciden con una consulta y, luego, limitas la cantidad de series temporales que se grafican. Para obtener más información, consulta Cómo mostrar 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 su rendimiento.

El resto de esta sección se aplica a la configuración de un gráfico cuando se usa una interfaz basada en menús. Esta sección no se aplica a la configuración de filtros de MQL, PromQL ni de Monitoring.

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, haz lo siguiente:

  1. En el elemento Filtrar, haz clic en Agregar filtro y selecciona una del menú.

  2. Para cambiar la comparación, selecciona un valor en el menú Comparador.

    Puedes elegir entre cuatro operadores: igual, =, no igual, !=, coincidencia de expresión regular, =~ y la expresión regular no coincide, !=~.

  3. En el campo Valor, ingresa o selecciona un valor:

    • Para una comparación directa, = o !=, selecciona el valor del menú o ingresa uno y haz clic en Aceptar. Puedes ingresar valores como us-central1-a o 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ú derivan de las series temporales recibidas, cuando un recurso supervisado no genera datos para la métrica seleccionada, debes ingresar un valor para la etiqueta.

    • Para una comparación de expresiones regulares, =~ o !=~, ingresa una expresión regular RE2 en el campo Valor y haz clic en Aceptar. 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.*".

Para agregar varios filtros, repite el procedimiento anterior:

  • Puedes usar la misma etiqueta varias veces, lo que te permite 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, para mostrar solo las zonas “a” en EE.UU., ingresa dos filtros: zone = starts_with("us") y zone = end_with("a").

Para editar el valor o el comparador de un filtro, en el elemento de filtro, haz clic en Menu, realiza los cambios y, luego, haz clic en Ok.

Para borrar un filtro, haz clic en Cancelar.

Escribir consultas de MQL

Para ingresar una consulta de MQL o PromQL, haz lo siguiente:

  1. En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Explorador de métricas:

    Ir al Explorador de métricas

  2. En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea  MQL o  PromQL.
  3. Verifica que MQL esté seleccionado en el botón de activación Idioma. El botón de activación del idioma está en la misma barra de herramientas que te permite dar formato a tu consulta.
  4. Opcional: Inhabilita la opción Ejecutar automáticamente.
  5. Ingresa tu consulta en el editor de consultas. Por ejemplo, para graficar el uso de CPU de las instancias de VM en tu proyecto de Google Cloud, usa la siguiente consulta:

    fetch gce_instance
    | metric 'compute.googleapis.com/instance/cpu/utilization'
    | group_by 1m, [value_utilization_mean: mean(value.utilization)]
    | every 1m
    

    Para obtener más información sobre MQL, consulta los siguientes documentos:

  6. Haz clic en Ejecutar consulta.

    Cuando se habilita el botón de activación de ejecución automática, no se muestra el botón Ejecutar consulta.

Escribir consultas de PromQL

Para ingresar una consulta de MQL o PromQL, haz lo siguiente:

  1. En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Explorador de métricas:

    Ir al Explorador de métricas

  2. En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea  MQL o  PromQL.
  3. Verifica que PromQL esté seleccionado en el botón de activación Language. El botón de activación del idioma está en la misma barra de herramientas que te permite dar formato a tu consulta.
  4. Opcional: Inhabilita la opción Ejecutar automáticamente.
  5. Ingresa tu consulta en el editor de consultas. Por ejemplo, para graficar el uso de CPU promedio de las instancias de VM en tu proyecto de Google Cloud, usa la siguiente consulta:

    avg(compute_googleapis_com:instance_cpu_utilization)
    

    Para obtener más información sobre el uso de PromQL, consulta PromQL en Cloud Monitoring.

  6. Haz clic en Ejecutar consulta.

    Cuando se habilita el botón de activación de ejecución automática, no se muestra el botón Ejecutar consulta.

Escribe consultas con el filtro de Monitoring

Cuando desees realizar alguna de las siguientes acciones, debes usar el modo de filtro directo, que te permite ingresar un filtro de Monitoring:

  • Mostrar un objetivo de nivel de servicio (SLO)
  • Muestra el recuento de procesos que se ejecutan en máquinas virtuales (VMs).
  • Muestra una métrica personalizada de la que aún no tengas datos.
  • Filtra una serie temporal en función de una etiqueta de la que aún no tienes datos.

Un filtro de Monitoring, o equivalente a un filtro de métricas, es una expresión que Monitoring usa para identificar la serie temporal que se representará en el gráfico. Por ejemplo, la siguiente expresión da como resultado un gráfico en el que se muestra un recuento de 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 series temporales por 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 el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Explorador de métricas:

    Ir al Explorador de métricas

  2. Haz clic en Help en el elemento Metric y, luego, selecciona Direct Filter Mode.

    Se borran los elementos Métrica y Filtro, y se crea un elemento Filtros que te permite ingresar 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 elemento Filtros.

  3. En el área de texto del elemento Filtros, ingresa una expresión de filtro de Monitoring. Para obtener información sobre la sintaxis, consulta los siguientes documentos:

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

  4. Opcional: Configura cómo se agrupan y alinean las series temporales. Para obtener más información, consulta Elige cómo mostrar los datos del gráfico.

Para volver a la interfaz basada en menús, haz clic en Salir del modo de filtro directo.

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.

El contenido de esta sección no se aplica cuando seleccionas los datos para graficar con un MQL o PromQL.

Combina series temporales

Puedes reducir la cantidad de datos que se muestran de una métrica si combinas diferentes series temporales. Por lo general, para combinar varias series temporales, debes especificar una o más etiquetas y una función. Las series temporales que tienen el mismo valor para todas las etiquetas especificadas se agrupan y, luego, la función que especificaste combina esas series temporales en una nueva.

La configuración del elemento Agregación puede cambiar la cantidad de series temporales que muestra el gráfico. La configuración predeterminada para este elemento se determina según el tipo de métrica que seleccionaste. Para modificar la pantalla, realiza una de las siguientes acciones:

  • Para mostrar cada serie temporal, en el elemento Aggregation (Agregación), asegúrate de que el primer menú esté configurado como Unaggregated y el segundo, como None.

  • Para combinar series temporales, en el elemento Aggregation, haz lo siguiente:

    1. Expande el primer menú y selecciona una función.

      El gráfico se actualiza y muestra una sola serie temporal. Por ejemplo, si seleccionas Mean, la serie temporal que se muestra es el promedio de todas las series temporales.

    2. Para combinar series temporales que tengan los mismos valores de etiqueta, expande el segundo menú y, luego, selecciona una o más etiquetas.

      El gráfico se actualiza y muestra una serie temporal para cada combinación única de valores de etiqueta. Por ejemplo, para que se muestren las series temporales por zona, configura el segundo menú como zone.

  • Para configurar el espaciado entre datos, haz clic en Agregar elemento de consulta, selecciona Intervalo mínimo y, luego, ingresa un valor.

Por ejemplo, si configuras la función en Sum y seleccionas la etiqueta user_labels.version, entonces 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 las series temporales individuales de una versión específica:

Se muestran las series temporales agrupadas por user_labels.version.

Cuando seleccionas varias etiquetas, se combinan las 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. En la siguiente captura de pantalla, se muestra un gráfico en el que las series temporales se combinan con las etiquetas user_labels.version y system_labels.machine_image:

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

Como se muestra, en el gráfico se muestra una serie temporal para cada par de valores de etiqueta. El hecho de que obtengas una serie temporal para cada combinación de etiquetas significa que esta técnica puede crear más datos de los que puedes incluir en un solo gráfico.

Mostrar todas las series temporales

Para mostrar todas las series temporales, en el elemento Agregación, configura el primer menú como No agregada y el segundo menú en Ninguna.

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.

Establecer intervalo de alineación

Para especificar el período fijo de la combinación de puntos, haz clic en Agregar elemento de consulta en el panel de consultas, selecciona Intervalo mínimo y, luego, completa el cuadro de diálogo.

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 campo Min Interval (Intervalo mínimo) se configura como 10 minutes, el gráfico mostrará 6 datos. Sin embargo, si ahora configuras el gráfico para que muestre una semana de datos, hay demasiados puntos para mostrar en el gráfico, por lo que el intervalo durante el cual se combinan los puntos se modifica de forma automática. En este ejemplo, el intervalo modificado es de una hora.

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, el campo Min Interval (Intervalo mínimo) se establece en 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 de cambiar el intervalo de 1 minute a 5 minutes:

Uso de CPU de instancias de VM con un 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. Cuando aumentas el campo Min Interval, se combinan más puntos, lo que tiene un efecto de suavizado en los datos trazados.

Configurar función de alineación

Cuando seleccionas la función para la agregación, Cloud Monitoring elige la función de alineación por ti. Cloud Monitoring determina la función de alineación óptima según el tipo de métrica que seleccionaste y tu elección para la función de agregación. Sin embargo, puedes especificar una función de alineación y anular la elección de Cloud Monitoring.

Para especificar la función de alineación, haz lo siguiente:

  1. En el elemento Agregación, expande el primer menú y selecciona Configurar alineador. Se agregan los elementos Función de alineación y Agrupación.
  2. Expande el elemento Función de alineación y selecciona una opción.

Si bien la mayoría de las funciones de alineación compatibles realizan funciones matemáticas comunes, algunas realizan acciones más complicadas:

  • siguiente más antigua: Para conservar solo la muestra más reciente dentro de un período de alineación, selecciona siguiente más antigua. Por lo general, esta función se usa con las verificaciones de tiempo de actividad y es una buena opción cuando solo te interesa el valor más reciente.

    Esta función solo es válida para las métricas de indicadores.

  • 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 especificarlo es seleccionar una función de 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.

    Esta función es válida solo para las métricas de indicador y delta cuando tienen un tipo de datos de distribución.

  • delta: Para convertir una métrica acumulada o una métrica delta en una métrica delta con una muestra por período de alineación, usa esta función. La interpolación de datos puede ocurrir cuando usas esta función. Para ver un ejemplo, consulta Clases, tipos y conversiones.

    Esta función solo es válida para las métricas acumulativas y delta.

  • rate: Para convertir una métrica acumulativa o delta en una métrica de indicador, usa esta función. Si eliges esta función, puedes pensar en las series temporales que se transforman como lo hacían con una función delta y, luego, se dividen 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 la segunda, el gráfico tendrá una unidad de MiB por segundo. Para obtener más información, consulta Tipos, tipos y conversiones.

    Esta función solo es válida para las métricas acumulativas y delta.

Para obtener más información sobre las funciones de alineación disponibles, consulta Aligner en la referencia de la API.

Agrupación y alineación secundarias

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 algunos tipos de métricas, tienes la opción de transformar los datos. Si esta opción está disponible y estableces el campo Transform en un valor distinto de None, todos los demás campos serán la configuración de agregación secundaria.

Cuando los campos de agregación secundarios se pueden configurar, para acceder a esos campos, a lo siguiente:

  1. Haz clic en Agregar elemento de consulta y, luego, selecciona Agregación secundaria.
  2. Configura el elemento Agregación secundaria.

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.

Configura el nombre de una columna de leyenda

El campo Alias de la 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 para el 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. Para crear una plantilla para descripciones, usa este campo.

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

Para agregar una plantilla de la leyenda a un gráfico, haz lo siguiente:

  1. En el panel Display, expande Alias de la leyenda (Legend Alias).
  2. Haz clic en Mostrar sugerencias de variables de plantilla y selecciona una entrada del menú. Por ejemplo, si seleccionas zone, se agrega 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?