Paneles y gráficos

Los paneles son una forma de ver y analizar los datos de métricas que te importan.

Cloud Monitoring admite paneles predefinidos y personalizados:

  • Los paneles preconfigurados se instalan de forma automática para los servicios de Google Cloud que usas. Estos paneles no se pueden configurar.
  • Los paneles personalizados son los que creas o instalas:

    • La página Paneles de Google Cloud Console proporciona una lista seleccionada de los paneles que puedes obtener una vista previa y, luego, instalar.

    • Cuando la representación JSON de un panel se almacena en GitHub o en un servidor local, puedes instalar ese panel mediante Cloud Console o la API de Cloud Monitoring. El repositorio monitoring-dashboard-samples de GitHub contiene definiciones de paneles para varios servicios de Google Cloud.

En cualquier panel personalizado que tengas en tu proyecto de Google Cloud, puedes descargar y copiar la definición de ese panel. Estas capacidades te permiten compartir una definición de panel con varios proyectos.

En este documento, se describe lo siguiente:

  • Qué se puede mostrar en un panel
  • Las cuotas y los límites aplicables a los paneles.
  • La autorización necesaria para crear y modificar paneles.
  • Cómo mejorar el rendimiento de tus gráficos y paneles.

Para obtener información sobre cómo crear y administrar paneles, consulta los siguientes documentos:

Widgets del panel

En esta sección, se proporcionan ejemplos de los widgets que puedes agregar a un panel personalizado.

Gráfico de líneas

Para que tu serie temporal se muestre con la mayor resolución posible, usa un gráfico de líneas o un gráfico de áreas apiladas. De forma predeterminada, los gráficos de líneas asignan un color único a cada serie temporal que se muestra. Sin embargo, puedes configurar estos gráficos para que solo muestren valores atípicos, medidas estadísticas, como el “percentil 50”, o los datos en modo de rayos X. Para obtener más información sobre estas opciones, consulta Configura opciones de vista.

En la siguiente captura de pantalla, se muestra un ejemplo de un gráfico de líneas en modo en color:

Ejemplo de un gráfico de líneas en modo en color

Gráfico de áreas apiladas

Para mostrar la suma de las series temporales, con la contribución de cada serie temporal ilustrada por una banda de color única, usa un gráfico de áreas apiladas. Puedes configurar estos gráficos para mostrar solo valores atípicos. Si colocas el cursor sobre el gráfico, puedes ver la contribución específica de una serie temporal a la suma.

En la siguiente captura de pantalla, se muestra un ejemplo de un gráfico de áreas apiladas en modo en color.

Ejemplo de un gráfico de áreas apiladas en el modo en color

Gráfico de barras apiladas

Para ver series temporales con muestras poco frecuentes, como las métricas de cuota que tienen una muestra por día, usa gráficos de barras apiladas. Estos gráficos tienen menor resolución que los gráficos de líneas y los gráficos de áreas apiladas. De forma predeterminada, a cada serie temporal se le asigna un color único. Sin embargo, puedes configurar estos gráficos para mostrar solo valores atípicos.

En la siguiente captura de pantalla, se muestra un ejemplo de un gráfico de barras apiladas en modo en color.

Ejemplo de un gráfico de barras apiladas en modo de color.

Gráfico de mapa de calor

Para mostrar métricas con un valor de distribución, usa gráficos de mapa de calor. Los mapas de calor usan color para representar los valores en la distribución. Para ver las líneas percentiles o los valores atípicos, usa la configuración del mapa de calor.

En la siguiente imagen, se muestran las latencias de solicitud de la API de Cloud Spanner en un proyecto de Google Cloud:

Ejemplo de gráfico de mapa de calor.

Para obtener un análisis detallado de estos gráficos, consulta Crea gráficos de las métricas de distribución.

Gráfico de alertas

Para mostrar un resumen de una política de alertas de una sola condición en tu panel personalizado, agrega un gráfico de alertas. Los gráficos de alertas muestran la serie temporal que supervisa la política, un límite, la cantidad de incidentes asociados con la política y si está inhabilitada.

En la siguiente captura de pantalla, se muestra un gráfico de alertas:

Ejemplo de un gráfico de alertas

En este ejemplo, la política de alertas supervisa el uso de CPU de dos máquinas virtuales diferentes. La línea discontinua muestra el umbral de la condición, que se establece en 50 %. El chip verde con la etiqueta No incidents indica que no hay incidentes abiertos para la política de alertas. Si colocas el puntero sobre el chip de incidentes, se abrirá un cuadro de diálogo que vincula a la política de alertas subyacente.

Medidores

Agrega un indicador para ver las mediciones más recientes en comparación con un conjunto de umbrales codificado por colores. Como se ilustra en la siguiente captura de pantalla, un indicador muestra el valor actual como un número, una línea horizontal gruesa y un arco con una línea delgada y una línea gruesa:

Ejemplo de un indicador.

La línea delgada del arco muestra el rango de valores posibles y usa el color para indicar zonas buenas, de advertencia y de peligro. En la captura de pantalla anterior, la línea delgada muestra un indicador configurado con las tres zonas. La línea gruesa del arco muestra el valor actual. En la captura de pantalla, el valor está en la zona buena y, por lo tanto, la línea gruesa es de color verde. El color de la línea horizontal coincide con el de la línea gruesa del arco.

Si el valor de un medidor ingresa una advertencia o zona de peligro, el fondo del indicador cambia de blanco a amarillo o rojo.

Paneles de registros

Agrega un panel de registros para ver los registros almacenados en tu proyecto de Google Cloud o en proyectos de Google Cloud accesibles a través del alcance de métricas actual. El panel de registros admite consultas mediante el lenguaje de consulta de Cloud Logging, y puedes abrir el Explorador de registros desde este panel.

En la siguiente captura de pantalla, se muestra un panel de registros:

Ejemplo de un panel con un panel de registros.

Cuadros de evaluación

Para ver la medición más reciente en comparación con un conjunto de umbrales, junto con un historial de mediciones recientes, agrega un cuadro de evaluación. En la siguiente captura de pantalla, se muestra un cuadro de evaluación configurado para mostrarse como SPARK_LINE:

Ejemplo de un cuadro de evaluación.

Los cuadros de evaluación muestran el valor actual como un número. Si seleccionas una vista SPARK_LINE, estos gráficos también incluirán una línea delgada que muestra el historial de mediciones recientes y una línea gruesa. El color de las dos líneas y el fondo está determinado por el valor actual (si está en la zona buena, de advertencia o de peligro). En este ejemplo, el valor actual está en la zona buena, por lo que las líneas son verdes y el fondo es blanco.

Tablas

Las tablas te permiten ver los datos de las métricas en formato de tabla. Las tablas pueden ser más responsivas que los gráficos y te permiten ordenar los datos que se muestran por valor de etiqueta.

Por ejemplo, en la siguiente captura de pantalla, se ve una tabla que muestra el uso de CPU de las instancias de máquina virtual:

Ejemplo de un widget de tabla.

Cuadros de texto

Los cuadros de texto te permiten agregar información al panel. El contenido de un cuadro de texto puede ser información sobre el panel, vínculos a recursos relevantes o qué hacer en diferentes situaciones. En la siguiente captura de pantalla, se ilustra un cuadro de texto:

Ejemplo de un panel con un widget de texto.

Los cuadros de texto pueden incluir vínculos a recursos externos.

Cuotas y límites

Los siguientes límites se aplican a los paneles y los gráficos:

Category Valor
Paneles por alcance de métricas 1000
Gráficos por panel 40
Líneas por gráfico 300

Autorización

En esta sección, se describen las funciones o los permisos necesarios para crear un panel o agregar gráficos a un panel. A fin de obtener información detallada sobre la administración de identidades y accesos (IAM) para Cloud Monitoring, consulta Control de acceso.

Cada función de IAM tiene un ID y un nombre. Los ID de las funciones tienen el formato roles/monitoring.editor y se pasan como argumentos a la herramienta de línea de comandos de gcloud cuando configuras el control de acceso. Para obtener más información, consulta Cómo otorgar, cambiar y revocar el acceso a los recursos. En Cloud Console, se muestran nombres de funciones, como el Editor de supervisión.

Funciones de Cloud Console requeridas

A fin de crear un panel o agregar gráficos a un panel, tu nombre de función de IAM para el proyecto de Google Cloud debe ser uno de los siguientes:

  • Editor de Monitoring
  • Administrador de Monitoring
  • Propietario del proyecto

Para ver una lista de las funciones y sus permisos asociados, consulta Funciones.

Permisos de API necesarios

A fin de usar la API de Cloud Monitoring con el objetivo de crear un panel o agregar gráficos a un panel, tu ID de función de IAM para el proyecto de Google Cloud debe ser uno de los siguientes:

  • roles/monitoring.dashboardEditor: este ID de función otorga los permisos mínimos necesarios para crear un panel o agregar gráficos a un panel. Para obtener más detalles sobre esta función, consulta Funciones de panel predefinidas.
  • roles/monitoring.editor
  • roles/monitoring.admin
  • roles/owner

A fin de identificar el permiso necesario para un método específico de la API de Cloud Monitoring, consulta Permisos de la API de Cloud Monitoring. Para ver una lista de las funciones y sus permisos asociados, consulta Funciones.

Determina tu función

Para determinar tu función en un proyecto con Cloud Console, haz lo siguiente:

  1. Abre Cloud Console y selecciona el proyecto de Google Cloud:

    Ir a Cloud Console

  2. Para ver tu función, haz clic en IAM y administrador. Tu función está en la misma línea que tu nombre de usuario.

Para determinar tus permisos a nivel de la organización, comunícate con el administrador de la organización.

Rendimiento de los paneles y los gráficos

El rendimiento de un gráfico es sensible a la cantidad de series temporales que se mostrarán. La cantidad de series temporales depende, en parte, de la estructura del tipo de métrica y del tipo de recurso supervisado asociado con la serie temporal. Cada uno de estos tipos tiene varias etiquetas. En la Lista de métricas y en la Lista de recursos supervisados, se incluyen las etiquetas de cada tipo de métrica y de recurso supervisado.

Hay una serie temporal para cada combinación única de valores del conjunto de etiquetas. La cantidad de combinaciones posibles se denomina cardinalidad. Para obtener más información sobre las etiquetas, los valores y la cardinalidad, consulta Cardinalidad.

Si encuentras problemas de rendimiento cuando muestras los datos de las métricas, a menudo puedes mitigar los problemas mediante el uso de una de las siguientes técnicas:

  • Quita la información innecesaria con los filtros.
  • Contrae la información relacionada mediante la combinación de series temporales.
  • Enfócate en los datos inusuales mediante el modo de valores atípicos.
  • Reduce la cardinalidad de una métrica personalizada mediante la reducción de la cantidad de etiquetas o el rango de valores posibles en una etiqueta.