Añadir texto y agrupaciones a un panel de control

En este documento se describe cómo añadir información útil a un panel de control y cómo agrupar widgets en él. Por ejemplo, puedes añadir información sobre el panel de control, enlaces a recursos relevantes o qué hacer en diferentes situaciones. Si un panel de control contiene muchos widgets, puedes mejorar su usabilidad agrupándolos.

Para obtener información sobre la API Cloud Monitoring, consulta el artículo Crear y gestionar paneles de control mediante APIs.

Esta función solo se admite en proyectos de Google Cloud . En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.

Antes de empezar

En el Google Cloud proyecto en el que quieras crear y modificar paneles de control personalizados, haz lo siguiente:

Añadir texto a un panel de control

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

Ejemplo de un panel de control con un widget de texto.

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

Para añadir un widget de texto a un panel de control, sigue estos pasos:

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

    Ve a Paneles.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

  2. En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
  3. Selecciona un panel de control o haz clic en Crear panel de control.
  4. En la barra de herramientas, haz clic en  Añadir widget.
  5. En el cuadro de diálogo Añadir widget, ve a la sección Diseño y selecciona Texto.
  6. Añade un título.

  7. En el panel Contenido, introduce el texto que quieras que se muestre.

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

  8. Opciones: usa los campos del panel Mostrar para personalizar el contenido.

    Por ejemplo, puede configurar la visibilidad del widget.

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

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

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 etiquetas HTML.

  • Encabezados

    Una línea que empieza por una almohadilla (#) indica un encabezado. Puedes usar varios signos de almohadilla para diferentes niveles de encabezados. Por ejemplo, para un encabezado de nivel superior, usa un solo signo de almohadilla (# Header). Para un encabezado de segundo nivel, usa dos almohadillas, ## Second-level header.

  • Párrafos

    Para crear un párrafo, utiliza 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 inversas, `fixed font`.

  • Enlaces: formato [link text](path).

    Puede usar cualquier valor para link text. El valor de path debe hacer referencia a un anclaje HTML del panel de control o ser una URL a una página externa.

    • Para crear un enlace a otra sección del panel de control. El ancla de una sección es el título de la sección, convertido a minúsculas y con las palabras separadas por un guion. Por ejemplo, para crear un enlace a una sección con el título "Gráficos que usan variables", defina el path como #charts-using-variables.

    • Para crear un enlace a un recurso externo, asigne a path la URL. Por ejemplo, para crear un enlace a example.com, asigna el valor https://example.com/ a path.

  • Listas: puedes crear listas ordenadas o desordenadas, así como anidar listas.

    • En las listas ordenadas, añade el prefijo 1. a cada elemento. Cuando se renderiza el texto, los elementos se numeran secuencialmente. Por ejemplo:

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

    • En las listas sin ordenar, añade un signo más (+), un guion (-) o un asterisco (*) delante de cada elemento. Por ejemplo:

      + Unordered list item 1
+ Unordered list item 2

    • Para anidar listas, sangra 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: usa el formato ${VARIABLE_NAME}.

    El widget de texto solo muestra el valor o los valores de la variable. Por ejemplo, si tiene una variable basada en etiquetas en la que la clave es zone y el valor es us-west1, el widget de texto mostrará 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 han escrito y no se renderizan.

  • Escape de caracteres

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

Organizar los widgets del panel de control

Los paneles de control 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 de control que tenga muchos widgets creando secciones o agrupando widgets:

  • Para crear secciones indexadas en tu panel de control, usa el widget de encabezado de sección. Cuando añades este widget a tu panel de control, se crea un índice y se añade una línea divisoria horizontal al panel. La tabla de contenido te permite desplazarte a una sección específica del panel de control. Cada widget de sección contiene un ancla. Cuando estés solucionando un problema, puede que quieras compartir la URL de la sección con un compañero. Para copiar la URL de la sección, haz clic con el botón derecho en Enlace al encabezado y, a continuación, selecciona Copiar dirección de enlace.

  • Para reducir el tiempo de carga de un panel de control, usa widgets de grupo. Hay tres tipos de widgets de grupo: contraíble, desplegable y de pestañas. Los widgets de grupo contienen una colección de widgets y mejoran el rendimiento al usar datos de menor prioridad para recuperar 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 están ocultos. Por el contrario, los widgets de grupo desplegable y de grupo de pestañas solo muestran un miembro de la colección. La diferencia entre estos widgets es si seleccionas el miembro que quieres mostrar mediante un menú o una pestaña.

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

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

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

Añadir un widget de encabezado de sección

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

Para añadir un widget de encabezado de sección mediante la consola Google Cloud , sigue estos pasos:

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

    Ve a Paneles.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

  2. En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
  3. En el cuadro de diálogo Añadir widget, ve a la sección Diseño y selecciona el widget Encabezado de sección.

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

    • El valor del campo Nombre de la sección se muestra en la tabla de contenido.
    • El valor del campo Subtítulo se muestra en el panel de control.
    • Si seleccionas *Añadir un separador al índice, se añadirá una línea horizontal después de la entrada del índice.

Añadir widgets de grupo que se puede ocultar

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

Para añadir un widget de grupo contraíble mediante la consola Google Cloud , sigue estos pasos:

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

    Ve a Paneles.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

  2. En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
  3. En el cuadro de diálogo Añadir widget, ve a la sección Diseño y selecciona Grupo contraíble.

  4. Para añadir un widget al grupo, arrástralo al grupo.

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

  5. Para añadir un título descriptivo al grupo, coloca el cursor sobre el widget para activar la barra de herramientas y, a continuación, haz clic en Editar grupo.

  6. Opcional: Para que el grupo se contraiga de forma predeterminada, coloca el puntero sobre el widget para activar la barra de herramientas y, a continuación, 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 inferior a la de otros widgets. Como resultado, tu panel de control se carga más rápido.

Añadir widgets de grupo desplegable o de grupo 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 se selecciona el miembro de la colección que se muestra. Los grupos desplegables ofrecen 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 Cloud Monitoring para crear estos widgets, consulta Panel de control con un widget SingleViewGroup.

Para añadir estos widgets a un panel de control, sigue estos pasos:

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

    Ve a Paneles.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

  2. En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
  3. Si es necesario, crea los widgets que quieras añadir al widget de grupo.

  4. En el cuadro de diálogo Añadir widget, ve a la sección Diseño y, a continuación, selecciona Grupo desplegable o Grupo de pestañas.

    Se añade un widget del tipo seleccionado a tu panel de control.

  5. Para añadir 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 añade el widget que quieras.

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

    1. En la barra de herramientas del widget, seleccione Editar grupo de pestañas y, a continuación, Editar grupo.
    2. Opcional: Escribe un título para el grupo.

    3. Haz clic en Añadir widget y, a continuación, selecciona una opción del menú Añadir widget.

      En el menú Añadir widget se muestran los widgets que se pueden añadir al grupo.

    4. Repite el paso anterior con cada widget que quieras añadir al widget de grupo de pestañas.

    5. Usa los botones Inferior y Superior para ordenar los widgets del widget de grupo.

    6. Haz clic en Aplicar.

    El panel de control se actualiza y solo se muestra uno de los widgets que se han añadido al widget de grupo. La barra de herramientas del widget mostrado te permite editarlo o realizar otras acciones.

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

Siguientes pasos

También puede añadir los siguientes widgets a sus paneles de control personalizados:

Para obtener información sobre cómo consultar datos representados en gráficos y filtrar paneles de control, consulta los siguientes artículos: