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

Cree gráficos con el Explorador de métricas

En este documento, se describe cómo puedes explorar datos de métricas mediante la creación de un gráfico temporal con el Explorador de métricas. Por ejemplo, para ver el uso de CPU de una máquina virtual (VM), puedes usar el Explorador de métricas a fin de construir un gráfico que muestre los datos más recientes. Si quieres obtener gráficos permanentes, puedes crear un gráfico con el Explorador de métricas y guardarlo en un panel personalizado. Una alternativa es crear un panel personalizado, que pueda mostrar gráficos, registros, incidentes y otro contenido, y luego usar la interfaz del panel para agregar gráficos a ese panel. Para obtener información sobre los paneles personalizados, consulta Crea y administra paneles personalizados.

Puedes crear gráficos simples, como los que grafican un solo tipo de métrica, y gráficos complejos, como los que trazan varios tipos de métrica. Después de crear un gráfico con el Explorador de métricas, puedes descartarlo, guardarlo en un panel personalizado, guardar su configuración o compartirlo.

En la siguiente captura de pantalla, se muestra un solo tipo de métrica: el uso de CPU de una instancia de VM, representado en la página Explorador de métricas:

Métrica representada con el Explorador de métricas.

En la captura de pantalla anterior, se muestran varias líneas, y cada una muestra el uso de CPU promedio de todas las VM en una zona específica.

Gráfico de un solo tipo de métrica

Si deseas configurar un gráfico para que muestre una sola métrica, haz lo siguiente:

En la consola de Google Cloud, selecciona Monitoring o haz clic en el siguiente botón:
Ir a Monitoring
En el panel de navegación, selecciona Explorador de métricas .
Especifica los datos que se mostrarán en el gráfico. Puedes usar una interfaz controlada por menú, el lenguaje de consulta de supervisión (MQL), PromQL o un filtro de Monitoring:
Interfaz basada en menús
1. Selecciona los datos de series temporales que deseas ver:
  1. En el panel Seleccionar una métrica, expande el menú Métrica y, luego, usa los menús para seleccionar un tipo de recurso y una métrica. Por ejemplo, puedes tomar las siguientes decisiones:
    
    En el menú Recursos activos, selecciona Instancia de VM.
    
    En el menú Categorías de métricas activas, selecciona uptime_check.
    
    En el menú Métricas activas, selecciona Solicitar latencia.
    
    Haz clic en Aplicar.
    
    Para limitar la cantidad de opciones en los menús, ingresa el nombre de la métrica o el recurso en la barra de filtros. Por ejemplo, para graficar la latencia de la solicitud de una instancia de VM, puedes ingresar “latencia”.
    
    Después de realizar sus selecciones, el título del panel cambia. Por ejemplo, si realizaste las sugerencias anteriores, el título del panel se convierte en Latencia de la solicitud.
  2. Opcional: Si quieres especificar un subconjunto de datos para mostrar, selecciona Agregar filtro y completa el diálogo. Por ejemplo, puedes ver un dato para una zona si aplicas un filtro. Puedes agregar varios filtros. Para obtener más información, consulta Filtra los datos del gráfico.
  Para obtener más información, consulta Selecciona los datos para graficar.
2. Agrupar y alinear series temporales:
  - Para mostrar todas las series temporales, en la entrada Agrupar por, haz clic en Borrar agrupación.
  - Para combinar series temporales que tengan el mismo valor de etiqueta, expande el menú Etiquetas y selecciona los valores de etiqueta. También puedes cambiar el valor de la función de agrupamiento. Por ejemplo, un gráfico puede mostrar el valor promedio de las series temporales, en el que el promedio se calcula por zona.
  - Opcional: Para configurar el espaciado entre datos, haz clic en Más opciones y, luego, usa los campos Alineación de datos.
  Para obtener más información sobre el agrupamiento y la alineación, consulta Cómo mostrar los datos del gráfico.
MQL
1. En la barra de herramientas del panel Selecciona una métrica, elija Editor de código.
2. Selecciona MQL en el botón de activación Idioma. El botón de activación del idioma se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.
3. 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
```
  En los siguientes documentos, se proporciona información sobre MQL:
  - Introducción a MQL
  - Usar el Editor de consultas
PromQL
1. En la barra de herramientas del panel Selecciona una métrica, elija Editor de código.
2. Selecciona PromQL en el botón de activación Idioma. El botón de activación del idioma se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.
3. 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.
Filtro de supervisión
1. En la barra de herramientas del panel Seleccionar una métrica, haz clic en Ayuda en el menú Métrica y, luego, selecciona Modo de filtro directo.
  
  Se mostrará un cuadro de texto con la etiqueta Ingresar un filtro de Monitoring. Si seleccionaste un tipo de recurso, una métrica o filtros antes de cambiar al modo de filtro directo, esa configuración se mostrará en el cuadro de texto.
2. Ingresa un filtro de Monitoring.
3. Agrupar y alinear series temporales:
  - Para mostrar todas las series temporales, en la entrada Agrupar por, haz clic en Borrar agrupación.
  - Para combinar series temporales que tengan el mismo valor de etiqueta, expande el menú Etiquetas y selecciona los valores de etiqueta. También puedes cambiar el valor de la función de agrupamiento. Por ejemplo, un gráfico puede mostrar el valor promedio de las series temporales, en el que el promedio se calcula por zona.
  - Opcional: Para configurar el espaciado entre datos, haz clic en Más opciones y, luego, usa los campos Alineación de datos.
  Para obtener más información sobre el agrupamiento y la alineación, consulta Cómo mostrar los datos del gráfico.
Actualiza la configuración del gráfico según el tipo de métrica que seleccionaste:
- Para los tipos de métricas de cuota, usa la siguiente configuración:
  - En la barra de herramientas, configura el control de tiempo para que sea de al menos una semana. Por lo general, las métricas de cuota informan una muestra por día.
  - En el panel Display, expande el menú Widget type y, luego, selecciona Stacked bar chart.
- Para los tipos de métricas que tienen un tipo de valor Distribution, asegúrate de que el menú Tipo de widget esté configurado en Gráfico de mapa de calor. Para obtener más información, consulta Información sobre las métricas con valor de distribución.
Opcional: Cambia la forma en que el gráfico muestra los datos seleccionados. Tienes las siguientes opciones:
- Cambia el tipo de widget. Por ejemplo, convierte un gráfico de líneas en un gráfico de barras apiladas.
- Agrega umbrales de referencia.
- Configura el eje Y y establece ese eje en escala de registro.
- Configura el gráfico para que se muestre en los modos de rayos X o de estadísticas.
- Compara los datos actuales con los anteriores.
- Configura el nombre de una columna de leyenda.

Gráfico de múltiples tipos de métricas

En algunas situaciones, es posible que desees mostrar series temporales de diferentes tipos de métricas en el mismo gráfico. Por ejemplo, a fin de comparar las cargas de lectura y escritura en una VM, configura un gráfico para que muestre la cantidad de bytes leídos y los escritos.

Para crear gráficos de varias métricas, debes usar la interfaz controlada por menú. Las otras interfaces no admiten el trazado de múltiples métricas.

Para mostrar varias métricas en un gráfico, haz lo siguiente:

En la consola de Google Cloud, selecciona Monitoring o haz clic en el siguiente botón:
Ir a Monitoring
En el panel de navegación, selecciona Explorador de métricas .
Usa las opciones del panel Seleccionar una métrica para seleccionar el primer tipo de métrica cuyos datos deseas ver. Para obtener información sobre estos pasos, consulta Gráfico de un solo tipo de métrica.

El título del panel Seleccionar una métrica cambia para ser la métrica que seleccionaste.
Para cada tipo de métrica adicional, haz lo siguiente:
1. Selecciona Agregar consulta.
  
  El nuevo panel Seleccionar una métrica oculta las consultas configuradas previamente.
2. En el panel Selecciona una métrica, usa los menús para seleccionar un tipo de recurso y un tipo de métrica. De manera opcional, también puedes usar los menús para agregar filtros, agrupar series temporales y establecer los campos de alineación.
Para ver todos los tipos de métricas que configuraste, ve a la barra de herramientas del panel que estás viendo y selecciona Contraer.

En la siguiente captura de pantalla, se muestra el Explorador de métricas cuando hay dos tipos de métricas representados:

$Ejemplo del Explorador de métricas con dos tipos de métricas.$
Opcional: En el panel Display, expande el menú Eje Y y configura qué eje Y se usa para cada tipo de métrica.

Representar gráficamente una proporción de métricas

Supervisar la cantidad de errores informados puede ser útil; sin embargo, es más probable que necesites supervisar la tasa de errores. Es decir, quieres saber cuántos errores se midieron en comparación con la cantidad total de respuestas. Para cumplir con este requisito, puedes configurar un gráfico a fin de que muestre la proporción de dos métricas. Para obtener referencias sobre ejemplos y información sobre anomalías que pueden ocurrir cuando graficas proporciones de métricas, consulta Razones de métricas.

Para mostrar una proporción de métricas en un gráfico, haz lo siguiente:

En la consola de Google Cloud, selecciona Monitoring o haz clic en el siguiente botón:
Ir a Monitoring
En el panel de navegación, selecciona Explorador de métricas .
Especifica los datos que aparecerán en el gráfico:
Interfaz basada en menús
1. Configura el numerador:
  1. En el panel Selecciona una métrica, usa los menús para seleccionar un tipo de recurso y un tipo de métrica. Para obtener información sobre estos pasos, consulta Gráfico de un solo tipo de métrica.
  2. Actualiza los campos de agrupación y los parámetros de alineación. De forma predeterminada, el Explorador de métricas agrega una agrupación que promedia las series temporales.
  3. Actualiza los parámetros de alineación (opcional). Para ver los parámetros de alineación, haz clic en Más opciones.
2. Configura el denominador:
  1. Selecciona Agregar consulta.
    
    El nuevo panel Seleccionar una métrica oculta las consultas configuradas previamente.
  2. En el panel Selecciona una métrica, usa los menús para seleccionar un tipo de recurso y un tipo de métrica.
    
    Los tipos de métricas de numerador y denominador deben tener el mismo tipo de métrica. Por ejemplo, si la métrica del numerador es una métrica GAUGE, la métrica que selecciones para el denominador debe ser una métrica GAUGE.
  3. Asegúrate de que el valor del campo Período de alineación mínimo sea el mismo para ambas métricas. Para ver los parámetros de alineación, haz clic en Más opciones.
  4. Actualiza los campos de agrupación.
    
    Recomendamos que los campos de agrupación del tipo de métrica del denominador coincidan con los valores establecidos para el tipo de métrica numerador. Por ejemplo, puedes agrupar ambos tipos de métricas según la etiqueta zone.
    
    No es necesario que uses la misma agrupación para ambos tipos de métricas; sin embargo, solo puedes agrupar por etiquetas que sean comunes a ambos tipos de métricas.
  5. Para ver todos los tipos de métricas que configuraste, ve a la barra de herramientas del panel que estás viendo y selecciona Contraer.
    
    Se muestran tus consultas de numerador y denominador.
3. Selecciona Crear proporción en la barra de herramientas del panel de consulta y, luego, completa el diálogo.
  
  Después de crear la proporción, se muestran tres consultas:
  - A/B Ratio identifica la consulta de proporción.
  - A identifica la consulta del numerador.
  - B identifica la consulta para el denominador.
  En el siguiente ejemplo, se ilustra una proporción que compara la suma de bytes escritos en el disco por zona y la cantidad total de bytes escritos en el disco:
  
  $Ejemplo de una proporción de métricas.$
4. Opcional: Para cambiar las métricas del numerador y del denominador, haz lo siguiente:
  1. Haz clic en Expandir en la barra de herramientas para la consulta cuyo nombre comienza con A/B.
  2. Expande el menú Numerador y denominador y selecciona una opción.
MQL
1. En la barra de herramientas del panel Selecciona una métrica, elija Editor de código.
2. Ingresa tu consulta en el editor de consultas. MQL te permite calcular una proporción de dos métricas diferentes y filtrar una sola métrica por etiqueta y, luego, calcular la proporción. En la siguiente consulta, se calcula la proporción de respuestas con un valor de 500 a la cantidad total de respuestas:
```
fetch https_lb_rule::loadbalancing.googleapis.com/https/request_count
| {
    filter response_code_class = 500
  ;
    ident
  }
| group_by [matched_url_path_rule]
| outer_join 0
| div
```
  En los siguientes documentos, se proporciona información sobre MQL:
PromQL
1. En la barra de herramientas del panel Selecciona una métrica, elija Editor de código.
2. Selecciona MQL en el botón de activación Idioma. El botón de activación del idioma se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.
3. Ingresa tu consulta en el editor de consultas. Por ejemplo, para graficar la proporción de latencia promedio de tu métrica my_summary_latency_seconds, usa la siguiente consulta:
```
sum without (instance)(rate(my_summary_latency_seconds_sum[5m])) /
sum without (instance)(rate(my_summary_latency_seconds_count[5m]))
```
  Para obtener más información sobre el uso de PromQL, consulta PromQL en Cloud Monitoring.
Filtro de supervisión
No compatible.

Guardar un gráfico para referencia futura

El Explorador de métricas te permite crear un gráfico que puedes usar para explorar una métrica. Sin embargo, los gráficos creados por esta herramienta no son persistentes. Cuando sales de la página Explorador de métricas, se descarta el gráfico.

Si deseas guardar un gráfico que configuraste con el Explorador de métricas para referencia futura, agrega el gráfico a un panel personalizado o guarda la URL del gráfico:

Para agregar el gráfico a un panel personalizado, realiza una de las siguientes acciones:
- Si usas la consola de Google Cloud para administrar tus paneles personalizados, selecciona Guardar gráfico en la barra de herramientas del Explorador de métricas y completa el diálogo. Puedes guardar el gráfico en un panel personalizado existente o crear un panel.
- Si usas la API de Cloud Monitoring para administrar tus paneles personalizados, actualiza el archivo JSON que define el panel y su contenido. Para acceder a la representación JSON, haz clic en Editor de JSON en la barra de herramientas del gráfico.
  
  Si deseas obtener información detallada sobre cómo usar la API para administrar tus paneles personalizados, consulta Cómo crear y administrar paneles por API.
Para mantener una referencia a la configuración del gráfico, guarda la URL del gráfico. Debido a que la URL del gráfico codifica la configuración del gráfico, cuando pegas esta URL en un navegador, se muestra el gráfico que configuraste.

Para obtener la URL del gráfico, haz clic en Link en la barra de herramientas del gráfico.

Guarda la configuración de un gráfico

Cuando administras paneles personalizados con la API de Cloud Monitoring, puedes usar el Explorador de métricas para crear los datos que proporcionas a la API:

Para generar la representación JSON de un gráfico que planeas agregar a un panel, configura el gráfico con el Explorador de métricas. Luego, puedes usar las opciones del Explorador de métricas para ver y copiar la representación JSON del gráfico.
Para identificar la sintaxis de un filtro de Monitoring, que se usa con la API de Cloud Monitoring, usa la interfaz basada en menús del Explorador de métricas para configurar el gráfico. Después de seleccionar la métrica y los filtros, cambia al modo de filtro directo para ver el filtro de Monitoring equivalente.

Guardar los datos que se muestran en el gráfico

Para guardar los datos que muestra el gráfico en tu sistema local, haz clic en Descargar CSV.