Creación y administración de widgets de panel

En este documento, se describe cómo compilar y configurar los widgets del panel mediante la vista del panel de Google Cloud Console. Todos los widgets del panel, excepto los cuadros de texto y los paneles de registros, pueden mostrar cualquier elemento tipo de métrica que tenga un valor numérico o de distribución, incluidométricas personalizadas yMétricas basadas en registros , Los widgets del panel no pueden graficar datos de tipo string.

Para obtener información sobre una herramienta de gráficos independiente, consulta Explorador de métricas.

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

Antes de comenzar

Asegúrate de que tengas una de las funciones que se describen en Autorización.

Diseña un panel

Cuando selecciones widgets de paneles, considera qué tipo de información deseas ver y cómo visualizarlos:

  • Para ver los datos de una serie temporal durante un intervalo de tiempo, agrega un gráfico de líneas, un gráfico de áreas apiladas, un gráfico de barras apiladas o un gráfico de mapas de calor. Se recomiendan los gráficos de barras apiladas para las métricas con muestras poco frecuentes, como las métricas de cuota que tienen una muestra por día, mientras que los gráficos de mapa de calor se recomiendan para las métricas de tipo de distribución.

    En esta página, el término gráfico solo hace referencia a gráficos de líneas, gráficos de áreas apiladas, gráficos de barras y gráficos de mapas de calor. En este contexto, el término gráfico no hace referencia a los gráficos de alertas.

  • Para mostrar si el valor de una métrica está en una zona de peligro, una zona de advertencia o en un rango esperado, agrega un indicador o un cuadro de evaluación.

  • Para agregar información sobre el panel o qué hacer en diferentes situaciones, agrega un cuadro de texto.

  • Para ver un resumen de una política de alertas de condición única en un panel, agrega un gráfico de alertas. Los gráficos de alertas muestran las series temporales que supervisa una política de alertas y un límite. Estos widgets también muestran chips que enumeran la cantidad de incidentes asociados con la política y si la política está inhabilitada.

  • Agrega un panel de registros para ver las entradas de registro almacenadas en tu proyecto de Google Cloud o en el alcance de las métricas de tu proyecto de Google Cloud. El panel de registros admite consultas mediante el lenguaje de consulta de Cloud Logging, y puedes abrir el Explorador de registros desde este panel.

Después de seleccionar el tipo de información, el siguiente paso es seleccionar los datos específicos que el widget mostrará. En esta página, se proporciona información general. Para obtener información detallada, consulta Selecciona datos para un gráfico.

Puedes colocar hasta 40 gráficos en un panel.

Agrega el widget del panel

En esta sección, se describe cómo agregar un widget a un panel. Para obtener información sobre la configuración, consulta Configuración de un widget del panel.

A fin de modificar un panel, asegúrate de que tu función de administración de identidades y accesos para el proyecto de alcance de un permiso de métricas incluya permiso de edición. Para obtener más información sobre las funciones, consulta Control de acceso.

Para agregar un widget al 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 de Monitoring, haz clic en  Paneles (Dashboards):

    • Para crear un panel nuevo, haz clic en Crear panel.
    • Para actualizar un panel existente, haz clic en el mosaico del panel si se muestra en Paneles recientes o busca el panel en la lista de todos los paneles y haz clic en su nombre.
  3. Si Editando no se muestra, luego haga clic Lectura y seleccionaCambiar al modo de edición ,

  4. Haz clic en el widget de la Biblioteca de gráficos que deseas agregar al panel. También puedes arrastrar el widget de la biblioteca al área del grafo. Se muestra un widget preconfigurado del tipo seleccionado.

    Puedes modificar la configuración del widget, cambiar su tamaño y cambiar su posición en el panel mediante el cursor. Para todos los widgets, excepto los gráficos de alertas, también puedes cambiar el tipo de widget. Por ejemplo, puedes convertir un gráfico de líneas en un gráfico de barras apiladas.

    En la siguiente captura de pantalla, se muestra un gráfico de líneas y su panel de configuración:

    Ejemplo de un gráfico de líneas que se agregó a un panel

  5. Configura el widget con el panel de configuración de widget, que se muestra cuando se puede editar el panel y se selecciónalo:

    • Para configurar un widget con rapidez, usa el modo básico. Esta elección tiene opciones de configuración mínimas. Una configuración básica siempre se puede representar en los demás modos.

    • Para tener acceso a la mayoría de los campos de configuración de widgets, usa el modo avanzado. Este modo proporciona acceso a la mayoría de los campos de agregación. Este modo no está disponible para todos los tipos de widgets. Es posible que una configuración avanzada no se pueda representar en el modo básico más simple.

    • Para configurar un widget con MQL, usa el modo MQL. Es posible que una configuración de MQL no se pueda representar en los otros modos.

  6. En la barra de herramientas del panel, haz clic en Agregar gráfico para activar la Biblioteca de gráficos y, luego, repite los pasos anteriores de cada widget que quieras agregar al panel (opcional).

Configura un widget de panel

En esta sección, se describe cómo configurar los widgets del panel mediante los selectores de Google Cloud Console. También puedes crear un gráfico o cambiar la configuración de un widget de panel si editas la representación JSON del panel.

Gráficos

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

Básica

Para configurar una línea, un área apilada, una barra o un gráfico de mapa de calor mediante el modo Básico, haz lo siguiente:

  1. Selecciona los datos de series temporales que deseas ver:

    • Para modificar el Tipo de recurso y la Métrica, selecciona desde los menús. El menú Tipo de recurso enumera todos los recursos supervisados para los que existen datos de métricas. El menú Métrica (Metric) determina las selecciones para el Tipo de recurso (Resource type).

      • Para buscar una entrada específica en un menú, usa la barra de desplazamiento o ingresa el texto en el área Filtrar del menú. Cuando ingresas texto, las entradas del menú se limitan a aquellas que lo incluyen.

      • Si deseas acceder a un tipo de recurso o métrica que aún no tiene datos, debes cambiar el comportamiento predeterminado:

        • Para poder seleccionar cualquier tipo de recurso, expande el menú Tipo de recurso y desmarca Solo mostrar activos.

        • Para ver todas las métricas del tipo de recurso seleccionado, incluso esas métricas sin datos, expande el menú Métrica y desmarca la opción Solo mostrar activos.

        • Para poder seleccionar cualquier métrica, haz clic en Cerrar en el menú Tipo de recurso y, luego, busca la entrada de interés. Si haces clic cerca del tipo de recursos, el menú Métrica incluye todas las métricas.

        • Para ver o editar la configuración, el filtro y el tipo de recurso como lo usa la API de Cloud Monitoring, en el menú Tipo de recurso, haz clic en Modo de filtro directo.

      Para obtener más información sobre cómo seleccionar métricas, consulta Selecciona datos para un gráfico.

    • Para agregar un filtro, haz clic en Agregar un filtro y, luego, selecciona la etiqueta y el valor de etiqueta. Puedes agregar varios filtros. Por ejemplo, puedes ver los datos de una zona si aplicas un filtro. Para obtener más información sobre los filtros, consulta Filtra datos del gráfico.

  2. 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.

  3. Usa los botones de selección, cuando se muestren, para especificar cómo combinar los datos.

    Por ejemplo, si un gráfico muestra 60 datos y los datos 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.

  4. Para cambiar el eje Y del eje derecho al eje izquierdo, haz clic en (opcional) Eje Y y seleccioneIzquierda.

    Cuando configures un gráfico para que muestre varias métricas, asegúrate de que todas las métricas asignadas al mismo eje Y tengan las mismas unidades. Para obtener más información, consulta Gráfico con varias métricas que muestra un mensaje de error.

    Esta opción no está disponible para los gráficos de mapas de calor.

  5. (Opcional) Para configurar cómo se muestran los datos en un gráfico, haz clic en Configuración:

    Para obtener información sobre las leyendas de los gráficos, consulta Configura leyendas.

  6. (Opcional) Puedes mostrar varias métricas en un solo gráfico. Si deseas mostrar otra métrica en un mismo gráfico, haz clic en Agregar otra métrica y repite los pasos anteriores. En un gráfico se puede mostrar un máximo de 10 métricas.

Aspectos avanzados

Cuando usas el modo Avanzado y, luego, seleccionas el modo Básico, es posible que se muestre un cuadro de diálogo. El cuadro de diálogo se muestra cuando la configuración que seleccionas en el modo Avanzado no se puede representar con las opciones disponibles en el modo Básico.

Para configurar una línea, un área apilada, una barra o un gráfico de mapa de calor mediante el modo Avanzado, haz lo siguiente:

  1. Selecciona los datos de series temporales que deseas ver:

    • Para modificar el Tipo de recurso y la Métrica, selecciona desde los menús. El menú Tipo de recurso enumera todos los recursos supervisados para los que existen datos de métricas. El menú Métrica (Metric) determina las selecciones para el Tipo de recurso (Resource type).

      • Para buscar una entrada específica en un menú, usa la barra de desplazamiento o ingresa el texto en el área Filtrar del menú. Cuando ingresas texto, las entradas del menú se limitan a aquellas que lo incluyen.

      • Si deseas acceder a un tipo de recurso o métrica que aún no tiene datos, debes cambiar el comportamiento predeterminado:

        • Para poder seleccionar cualquier tipo de recurso, expande el menú Tipo de recurso y desmarca Solo mostrar activos.

        • Para ver todas las métricas del tipo de recurso seleccionado, incluso esas métricas sin datos, expande el menú Métrica y desmarca la opción Solo mostrar activos.

        • Para poder seleccionar cualquier métrica, haz clic en Cerrar en el menú Tipo de recurso y, luego, busca la entrada de interés. Si haces clic cerca del tipo de recursos, el menú Métrica incluye todas las métricas.

        • Para ver o editar la configuración, el filtro y el tipo de recurso como lo usa la API de Cloud Monitoring, en el menú Tipo de recurso, haz clic en Modo de filtro directo.

      Para obtener más información sobre cómo seleccionar métricas, consulta Selecciona datos para un gráfico.

    • Para agregar un filtro, haz clic en Agregar un filtro y, luego, selecciona la etiqueta y el valor de etiqueta. Puedes agregar varios filtros. Por ejemplo, puedes ver los datos de una zona si aplicas un filtro. Para obtener más información sobre los filtros, consulta Filtra datos del gráfico.

  2. Selecciona cómo se procesan 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.

    En este caso, 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, si las unidades para la métrica son MiB, cuando seleccionas rate, las unidades cambian a MiB por segundo. Para obtener más información y un ejemplo, consulta Categorías, tipos y conversiones.

  3. 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.

  4. 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 Crear 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.

  5. Para cambiar el eje Y del eje derecho al eje izquierdo, haz clic en (opcional) Eje Y y seleccioneIzquierda.

    Cuando configures un gráfico para que muestre varias métricas, asegúrate de que todas las métricas asignadas al mismo eje Y tengan las mismas unidades. Para obtener más información, consulta Gráfico con varias métricas que muestra un mensaje de error.

    Esta opción no está disponible para los gráficos de mapas de calor.

  6. (Opcional) Para configurar cómo se muestran los datos en un gráfico, haz clic en Configuración:

    Para obtener información sobre las leyendas de los gráficos, consulta Configura leyendas.

  7. (Opcional) Puedes mostrar varias métricas en un solo gráfico. Para mostrar otra métrica en el mismo gráfico, haz clic en Agregar otra métrica y repite los pasos anteriores. En un gráfico se puede mostrar un máximo de 10 métricas.

MQL

MQL es un lenguaje más expresivo que el lenguaje de filtro que usan los modos Básico y Avanzado. Si configuras un gráfico mediante MQL y, luego, seleccionas un modo diferente, se mostrará un cuadro de diálogo cuando puedas perder la configuración de MQL. En este cuadro de diálogo, se proporcionan las opciones para cancelar o continuar con los modos de cambio.

Cuando uses MQL para configurar los gráficos de mapas de calor, asegúrate de configurar las opciones de agregado a fin de combinar las series temporales. 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 más información sobre cómo usar MQL, consulta Introducción al MQL.

Medidores y cuadros de evaluación

En esta sección, se describe cómo configurar un indicador o un cuadro de evaluación. Para obtener información sobre cómo agregar uno de estos widgets a tu panel mediante Google Cloud Console, consulta Agrega widget de panel. Para obtener información sobre el uso de la API de Cloud Monitoring, consulta Panel con un Scorecard básico.

Básica

Para configurar un indicador o un cuadro de evaluación con el modo Básico, sigue estos pasos:

  1. Selecciona un widget existente para activar su panel de configuración o agrega un widget a tu panel y, luego, haz clic en la pestaña Básico.

  2. Selecciona los datos de series temporales que deseas ver:

    • Para modificar el Tipo de recurso y la Métrica, selecciona desde los menús. El menú Tipo de recurso enumera todos los recursos supervisados para los que existen datos de métricas. El menú Métrica (Metric) determina las selecciones para el Tipo de recurso (Resource type).

      • Para buscar una entrada específica en un menú, usa la barra de desplazamiento o ingresa el texto en el área Filtrar del menú. Cuando ingresas texto, las entradas del menú se limitan a aquellas que lo incluyen.

      • Si deseas acceder a un tipo de recurso o métrica que aún no tiene datos, debes cambiar el comportamiento predeterminado:

        • Para poder seleccionar cualquier tipo de recurso, expande el menú Tipo de recurso y desmarca Solo mostrar activos.

        • Para ver todas las métricas del tipo de recurso seleccionado, incluso esas métricas sin datos, expande el menú Métrica y desmarca la opción Solo mostrar activos.

        • Para poder seleccionar cualquier métrica, haz clic en Cerrar en el menú Tipo de recurso y, luego, busca la entrada de interés. Si haces clic cerca del tipo de recursos, el menú Métrica incluye todas las métricas.

        • Para ver o editar la configuración, el filtro y el tipo de recurso como lo usa la API de Cloud Monitoring, en el menú Tipo de recurso, haz clic en Modo de filtro directo.

      Para obtener más información sobre cómo seleccionar métricas, consulta Selecciona datos para un gráfico.

    • Para agregar un filtro, haz clic en Agregar un filtro y, luego, selecciona la etiqueta y el valor de etiqueta. Puedes agregar varios filtros. Por ejemplo, puedes ver los datos de una zona si aplicas un filtro. Para obtener más información sobre los filtros, consulta Filtra datos del gráfico.

  3. Especifica cómo se combinan las series temporales seleccionadas en un solo valor.

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

  4. Configura los niveles de límite y advertencia de un indicador o cuadro de evaluación:

    • Para los indicadores, ingresa los valores de Mínimos y Máximos de la métrica. Cuando el indicador muestre un porcentaje, configura estos valores en 0 y 1 respectivamente.

    • Para los cuadros de evaluación, configura la Vista del gráfico de Spark. Todas las opciones muestran lo más reciente.

      • Línea: Muestra un gráfico de líneas.
      • Barra: Muestra un gráfico de barras.
      • Icono: Muestra un ícono verde, ámbar o rojo.
      • Valor: Muestra solo el valor.
    • Para los medidores y los cuadros de evaluación, configura los límites de advertencia y peligro:

      • Peligro superior: Cuando el valor está por encima de este límite, establecido en rojo.
      • Advertencia superior: Cuando el valor esté por encima de este límite, configúralo en ámbar.
      • Peligro inferior: Cuando el valor es menor que este umbral, configúralo en rojo.
      • Advertencia a continuación: Cuando el valor sea inferior a este umbral, configúralo en ámbar.

      Por ejemplo, en la siguiente captura de pantalla, se muestra una configuración para un indicador con los umbrales Advertencia arriba y Peligro arriba establecidos:

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

      En la siguiente captura de pantalla, se muestra un ejemplo del indicador, cuando la lectura es menor que los límites de advertencia y peligro:

      Ejemplo de un indicador.

      En el arco externo delgado, se muestra el rango de valores posibles y se indican las zonas de advertencia y peligro. El arco interno grueso muestra el valor actual.

Aspectos avanzados

Cuando usas el modo Avanzado y, luego, seleccionas el modo Básico, es posible que se muestre un cuadro de diálogo. El cuadro de diálogo se muestra cuando la configuración que seleccionas en el modo Avanzado no se puede representar con las opciones disponibles en el modo Básico.

Para configurar un indicador o un cuadro de evaluación con el modo Avanzado, sigue estos pasos:

  1. Selecciona un widget existente para activar su panel de configuración o agrega un widget a tu panel y, luego, haz clic en la pestaña Avanzado.

  2. Selecciona los datos de series temporales que deseas ver:

    • Para modificar el Tipo de recurso y la Métrica, selecciona desde los menús. El menú Tipo de recurso enumera todos los recursos supervisados para los que existen datos de métricas. El menú Métrica (Metric) determina las selecciones para el Tipo de recurso (Resource type).

      • Para buscar una entrada específica en un menú, usa la barra de desplazamiento o ingresa el texto en el área Filtrar del menú. Cuando ingresas texto, las entradas del menú se limitan a aquellas que lo incluyen.

      • Si deseas acceder a un tipo de recurso o métrica que aún no tiene datos, debes cambiar el comportamiento predeterminado:

        • Para poder seleccionar cualquier tipo de recurso, expande el menú Tipo de recurso y desmarca Solo mostrar activos.

        • Para ver todas las métricas del tipo de recurso seleccionado, incluso esas métricas sin datos, expande el menú Métrica y desmarca la opción Solo mostrar activos.

        • Para poder seleccionar cualquier métrica, haz clic en Cerrar en el menú Tipo de recurso y, luego, busca la entrada de interés. Si haces clic cerca del tipo de recursos, el menú Métrica incluye todas las métricas.

        • Para ver o editar la configuración, el filtro y el tipo de recurso como lo usa la API de Cloud Monitoring, en el menú Tipo de recurso, haz clic en Modo de filtro directo.

      Para obtener más información sobre cómo seleccionar métricas, consulta Selecciona datos para un gráfico.

    • Para agregar un filtro, haz clic en Agregar un filtro y, luego, selecciona la etiqueta y el valor de etiqueta. Puedes agregar varios filtros. Por ejemplo, puedes ver los datos de una zona si aplicas un filtro. Para obtener más información sobre los filtros, consulta Filtra datos del gráfico.

  3. 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.

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

  5. Configura los niveles de límite y advertencia de un indicador o cuadro de evaluación:

    • Para los indicadores, ingresa los valores de Mínimos y Máximos de la métrica. Cuando el indicador muestre un porcentaje, configura estos valores en 0 y 1 respectivamente.

    • Para los cuadros de evaluación, configura la Vista del gráfico de Spark. Todas las opciones muestran lo más reciente.

      • Línea: Muestra un gráfico de líneas.
      • Barra: Muestra un gráfico de barras.
      • Icono: Muestra un ícono verde, ámbar o rojo.
      • Valor: Muestra solo el valor.
    • Para los medidores y los cuadros de evaluación, configura los límites de advertencia y peligro:

      • Peligro superior: Cuando el valor está por encima de este límite, establecido en rojo.
      • Advertencia superior: Cuando el valor esté por encima de este límite, configúralo en ámbar.
      • Peligro inferior: Cuando el valor es menor que este umbral, configúralo en rojo.
      • Advertencia a continuación: Cuando el valor sea inferior a este umbral, configúralo en ámbar.

      Por ejemplo, en la siguiente captura de pantalla, se muestra una configuración para un indicador con los umbrales Advertencia arriba y Peligro arriba establecidos:

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

      En la siguiente captura de pantalla, se muestra un ejemplo del indicador, cuando la lectura es menor que los límites de advertencia y peligro:

      Ejemplo de un indicador.

      En el arco externo delgado, se muestra el rango de valores posibles y se indican las zonas de advertencia y peligro. El arco interno grueso muestra el valor actual.

MQL

MQL es un lenguaje más expresivo que el lenguaje de filtro que usan los modos Básico y Avanzado. Si configuras un gráfico mediante MQL y, luego, seleccionas un modo diferente, se mostrará un cuadro de diálogo cuando puedas perder la configuración de MQL. En este cuadro de diálogo, se proporcionan las opciones para cancelar o continuar con los modos de cambio. Para obtener más información, consulta Introducción a MQL.

Cuando uses MQL para configurar medidores y cuadros de evaluación, asegúrate de configurar las opciones de agregado a fin de combinar las series temporales. Cuando el widget muestre Your MQL Query has too many time series, modifica la configuración de agregación para combinar las series temporales.

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.

Tablas

En esta sección, se describe cómo configurar una tabla. Para obtener información sobre cómo agregar una tabla a tu panel mediante Google Cloud Console, consulta Agrega el widget del panel. Para obtener información sobre el uso de la API de Cloud Monitoring, consulta Panel con un widget TimeSeriesTable.

Los widgets de tabla pueden mostrar cualquier tipo de métrica que tenga un valor numérico. Los widgets de tabla pueden mostrar percentiles para las métricas con valor de distribución.

Para configurar una tabla, haz lo siguiente:

  1. Especifica la métrica que se mostrará en la tabla, los filtros y cómo deseas que se combinen las series temporales. En el caso de las tablas, estos pasos son idénticos a los que usas cuando configuras un gráfico.

    Para configurar una tabla, puedes usar el modo Básico, Avanzado o MQL.

  2. Para cambiar el nombre de la tabla, usa el campo Título del gráfico en el panel de configuración (opcional).

Después de configurar una tabla, tienes las siguientes opciones:

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

  2. Para desplazarte por los resultados, usa los botones Siguiente y Anterior.

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

  4. Para enumerar solo las filas seleccionadas, agrega uno o más filtros. Cuando agregas un filtro, seleccionas una propiedad de filtro y un valor de filtro. Cuando no especificas el operador OR entre dos filtros, un operador lógico AND une los 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 la propiedad Name y, luego, ingresas el valor demo, la tabla solo mostrará las filas en las que el campo Name incluye el valor demo.

Cuadros de texto

En esta sección, se describe cómo configurar un cuadro de texto. Para obtener información sobre cómo agregar un cuadro de texto a tu panel mediante Google Cloud Console, consulta Agrega el widget del panel. Para obtener información sobre cómo agregar un cuadro de texto a tu panel con Google Cloud Console, consulta Agrega un widget Texta un panel.

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.

Gráficos de alertas

Para configurar un gráfico de alertas, lo asocias con una política de alertas de condición única. Las instrucciones de esta sección son para Google Cloud Console. Para obtener información sobre cómo usar la API de Cloud Monitoring, consulta Panel con un widget AlertChart.

Para asociar un gráfico de alertas a una política de alertas, haz lo siguiente:

  1. Agrega un widget de gráfico de alertas a tu panel. Para obtener información sobre este paso, consulta Agrega el widget del panel.

  2. Realice una de las acciones siguientes:

    • Cuando exista la política de alertas que deseas mostrar, selecciónala en el menú Política de alertas en el panel de configuración del widget Gráfico de alertas.

    • Cuando la política de alertas que deseas mostrar no existe, haz clic en Crear política de alertas en el panel de configuración del widget Gráfico de alertas. Para obtener información sobre cómo completar el cuadro de diálogo, consulta Crea una política de alertas.

      No configures la política de alertas para que contenga más de una condición. Un gráfico de alertas no puede mostrar una política que contenga más de una condición.

      Después de crear la política, el gráfico de alertas la muestra de forma automática.

Un gráfico de alertas muestra datos de series temporales, un umbral, la cantidad de incidentes abiertos y si la política está inhabilitada. En la siguiente captura de pantalla, se muestra un gráfico de alertas para una política de alertas que supervisa el uso de CPU de dos máquinas virtuales diferentes.

Ejemplo de un gráfico de alertas

En la captura de pantalla anterior, la línea discontinua muestra el umbral de condición, que se establece en 50%. La etiqueta No incidents indica que no hay incidentes abiertos para la política de alertas.

Puedes ver y editar la política de alertas que muestra un gráfico de alertas:

  • Para editar la política de alertas que muestra un gráfico de alertas, selecciona el gráfico de alertas a fin de activar el panel de configuración y, luego, haz clic en Editar política.

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

  • 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.

La representación JSON es útil cuando usas la API de Cloud Monitoring. Para ver la representación JSON de un gráfico de alertas, haz clic en Editor de JSON en la barra de herramientas del panel.

Paneles de registros

Para obtener información sobre cómo ver las entradas de registro en el panel, consulta Visualiza registros en un panel.

Cambiar un tipo de widget

Puedes cambiar el tipo de widget cuando el widget de destino puede representar los datos que muestra el widget de origen. Por ejemplo, siempre puedes cambiar un gráfico de líneas a un gráfico de áreas apiladas o de barras apiladas. De manera similar, siempre puedes convertir un indicador, que muestra exactamente una serie temporal, en un gráfico de líneas. Sin embargo, es posible que no puedas convertir un gráfico de líneas, que puede mostrar muchas series temporales, en un indicador.

No puedes cambiar el tipo de un gráfico de alertas, una tabla o un panel de registros. Tampoco puedes convertir ninguno de los tipos de widgets.

Para obtener información sobre cómo convertir un widget en un gráfico de alertas, consulta Cambia al gráfico de alertas.

Para todas las demás conversiones de tipo de widget, haz lo siguiente:

  1. Si Editando no se muestra, luego haga clic Lectura y seleccionaCambiar al modo de edición ,
  2. Selecciona el widget.
  3. En el panel de configuración, haz clic en el nombre del tipo de widget actual y, luego, selecciona una opción del menú. Por ejemplo, para convertir un gráfico de líneas en un gráfico de áreas apiladas, en el panel de configuración, haz clic en Gráfico de líneas y, luego, selecciona Gráfico de áreas apiladas.

    El menú de opciones enumera todos los tipos de widgets que pueden representar los datos de las métricas. Sin embargo, un tipo de widget se inhabilita cuando no se pueden mostrar los datos seleccionados:

    • Cuando la métrica representada no tiene valor de distribución, la opción de mapa de calor está inhabilitada.
    • Cuando el widget actual muestra más de una serie temporal, las opciones de indicador y cuadro de evaluación están inhabilitadas.
    • Cuando se configura el eje Y a la izquierda de un gráfico de líneas, se inhabilitan todos los tipos de widgets, excepto el área apilada y la barra apilada.

Cambia el gráfico de alertas

Puedes convertir un gráfico de líneas en un gráfico de alertas cuando el gráfico de líneas muestra una sola métrica y como máximo un umbral.

Para convertir un gráfico de líneas en un gráfico de alertas, haz lo siguiente:

  1. Si Editando no se muestra, luego haga clic Lectura y seleccionaCambiar al modo de edición ,

  2. Selecciona el widget para activar el panel de configuración del widget.

  3. Haz clic en Más opciones y selecciona Convertir en gráfico de alertas.

    Cuando realizas esta selección, se abre el cuadro de diálogo Crear política de alertas y la métrica, el filtro y las selecciones de agrupación de tu gráfico se aplican a la condición de alertas. Para completar la política de alertas, configura el activador de condición, especifica los canales de notificación y la documentación y, luego, haz clic en Crear política. Para obtener más información, consulta Crea una política de alertas.

Para administrar la política nueva, ve a la página Alertas en Google Cloud Console.

Editar un widget de panel

Para borrar un contacto, haz lo siguiente:

  1. Si Editando no se muestra, luego haga clic Lectura y seleccionaCambiar al modo de edición ,

  2. Selecciona el widget para activar el panel de configuración del widget.

  3. Para editar el widget con el editor JSON, haz clic en Editor de JSON a fin de abrirlo. (Opcional)

  4. Modifica el widget mediante el panel de configuración del widget o el editor de JSON:

    • Panel de configuración: Los cambios se guardan de forma automática, a menos que inhabilites el guardado automático. Para obtener información sobre cómo modificar el aspecto de un gráfico, consulta Configura las opciones de vista.
    • Editor de JSON: para guardar los cambios, haz clic en Aplicar cambios. De forma predeterminada, solo se expande la sección específica del gráfico del JSON. Para ver la definición del panel completa, haz clic en Mostrar más:

      Ilustra el botón para expandir en el editor de JSON.

Borrar un widget de panel

Borrar un gráfico de alertas no borra la política de alertas cuyos datos se mostraron en el gráfico. Por lo tanto, es posible que recibas notificaciones de esa política después de que se borre el gráfico de alertas. Para administrar tus políticas de alertas, ve a la página Alertas en Google Cloud Console.

Para borrar un contacto, haz lo siguiente:

  1. Si Editando no se muestra, luego haga clic Lectura y seleccionaCambiar al modo de edición ,
  2. Selecciona el widget que deseas borrar.
  3. En la barra de herramientas del gráfico, selecciona Borrar.

¿Qué sigue?