Agrega texto y agrupaciones a un panel

Los widgets de texto, encabezado de sección y grupo en un panel personalizado de Cloud Monitoring te permiten documentar los pasos para solucionar problemas y organizar grandes colecciones de gráficos. Puedes usar widgets de texto de Markdown para mostrar vínculos y orientación operativa, y encabezados de sección para generar un índice navegable. Para reducir el desorden visual y mejorar los tiempos de carga del panel, puedes agrupar los widgets en grupos contraíbles, desplegables o de pestañas.

En este documento, se describe cómo agregar estos widgets con la consola deGoogle Cloud . Para obtener información sobre cómo usar la API de Cloud Monitoring, consulta Crea y administra paneles con la API.

Antes de comenzar

Completa lo siguiente en el proyecto de Google Cloud en el que deseas crear y modificar paneles personalizados:

Agrega texto a un panel

En la siguiente captura de pantalla, se muestra un widget de texto:

Ejemplo de un panel con un widget de texto.

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

Para agregar un widget de texto a un panel, haz lo siguiente:

  1. En la consola de Google Cloud , accede a la página Paneles :

    Acceder a Paneles

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

  2. En la barra de herramientas de la consola de Google Cloud , selecciona tu proyecto de Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.
  3. Selecciona un panel o haz clic en Crear panel.
  4. En la barra de herramientas, haz clic en  Agregar widget.
  5. En el cuadro de diálogo Agregar widget, ve a la sección Diseño y, luego, selecciona Texto.
  6. Agrega un título.

  7. En el panel Contenido, ingresa el texto que deseas que se muestre.

    Para obtener información sobre el formato, consulta Sintaxis de Markdown.

  8. Opcional: Usa los campos del panel Visualización para personalizar tu contenido.

    Por ejemplo, puedes configurar la visibilidad del widget.

  9. Para aplicar los cambios en el panel, en la barra de herramientas, haz clic en Aplicar. Para descartar los cambios, haz clic en Cancelar.

  10. Para guardar el panel modificado, en la barra de herramientas, haz clic en Guardar.

Sintaxis de markdown

En esta sección, se describe la mayor parte de la sintaxis de Markdown que admite el widget de texto. No se admiten las etiquetas HTML.

  • Encabezados

    Una línea que comienza con un numeral, #, indica un encabezado. Puedes usar varios signos de numeral para diferentes niveles de encabezados. Por ejemplo, para un encabezado de nivel superior, usa un solo numeral, # Header. Para un encabezado de segundo nivel, usa dos numerales, ## Second-level header.

  • Párrafos

    Para crear un párrafo nuevo, usa una línea en blanco.

  • Énfasis

    • Cursiva: Usa *italic* o _italic_.
    • Negrita: Usa **bold** o __bold__.
    • Negrita y cursiva: Usa ***bold and italic***.
    • Fuente fija: Usa comillas simples, `fixed font`.

  • Vínculos: Aplica el formato [link text](path).

    Puedes usar cualquier valor para link text. El valor de path debe hacer referencia a un ancla HTML en el panel o ser una URL a una página externa.

    • Para vincular a otra sección del panel, establece path en el ancla de la sección. El ancla de una sección es el título de la sección, convertido a minúsculas con palabras separadas por un guion. Por ejemplo, para vincular a una sección con el título "Gráficos con variables", establece el path en #charts-using-variables.

    • Para vincular a un recurso externo, establece path en la URL. Por ejemplo, para vincular a example.com, establece path en https://example.com/.

  • Listas: Puedes crear listas ordenadas o listas sin ordenar, y puedes anidar listas.

    • En el caso de las listas ordenadas, agrega el prefijo 1. a cada elemento de la lista. Cuando se renderiza el texto, los elementos se numeran de forma secuencial. Por ejemplo:

      1. Ordered list item 1
1. Ordered list item 2

    • Para las listas sin ordenar, agrega un prefijo a cada elemento de la lista con un signo más (+), un guion (-) o un asterisco (*). Por ejemplo:

      + Unordered list item 1
+ Unordered list item 2

    • Para anidar listas, aplica sangría a la lista anidada. Por ejemplo:

      1.  Item 1
    + Nested unordered-list item 1
    + Nested unordered-list item 2
1.  Item 2
    1. Nested ordered-list item 1
    1. Nested ordered-list item 2

  • Variables: Aplica el formato ${VARIABLE_NAME}.

    El widget de texto solo renderiza el valor o los valores de la variable. Por ejemplo, si tienes una variable basada en etiquetas en la que la clave es zone y el valor es us-west1, el widget de texto muestra us-west1.

    Cuando el valor de una variable es el comodín (*), el widget de texto muestra all.

    Las variables no reconocidas se muestran tal como se escriben y no se renderizan.

  • Caracteres de escape

    Algunos caracteres, como los signos más (+), se convierten en elementos de lista. Si deseas mostrar estos tipos de caracteres de forma literal, usa una barra inversa para escapar el carácter, \+.

Organiza los widgets del panel

Los paneles personalizados te permiten especificar la posición de los gráficos, las políticas de alertas y otros widgets. Sin embargo, puedes mejorar la usabilidad de un panel que tiene muchos widgets creando secciones en tu panel o agrupando widgets:

  • Para crear secciones indexadas en tu panel, usa el widget section-header. Cuando agregas este widget a tu panel, se crea un índice y se agrega un divisor horizontal al panel. El índice te permite navegar a una sección específica del panel. Cada widget de sección contiene un ancla. Cuando solucionas problemas, es posible que quieras compartir la URL de la sección con un compañero de equipo. Para copiar la URL de la sección, haz clic con el botón derecho en Vincular al encabezado y, luego, selecciona Copiar dirección del vínculo.

  • Para reducir el tiempo de carga de un panel, usa widgets de grupo. Existen tres tipos de widgets de grupo: contraíble, desplegable y de pestaña. Los widgets de grupo contienen una colección de widgets y mejoran el rendimiento, ya que recuperan datos con una prioridad más baja para los miembros de la colección que no se muestran. El widget de grupo contraíble muestra todos los miembros de la colección cuando se expande; de lo contrario, todos los miembros se ocultan. En cambio, los widgets de grupo desplegable y grupo de pestañas muestran solo un miembro de la colección. La diferencia entre estos widgets es si seleccionas el miembro que se mostrará con un menú o una pestaña.

Para usar los widgets que se describen en esta sección, tu panel personalizado debe usar el modo mosaico, que es el diseño predeterminado. Si cambias el diseño al de una cuadrícula, estos widgets no estarán disponibles.

En la mayoría de los widgets, puedes configurar su visibilidad. Sin embargo, los widgets organizativos siempre están visibles.

En el resto de esta sección, se describe cómo agregar y configurar widgets que puedes usar para organizar tus paneles. Para obtener información sobre cómo modificar estos widgets, consulta Modifica la configuración de un widget.

Cómo agregar un widget de encabezado de sección

Para obtener información sobre cómo usar la API de Cloud Monitoring para crear un widget de encabezado de sección, consulta Panel con un widget SectionHeader.

Para agregar un widget de encabezado de sección con la consola de Google Cloud , haz lo siguiente:

  1. En la consola de Google Cloud , accede a la página Paneles :

    Acceder a Paneles

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

  2. En la barra de herramientas de la consola de Google Cloud , selecciona tu proyecto de Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.
  3. En el diálogo Agregar widget, ve a la sección Diseño y, luego, selecciona el widget Encabezado de sección.

  4. En el widget, haz clic en Editar sección y completa el diálogo:

    • El valor del campo Nombre de la sección se muestra en el índice.
    • El valor del campo Subheading se muestra en el panel.
    • Si seleccionas Agregar una sección divisoria al índice, se agregará una línea horizontal después de la entrada en el índice.

Agrega widgets de grupos contraíbles

Para obtener información sobre cómo usar la API de Cloud Monitoring para crear un widget de grupo contraíble, consulta Panel con un widget CollapsibleGroup.

Para agregar un widget de grupo contraíble con la consola de Google Cloud , haz lo siguiente:

  1. En la consola de Google Cloud , accede a la página Paneles :

    Acceder a Paneles

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

  2. En la barra de herramientas de la consola de Google Cloud , selecciona tu proyecto de Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.
  3. En el diálogo Agregar widget, ve a la sección Diseño y, luego, selecciona Grupo contraíble.

  4. Para agregar un widget al grupo, arrástralo hasta allí.

    Después de agregar widgets al grupo, puedes usar el puntero para cambiar su tamaño y posición.

  5. Para agregar un título descriptivo al grupo, coloca el puntero sobre el widget para activar la barra de herramientas y, luego, haz clic en Editar grupo.

  6. Opcional: Para forzar que el grupo se contraiga de forma predeterminada, coloca el puntero sobre el widget para activar la barra de herramientas y, luego, haz clic en Contraer grupo.

    Cuando se contrae un widget de grupo contraíble, Monitoring recupera los datos de los widgets del grupo con una prioridad más baja que la de otros widgets. Como resultado, tu panel se carga más rápido.

Agrega widgets de grupos desplegables o de grupos de pestañas

Los widgets de grupo desplegable y de grupo de pestañas contienen una colección de otros widgets, pero solo muestran un miembro de la colección. La diferencia entre estos widgets es la forma en que seleccionas qué miembro de la colección se muestra. Los grupos desplegables proporcionan un menú, mientras que los grupos de pestañas proporcionan pestañas en la barra de herramientas.

Para obtener información sobre cómo usar la API de Cloud Monitoring para crear estos widgets, consulta Panel con un widget de SingleViewGroup.

Para agregar estos widgets a un panel, haz lo siguiente:

  1. En la consola de Google Cloud , accede a la página Paneles :

    Acceder a Paneles

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

  2. En la barra de herramientas de la consola de Google Cloud , selecciona tu proyecto de Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.
  3. Si es necesario, crea los widgets que quieras agregar al widget de grupo.

  4. En el diálogo Agregar widget, ve a la sección Diseño y, luego, selecciona Grupo de menú desplegable o Grupo de pestañas.

    Se agregará un widget del tipo seleccionado a tu panel.

  5. Para agregar widgets, como un gráfico de líneas, a un widget de grupo, arrástralos al widget de grupo o edita el widget de grupo y realiza una operación de adición.

    Por ejemplo, para agregar widgets a un widget de grupo de pestañas editando el grupo, haz lo siguiente:

    1. En la barra de herramientas del widget, selecciona Editar grupo de pestañas y, luego, Editar grupo.
    2. Opcional: Ingresa un título para el grupo.

    3. Haz clic en Agregar widget y, luego, selecciona una opción en el menú Agregar widget.

      En el menú Agregar widget, se enumeran los widgets que se pueden agregar al grupo.

    4. Repite el paso anterior para cada widget que quieras agregar al widget de grupo de pestañas.

    5. Usa los botones Más abajo y Más arriba para ordenar los widgets en el widget de grupo.

    6. Haz clic en Aplicar.

    Se actualiza el panel y solo se puede ver uno de los widgets que se agregaron al widget de grupo. La barra de herramientas del widget que se muestra te permite editarlo o realizar otras acciones.

  6. Para guardar el panel modificado, en la barra de herramientas, haz clic en Guardar.

¿Qué sigue?

También puedes agregar widgets a tus paneles personalizados que muestren lo siguiente:

Para obtener información sobre cómo explorar los datos de los gráficos y filtrar tus paneles, consulta los siguientes documentos: