Se usó la API de Cloud Translation para traducir esta página.

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 puede mostrar solo datos numéricos de series temporales.

Selecciona los datos que se mostrarán

Para configurar qué series temporales se muestran en un gráfico, puedes hacer lo siguiente: crear una consulta a través de selecciones de menús o puedes escribir una consulta. Cuando escribes una consulta, seleccionas tu lenguaje de consulta y, luego, usas un de consultas de Google o una interfaz basada en texto:

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

Por lo general, no es posible convertir las consultas de MQL en formularios que pueden usar las otras interfaces. Tus consultas no guardadas son las siguientes: descartados 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 las consultas de PromQL en formularios que pueden usar las otras interfaces. Tus consultas no guardadas son las siguientes: descartados cuando cambias a o desde la pestaña de PromQL.
Consultas del filtro de supervisión Especifican las series temporales, pero no incluyen las declaraciones de agrupación o alineación.

Se puede especificar cualquier serie temporal que Monitoring pueda especificar con un filtro de Monitoring. Por ejemplo, para graficar la cantidad de procesos que se ejecutan en una VM, debes usar una Filtro de supervisión que especifica una función.

No siempre es posible convertir un filtro de Monitoring en el formato requerido por otras interfaces. Por lo tanto, tu consulta podría se descartarán 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 deben recopilar de un recurso. En este, se incluye una descripción de lo que se mide y cómo se interpretan las mediciones. A veces, un tipo de métrica es se conoce como 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 de qué recurso provienen los datos de métricas. capturada. El tipo de recurso a veces se denomina tipo de recurso supervisado o recurso. Un ejemplo de un 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 agrupación y alineación declaraciones. Sin embargo, cuando escribes un filtro de Monitoring para seleccionar las series temporales que deseas representar, configurar la agrupación y de alineación con los menús.

Crear consultas con menús

La configuración predeterminada es la compilación de 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 las selecciones se mantienen y se les cambia el formato para esa interfaz. Es decir, una consulta creada con menús puede convertirse en una consulta de MQL.

Puedes regresar de las otras interfaces a la interfaz controlada por menús; para ello, haz lo siguiente: Selecciona Builder. Sin embargo, se descartará la consulta. Es decir, una consulta de MQL no se puede convertir en un equivalente formulario basado en menús.

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

En la consola de Google Cloud, ve a la página Explorador de métricas:
Dirígete al Explorador de métricas

Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
En la barra de herramientas del panel de consultas, haz lo siguiente:
1. En el elemento Métrica, expande el menú Selecciona una métrica.
  
  El menú Selecciona una métrica (Select a metric) contiene funciones que te ayudan a encontrar los tipos de métricas disponibles:
  - Para encontrar un tipo de métrica específico, usa la Barra de filtros. Por ejemplo, si ingresas util, restringirás el menú a mostrar entradas que incluyan util. Las entradas se muestran cuando pasan un elemento "contiene" que no distingue mayúsculas de minúsculas la prueba.
  - Para mostrar todos los tipos de métricas, incluso las que no tienen datos, haz clic en Activa. De forma predeterminada, los menús solo mostrar tipos de métricas con datos.
2. Selecciona una opción en el menú Recursos. el menú Categorías de métricas, el menú Métricas y, luego, Haz clic en Aplicar.
  
  Por ejemplo, para graficar el uso de CPU de una Compute Engine puedes seleccionar Instancia de VM, Instancia, Uso de CPU y haz clic en Aplicar.
  
  El menú Recursos enumera el recurso del que provienen los datos. de los datos recopilados. Cuando una métrica no se escribe en un recurso, selecciona Sin especificar.
Después de seleccionar el tipo de recurso y la métrica, el gráfico muestra todas las series temporales disponibles para ese par:

El gráfico anterior contiene más datos de los que se pueden mostrar. gráficos son tiene 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 la Ordenar y limit. Para obtener más información, consulta Muestra valores atípicos.

También puedes usar las opciones de filtrado y agregación para reducir la cantidad de datos del gráfico. Estas técnicas hacen que los gráficos sean más útiles para el diagnóstico y el análisis, y aumentan el rendimiento la capacidad de respuesta de la propia interfaz de usuario.
Opcional: Agrega filtros para restringir las series temporales que se muestran. Los siguientes se describen las opciones de filtrado.
Opcional: Configura cómo se agrupan y alinean las series temporales. Para ver más consulta Elige cómo mostrar los datos del gráfico.

Los filtros garantizan que solo se incluyan en el gráfico las series temporales que cumplen con algún conjunto de criterios. Cuando aplica filtros, puede reducir el número de líneas en el gráfico lo que puede mejorar el rendimiento del gráfico. Otra forma en que puedes mejorar la capacidad de respuesta de un gráfico es configurar las opciones de agregación y ordenar y limitar la cantidad de series temporales que se muestran. Para obtener más información, consulta Cómo mostrar valores atípicos.

Un filtro consta de una etiqueta, un comparador y un valor. Por ejemplo: para que coincida con todas las series temporales cuya etiqueta zone comienza con "us-central1", podrías usar el filtro zone=~"us-central1.*", que usa una expresión regular para realizar la comparación. Existen cuatro operadores de comparación:

es igual a, =
no es igual a, !=
coincidencia de expresión regular, =~
la expresión regular no coincide, !=~

Cuando filtras por ID del proyecto o contenedor de recursos, debes usar el operador igual, (=). Cuando filtras por otras etiquetas, puedes usar cualquier comparador compatible. Por lo general, puedes filtrar las etiquetas de métricas y recursos, y grupo de recursos.

Si proporcionas varios criterios de filtrado, en el gráfico correspondiente solo las series temporales que cumplen con todos los criterios, un AND lógico.

Para agregar un filtro cuando uses la interfaz basada en menús de la consola de Google Cloud, sigue estos pasos: haz lo siguiente:

En el elemento Filtro, haz clic en Agregar filtro y selecciona una opción. en el menú.
Para cambiar la comparación, selecciona un valor en el menú Comparador.
En el campo Valor, ingresa o selecciona un valor:
- Para una comparación directa, = o !=, selecciona el valor de o ingresa un valor y haz clic en Aceptar. Puedes ingresar valores como us-central1-a, o puedes crear un filtro o una cadena que comienza 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 cadenas de filtros.
  
  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.
- Para una comparación de expresiones regulares, =~ o !=~, ingresa un RE2 la expresión regular 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 uno de los us-central1 zonas, aplica un filtro zone=~"us-central1.*".

Cuando agregas varios filtros, se aplican los siguientes puntos:

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. constituyen un AND lógico.

Para editar el valor o el comparador de un filtro, haz lo siguiente: en el elemento del filtro, haz clic en Menú, haz que tu y, luego, haz clic en Aceptar.

Para borrar un filtro, haz clic en Cancelar.

Escribe consultas de MQL

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

En la consola de Google Cloud, ve a la página Explorador de métricas:
Dirígete al Explorador de métricas

Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea MQL o PromQL.
Verifica que MQL esté seleccionado en el botón de activación Lenguaje. El botón de activación de lenguaje se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.
Opcional: Inhabilita la opción Ejecutar automáticamente.
Ingresa tu consulta en el Editor de consultas. Por ejemplo, para graficar la Usa el uso de CPU de las instancias de VM en tu proyecto de Google Cloud, usa el 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:
- Introducción a MQL
- Usa el editor de código de MQL
Haz clic en Ejecutar consulta.

Cuando el botón de activación de Ejecución automática está habilitado, no se muestra el botón Ejecutar consulta.

Escribe consultas de PromQL

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

En la consola de Google Cloud, ve a la página Explorador de métricas:
Dirígete al Explorador de métricas

Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea MQL o PromQL.
Verifica que PromQL esté seleccionado en el botón de activación Lenguaje. El botón de activación de lenguaje se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.
Opcional: Inhabilita la opción Ejecutar automáticamente.
Ingresa tu consulta en el Editor de consultas. Por ejemplo, para graficar el promedio El uso de CPU de las instancias de VM en tu proyecto de Google Cloud, usa 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.
Haz clic en Ejecutar consulta.

Cuando el botón de activación de Ejecución automática está habilitado, no se muestra el botón Ejecutar consulta.

Escribe consultas sobre filtros de Monitoring

Cuando quieras realizar alguna de las siguientes acciones, debes usar el modo de filtro directo: que te permite ingresar una Filtro de supervisión:

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

Un filtro de Monitoring o, de forma equivalente, un filtro de métrica, es una expresión que Monitoring que se usa para identificar las series temporales que se representarán. Por ejemplo, la siguiente expresión genera en 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"

También puedes usar los filtros de Monitoring para identificar las series temporales según su tipo de recurso y métrica. La siguiente expresión da como resultado una gráfico que muestra el recuento de entradas de registro de todas las instancias de máquina virtual 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:

En la consola de Google Cloud, ve a la página Explorador de métricas:
Dirígete al Explorador de métricas

Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
Haz clic en Help en el elemento Metric y, luego, Selecciona Modo de filtro directo.

Se borran los elementos Métrica y Filtro, y Filtros te permite ingresar texto.

Si seleccionaste un tipo de recurso, métrica o filtros antes de cambiar al modo de filtro directo y, luego, esos parámetros de configuración se muestran en el elemento Filtros.
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 usa el modo de filtro directo y no hay datos disponibles que cumplan con filtro, aparece un error. Los mensajes de error más comunes incluyen Chart definition invalid y No data is available for the selected timeframe.
Opcional: Configura cómo se agrupan y alinean las series temporales. Para ver más 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.

Para obtener más información sobre las opciones de vista, consulta Configura las opciones de visualización del gráfico.
Para obtener más información sobre cómo interactuar con el gráfico, consulta Explora los datos del gráfico.

El contenido de esta sección no se aplica cuando has seleccionado los datos para un gráfico con MQL o PromQL.

Combina 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, especificar una o más etiquetas y una función. Las series temporales que tienen mismo valor para todas las etiquetas especificadas y, luego, la función que especificaste combina esas series temporales en una nueva.

La configuración del elemento Aggregation puede cambiar la cantidad de series temporales que muestra tu gráfico. La configuración predeterminada de este elemento están determinadas por 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 Sin agregar y que el segundo Establécelo en Ninguno.
Para combinar series temporales, en el elemento Aggregation (Agregación) 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 Media, la serie temporal que se muestra es el promedio de todas las series temporales.
2. Para combinar series temporales que tienen los mismos valores de etiqueta, haz lo siguiente: expandir el segundo menú y, luego, seleccionar una o más etiquetas.
  
  El gráfico se actualiza y muestra una serie temporal por cada combinación de valores de etiquetas. Por ejemplo, para mostrar en series temporales por zona, establece el segundo menú en 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 estableces la función en Sum y seleccionas la etiqueta user_labels.version, hay una serie temporal para cada valor de la etiqueta user_labels.version. Los datos en cada serie temporal se calculan a partir de la suma de todos los valores sobre series temporales individuales para una versión específica:

Se muestran las series temporales agrupados por user_labels.version.

Cuando seleccionas varias etiquetas, las series temporales que tienen el mismo se combinan los valores de 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 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, el gráfico 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 Esta técnica permite crear más datos de los que se pueden incluir en una gráfico único.

Mostrar todas las series temporales

Para mostrar todas las series temporales, en el elemento Aggregation (Agregación), haz lo siguiente: Configura el primer menú en Sin agregar y el segundo menú en Ninguno.

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.

Establece el intervalo de alineación

Para especificar la cantidad fija de tiempo para que se combinen los puntos, Haz clic en Agregar elemento de consulta en el panel de consultas. Selecciona Min Interval y, luego, completa el 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 se establece en 10 minutes, la gráfico que muestra 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 y así el intervalo sobre el que se combinan puntos se modifica automáticamente. 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, la siguiente captura de pantalla ilustra el efecto de cambiar el intervalo de 1 minute a 5 minutes:

Uso de CPU de las instancias de VM de forma predeterminada 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. Al aumentar el valor Min Interval, se combinan más puntos, que tiene un suavizado efecto en los datos trazados.

Establecer 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 función de alineación 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:

En el elemento Aggregation, expande el primer menú y selecciona Configura el alineador. La Función de alineación y Se agregan los elementos de agrupación.
Expande el elemento Función de alineación y selecciona tu opción.

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

next next: Para retener solo la muestra más reciente dentro de una alineación período, selecciona Siguiente más antiguo. Esta función se usa comúnmente con de tiempo de actividad y es una buena opción cuando te interesan valor.

Esta función solo es válida 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 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 acumulativa o una métrica delta en delta con una muestra por período de alineación, usa esta función. Es posible que se interpolan datos cuando usas esta función. Para ver un ejemplo, consulta Tipos, tipos y conversiones.

Esta función es válida solo 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 transformarse como lo estaba con una función delta y, luego, dividirse 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 el segundo; luego, tiene una unidad de MiB por segundo. Para obtener más información, consulta Tipos, tipos y conversiones.

Esta función es válida solo 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 está disponible y si estableces el campo Transform en un valor que que None, todos los demás campos son la configuración de agregación secundaria.

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

Haz clic en Agregar elemento de consulta. y, luego, selecciona Agregación secundaria.
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 la leyenda

El campo Alias de la leyenda te permite personalizar la descripción del series temporales en tu gráfico. Estas descripciones aparecen en el cuadro de información de y en la leyenda del gráfico en la columna Name. 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 compilar una plantilla descripciones, usa este campo.

Puedes ingresar texto sin formato y plantillas en el campo Alias de la leyenda. Cuándo agregas una plantilla y una expresión que se evalúa cuando la leyenda el código fuente.

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

En el panel Display, haz lo siguiente: Expande Alias de la leyenda.
Haz clic en Mostrar sugerencias de variables de plantilla. y selecciona una entrada del menú. Por ejemplo, si seleccionas zone, la Se agregó la plantilla ${resource.labels.zone}.

Por ejemplo, la siguiente captura de pantalla muestra una plantilla de la 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 Name y en el cuadro de información:

Descripciones generadas a partir de una plantilla

Puedes configurar la plantilla de la leyenda para que incluya varias cadenas de texto y templates; Sin embargo, el espacio de visualización disponible en el cuadro de información es limitado.