Cómo agregar widgets al panel

En este documento, se describe cómo agregar widgets a un panel personalizado con 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 los 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 en 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 mapas de calor. Para mostrar solo los datos más recientes, agrega una tabla o un indicador. Los indicadores cambian de color según cómo se comparan los datos con los umbrales de advertencias y peligros. 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.

Agregar gráficos y tablas a un panel

En esta sección, se describe cómo configurar gráficos de líneas, de áreas apiladas, de barras apiladas, de mapas de calor y de tablas mediante Cloud Console. Para obtener información sobre el uso de la API de Cloud Monitoring, consulta Panel con un widget XyChart.

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

  1. En Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, selecciona 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 gráfico o tabla de la Biblioteca de gráficos o arrastra uno de estos widgets desde la biblioteca al á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 tener acceso 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, sigue estos pasos:

  1. Selecciona los datos de las series temporales que deseas ver.
  2. (Opcional) Series temporales de grupo.
  3. (Opcional) Configura las opciones de la vista de gráfico.
  4. (Opcional) Gráfico de múltiples tipos de métrica.

Selecciona los datos de las series temporales que deseas ver

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

  • Para mostrar un tipo de métrica, como el uso de CPU de una VM, usa los menús para hacer 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 filtro de . Por ejemplo, para graficar el uso de CPU de una instancia de VM, puedes ingresar utilization en la barra de filtros.

      Si deseas enumerar todos los tipos de recursos y métricas, inhabilita la opción Mostrar solo recursos activos y métricas. De forma predeterminada, este botón de activación está habilitado, por lo que en los menús solo se muestran las métricas y los recursos con datos.

    2. (Opcional) Si quieres especificar un subconjunto de datos para mostrar, agrega un filtro o aplica variables de plantilla. Por ejemplo, puedes ver los datos de una zona si aplicas un filtro. Puedes agregar varios filtros. Para obtener más información sobre los filtros, consulta Filtra datos registrados. Para obtener información sobre las variables de la plantilla, consulta Filtra un panel.

      Para agregar un filtro, haz clic en Agregar 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 Monitoring en el cuadro de texto.

Para obtener más información sobre estas opciones, consulta Selecciona métricas para los widgets del panel.

Series temporales de grupos

  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 se escriben a 1 punto por minuto, 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.

Opcional: Representa el gráfico de 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 hayas realizado 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, sigue estos pasos:

  1. Selecciona los datos de las series temporales que deseas ver.
  2. Selecciona cómo se procesan previamente las series temporales.
  3. (Opcional) Series temporales de grupo.
  4. (Opcional) Configura las opciones de la vista de gráfico.
  5. (Opcional) Gráfico de múltiples tipos de métrica.
  6. Representa un gráfico de una proporción de tipos de métricas(opcional).

Selecciona los datos de las series temporales que deseas ver

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

  • Para mostrar un tipo de métrica, como el uso de CPU de una VM, usa los menús para hacer 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 filtro de . Por ejemplo, para graficar el uso de CPU de una instancia de VM, puedes ingresar utilization en la barra de filtros.

      Si deseas enumerar todos los tipos de recursos y métricas, inhabilita la opción Mostrar solo recursos activos y métricas. De forma predeterminada, este botón de activación está habilitado, por lo que en los menús solo se muestran las métricas y los recursos con datos.

    2. (Opcional) Si quieres especificar un subconjunto de datos para mostrar, agrega un filtro o aplica variables de plantilla. Por ejemplo, puedes ver los datos de una zona si aplicas un filtro. Puedes agregar varios filtros. Para obtener más información sobre los filtros, consulta Filtra datos registrados. Para obtener información sobre las variables de la plantilla, consulta Filtra un panel.

      Para agregar un filtro, haz clic en Agregar 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 Monitoring en el cuadro de texto.

Para obtener más información sobre estas opciones, consulta Selecciona métricas para los widgets del panel.

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 {8/}, si seleccionas rate, se cambian las unidades a {8/} por segundo. Para obtener más información y ver un ejemplo, consulta Tipos, tipos y conversiones.

Series temporales de grupos

  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.

Opcional: Representa el gráfico de 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 hayas realizado 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 mediante un gráfico 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 graficar una proporción de tipos de métricas. Un gráfico que muestra una proporción de tipos de métricas puede mostrar anomalías debido a las diferencias de muestreo y alineación. Para obtener referencias a ejemplos y más información, consulta Proporción de métricas.

En los siguientes pasos, se supone que completaste los pasos para graficar un tipo de métrica. En los siguientes pasos, debes seleccionar un segundo tipo de métrica y, luego, convertir 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 realizaste 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 para Series temporales B.

    Ambos tipos deben ser del mismo tipo. Por ejemplo, si la serie temporal A es una métrica de GAUGE, selecciona un tipo de métrica que tenga un tipo 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étrica.

  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 Serie temporal-A. Por ejemplo, puedes agrupar ambos tipos de métricas según 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 que son comunes a ambos campos.

  5. Habilite la opción Mostrar métricas como proporción.

    Cuando realizas esta selección, se cambia el nombre de la etiqueta Time Series-A a Numerator y la etiqueta Time Series-B, Denominator.

  6. (Opcional) Para cambiar el tipo de métrica que corresponde al numerador, haz clic en Swap numerator.

  7. (Opcional) Expande Mostrar opciones de proporción para configurar 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 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 las relaciones de procesamiento con MQL, consulta Proporción de procesamiento.

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

Cómo 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 indicador o un cuadro de evaluación. Los indicadores solo muestran las mediciones más recientes, mientras que los cuadros de evaluación también muestran un historial de las 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 Cloud Console. Para obtener información sobre el uso de la API de Cloud Monitoring, consulta Panel con un Scorecard básico.

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

  1. En Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, selecciona 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 en la Biblioteca de gráficos o arrastra uno de estos widgets al área del gráfico de la biblioteca.
  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 tener acceso 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, sigue estos pasos:

  1. Selecciona los datos de las 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 las series temporales que deseas ver

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

  • Para mostrar un tipo de métrica, como el uso de CPU de una VM, usa los menús para hacer 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 filtro de . Por ejemplo, para graficar el uso de CPU de una instancia de VM, puedes ingresar utilization en la barra de filtros.

      Si deseas enumerar todos los tipos de recursos y métricas, inhabilita la opción Mostrar solo recursos activos y métricas. De forma predeterminada, este botón de activación está habilitado, por lo que en los menús solo se muestran las métricas y los recursos con datos.

    2. (Opcional) Si quieres especificar un subconjunto de datos para mostrar, agrega un filtro o aplica variables de plantilla. Por ejemplo, puedes ver los datos de una zona si aplicas un filtro. Puedes agregar varios filtros. Para obtener más información sobre los filtros, consulta Filtra datos registrados. Para obtener información sobre las variables de la plantilla, consulta Filtra un panel.

      Para agregar un filtro, haz clic en Agregar 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 Monitoring en el cuadro de texto.

Para obtener más información sobre estas opciones, consulta Selecciona métricas para los widgets del panel.

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 límite

Realice una de las acciones siguientes:

  • En el caso de los medidores, haz lo siguiente:

    1. Ingresa los valores Mínimo y Máximo 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, en la siguiente captura de pantalla, se muestra una configuración para un indicador con los umbrales Warning arriba y Peligro superior:

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

  • En los cuadros de evaluación, haz lo siguiente:

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

Avanzado

Para configurar el widget, sigue estos pasos:

  1. Selecciona los datos de las 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 las series temporales que deseas ver

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

  • Para mostrar un tipo de métrica, como el uso de CPU de una VM, usa los menús para hacer 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 filtro de . Por ejemplo, para graficar el uso de CPU de una instancia de VM, puedes ingresar utilization en la barra de filtros.

      Si deseas enumerar todos los tipos de recursos y métricas, inhabilita la opción Mostrar solo recursos activos y métricas. De forma predeterminada, este botón de activación está habilitado, por lo que en los menús solo se muestran las métricas y los recursos con datos.

    2. (Opcional) Si quieres especificar un subconjunto de datos para mostrar, agrega un filtro o aplica variables de plantilla. Por ejemplo, puedes ver los datos de una zona si aplicas un filtro. Puedes agregar varios filtros. Para obtener más información sobre los filtros, consulta Filtra datos registrados. Para obtener información sobre las variables de la plantilla, consulta Filtra un panel.

      Para agregar un filtro, haz clic en Agregar 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 Monitoring en el cuadro de texto.

Para obtener más información sobre estas opciones, consulta Selecciona métricas para los widgets del panel.

Combina las series temporales en una sola

  1. Selecciona los parámetros de alineación. En general, los parámetros de alineación pueden dejarse 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 límite

Realice una de las acciones siguientes:

  • En el caso de los medidores, haz lo siguiente:

    1. Ingresa los valores Mínimo y Máximo 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, en la siguiente captura de pantalla, se muestra una configuración para un indicador con los umbrales Warning arriba y Peligro superior:

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

  • En los cuadros de evaluación, haz lo siguiente:

    1. Configure la vista de gráfico de Spark. La vista determina cómo se muestran los datos pasados. Por ejemplo, si seleccionas Línea (Line), 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. En esta consulta, se agrupan los datos por zona y, luego, se promedian los datos de 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.

Muestre datos en forma de tabla en un panel

Para ver los datos más recientes en forma de tabla, agrega una tabla. A diferencia de los medidores y los cuadros de evaluación, las tablas pueden mostrar datos de varias series temporales. Al igual que con los gráficos de líneas, 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.

En la siguiente captura de pantalla, se muestra una tabla que muestra el uso de CPU de las instancias de máquinas virtuales:

Ejemplo de un widget de tabla.

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

Ordena y filtra 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 cargar el panel, 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, agrega uno o más filtros. Puedes agregar varios filtros. Cuando no especificas el operador OR entre dos filtros, se usa un operador lógico AND.

    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 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 sobre Cloud Console. 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 Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, selecciona 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 de la biblioteca al área del gráfico.
  5. Ingresa el texto que quieras 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 Cloud Console. 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 alerta a un panel, haz lo siguiente:

  1. En Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, selecciona 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 arrastra este widget de la biblioteca al área del gráfico.
  5. Selecciona una política de alertas existente con el menú Política de alertas.

Visualiza las políticas de alertas

Cuando estés viendo 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, prueba lo siguiente:

  • Para ver los detalles de la política de alertas, haz clic en el chip de incidentes en el gráfico de alertas y, luego, 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 el modo de edición.
    2. Selecciona el gráfico de alertas para activar el panel de configuración y 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.

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 las entradas de registro en tu panel, consulta Cómo ver registros en un panel.

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) de 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 gráficos de SLO, puedes crear un panel personalizado que muestre el estado de todos los SLO de un conjunto de servicios.

Para 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 Cloud Console. No se admite la creación de gráficos de SLO mediante la API de Cloud Monitoring.

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

  1. En Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, selecciona 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 de la Biblioteca de gráficos o arrastra este widget de la biblioteca al á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, aparecerá un mensaje que te indicará que debes crear uno. Para agregar un SLO, haz clic en Crear SLO. Para obtener más información sobre cómo crear 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 del objetivo de nivel de servicio. Puede elegir entre el estado, el cumplimiento y el porcentaje de error aceptable absoluto o fraccionario. Para obtener más información sobre las métricas de SLO, consulta Recupera datos de SLO.

Cómo 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 que se puede contraer es un contenedor de 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 Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, selecciona 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) Configura la vista predeterminada para expandir o contraer el grupo. Cuando se contrae un widget de grupo que se puede contraer, Monitoring recupera los datos de los widgets en el grupo con una prioridad más baja que otros widgets.
  8. Para agregar widgets al grupo, realiza una de las siguientes acciones:

    • 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 widget de grupo que se puede contraer, puedes borrarlo o arrastrarlo al espacio sin usar del 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?