Cómo agregar 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 desees 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 agrupándolos.

Para obtener información sobre la API de Cloud Monitoring, consulta Crea y administra paneles mediante la API.

Antes de comenzar

Si quieres obtener los permisos que necesitas para crear y modificar paneles personalizados con la consola de Google Cloud, pídele a tu administrador que te otorgue el rol de IAM Editor de Monitoring (roles/monitoring.editor) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

Es posible que también puedas obtener los permisos necesarios a través de los roles personalizados o de otros roles predefinidos.

Para obtener más información sobre las funciones, consulta Controla el acceso con Identity and Access Management.
Puedes colocar hasta 40 gráficos en un panel.

Agregar 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 corresponde a 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:

En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego, Paneles:
Ir a Paneles
Selecciona un panel o haz clic en Crear panel.
En la barra de herramientas, haz clic en Agregar widget.
En el diálogo Agregar widget, ve a la sección Diseño y selecciona Texto.
Agrega un título.
En el panel Contenido, ingresa el texto que deseas que se muestre. El widget 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 [example.com](https://example.com/) para vincularlo a example.com.
Opciones: Usa los campos del panel Pantalla para personalizar tu contenido.
Para aplicar los cambios al panel, en la barra de herramientas, haz clic en Apply. Para descartar los cambios, haz clic en Cancelar.

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 tenga muchos widgets si creas secciones en tu panel o agrupas los widgets:

Para crear secciones indexadas en tu panel, usa el widget de encabezado de sección. 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 intentes solucionar problemas, te recomendamos 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 Link to heading y, luego, selecciona Copy link address.
Para reducir el tiempo de carga de un panel, usa widgets de grupo contraíbles y widgets de vista única. Ambos widgets contienen una colección de widgets y mejoran el rendimiento mediante el uso de datos de menor prioridad 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 estarán ocultos. Por el contrario, un widget de grupo de una sola vista muestra solo un miembro de la colección a la vez, y puedes usar un menú para seleccionar qué miembro se muestra.

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 uno de cuadrícula, estos widgets no estarán disponibles.

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.

Agrega un widget de encabezado de sección

Si quieres 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:

En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego, Paneles:
Ir a Paneles
En el diálogo Agregar widget, ve a la sección Diseño y selecciona el widget Encabezado de la sección.
En el widget, haz clic en Edit section 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 Subheading se muestra en el panel.
- Si seleccionas *Agregar una línea divisoria al índice, se agregará una línea horizontal después de la entrada en el índice.

Cómo agregar un widget de grupo que se puede contraer

Si deseas obtener información sobre el uso de 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:

En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego, Paneles:
Ir a Paneles
En el diálogo Agregar widget, ve a la sección Diseño y selecciona Contraíble Group.
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 posición.
Para agregar un título descriptivo al grupo, coloca el puntero en el widget para activar la barra de herramientas y, luego, haz clic en Editar grupo.
Opcional: Si quieres asegurarte de que el grupo se contraiga de forma predeterminada, coloca el puntero en el widget para activar la barra de herramientas y, luego, haz clic en Collapse group.

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.

Cómo agregar un widget de grupo de vista única

Si deseas obtener información sobre el uso de la API de Cloud Monitoring para crear un widget de vista única, consulta Panel con un widget SingleViewGroup.

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

En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego, Paneles:
Ir a Paneles
Si es necesario, crea los widgets que deseas agregar al widget de vista única.
En el diálogo Agregar widget, ve a la sección Diseño y selecciona Single View Group.

Se agregará un widget de grupo de vista única a tu panel.
Agrega widgets al widget de grupo de vista única:
1. En el widget de grupo de vista única, expande el menú Widget y, luego, selecciona Editar grupo.
2. Haz clic en Agregar widget y selecciona una opción en el menú Agregar widget.
  
  Nota: No todos los tipos de widgets se pueden agregar a un widget de grupo de vista única. El menú Agregar widget solo muestra los widgets compatibles.
3. Repite el paso anterior para cada widget que desees agregar al widget de grupo de vista única.
4. Usa los botones Inferior y Más alto para ordenar los widgets en el widget de grupo.
5. Haz clic en Enviar.
El panel se actualiza y solo uno de los widgets que se agregaron al widget de grupo de vista única es visible. La barra de herramientas del widget que se muestra te permite editar el widget que se muestra o realizar otras acciones.

¿Qué sigue?

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

Para obtener más información sobre cómo explorar los datos del gráfico y filtrar los paneles, consulta los siguientes documentos: