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 serie temporal 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

Para configurar qué series temporales mostrar cuando usas el Explorador de métricas, puedes crear una consulta mediante la selección de menús o puedes escribir una consulta. Cuando escribes una consulta, debes seleccionar su lenguaje de consulta y, luego, usar un editor de consultas o una interfaz basada en texto:

• Las consultas del lenguaje de consulta de supervisión (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 consultas con sugerencias y verificación de sintaxis.

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

• Las consultas del lenguaje de consulta de Prometheus (PromQL) especifican las series temporales y cómo se agrupan y se alinean. La interfaz de PromQL es compatible con un editor con sugerencias.

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

• Las consultas del filtro de Monitoring especifican las series temporales, pero no incluyen instrucciones de agrupación o alineación.

  Cualquier serie temporal que Monitoring pueda graficar se puede especificar mediante 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 en el formato que requieren otras interfaces. Por lo tanto, es posible que se descarte la consulta si cambias a una interfaz diferente.

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

• 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 a un tipo de métrica como una métrica. Un ejemplo de 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 métricas. 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.

Las consultas de MQL y PromQL incluyen instrucciones de agrupación y alineación. Sin embargo, cuando escribes un filtro de Monitoring o usas menús para seleccionar las series temporales a fin de graficarlas, debes establecer la configuración de agrupación y alineación a través de menús.

Nota: Google Cloud Console solo puede mostrar datos numéricos. Para recuperar métricas con un tipo de String, usa un método en la API, como timeSeries.list.

Crea consultas mediante menús

Para compilar tu consulta mediante menús, haz lo siguiente:

1. En Google 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. Selecciona la métrica y el recurso que deseas representar:

   1. 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 las entradas que incluyen 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, activa la opción Mostrar solo recursos y métricas activos. De forma predeterminada, este botón de activación está habilitado para que solo las métricas y los recursos con datos se muestren en los menús.

   3. En el menú Recurso, selecciona el recurso del que se capturan los datos de métricas.

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

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

      La categoría suele ser 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, selecciona la métrica que quieres graficar.

   6. Haz clic en Aplicar.

   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 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. En la siguiente captura de pantalla, se muestra un gráfico después de seleccionar el tipo de recurso y la métrica:

   

   El gráfico anterior contiene más datos que se pueden mostrar. Los gráficos tienen un límite de 300 líneas. En el gráfico, se indica que hay demasiados datos para mostrar y se sugiere usar el modo de valores atípicos, lo que reduce en gran medida la cantidad de datos que se muestran. Para acceder a los controles del 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 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.

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

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

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

El resto de esta sección se aplica a la configuración de un gráfico cuando se utiliza una interfaz controlada por menús. Esta sección no se aplica a las configuraciones de MQL, PromQL ni 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 cuando uses 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 los 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:

   

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, !=~:

   

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

   • Para una comparación directa, = o !=, selecciona el valor 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 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ú 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:

     

   • 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.*":

     

Nota: Para editar o borrar un filtro, haz clic en Editar filtro en el panel del filtro.

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

Escribe consultas de MQL y PromQL

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

1. En Google 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 MQL o PROMQL.
4. Ingresa tu consulta y haz clic en Ejecutar.

En este documento, no se describe cómo usar MQL o PromQL. Para obtener información sobre estos idiomas, consulta los siguientes documentos:

• Introducción al lenguaje de consultas de Monitoring (MQL).
• PromQL en Cloud Monitoring.

Escribir consultas de filtros de Monitoring

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

• Muestre un objetivo de nivel de servicio (SLO).
• Muestra el recuento de los procesos que se ejecutan en máquinas virtuales (VM).
• Muestre una métrica personalizada para la que aún no tenga datos.
• Filtra una serie temporal según una etiqueta de la que aún no tienes datos.

Un filtro de Monitoring, o un filtro de métrica equivalente, es una expresión que Monitoring usa para identificar las series temporales que se representarán en el gráfico. 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 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áquinas virtuales 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 Google 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 Modo de filtro directo.

   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 Direct Filter Mode, esas configuraciones se muestran 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:

   • Filtros de supervisión
   • Filtros de estado del proceso
   • Recuperar datos de SLO

   Se muestra un error cuando usas el modo de filtro directo y no hay datos disponibles que satisfagan el filtro. Los mensajes de error comunes incluyen Chart definition invalid y No data is available for the selected timeframe.

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

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

Nota: Si ingresas un filtro de Monitoring y luego cambias a una interfaz diferente, el filtro de Monitoring se descarta.

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.

• Para obtener información sobre las opciones de vista, incluido el modo de valores atípicos, consulta Configura las opciones de vistas.
• Para obtener más información sobre la interacción con el gráfico, consulta Explora los datos del gráfico.

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 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 establece en 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:

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:

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.

Nota: Si solo borras las etiquetas agrupar por, en el gráfico, se mostrará una sola línea que representa todos los datos después de que se aplicó el agregador. Para deshacer la agrupación, debes quitar las etiquetas de agrupación y restablecer el agregador en 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 de media, cada punto en el 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, entonces 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:

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:

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.

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

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:

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 quieres compilar una plantilla para las descripciones, usa este campo.

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

Puedes ingresar texto sin formato y plantillas 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 de forma automática una plantilla. 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}:

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:

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?

• Métricas personalizadas
• Configura la plantilla de leyenda
• Cómo configurar las opciones de vista
• Explora los datos del gráfico