Agrega texto y agrupaciones a un panel

En este documento, se describe cómo puedes agregar información útil a un panel y cómo agrupar widgets en un panel. Por ejemplo, es posible que quieras agregar información sobre el panel, vínculos a recursos relevantes o qué hacer en diferentes situaciones. Cuando un panel contiene muchos widgets, puedes mejorar su usabilidad agrúpalos.

Para obtener información sobre la API de Cloud Monitoring, consulta Cómo crear y administrar paneles con la API.

Esta función solo es compatible con los proyectos de Google Cloud.

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 el uso de 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, ve a la página  Paneles.

    Dirígete a Paneles de control

    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.
  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 Comandos de Markdown compatibles.

  8. Opciones: 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, haz clic en Guardar en la barra de herramientas.

Comandos de Markdown compatibles

En esta sección, se describen los comandos de Markdown que admite el widget de texto:

  • Encabezados

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

  • Fuentes

    • Cursiva: Usa *italic* o _italic_.
    • Negrita: Usa **bold** o __bold__.
  • Vínculos: Debe tener 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. El ancla de una sección es el título de la sección, convertido en 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 path como #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/.

  • Variables: Usa el formato ${VARIABLE_NAME}.

    El widget de texto renderiza solo 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 como están escritas y no se renderizan.

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 si creas secciones en él o si agrupas los widgets:

  • Para crear secciones indexadas en tu panel, usa el widget de sección de encabezado. 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 soluciones problemas, te recomendamos que compartas 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 a 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: plegables, desplegables y de pestaña. Los widgets de grupo contienen una colección de widgets y mejoran el rendimiento mediante el uso de datos de prioridad inferior para recuperar miembros de la colección que no se muestran. El widget de grupo plegable 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 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 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 la organización 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 Cómo modificar la configuración de un widget.

Agrega un widget de encabezado de sección

Para obtener información sobre el uso de 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, ve a la página  Paneles.

    Dirígete a Paneles de control

    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.
  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 la tabla de contenido.
    • El valor del campo Subtítulo 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.

Se agregaron widgets de grupo que se pueden contraer

Para obtener información sobre el uso de la API de Cloud Monitoring para crear un widget de grupo plegable, consulta Panel con un widget CollapsibleGroup.

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

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

    Dirígete a Paneles de control

    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.
  3. En el cuadro de diálogo Agregar widget, ve a la sección Diseño y, luego, selecciona Grupo plegable.
  4. Para agregar un widget al grupo, arrástralo al grupo.

    Después de agregar widgets al grupo, puedes usar el puntero para cambiar su tamaño y su 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 asegurarte de 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 que se puede contraer, la supervisión recupera los datos de los widgets del grupo con una prioridad menor que la de otros widgets. Como resultado, tu panel se carga más rápido.

Cómo agregar widgets de grupos de pestañas o grupos desplegables

Los widgets de grupos desplegables y de grupos 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 SingleViewGroup.

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

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

    Dirígete a Paneles de control

    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.
  3. Si es necesario, crea los widgets que quieras agregar al widget del grupo.
  4. En el diálogo Agregar widget, ve a la sección Diseño y, luego, selecciona Grupo 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ástralo al widget de grupo o edítalo 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 muestran los widgets que se pueden agregar al grupo.

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

    5. Usa los botones Más bajo y Más alto 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 del grupo. La barra de herramientas del widget que se muestra te permite editarlo o realizar otras acciones.

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

¿Qué sigue?

También puedes agregar los siguientes widgets a tus paneles personalizados:

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