Agregar widgets de panel

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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 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 definidas por el usuario 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 mostrar esos datos durante un intervalo de tiempo o solo los datos 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 según la forma en que 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 Identity and Access Management:

  • 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 de Google Cloud:

  • Los gráficos muestran datos en el tiempo y hay cuatro estilos disponibles: de línea, de área apilada, de barras apiladas y de mapa de calor. Después de configurar un gráfico, puedes cambiar su tipo de widget. Para obtener información sobre los motivos por los que puedes seleccionar un estilo específico, consulta la sección 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 Table 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. Para obtener más información y un ejemplo, consulta Muestra datos en forma tabular en un panel.

    Si deseas 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 Google 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 gráfico o widget de tabla 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 tener acceso a todos los campos configurables o ingresar un filtro de Monitoring, usa el modo Avanzado. Es posible que no puedas cambiar a otro modo de configuración.
    • 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ásico

Para configurar el widget, completa los siguientes pasos:

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

Selecciona los datos de series temporales que quieras ver

Para seleccionar la serie temporal a fin de graficarla, realiza una de las siguientes acciones:

  • Si quieres 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 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 y métricas 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. Si quieres 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 si aplicas 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 plantilla, consulta Filtra un panel.

      Para agregar un filtro, haz clic en Agregar un filtro y, luego, selecciona la etiqueta y el valor de la etiqueta. Por ejemplo, para mostrar las series temporales solo para 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.

Para obtener más información sobre estas opciones, consulta Selecciona métricas para los gráficos de los 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.

Cómo configurar las opciones de la vista de gráfico

Estos campos no están disponibles para las tablas.

Opcional: Cree gráficos de varios tipos de métricas

Esta opción no está disponible para tablas.

Para mostrar otro tipo de métrica en el 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 realizaste 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 configuración del Explorador de métricas con dos métricas.

Aspectos avanzados

Para configurar el widget, completa los siguientes pasos:

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

Selecciona los datos de series temporales que quieras ver

Para seleccionar la serie temporal a fin de graficarla, realiza una de las siguientes acciones:

  • Si quieres 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 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 y métricas 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. Si quieres 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 si aplicas 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 plantilla, consulta Filtra un panel.

      Para agregar un filtro, haz clic en Agregar un filtro y, luego, selecciona la etiqueta y el valor de la etiqueta. Por ejemplo, para mostrar las series temporales solo para 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.

Para obtener más información sobre estas opciones, consulta Selecciona métricas para los gráficos de los paneles.

Selecciona el procesamiento previo de 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 de 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, si seleccionas rate, las unidades cambian 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.

Cómo configurar las opciones de la vista de gráfico

Estos campos no están disponibles para las tablas.

Opcional: Cree gráficos de varios tipos de métricas

Esta opción no está disponible para tablas.

Para mostrar otro tipo de métrica en el 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 realizaste 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 configuración del Explorador de métricas con dos métricas.

Opcional: Cree un gráfico de una proporción de tipos de métricas

Esta opción no está disponible para 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 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, 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 Series temporales B.

    Ambos tipos de métrica deben tener el mismo tipo de métrica. Por ejemplo, si 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 mínimo de alineación 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 Serie temporal-A. Por ejemplo, puedes agrupar ambos tipos de métricas por 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 sean comunes a ambos campos.

  5. Habilite 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 cambia de nombre a Denominator.

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

  7. De manera 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 de MQL.

Por ejemplo, la siguiente consulta muestra el uso de CPU promedio de cada 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 selecciones 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 Calcula proporciones.

Para obtener más información sobre el uso de MQL, consulta Introducción a MQL.

Para obtener más información sobre cómo agregar filtros de plantillas cuando se usa MQL, consulta Filtros del panel.

PromQL

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

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

avg(compute_googleapis_com:instance_cpu_utilization)

Cuando selecciones 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 Query has too many time series, modifica tu consulta para combinar las series temporales.

Para obtener más información sobre el uso de PromQL, consulta PromQL en Cloud Monitoring.

Los gráficos de PromQL no son compatibles con los filtros de nivel de página en tus paneles personalizados.

Cómo agregar indicadores a un panel

Para ver la medición más reciente en comparación con un conjunto de umbrales codificados por color, agrega un indicador o un 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 corresponde a Google 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 Google 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 otro modo de configuración.
    • 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ásico

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 quieras ver

Para seleccionar la serie temporal a fin de graficarla, realiza una de las siguientes acciones:

  • Si quieres 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 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 y métricas 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. Si quieres 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 si aplicas 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 plantilla, consulta Filtra un panel.

      Para agregar un filtro, haz clic en Agregar un filtro y, luego, selecciona la etiqueta y el valor de la etiqueta. Por ejemplo, para mostrar las series temporales solo para 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.

Para obtener más información sobre estas opciones, consulta Selecciona métricas para los gráficos de los 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 límite y advertencia

Realice una de las siguientes acciones:

  • Para los medidores, haz lo siguiente:

    1. Ingresa los valores mínimo y máximo de 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 ilustra una configuración para un indicador con los umbrales Warning above y Peligro 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.

Aspectos avanzados

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 quieras ver

Para seleccionar la serie temporal a fin de graficarla, realiza una de las siguientes acciones:

  • Si quieres 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 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 y métricas 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. Si quieres 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 si aplicas 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 plantilla, consulta Filtra un panel.

      Para agregar un filtro, haz clic en Agregar un filtro y, luego, selecciona la etiqueta y el valor de la etiqueta. Por ejemplo, para mostrar las series temporales solo para 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.

Para obtener más información sobre estas opciones, consulta Selecciona métricas para los gráficos de los 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 límite y advertencia

Realice una de las siguientes acciones:

  • Para los medidores, haz lo siguiente:

    1. Ingresa los valores mínimo y máximo de 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 ilustra una configuración para un indicador con los umbrales Warning above y Peligro 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 el uso de MQL, consulta Introducción a MQL.

PromQL

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

Por ejemplo, considera la consulta para el uso de CPU de una instancia de VM. Si tienes varias VM, esta consulta recupera varias series temporales y no se puede mostrar mediante un medidor o cuadro de evaluación:

compute_googleapis_com:instance_cpu_utilization

Si tu consulta muestra varias series temporales, un widget de indicador o cuadro de evaluación te muestra el mensaje de error Your Query has too many time series.

Para resolver esta condición de error, asegúrate de que la consulta muestre una sola serie temporal. Por ejemplo, la siguiente consulta calcula el promedio de todas las series temporales:

avg(compute_googleapis_com:instance_cpu_utilization)

Para obtener más información sobre el uso de MQL, consulta PromQL en Cloud Monitoring.

Muestra datos en forma tabular 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 pueden mostrar percentiles para las métricas con valores de distribución. Las tablas solo muestran el valor más reciente, similar al comportamiento de los medidores y 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 de Lista principal está preconfigurado para tener dos columnas y limitar la cantidad de filas. Una columna del widget de la Lista superior muestra una etiqueta como instance_id y la otra muestra el valor y un indicador visual del valor en comparación con el rango de valores posibles. El widget de Tabla está preconfigurado para mostrar una columna por cada etiqueta con más de un valor único, una fila por cada serie temporal y un valor numérico como “25%”.

Ambos widgets están representados por la misma estructura de datos. Por lo tanto, después de agregar uno de estos widgets a tu panel, puedes limitar la cantidad de filas que se muestran, cambiar las columnas que muestra la tabla y cambiar la forma en que se representa el valor.

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 List List y un widget Table:

Ejemplo de widgets de **Lista principal** y **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 lo vuelves a cargar, se descartan las opciones de ordenamiento 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, un operador AND lógico se une a 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 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 corresponde a Google 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 Google 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 en la Biblioteca de gráficos o arrastra este widget de la biblioteca al á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.

Muestra las 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. En los gráficos de alertas, se muestran las series temporales que supervisa la política, un límite, la cantidad de incidentes asociados con la política y si se inhabilita. 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 corresponde a Google 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 alertas a un panel, haz lo siguiente:

  1. En Google 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 en 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 mediante el menú Política de alertas.

Ver políticas de alertas

Cuando veas 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 notificación 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 los detalles de 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.

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

Cómo mostrar incidentes en un panel

Para ver una tabla de incidentes en el mismo contexto que tus datos de métricas, agrega un widget de Incidentes. Cada fila de una tabla de Incidentes enumera información sobre un incidente. Esa información incluye el nombre de la política, el nombre de la condición y cuándo se abrió el incidente. El widget incluye opciones que te permiten ver la política de alertas asociada y los detalles del incidente.

En la siguiente captura de pantalla, se muestra un widget de Incidentes (Incidents):

Ejemplo de un widget **Incidentes**.

La información restante de esta sección corresponde a Google Cloud Console. Para obtener información sobre el uso de la API de Cloud Monitoring, consulta Panel con un widget Incidents.

Para mostrar los incidentes en un panel, haz lo siguiente:

  1. En Google 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 la Lista de incidentes de la Biblioteca de gráficos o arrastra este widget de la biblioteca al área del gráfico.
  5. Actualiza el título del widget (opcional).
  6. Opcional: Selecciona los criterios que definen qué incidentes se muestran. De forma predeterminada, se enumeran todos los incidentes del proyecto de Google Cloud. Sin embargo, puedes restringir el widget a fin de que muestre incidentes para políticas de alertas específicas o para recursos y métricas específicos:

    • Para mostrar incidentes de políticas de alertas específicas, selecciona Alert policy y, luego, elige en el menú Alert policies.

      Cuando realizas una selección en este menú, las selecciones que realizaste en el menú Tipos de recursos se descartan.

    • Para mostrar los incidentes según tipos de recursos específicos, selecciona Tipo de recurso y, luego, elige en el menú Tipos de recursos.

      Cuando realizas una selección en este menú, se descartan todas las selecciones del menú Política de alertas.

    Cuando no seleccionas políticas de alertas ni tipos de recursos específicos, se muestran todos los incidentes.

  7. Opcional: De forma predeterminada, solo se muestran los incidentes abiertos. Para mostrar todos los incidentes, incluidos los que se cerraron dentro del intervalo del temporizador especificado en el selector de intervalo de tiempo, habilita el botón de activación Mostrar cerrado.

Puedes ordenar la lista de incidentes por fecha de apertura o cierre. También puedes buscar la lista mediante el campo Filtro.

Ver detalles de la política de incidentes y alertas

Cuando veas un widget de Incidentes, es posible que quieras obtener información sobre la política de alertas o el incidente:

  • Para ver los detalles de la política de alertas asociada con el incidente, busca ese incidente en el widget Incidentes y selecciona el nombre de la política.

  • Para ver los detalles de un incidente, búscalo en el widget Incidentes y haz clic en Ver.

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 configurarla para que muestre solo las entradas de registro que te interesan.

En la siguiente captura de pantalla, se ilustra 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 Ver registros en un panel personalizado.

Muestra los SLO en un panel

Para ver el estado de cumplimiento, 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 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 muestra 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 corresponde a Google Cloud Console. 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 Google 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, un mensaje te indica 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. Puede seleccionar el estado de cumplimiento, 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.

Organiza 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 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 visualización que supervisan las VM.

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

  1. En Google 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) Establezca 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 del grupo con una prioridad menor que con 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 widget de grupo que se puede contraer, puedes borrarlo o arrastrarlo al espacio no utilizado 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?