Ayúdanos a definir el futuro de las operaciones de software y haz oír tu voz mediante la encuesta estatal de DevOps 2021.

Selecciona datos para graficarlos

En esta página, se describe cómo especificar qué datos se deben mostrar en un gráfico. Para obtener información sobre cómo configurar el estilo de un gráfico, consulta Configura las opciones de vista.

Selecciona los datos que se mostrarán

Para propagar el gráfico, debes especificar al menos un par de valores:

  • Un tipo de métrica que identifica las medidas que se pueden recopilar desde un recurso supervisado. En este, se incluye una descripción de lo que se mide y cómo se interpretan las mediciones. A veces, el tipo de métrica se denomina métrica. Para obtener información conceptual, consulta Tipos de métricas.

  • Un recurso supervisado especifica desde qué recurso se capturan los datos de la métrica. A veces, el recurso supervisado se denomina tipo de recurso supervisado o recurso. Para obtener información conceptual, consulta Recursos supervisados.

Monitoring tiene muchos tipos de métricas predefinidos y recursos supervisados disponibles. También puedes crear métricas personalizadas:

Campo de especificación de métrica

Cuando arrastras un widget de la Biblioteca de widgets al área del grafo, se muestra un gráfico con un tipo de recurso y una métrica preseleccionados:

Ejemplo de un gráfico de líneas recién creado

Existen diferentes formas de especificar los datos que se representarán en el gráfico:

  • Para configurar un gráfico con rapidez, usa el modo básico. Esta elección tiene opciones de configuración mínimas. Una configuración básica siempre se puede representar en los demás modos. Para obtener más información, consulta Usa el modo Básico o Avanzado.
  • Para tener acceso a todos los campos de configuración del gráfico, usa el modo Avanzado. Este modo proporciona acceso a la mayoría de los campos de agregación. Para obtener más información, consulta Usa el modo Básico o Avanzado.

  • Para configurar un gráfico con un lenguaje de consulta, usa el modo MQL. Con este modo, tienes acceso al Editor de consultas. Si usas MQL, esta configuración no puede representarse mediante los otros modos. Para obtener información sobre MQL, consulta Introducción al MQL.

Usa el modo Básico o Avanzado

El menú Tipo de recurso (Resource type) enumera todos los recursos supervisados para los que existen datos de métricas. El menú Métrica (Metric) se determina mediante la selección para el Tipo de recurso (Resource type).

  • Para buscar una entrada específica en un menú, usa la barra de desplazamiento o ingresa el texto en el área Filtrar  del menú. Cuando ingresas texto, las entradas del menú se limitan a aquellas que lo incluyen.

    En la siguiente captura de pantalla, se ilustra el menú expandido para el campo Métrica (Metric). La barra de filtros contiene el texto lat, por lo que este menú solo muestra entradas que incluyen esa string:

    Se muestra la barra de filtros de métricas.

    Ten en cuenta que, en la captura de pantalla anterior, se destaca la métrica Late Boot Validation. Cuando el cursor se coloca sobre una entrada, se abre un panel y muestra información detallada sobre esa métrica. Como se ilustra, en este panel se enumeran, entre otros aspectos, el tipo de métrica, el tipo de valor y el campo de descripción.

Si deseas acceder a un tipo de recurso o métrica que aún no tiene datos, debes cambiar el comportamiento predeterminado:

  • Para poder seleccionar cualquier tipo de recurso, expande el menú Tipo de recurso y desmarca Solo mostrar activos.

  • Para ver todas las métricas del tipo de recurso seleccionado, incluso esas métricas sin datos, expande el menú Métrica y desmarca la opción Solo mostrar activos.

  • Para poder seleccionar cualquier métrica, haz clic en Cerrar en el menú Tipo de recurso y, luego, busca la entrada de interés. Si haces clic cerca del tipo de recursos, el menú Métrica incluye todas las métricas.

  • Para ver o editar la configuración, el filtro y el tipo de recurso como lo usa la API de Cloud Monitoring, en el menú Tipo de recurso, haz clic en Modo de filtro directo.

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. 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. Por lo general, puedes filtrar por grupo de recursos, por nombre, por etiqueta de recurso, por zona y por etiqueta de métricas.

Si seleccionas el modo MQL, usa el Editor de consultas para especificar el filtro.

Para agregar un filtro cuando seleccionas el modo Básico o Avanzado, haz clic en Agregar filtro y, luego, 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 Filtrar . Cuando ingresas texto, las entradas del menú se limitan a aquellas que lo contienen.

    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ú o deja el valor predeterminado. Puedes elegir entre cuatro operadores: igual, =, no igual, !=, coincidencia de expresión regular, =~ y la expresión regular no coincide, !=~:

    Lista de comparadores de filtros.

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

    • Si seleccionaste una comparación directa, = o !=, selecciona la opción del menú o haz clic en Editar y, luego, ingresa un valor. 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 del menú se derivan de la serie temporal recibida, si 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.

    • Si seleccionaste una comparación de expresión regular, =~ o !=~, ingresa una expresión regular RE2 en el valor. 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, si deseas 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. Esto te permite especificar un filtro para un rango de valores. Deben cumplirse todos los criterios de filtro. constituyen un AND lógico. Por ejemplo, la siguiente configuración usa 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

Después de seleccionar los datos de series temporales, el siguiente paso es determinar cómo se muestran esos datos. Por ejemplo, ¿quieres mostrar cada serie temporal o quieres combinarlas?

Para especificar cómo se muestran los datos, configura las opciones de agregación. La agregación consiste en alinear datos de series temporales y, luego, combinar distintas series temporales. La combinación de series temporales es opcional.

Para obtener una explicación detallada de la agregación, consulta Filtrado y agregación: manipula series temporales.

Alinear datos

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 de tiempo mínimo que se usará cuando se alinean los 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.

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. Sin embargo, si configuras el gráfico para que muestre una semana de datos, hay demasiados puntos para mostrar en el gráfico a fin de que el período se modifique automáticamente. En este ejemplo, el período de alineación modificado es de una hora.

El campo Función de alineación especifica la función 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 mín, los datos alineados son el mínimo de todos los datos dentro del período de alineación. Algunos de los alineadores realizan acciones más compuestas:

  • 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 las unidades de la serie temporal original son MiB y las unidades del período de alineación son segundos, esta opción de alineador da como resultado un gráfico con las unidades 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 acceder a los campos de alineación, haz lo siguiente:

  • Modo básico: Todos los campos de alineación están preconfigurados.

  • Modo avanzado: Todas las opciones de alineación son accesibles después de seleccionar el tipo de recurso y la métrica. Se proporcionan los valores predeterminados para estos campos. Sin embargo, puedes modificar las selecciones.

  • Modo MQL: Todas las opciones de alineación están disponibles.

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.

Combinar 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 agrupar y combinar series temporales, realiza una de las siguientes acciones:

  • Modo básico:

    1. Determina cómo agrupar series temporales:

      • Para mostrar todas las series temporales, deja desmarcada Agrupado.
      • Para agrupar series temporales por valores de etiqueta, marca Agrupado y, luego, usa el menú Agrupar por a fin de seleccionar las etiquetas para agrupar. Una vez que realices las selecciones que hagas, haz clic en Aceptar.
    2. Determina cómo combinar los datos:

      • Si los botones de selección solo enumeran percentiles, entonces seleccionaste una métrica que tiene un valor de distribución. Usa los botones de selección para elegir el percentil de la distribución que deseas ver.

      • Si los botones de selección enumeran mean, min y max, seleccionaste una métrica con un valor numérico. Usa estos botones para especificar cómo se combinan los datos como parte del proceso de creación de gráficos. Para comprender cómo funcionan estos combinadores, supongamos que un gráfico puede mostrar 60 datos y que la tasa de datos es de 1 punto por minuto. Si muestras una hora de datos, el gráfico puede mostrar cada punto. Sin embargo, si deseas mostrar 3 horas de datos, debes reducir 180 datos a 60, que es la cantidad de puntos que se puede mostrar en el gráfico. Una forma de reducir los datos es promediar tres muestras adyacentes; otra es la mínima.

  • Modo avanzado:

    • Para combinar todas las series temporales en una sola serie temporal, asegúrate de que Group by esté vacío y selecciona cómo se combinan las series temporales con la función Agrupar por función.

    • Para mostrar todas las series temporales, realiza una de las siguientes acciones:

      • Asegúrate de que Agrupar por esté vacío y selecciona none para la Agrupar por función.
      • Haz clic en el menú Agrupar por, selecciona Agregar todo y, luego, selecciona Agrupar por función. Para las métricas que almacenan un valor numérico, la elección de agrupación por función no puede producir un gráfico visible de manera diferente.
    • Para agrupar series temporales por valores de etiqueta específicos, haz clic en Agrupar por y selecciona las etiquetas que deseas agrupar. Para especificar cómo se combinan las series temporales, selecciona una función con el menú Agrupar por función.

  • Modo MQL:

    Para obtener información sobre el lenguaje de consulta de Monitoring, consulta Usa el Editor de consultas.

En la siguiente captura de pantalla, se muestra una agrupación por user_labels.version con la función de agrupación configurada en el valor predeterminado de sum. 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. Si tienes varias opciones de agrupación, las series temporales se agrupan por cada combinación de valores de etiqueta, y la función de agrupación 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 una función de agrupación, 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 todas las condiciones agrupadas, realiza una de las siguientes acciones:

  • Modo básico: Desmarca Agrupado.

  • Modo avanzado: Haz lo siguiente:

    1. En el menú Agrupar por, haz clic en Quitar todo y, luego, en Aceptar.
    2. En el menú Agrupar por función, selecciona none.
  • Modo MQL: borra los comandos de agrupación.

    Para obtener información sobre el lenguaje de consulta de Monitoring, consulta Usa el Editor de consultas.

Agregación secundaria

La pestaña que selecciones determinará las opciones de agregación:

  • Modos básico y Avanzado: el editor del panel determina cómo asignar tus selecciones de agregación a los campos de agregación principal y secundario especificados por la API de Cloud Monitoring mediante la siguiente información:

    • Tipo de widget
    • Categoría de métrica
    • Tipo de valor de la métrica
    • Qué modo se utiliza para configurar el widget

    Para determinar esta asignación de gráficos en paneles personalizados, puedes recuperar la configuración del panel con la herramienta de línea de comandos de gcloud. Para obtener más información, consulta Enumera paneles.

  • Modo MQL: estos campos son accesibles.

¿Qué sigue?