Agregar widgets del panel

En este documento, se describe cómo agregar widgets a un panel personalizado mediante Google Cloud Console. Los paneles personalizados pueden mostrar datos de métricas, políticas de alertas, texto descriptivo y entradas de registro. Estos paneles también pueden mostrar objetivos de nivel de servicio (SLO) para un conjunto de servicios.

En general, los widgets del panel pueden mostrar cualquier tipo de métrica que tenga un valor numérico o de distribución, incluidas las métricas personalizadas y las métricas basadas en registros. Los widgets del panel no pueden graficar datos de tipo string.

Cuando agregas widgets que muestran datos de métricas, puedes mostrarlos durante un intervalo de tiempo o mostrar solo los más recientes. Por ejemplo, para mostrar una métrica durante un intervalo de tiempo, agrega un gráfico de líneas, un gráfico de áreas apiladas, un gráfico de barras o un gráfico de mapa de calor. Para mostrar solo los datos más recientes, agrega una tabla o un indicador. Los indicadores cambian de color en función de cómo se comparan los datos con los umbrales de advertencia y peligro. Para obtener información general sobre los diferentes tipos de widgets, consulta Paneles y gráficos.

Puedes colocar hasta 40 widgets en un panel y organizarlos en grupos con nombre.

Para obtener información sobre la API de Cloud Monitoring, consulta Administra paneles con la API.

Antes de comenzar

Antes de crear o modificar un panel, asegúrate de tener una de las siguientes funciones de administración de identidades y accesos:

  • roles/monitoring.dashboardEditor
  • roles/monitoring.editor
  • roles/monitoring.admin
  • roles/owner

Para obtener más información sobre las funciones, consulta Control de acceso.

Agrega gráficos y tablas a un panel

En esta sección, se describe cómo configurar gráficos y tablas mediante la consola:

  • Los gráficos muestran datos a lo largo del tiempo y hay cuatro estilos disponibles: Línea, Área apilada, Barra apilada y Mapa de calor. Después de configurar un gráfico, puedes cambiar su tipo de widget. Para obtener información sobre por qué puedes seleccionar un estilo específico, consulta Gráficos que muestran datos en el tiempo.

    Si deseas obtener información sobre el uso de la API de Cloud Monitoring para configurar un gráfico, consulta Panel con un widget XyChart.

  • Las tablas contienen una fila para cada serie temporal supervisada y solo muestran el valor más reciente. Hay dos estilos de tablas. El widget Tabla muestra un valor numérico como “25%”. El widget de Lista superior muestra el valor y un indicador visual del valor en comparación con el rango de valores posibles. Puedes cambiar entre estos tipos de widgets.

    Si quieres obtener información sobre el uso de la API de Cloud Monitoring para configurar una tabla, consulta Panel con un widget TimeSeriesTable.

Para agregar un gráfico o una tabla a un panel, haz lo siguiente:

  1. En la consola, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, el panel que deseas ver o editar.
  3. Si se muestra el botón Editar panel, haz clic en él.
  4. Selecciona un gráfico o widget de tabla desde la biblioteca de gráficos o arrastra uno de estos widgets desde la biblioteca hasta el área del gráfico.

  5. Especifica los datos que muestra el widget:

    • Para configurar el widget rápidamente, usa el modo Básico. Este modo proporciona opciones de configuración mínimas. Siempre puedes cambiar de una configuración básica a un modo de configuración diferente.
    • Para acceder a todos los campos configurables o ingresar un filtro de Monitoring, usa el modo Avanzado. Es posible que no puedas cambiar a un modo de configuración diferente.
    • Para usar el lenguaje de consulta de Monitoring (MQL), selecciona la pestaña MQL. Cuando usas MQL, no puedes cambiar a un modo de configuración diferente y conservar tu consulta.

    En la siguiente tabla, se describen las opciones para cada modo:

Básica

Para configurar el widget, completa los siguientes pasos:

  1. Selecciona los datos de series temporales que deseas ver.
  2. (Opcional) Series temporales de grupos.
  3. (Opcional) Configure las opciones de vista de gráfico.
  4. (Opcional) Cree gráficos de varios tipos de métricas.

Selecciona los datos de series temporales que deseas ver

Para seleccionar las series temporales que quieres crear, realiza una de las siguientes acciones:

  • A fin de mostrar un tipo de métrica, como el uso de CPU de una VM, usa los menús para realizar tus selecciones:

    1. Haz clic en Seleccionar una métrica y, luego, usa los menús para seleccionar un tipo de recurso y un tipo de métrica.

      Para reducir la cantidad de opciones del menú, ingresa el nombre de un recurso o un tipo de métrica en la barra de filtros . Por ejemplo, para graficar el uso de CPU de una instancia de VM, puedes ingresar utilization en la barra de filtros.

      Para enumerar todos los tipos de recursos y métricas, inhabilita la opción Mostrar solo recursos 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.

    2. Para especificar un subconjunto de datos para mostrar, agrega un filtro o aplica variables de plantilla (opcional). Por ejemplo, puedes ver los datos de una zona mediante la aplicación de un filtro. Puedes agregar varios filtros. Para obtener más información sobre los filtros, consulta Filtra los datos del gráfico. Para obtener información sobre las variables de la plantilla, consulta Filtra un panel.

      Para agregar un filtro, haz clic en Agregar un filtro y selecciona la etiqueta y el valor de la etiqueta. Por ejemplo, para mostrar series temporales solo en la zona us-east1-b, ingresa el filtro zone = us-east1-b.

      Para aplicar una variable de plantilla, usa el menú.

  • Para mostrar un objetivo de nivel de servicio o el recuento de procesos que se ejecutan en las VM, ingresa un filtro de Monitoring:

    1. Haz clic en Ayuda en el menú Seleccionar una métrica.
    2. Seleccione Modo de filtro directo.
    3. Ingresa el filtro de Monitoring en el cuadro de texto.

Si deseas obtener más información sobre estas opciones, consulta Selecciona métricas para gráficos en paneles.

Series temporales grupales

  1. Determina si deseas ver todas las series temporales o si deseas agrupar series temporales por valores de etiqueta.

    • Para mostrar todas las series temporales, deja desmarcada la opción Agrupado.
    • Para agrupar series temporales por valores de etiqueta, selecciona Agrupado y, luego, usa el menú Agrupar por a fin de seleccionar las etiquetas para agrupar. Una vez que realices las selecciones que hagas, haz clic en Aceptar.

    Esta opción no está disponible para los gráficos de mapas de calor, ya que estos solo pueden mostrar una sola serie temporal.

  2. Para especificar cómo combinar datos dentro de una serie temporal, usa los botones de selección.

    Por ejemplo, si un gráfico puede mostrar 60 datos y los datos se escriben a 1 punto por minuto, entonces, el gráfico puede mostrar 1 hora de datos. Para mostrar 3 horas de datos, debes reducir 180 datos a 60. Cuando este selector es mean, cada punto del gráfico es el promedio de tres puntos en la serie temporal original.

Configura las opciones de vista de gráfico

Estos campos no están disponibles para las tablas.

Representar gráficamente varios tipos de métricas

Esta opción no está disponible para las tablas.

Para mostrar otro tipo de métrica en tu gráfico, haz clic en Agregar otra métrica y repite los pasos anteriores. Un gráfico puede mostrar un máximo de 10 tipos de métricas.

La primera vez que hagas clic en Agregar otra métrica, las selecciones que hiciste antes se mostrarán en el panel Series temporales A. Además, se abrirá el panel Series temporales B. Este panel contiene los campos de configuración que completas para graficar el segundo tipo de métrica.

En la siguiente captura de pantalla, se ilustra este comportamiento:

Ejemplo de la configuración del Explorador de métricas con dos métricas.

Avanzado

Para configurar el widget, completa los siguientes pasos:

  1. Selecciona los datos de series temporales que deseas ver.
  2. Selecciona cómo se procesan las series temporales.
  3. (Opcional) Series temporales de grupos.
  4. (Opcional) Configure las opciones de vista de gráfico.
  5. (Opcional) Cree gráficos de varios tipos de métricas.
  6. Crea un gráfico de una proporción de tipos de métricas (opcional).

Selecciona los datos de series temporales que deseas ver

Para seleccionar las series temporales que quieres crear, realiza una de las siguientes acciones:

  • A fin de mostrar un tipo de métrica, como el uso de CPU de una VM, usa los menús para realizar tus selecciones:

    1. Haz clic en Seleccionar una métrica y, luego, usa los menús para seleccionar un tipo de recurso y un tipo de métrica.

      Para reducir la cantidad de opciones del menú, ingresa el nombre de un recurso o un tipo de métrica en la barra de filtros . Por ejemplo, para graficar el uso de CPU de una instancia de VM, puedes ingresar utilization en la barra de filtros.

      Para enumerar todos los tipos de recursos y métricas, inhabilita la opción Mostrar solo recursos 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.

    2. Para especificar un subconjunto de datos para mostrar, agrega un filtro o aplica variables de plantilla (opcional). Por ejemplo, puedes ver los datos de una zona mediante la aplicación de un filtro. Puedes agregar varios filtros. Para obtener más información sobre los filtros, consulta Filtra los datos del gráfico. Para obtener información sobre las variables de la plantilla, consulta Filtra un panel.

      Para agregar un filtro, haz clic en Agregar un filtro y selecciona la etiqueta y el valor de la etiqueta. Por ejemplo, para mostrar series temporales solo en la zona us-east1-b, ingresa el filtro zone = us-east1-b.

      Para aplicar una variable de plantilla, usa el menú.

  • Para mostrar un objetivo de nivel de servicio o el recuento de procesos que se ejecutan en las VM, ingresa un filtro de Monitoring:

    1. Haz clic en Ayuda en el menú Seleccionar una métrica.
    2. Seleccione Modo de filtro directo.
    3. Ingresa el filtro de Monitoring en el cuadro de texto.

Si deseas obtener más información sobre estas opciones, consulta Selecciona métricas para gráficos en paneles.

Selecciona cómo se procesan previamente las series temporales

En general, esta configuración se puede dejar en el valor predeterminado.

Las opciones de procesamiento previo se muestran cuando la métrica seleccionada es un tipo de métrica delta o cumulativa. El tipo de valor de la métrica determina las opciones específicas que están disponibles.

Cuando las opciones de procesamiento previo están disponibles, usas los botones de selección para especificar cómo quieres que se procesen los datos sin procesar antes de alinear los datos. En el siguiente ejemplo, se muestran las opciones cuando se seleccionan series temporales para una métrica DELTA:

Muestra las opciones de procesamiento previo para una métrica acumulativa.

Para las métricas DELTA, cuando se selecciona Rate, los valores de datos se dividen por la tasa de muestreo. Cuando se selecciona No preprocessing step, la tasa de muestreo no escala los valores de datos. Por ejemplo, cuando las unidades de la métrica son MiB, cuando seleccionas rate, se cambian las unidades a MiB por segundo. Para obtener más información y un ejemplo, consulta Tipos, tipos y conversiones.

Series temporales grupales

  1. Selecciona los parámetros de alineación. En general, estos campos pueden quedar con los valores predeterminados. Para obtener más información, consulta Alineación: regularización dentro de la serie.

  2. Determina si deseas ver todas las series temporales o si deseas agrupar series temporales por valores de etiqueta.

    • Para combinar las series temporales en una sola serie temporal, asegúrate de que el campo Agrupar por esté vacío y selecciona cómo se combinan las series temporales con el menú Agrupar por función.

      Cuando muestras series temporales en un mapa de calor, debes combinar las series temporales con este enfoque. Los mapas de calor solo pueden mostrar una sola serie temporal. Para obtener más información, consulta Métricas de distribución.

    • Para mostrar todas las series temporales, realiza una de las siguientes acciones:

      • Asegúrate de que el campo Agrupar por esté vacío y selecciona none para Agrupar por función.
      • Expande el menú Agrupar por, selecciona Agregar todo y, luego, selecciona el menú Agrupar por función.
    • Para agrupar series temporales por valores de etiqueta específicos, haz clic en Agrupar por y selecciona las etiquetas que deseas agrupar. Para especificar cómo se combinan las series temporales, selecciona una función con el menú Agrupar por función.

    Para obtener información general sobre la alineación y la agrupación, consulta Elige cómo mostrar los datos.

Configura las opciones de vista de gráfico

Estos campos no están disponibles para las tablas.

Representar gráficamente varios tipos de métricas

Esta opción no está disponible para las tablas.

Para mostrar otro tipo de métrica en tu gráfico, haz clic en Agregar otra métrica y repite los pasos anteriores. Un gráfico puede mostrar un máximo de 10 tipos de métricas.

La primera vez que hagas clic en Agregar otra métrica, las selecciones que hiciste antes se mostrarán en el panel Series temporales A. Además, se abrirá el panel Series temporales B. Este panel contiene los campos de configuración que completas para graficar el segundo tipo de métrica.

En la siguiente captura de pantalla, se ilustra este comportamiento:

Ejemplo de la configuración del Explorador de métricas con dos métricas.

(Opcional) Representa gráficamente una proporción de tipos de métricas

Esta opción no está disponible para las tablas.

Cuando te interesa, por ejemplo, la tasa de errores en lugar de la cantidad absoluta de errores, debes representar una proporción de tipos de métricas. Un gráfico que muestra una proporción de tipos de métricas podría mostrar anomalías debido a las diferencias de muestreo y alineación. Para obtener referencias a ejemplos y más información, consulta Índices de métricas.

En los siguientes pasos, se supone que completaste los pasos para graficar un tipo de métrica. En los siguientes pasos, selecciona un segundo tipo de métrica y, luego, convierte el gráfico para mostrar una proporción:

  1. Seleccione Agregar otra métrica.

    Cuando haces clic en Agregar otra métrica, las selecciones que hiciste antes se muestran en el panel Series temporales A. Además, se abrirá el panel Series temporales B.

  2. Seleccione el tipo de métrica Series temporales B.

    Ambos tipos de métricas deben tener el mismo tipo de métrica. Por ejemplo, si la Serie temporal-A es una métrica de GAUGE, selecciona un tipo de métrica que tenga una categoría de métrica de GAUGE.

  3. Asegúrate de que el valor del campo Período de alineación mínimo sea el mismo para ambos tipos de métricas.

  4. Establece los parámetros de agrupación para el segundo tipo de métrica.

    Recomendamos que los campos de agrupación para el segundo tipo de métrica coincidan con los valores de Series temporales-A. Por ejemplo, puedes agrupar ambos tipos de métricas por la etiqueta zone.

    No es necesario que uses la misma agrupación para el numerador y el denominador; sin embargo, solo puedes agrupar por etiquetas comunes a ambos campos.

  5. Habilita Mostrar métricas como proporción.

    Cuando realizas esta selección, la etiqueta Time Series-A pasa a llamarse Numerator y la etiqueta Time Series-B pasa a ser Denominator.

  6. (Opcional) Para cambiar qué tipo de métrica es el numerador, haz clic en Intercambiar numerador.

  7. (Opcional) Expande Mostrar opciones de proporción para mostrar las opciones de agregación secundarias.

MQL

Para agregar un gráfico o una tabla a un panel mediante el modo MQL, ingresa una consulta de MQL.

Por ejemplo, la siguiente consulta muestra el uso de CPU promedio de una instancia de máquina virtual (VM) de Compute Engine:

fetch gce_instance
| metric 'compute.googleapis.com/instance/cpu/utilization'
| group_by 1m, [value_utilization_mean: mean(value.utilization)]
| every 1m

Cuando seleccionas un widget de mapa de calor, asegúrate de que las opciones de agregación combinen las series temporales en una sola. Si en un gráfico de mapa de calor se muestra Your MQL Query has too many time series, debes modificar la configuración de agregación para combinar las series temporales.

Para obtener información sobre cómo calcular proporciones con MQL, consulta Proporciónes de procesamiento.

Para obtener más información sobre cómo usar MQL, consulta Introducción al MQL.

Para obtener información sobre cómo agregar filtros de plantilla cuando usas MQL, consulta Filtros del panel.

Agregar indicadores a un panel

Para ver las mediciones más recientes en comparación con un conjunto de umbrales codificados por color, agrega un medidor o cuadro de evaluación. Los indicadores solo muestran la medición más reciente, mientras que los cuadros de evaluación también muestran un historial de mediciones recientes. El color de fondo de estos widgets también está codificado por colores. Cuando el valor más reciente está dentro de los rangos esperados, el color del widget es blanco. Cuando el valor está en un rango de advertencia, el widget se vuelve ámbar. Del mismo modo, cuando el valor está en un rango de peligro, el widget se vuelve rojo.

Ambos widgets muestran una sola serie temporal. En la siguiente captura de pantalla, se muestra un ejemplo de un indicador cuando la medición más reciente es menor que los umbrales de advertencia y peligro:

Ejemplo de un indicador.

El resto de la información de esta sección es para la consola. Para obtener información sobre el uso de la API de Cloud Monitoring, consulta Panel con una Scorecard básica.

Para agregar un indicador o cuadro de evaluación a un panel, haz lo siguiente:

  1. En la consola, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, el panel que deseas ver o editar.
  3. Si se muestra el botón Editar panel, haz clic en él.
  4. Selecciona un widget de medidor o cuadro de evaluación de la Biblioteca de gráficos o arrastra uno de estos widgets desde la biblioteca hasta el área del gráfico.
  5. Especifica los datos que muestra el widget:
    • Para configurar el widget rápidamente, usa el modo Básico. Este modo proporciona opciones de configuración mínimas. Siempre puedes cambiar de una configuración básica a un modo de configuración diferente.
    • Para acceder a todos los campos configurables o ingresar un filtro de Monitoring, usa el modo Avanzado. Es posible que no puedas cambiar a un modo de configuración diferente.
    • Para usar el lenguaje de consulta de Monitoring (MQL), selecciona la pestaña MQL. Cuando usas MQL, no puedes cambiar a un modo de configuración diferente y conservar tu consulta.

    En la siguiente tabla, se describen las opciones para cada modo:

Básica

Para configurar el widget, completa los siguientes pasos:

  1. Selecciona los datos de series temporales que deseas ver.
  2. Combina las series temporales en una sola.
  3. Configura los niveles de advertencia y límite.

Selecciona los datos de series temporales que deseas ver

Para seleccionar las series temporales que quieres crear, realiza una de las siguientes acciones:

  • A fin de mostrar un tipo de métrica, como el uso de CPU de una VM, usa los menús para realizar tus selecciones:

    1. Haz clic en Seleccionar una métrica y, luego, usa los menús para seleccionar un tipo de recurso y un tipo de métrica.

      Para reducir la cantidad de opciones del menú, ingresa el nombre de un recurso o un tipo de métrica en la barra de filtros . Por ejemplo, para graficar el uso de CPU de una instancia de VM, puedes ingresar utilization en la barra de filtros.

      Para enumerar todos los tipos de recursos y métricas, inhabilita la opción Mostrar solo recursos 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.

    2. Para especificar un subconjunto de datos para mostrar, agrega un filtro o aplica variables de plantilla (opcional). Por ejemplo, puedes ver los datos de una zona mediante la aplicación de un filtro. Puedes agregar varios filtros. Para obtener más información sobre los filtros, consulta Filtra los datos del gráfico. Para obtener información sobre las variables de la plantilla, consulta Filtra un panel.

      Para agregar un filtro, haz clic en Agregar un filtro y selecciona la etiqueta y el valor de la etiqueta. Por ejemplo, para mostrar series temporales solo en la zona us-east1-b, ingresa el filtro zone = us-east1-b.

      Para aplicar una variable de plantilla, usa el menú.

  • Para mostrar un objetivo de nivel de servicio o el recuento de procesos que se ejecutan en las VM, ingresa un filtro de Monitoring:

    1. Haz clic en Ayuda en el menú Seleccionar una métrica.
    2. Seleccione Modo de filtro directo.
    3. Ingresa el filtro de Monitoring en el cuadro de texto.

Si deseas obtener más información sobre estas opciones, consulta Selecciona métricas para gráficos en paneles.

Combina las series temporales en una sola

Usa los botones de selección para especificar cómo se combinan los datos de las diferentes series temporales. Por ejemplo, para promediar las series temporales, selecciona mean.

Configura los niveles de advertencia y umbral

Realice una de las siguientes acciones:

  • Para los medidores, haz lo siguiente:

    1. Ingresa los valores Minimum y Maximum para la métrica. Cuando el indicador muestre un porcentaje, configura estos valores en 0 y 1 respectivamente.
    2. Configura los umbrales de advertencia y peligro.

      Por ejemplo, la siguiente captura de pantalla ilustra una configuración para un indicador con los umbrales Warning above y Danger above (Advertencia sobre arriba)

      Gráfico que muestra la configuración del indicador.

  • Para los cuadros de evaluación, haga lo siguiente:

    1. Configura la vista de gráfico de Spark. La vista determina cómo se muestran los datos anteriores. Por ejemplo, si seleccionas Línea, se muestra una línea.
    2. Configura los umbrales de advertencia y peligro.

Avanzado

Para configurar el widget, completa los siguientes pasos:

  1. Selecciona los datos de series temporales que deseas ver.
  2. Combina las series temporales en una sola.
  3. Configura los niveles de advertencia y límite.

Selecciona los datos de series temporales que deseas ver

Para seleccionar las series temporales que quieres crear, realiza una de las siguientes acciones:

  • A fin de mostrar un tipo de métrica, como el uso de CPU de una VM, usa los menús para realizar tus selecciones:

    1. Haz clic en Seleccionar una métrica y, luego, usa los menús para seleccionar un tipo de recurso y un tipo de métrica.

      Para reducir la cantidad de opciones del menú, ingresa el nombre de un recurso o un tipo de métrica en la barra de filtros . Por ejemplo, para graficar el uso de CPU de una instancia de VM, puedes ingresar utilization en la barra de filtros.

      Para enumerar todos los tipos de recursos y métricas, inhabilita la opción Mostrar solo recursos 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.

    2. Para especificar un subconjunto de datos para mostrar, agrega un filtro o aplica variables de plantilla (opcional). Por ejemplo, puedes ver los datos de una zona mediante la aplicación de un filtro. Puedes agregar varios filtros. Para obtener más información sobre los filtros, consulta Filtra los datos del gráfico. Para obtener información sobre las variables de la plantilla, consulta Filtra un panel.

      Para agregar un filtro, haz clic en Agregar un filtro y selecciona la etiqueta y el valor de la etiqueta. Por ejemplo, para mostrar series temporales solo en la zona us-east1-b, ingresa el filtro zone = us-east1-b.

      Para aplicar una variable de plantilla, usa el menú.

  • Para mostrar un objetivo de nivel de servicio o el recuento de procesos que se ejecutan en las VM, ingresa un filtro de Monitoring:

    1. Haz clic en Ayuda en el menú Seleccionar una métrica.
    2. Seleccione Modo de filtro directo.
    3. Ingresa el filtro de Monitoring en el cuadro de texto.

Si deseas obtener más información sobre estas opciones, consulta Selecciona métricas para gráficos en paneles.

Combina las series temporales en una sola

  1. Selecciona los parámetros de alineación. En general, los parámetros de alineación se pueden dejar en los valores predeterminados. Para obtener más información, consulta Alineación: regularización dentro de la serie.

  2. Selecciona la función Agrupar por. Esta función combina las series temporales.

Configura los niveles de advertencia y umbral

Realice una de las siguientes acciones:

  • Para los medidores, haz lo siguiente:

    1. Ingresa los valores Minimum y Maximum para la métrica. Cuando el indicador muestre un porcentaje, configura estos valores en 0 y 1 respectivamente.
    2. Configura los umbrales de advertencia y peligro.

      Por ejemplo, la siguiente captura de pantalla ilustra una configuración para un indicador con los umbrales Warning above y Danger above (Advertencia sobre arriba)

      Gráfico que muestra la configuración del indicador.

  • Para los cuadros de evaluación, haga lo siguiente:

    1. Configura la vista de gráfico de Spark. La vista determina cómo se muestran los datos anteriores. Por ejemplo, si seleccionas Línea, se muestra una línea.
    2. Configura los umbrales de advertencia y peligro.

MQL

Para configurar el widget, ingresa una consulta de MQL que combine las series temporales en una sola.

Por ejemplo, considera la consulta para el uso de CPU de una instancia de VM. Esta consulta agrupa los datos por zona y, luego, promedia los datos en cada zona:

fetch gce_instance
 | metric 'compute.googleapis.com/instance/cpu/utilization'
 | group_by [zone], mean(val())

Cuando todas las instancias de VM están en la misma zona, un indicador o un cuadro de evaluación pueden mostrar los datos solicitados. Sin embargo, cuando tus instancias de VM están en varias zonas, estos widgets muestran el mensaje de error Your MQL Query has too many time series.

Para resolver esta condición de error, asegúrate de que la última cláusula group_by combine las series temporales:

fetch gce_instance
 | metric 'compute.googleapis.com/instance/cpu/utilization'
 | group_by [zone], mean(val())
 | every 1m
 | group_by [], max(val())

En la última cláusula group_by, el primer argumento, [], especifica que las series temporales se deben combinar y el segundo argumento, max(val()), define cómo se deben combinar las series temporales. Una vez que se completa la operación de agrupación, hay una sola serie temporal.

Para obtener más información sobre cómo usar MQL, consulta Introducción al MQL.

Muestra datos en forma de tabla en un panel

Para ver los datos más recientes en formato tabular, agrega una tabla. Las tablas pueden mostrar cualquier tipo de métrica que tenga un valor numérico y mostrar percentiles para las métricas con valor de distribución.

Las tablas solo muestran el valor más reciente, similar al comportamiento de los medidores y los cuadros de evaluación. Sin embargo, a diferencia de los medidores y los cuadros de evaluación, las tablas contienen una fila para cada serie temporal supervisada.

Hay dos estilos de tablas. El widget Tabla muestra un valor numérico como “25%”. El widget de Lista superior muestra el valor y un indicador visual del valor en comparación con el rango de valores posibles. Puedes cambiar entre estos tipos de widgets.

En la siguiente captura de pantalla, se muestra un panel en el que se muestra el uso de CPU de las instancias de máquina virtual mediante el uso de un widget Lista principal y un widget Tabla:

Ejemplo de un widget de tabla.

Para obtener información sobre cómo agregar tablas a un panel, consulta los siguientes documentos:

Ordenar y filtrar tablas

Puedes cambiar el orden de las filas en la pantalla de la tabla y puedes filtrar el contenido de la tabla para que solo se muestren filas específicas. Esta configuración no es persistente. Cuando sales de la página del panel o cuando vuelves a cargarlo, se descartan las opciones de orden y filtrado que aplicaste.

Tienes las siguientes opciones para ordenar y filtrar:

  • Para ordenar la tabla por una columna, haz clic en el encabezado de la columna.

  • Para cambiar las columnas de la tabla, haz clic en Ver columnas, realiza las modificaciones y, luego, haz clic en Aceptar.

  • Para enumerar solo filas específicas, agregue uno o más filtros. Puedes agregar varios filtros. Cuando no especificas el operador OR entre dos filtros, un AND lógico une esos filtros.

    Para agregar un filtro, haz clic en Enter property name or value, selecciona una propiedad del menú y, luego, ingresa un valor o selecciona el menú. Por ejemplo, si filtras en la propiedad Name y, luego, ingresas el valor demo, la tabla solo enumera las filas en las que el campo Name incluye el valor demo.

Agrega texto a un panel

Para agregar información útil a un panel, agrega un cuadro de texto. 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. El contenido de los widgets de texto es persistente. En la siguiente captura de pantalla, se muestra un cuadro de texto:

Ejemplo de un panel con un widget de texto.

La información de esta sección es para la consola. Para obtener información sobre el uso de la API de Cloud Monitoring, consulta Panel con un widget Text.

Para agregar un cuadro de texto, haz lo siguiente:

  1. En la consola, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, el panel que deseas ver o editar.
  3. Si se muestra el botón Editar panel, haz clic en él.
  4. Selecciona el widget de cuadro de texto de la Biblioteca de gráficos o arrastra este widget desde la biblioteca hasta el área del gráfico.
  5. Ingrese el texto que desea mostrar. El widget de cuadro de texto admite un conjunto limitado de comandos de Markdown:

    • Para crear un encabezado, usa #. Puedes usar varios signos hash para diferentes niveles de encabezados:

        # Header
        ## Second heading
        ### Third heading
      
    • Para mostrar la fuente en cursiva, usa *italic* o _italic_.

    • Para mostrar la fuente en negrita, usa **bold** o __bold__.

    • Para agregar un vínculo, usa [link text](absolute URL). Puedes usar cualquier valor para link text, pero debes usar la URL absoluta.

      Por ejemplo, puedes escribir [cloud.google.com](https://cloud.google.com/) para vincularlo a cloud.google.com.

Mostrar políticas de alertas en un panel

Para ver el gráfico asociado con una política de alertas en el mismo contexto que tus datos de métricas, agrega un gráfico de alerta a tu panel. Los gráficos de alertas muestran las series temporales que supervisa la política, un umbral, la cantidad de incidentes asociados con la política y si la política está inhabilitada. En la siguiente captura de pantalla, se muestra un gráfico de alertas:

Ejemplo de un gráfico de alertas

La información restante de esta sección es para la consola. Para obtener información sobre el uso de la API de Cloud Monitoring, consulta Panel con un widget AlertChart.

Para agregar un gráfico de alertas a un panel, haz lo siguiente:

  1. En la consola, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, el panel que deseas ver o editar.
  3. Si se muestra el botón Editar panel, haz clic en él.
  4. Selecciona el widget de gráfico de alertas de la Biblioteca de gráficos o arrástralo desde la biblioteca hasta el área del gráfico.
  5. Selecciona una política de alertas existente mediante el menú Política de alertas.

Visualiza las políticas de alertas

Cuando ves un gráfico de alertas, es posible que desees obtener más información sobre la política de alertas que muestra. Por ejemplo, es posible que desees revisar los canales de notificaciones seleccionados o qué documentación personalizada se incluye con una notificación. Para obtener información sobre la política de alertas, intenta lo siguiente:

  • Para ver detalles sobre la política de alertas, haz clic en el chip de incidentes en el gráfico de alertas y selecciona Ver política de alertas.

  • Para editar la política de alertas, haz lo siguiente:

    1. Asegúrate de que el panel esté en modo de edición.
    2. Selecciona el gráfico de alertas para activar el panel de configuración y, luego, haz clic en Editar política.
  • Para ver los detalles de la configuración de la serie temporal que muestra el gráfico de alertas, haz clic en Más opciones y selecciona Ver en el Explorador de métricas.

    El Explorador de métricas muestra un gráfico de líneas configurado con la misma configuración de métricas y filtros que el gráfico de alertas. Cualquier cambio que realices en el gráfico que muestra el explorador de métricas se limita a ese gráfico. Es decir, no puedes usar el Explorador de métricas para cambiar la política de alertas.

Borra políticas de alertas

Si borras la política de alertas asociada con un gráfico de alertas, este ya no mostrará ningún dato. Para obtener más información, consulta El gráfico de alertas no muestra ningún dato.

Muestra entradas de registro en un panel

Para ver entradas de registro en el mismo contexto que tus métricas, agrega un panel de registros a un panel personalizado. Debido a que el panel de registros te permite filtrar tus entradas de registro, puedes configurarlo para que muestre solo las entradas de registro que te interesan.

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

Ejemplo de un panel con un panel de registros.

Para obtener información sobre cómo mostrar entradas de registro en tu panel, consulta Visualiza registros en un panel personalizado.

Muestra los SLO en un panel

Para ver el estado, el cumplimiento o el porcentaje de error aceptable de un objetivo de nivel de servicio (SLO) para un servicio, agrega un gráfico de SLO a un panel personalizado. Un gráfico de SLO proporciona un resumen del rendimiento de un servicio en relación con un SLO configurado. Mediante los gráficos de SLO, puedes crear un panel personalizado que muestre el estado de todos los SLO para un conjunto de servicios.

Antes de poder usar un gráfico de SLO, debes configurar los servicios. Para obtener información sobre los servicios y los SLO, consulta Supervisión de SLO.

En la siguiente captura de pantalla, se ilustra un gráfico de SLO que muestra el porcentaje de error aceptable de un SLO:

Ejemplo de un gráfico de SLO que muestra el porcentaje de error aceptable restante de un SLO.

La información restante de esta sección es para la consola. Para obtener información sobre el uso de la API de Cloud Monitoring, consulta Panel con un widget de SLO.

Para agregar un gráfico de SLO a un panel, haz lo siguiente:

  1. En la consola, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, el panel que deseas ver o editar.
  3. Si se muestra el botón Editar panel, haz clic en él.
  4. Selecciona el widget de gráfico de SLO desde la Biblioteca de gráficos o arrastra este widget desde la biblioteca hasta el área del gráfico.
  5. Selecciona un servicio existente del menú Servicio.
  6. Selecciona un SLO existente para el servicio en el menú Objetivos de nivel de servicio.

    Si el servicio elegido no tiene SLO, un mensaje te indicará que debes crear uno. Para agregar un SLO, haz clic en Crear SLO. Para obtener más información sobre la creación de SLO, consulta Crea un SLO. Después de crear un SLO, selecciónalo y continúa con el siguiente paso.

  7. Selecciona una métrica de SLO del menú Tipo de gráfico de objetivos de nivel de servicio. Puedes seleccionar el estado de cumplimiento, el porcentaje de error absoluto o fraccional. Para obtener más información sobre las métricas de SLO, consulta Recupera datos de SLO.

Organizar los widgets del panel

Para mejorar la usabilidad de un panel con muchos widgets, usa widgets de grupo que se pueden contraer. Un widget de grupo contraíble es un contenedor para otros widgets, por lo que puedes ver y administrar esos widgets como una colección. Por ejemplo, un widget de grupo que se puede contraer puede contener gráficos que muestran métricas de VM y políticas de alertas de supervisión que supervisan las VM.

Para agregar un widget de grupo que se puede contraer, haz lo siguiente:

  1. En la consola, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, el panel que deseas ver o editar.
  3. Si se muestra el botón Editar panel, haz clic en él.
  4. En la barra de herramientas del panel, asegúrate de que esté seleccionada la opción Mosaic.
  5. Selecciona el widget de grupo que se puede contraer en la Biblioteca de gráficos o arrastra este widget de la biblioteca al área del gráfico.
  6. Ingresa un título descriptivo en el panel de configuración (opcional). El título se muestra en el widget.
  7. (Opcional) Establece la vista predeterminada para expandir o contraer el grupo. Cuando un widget de grupo contraíble se contrae, Monitoring recupera los datos para los widgets en el grupo con una prioridad más baja que para otros widgets.
  8. Agrega widgets al grupo mediante una de las siguientes opciones:

    • Arrastra un widget existente al grupo.
    • Arrastra un widget de la biblioteca de gráficos al grupo.
  9. (Opcional) Usa el puntero para cambiar el tamaño y la posición de los widgets dentro del grupo.

Para quitar un widget de un grupo de contracción, puedes borrar el widget o arrastrarlo al espacio no utilizado en el panel.

Para quitar la agrupación, selecciona el widget de grupo que se puede contraer y, en la barra de herramientas del widget, selecciona Cancel.

¿Qué sigue?