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

El Explorador de métricas es una herramienta de gráficos independiente que te permite compilar gráficos para cualquier métrica (numérica) recopilada por tu proyecto. En esta página, se describe cómo configurar el Explorador de métricas mediante su pestaña Configuración. Si usas el lenguaje de consulta de Monitoring (MQL), se aplican los conceptos de esta página. Sin embargo, debes usar la sintaxis definida en la Introducción al lenguaje de consulta de Monitoring (MQL).

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 especificar las métricas que se muestran cuando usas el Explorador de métricas, debes especificar valores para una métrica y un tipo de recurso:

  • El campo metric identifica las mediciones que se recopilarán de un recurso supervisado. En este, se incluye una descripción de lo que se mide y cómo se interpretan las mediciones. Métrica es una forma abreviada de tipo de métrica. Para obtener información conceptual, consulta Tipos de métricas.

  • El campo resource type especifica desde qué recurso se capturan los datos de métricas. El tipo de recurso a veces 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:

  • Para obtener información sobre los tipos de métricas predefinidas, consulta la Lista de métricas. En cada documento, se enumeran las métricas por tipo de servicio. Por ejemplo, la página Métricas de Google Cloud contiene una serie de tablas, una para cada servicio de Google Cloud.

  • Para obtener información sobre los tipos de recursos supervisados disponibles, consulta la Lista de recursos supervisados.

  • Para obtener información sobre cómo definir tus propias métricas, consulta Usa métricas personalizadas.

Campo de especificación de métrica

Los campos Resource type y Metric determinan la métrica incluida en el gráfico. Puedes completar estos campos en cualquier orden, y ambos te permiten ingresar valores o seleccionar entradas del menú:

  • Si deseas reducir la cantidad de opciones que se muestran en un menú, ingresa un valor en la barra de filtros. Por ejemplo, si ingresas cpu, el menú solo mostrará las entradas que incluyen cpu. Se usa una prueba que no distingue entre mayúsculas y minúsculas para determinar si una entrada aparece en la lista.

  • Para obtener más información sobre una entrada, coloca el puntero sobre ella a fin de activar la información sobre la herramienta.

  • Para ingresar un filtro de Monitoring, consulta Modo de filtro directo.

Una vez que se seleccionan 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.

En este gráfico, hay más datos de los que se pueden mostrar; los gráficos pueden mostrar un máximo de 300 líneas. El gráfico proporciona un aviso de 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 del modo de valores atípicos, haz clic en Configuración. Para obtener más información, consulta Configura opciones de vista.

También puedes usar las opciones de filtrado y agregación para reducir la cantidad de datos del gráfico. 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.

Modo de filtro directo

El modo de filtro directo te permite ingresar una expresión que Monitoring usa para identificar las series temporales que se supervisarán. A veces, las expresiones que ingresas en el modo de filtro directo se conocen como filtros de métricas o Filtros de supervisión. A continuación, se muestra una expresión que hace que Monitoring muestre las entradas de registro de 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"

El modo de filtro directo es útil cuando deseas identificar la sintaxis adecuada para una llamada a la API o verificar que un filtro de Monitoring tenga el formato correcto. También es útil cuando deseas graficar los datos que el modelo de recursos y métricas no puede representar. Por ejemplo, la siguiente expresión da como resultado un gráfico que muestra un recuento de procesos cuyo nombre incluye nginx:

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

Para obtener información sobre la sintaxis, consulta Filtros del estado del proceso y Recupera datos de SLO. Para obtener información general, consulta Filtros de supervisión.

Para ingresar un filtro de Monitoring, haz lo siguiente:

  1. Expande el menú Tipo de recurso y selecciona Modo de filtro directo.
  2. Ingresa una expresión de filtro de Monitoring en el cuadro de texto.

    El cuadro de texto se propaga con la configuración del tipo de recurso, la métrica y el filtro que creaste antes de cambiar al Modo de filtro directo.

    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 timeframe.

Para volver a la interfaz basada en el menú, haz 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. 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 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 usas la pestaña MQL, usa el Editor de consultas a fin de especificar el filtro.

Para agregar un filtro cuando usas la pestaña Configuración, 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, luego, selecciona una entrada del menú.

    Para encontrar una etiqueta específica, puedes usar la barra de desplazamiento o puedes ingresar texto en el área de texto Filtrar . Cuando ingresas texto, el menú muestra solo 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 Comparison y, luego, selecciona una entrada del menú. Puedes elegir entre cuatro operadores: equals, =, no igual, !=, coincidencia de expresiones regulares, =~, 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 del menú o ingresa un valor 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 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ú 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 expresiones regulares, =~ o !=~, ingresa una expresión regular RE2 en el campo Valor y haz clic. 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, 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. Estas capacidades te permiten especificar un filtro para un rango de valores. Se deben cumplir todos los criterios de filtro. constituyen una AND lógica. Por ejemplo, puedes usar la siguiente configuración a fin de usar 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 representados

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 en 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 grupales

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 dentro 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 crea de forma dinámica en función de 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 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 está configurado 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.

Alinear 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 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 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. 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. El dato alineado se determina mediante el cálculo del percentil especificado mediante todos los datos en el 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 la segunda, el gráfico tiene una unidad de MiB/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, haz 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. Cuando se aumenta el período de alineación, se promedian más puntos, lo que tiene un efecto de suavizado de los datos trazados.

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 los datos por zona, el 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 secundarios.

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 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.

Para acceder a la plantilla de leyenda de un gráfico, en Cloud Console, selecciona la pestaña Avanzado (Advanced) en el panel de configuración del gráfico. 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, agregas 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 una plantilla de forma automática. Por ejemplo, si seleccionas response_code, se agrega la plantilla ${resource.labels.zone}.

Por ejemplo, en la siguiente captura de pantalla, se 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 (Name) y en la tarjeta emergente:

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 en pantalla disponible en la tarjeta emergente es limitado.

¿Qué sigue?