Crear y administrar paneles personalizados

En este documento, se describe cómo crear y administrar paneles personalizados con la consola de Google Cloud . Los paneles personalizados te permiten mostrar información que te interesa, organizada de una manera que te resulte útil. Por ejemplo, puedes crear un panel para mostrar los registros, las métricas de rendimiento y las políticas de alertas de las máquinas virtuales (VM) en tu entorno de producción. Después de crear un panel personalizado, también puedes copiarlo, modificarlo y compartirlo. Para crear paneles, puedes usar la Google Cloud consola, la API de Cloud Monitoring o Google Cloud CLI.

En este documento, se describe cómo crear y administrar tus paneles personalizados con la consola de Google Cloud :

Esta función solo se admite para proyectos de Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.

Acerca de los paneles personalizados

Los paneles personalizados admiten una variedad de tipos de widgets, por lo que puedes elegir la mejor manera de mostrar tus datos. De forma predeterminada, los paneles muestran todos los datos de métricas disponibles para tu proyecto de Google Cloud . Si configuras un permiso de métricas, tu panel puede mostrar datos de métricas para varios proyectos de Google Cloud .

Un panel personalizado puede mostrar todo lo siguiente:

Puedes mejorar el tiempo de carga o la usabilidad de un panel agrupando widgets. Por ejemplo, puedes agregar secciones a un panel. Como alternativa, puedes agregar widgets a un contenedor que esté expandido o contraído.

Después de crear un panel, puedes agregar filtros, variables, eventos o etiquetas definidas por el usuario:

  • Los filtros para todo el panel se aplican a todos los widgets del panel. Estos filtros pueden ser útiles cuando solucionas problemas. Por ejemplo, puedes usar estos filtros para mostrar datos solo de una zona específica. Para obtener más información, consulta Cómo agregar o quitar filtros.

  • Las variables se aplican a los widgets seleccionados. Por ejemplo, puedes usar una variable para modificar la consulta que emite el widget o para controlar la visibilidad de un widget. Para obtener más información, consulta Crea y administra variables y filtros fijados.

  • Los eventos, como la falla de un Pod de Google Kubernetes Engine, pueden ayudarte a correlacionar datos de diferentes fuentes cuando solucionas un problema. Para obtener más información, consulta Cómo mostrar eventos en un panel.

  • Las etiquetas pueden ayudarte a ubicar los paneles según el tipo de contenido que muestran. Por ejemplo, puedes agregar la etiqueta prod a los paneles que muestran información sobre los sistemas de producción. Del mismo modo, puedes agregar la etiqueta staging para indicar que el panel muestra información sobre los sistemas de producción.

Antes de comenzar

Completa lo siguiente en el proyecto Google Cloud en el que deseas crear y administrar paneles:

Agrega un panel personalizado a tu proyecto

Existen diferentes enfoques que puedes usar para agregar un panel personalizado a tu proyecto Google Cloud :

  • Puedes crear un panel.
  • Puedes copiar o duplicar un panel.
  • Puedes copiar un panel de un proyecto a otro.
  • Puedes subir o instalar paneles desde una ubicación compartida.
  • Puedes importar un panel desde Grafana.

Por ejemplo, supongamos que tienes varios proyectos Google Cloud y deseas que definan el mismo panel personalizado. En esta situación, puedes crear el panel en un proyecto y, luego, descargar una plantilla para el panel en tu sistema local. Luego, puedes instalar esa plantilla en otros proyectos deGoogle Cloud .

Crea un panel nuevo

Si deseas crear un panel personalizado, 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 Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
  3. En la página Paneles, haz clic en Crear panel personalizado.

  4. Para agregar widgets a tu panel, haz lo siguiente:

    1. En la barra de herramientas del panel, haz clic en  Agregar widget.

    2. En el panel Agregar widget, selecciona un widget para agregarlo a tu panel.

      Puedes seleccionar un widget según el tipo de datos que deseas mostrar o la forma en que quieres mostrarlos. En todos los casos, se abrirá un panel de configuración. Por ejemplo, puedes seleccionar el widget Métrica y, luego, establecer la visualización en Área apilada. También puedes seleccionar el widget de Área apilada y, luego, la métrica.

    3. Configura el widget.

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

      Después de agregar el widget al panel, puedes cambiar su configuración.

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

  6. Opcional: Agrega etiquetas definidas por el usuario a tu panel:

    1. En la lista de paneles, ubica el panel y, luego, haz clic en Agregar etiquetas al panel.
    2. Realiza una de las siguientes acciones:

      • Para crear una etiqueta y agregarla a tu panel, en la sección Crear una etiqueta nueva, ingresa el nombre de la etiqueta en el cuadro de texto y, luego, haz clic en Crear y aplicar.

      • Para configurar qué etiquetas se agregan a tu panel, haz clic en Seleccionar etiquetas para aplicar, selecciona las etiquetas y, luego, haz clic en Aceptar.
    3. Para guardar los cambios, haz clic en Confirmar.

Cómo copiar un panel

Cuando quieras experimentar con diferentes métricas o distintas opciones de agregación, puedes copiar un panel y, luego, usar el panel nuevo para fines experimentales.

Para copiar 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 Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
  3. En la página Descripción general de los paneles, identifica el panel que deseas copiar y, luego, haz clic en Copiar panel.
  4. Opcional: Actualiza el nombre del panel.
  5. Haz clic en Copiar en el cuadro de diálogo de confirmación.

Copia un panel en otro proyecto

Para copiar un panel de un proyecto a otro, tu rol de IAM para los proyectos de destino Google Cloud debe incluir el permiso de editor de Monitoring. Para obtener más información sobre los roles, consulta Controla el acceso con Identity and Access Management.

Para copiar un panel a otro proyecto 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 Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.

  3. Copia el código JSON del panel en el portapapeles:

    1. En la barra de herramientas del panel, haz clic en Configuración, luego en JSON y, por último, en Editor de JSON.
    2. En la barra de herramientas del editor, haz clic en Copiar.

  4. Pega el código JSON del portapapeles en un panel nuevo creado en otro proyecto:

    1. Usa el Google Cloud selector de proyectos de la consola para seleccionar el proyecto en el que deseas crear la copia.
    2. Haz clic en Crear panel de control.
    3. En la barra de herramientas del panel, haz clic en Configuración, luego en JSON y, por último, en Editor de JSON.
    4. Pega el contenido del portapapeles en el editor.
    5. Haz clic en Aplicar cambios.
    6. Para guardar el panel modificado, haz clic en Guardar en la barra de herramientas.

Cómo instalar una plantilla de panel

Puedes subir a tu proyecto Google Cloud una plantilla para un panel, cuando esa plantilla se almacena en una ubicación compartida. Por ejemplo, Cloud Monitoring proporciona un conjunto seleccionado de plantillas de panel en GitHub que son específicas para varios servicios de Google Cloud . Los gráficos de estos paneles presentan una selección de métricas pertinentes para un servicio específico.

Después de subir una plantilla de panel, puedes personalizarla. Por ejemplo, puedes agregar gráficos, agregar etiquetas o configurar qué eventos se mostrarán.

Para obtener más información, consulta Instala una plantilla de panel.

Importa un panel desde Grafana

Cloud Monitoring proporciona un importador que puedes usar para importar archivos de panel en el formato JSON de Grafana a Cloud Monitoring. Para obtener más información, consulta Importa paneles de Grafana a Cloud Monitoring.

Cómo encontrar y ver un panel

Los paneles personalizados se muestran en la misma lista que los paneles específicos del servicio que Cloud Monitoring crea a medida que agregas recursos a tu proyecto de Google Cloud .

Para ver 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 Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.

    En la página Paneles, se enumeran todos los paneles de tu proyecto deGoogle Cloud .

  3. Para encontrar un panel, haz lo siguiente:

    • Usa las opciones Vistos recientemente y Favoritos para restringir los paneles que se muestran en la lista.

    • Usa el menú Integraciones para enumerar solo los paneles asociados con una integración específica.

    • Usa el menú Tipo para mostrar solo los paneles que tienen un tipo específico. Por ejemplo, para enumerar los paneles que Google Cloud crea automáticamente en función de tu uso de los servicios deGoogle Cloud , en el menú Tipo, selecciona Servicios de Google. Para definir mejor la lista, usa la barra de Filtro.

    • Usa el menú Etiquetas para enumerar solo los paneles que tienen una etiqueta específica definida por el usuario. Por ejemplo, supongamos que creaste una etiqueta llamada Staging y, luego, aplicaste esa etiqueta a tus paneles que muestran información sobre tus recursos de etapa de pruebas. Para enumerar estos paneles, selecciona la etiqueta Staging. Para definir mejor la lista, usa la barra de Filtro.

    • Agrega filtros a la barra de filtros :

      • Para mostrar una lista de los paneles cuyo nombre o descripción contengan texto específico, ingresa ese texto en la barra Filtro.

      • Para enumerar los paneles después de filtrarlos por el valor del campo del panel, haz lo siguiente:

        1. Selecciona Buscar en tus paneles y, luego, elige un campo para filtrar. Puedes filtrar por los siguientes campos del panel: nombre, descripción, tipo y etiqueta definida por el usuario.

        2. Ingresa un valor para el filtro o selecciona una opción del menú.

      • Para enumerar los paneles que no tienen gráficos, selecciona Buscar en tus paneles, luego Etiquetas y, por último, (Vacío).

      Cuando agregas varios filtros y no incluyes el operador OR entre dos filtros, un operador AND une los filtros.

  4. Después de encontrar el panel, selecciónalo.

Cómo ver el historial de versiones del panel

Para determinar qué cambios se realizaron en un panel, puedes consultar el historial de versiones, en el que se indica el usuario que realizó un cambio y la cantidad de cambios que se realizaron. También puedes revertir a una versión anterior del panel o comparar una versión anterior con la actual viendo la diferencia. Las revisiones de un panel existente se conservan durante 90 días, pero la revisión más reciente se conserva de forma indefinida.

Para ver el historial de versiones de 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 Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.

  3. En la barra de herramientas del panel, ve a Configuración y, luego, selecciona Ver historial de versiones. Se abrirá el panel del historial de versiones.

  4. Opcional: Para restablecer una versión anterior de un panel, selecciona una versión de la lista y haz clic en el botón Revertir. El panel se vuelve a cargar y muestra la versión anterior.

Cómo modificar un panel

Después de crear un panel, es posible que determines que necesita modificaciones para que te resulte más útil. Por ejemplo, es posible que desees agregar o quitar widgets, cambiar el diseño o modificar la forma en que un widget muestra los datos. Además, es posible que quieras agregar etiquetas a un panel para que sea más fácil de encontrar o para indicar el tipo de contenido que incluye.

Cómo agregar o quitar etiquetas

Las etiquetas pueden ayudarte a ubicar los paneles según el tipo de contenido que muestran. Por ejemplo, puedes agregar la etiqueta prod a los paneles que muestran información sobre los sistemas de producción. Del mismo modo, puedes agregar la etiqueta staging para indicar que el panel muestra información sobre los sistemas de producción. Luego, cuando enumeres tus paneles, podrás seleccionar una etiqueta para filtrar la lista y mostrar solo los paneles que contengan la etiqueta seleccionada.

Para agregar o quitar etiquetas definidas por el usuario en 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 Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
  3. En la lista de paneles, ubica el panel y, luego, haz clic en Agregar etiquetas al panel.
  4. Realiza una de las siguientes acciones:

    • Para crear una etiqueta y agregarla a tu panel, en la sección Crear una etiqueta nueva, ingresa el nombre de la etiqueta en el cuadro de texto y, luego, haz clic en Crear y aplicar.

    • Para configurar qué etiquetas se agregan a tu panel, haz clic en Seleccionar etiquetas para aplicar, selecciona las etiquetas y, luego, haz clic en Aceptar.
  5. Para guardar los cambios, haz clic en Confirmar.

Para enumerar, editar y borrar tus etiquetas, haz clic en Administrar etiquetas.

Cómo agregar o quitar filtros y variables

Después de crear un panel, puedes agregar filtros y variables. Los filtros se aplican a todos los widgets de un panel. Las variables se aplican a algunos widgets del panel. Los filtros y las variables pueden ser útiles cuando solucionas problemas. Por ejemplo, puedes usar un filtro para que el panel muestre datos solo para una zona específica.

  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 Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.

  3. Ubica y selecciona el panel.

    • Para agregar un filtro a nivel del panel que se aplique solo a tu sesión actual, usa la barra de filtros del panel. Para obtener más información, consulta Filtros temporales.

    • Para agregar un filtro permanente para todo el panel, en la barra de herramientas del panel, ve a Configuración y, luego, selecciona Administrar filtros. Para obtener más información, consulta Crea y administra variables y filtros fijados.

Modificar widgets o cambiar el diseño

Para modificar los widgets de un panel o su diseño, haz cualquiera de las siguientes acciones:

  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 Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
  3. Ubica y selecciona el panel.

  4. Opcional: Para agregar un widget a tu panel, en la barra de herramientas del panel, haz clic en  Agregar widget y, luego, selecciona y configura el widget. Para aplicar los cambios en el panel, en la barra de herramientas, haz clic en Aplicar. Para descartar los cambios, haz clic en Cancelar.

    Si deseas obtener más información, consulta las siguientes páginas:

  5. Opcional: Para modificar un widget, realiza una de las siguientes acciones:

    • Coloca el puntero sobre el widget para activar la barra de herramientas, haz clic en  Editar widget y, luego, actualiza el widget. Para aplicar los cambios en el panel, en la barra de herramientas, haz clic en Aplicar. Para descartar los cambios, haz clic en Cancelar.

      Puedes cambiar la mayoría de los parámetros de configuración del widget, incluido el tipo de widget. Por ejemplo, para cambiar un gráfico de líneas a un gráfico de áreas apiladas, haz clic en Gráfico de líneas y selecciona Gráfico de áreas apiladas en el menú. Para obtener más información, consulta Cómo cambiar el tipo de un widget.

    • Haz clic en Configuración, luego en JSON y, por último, en Editor de JSON. Si modificas el JSON, debes hacer clic en Aplicar cambios.

      También puedes acceder al código JSON de un widget editándolo en la barra de herramientas de widgets y, luego, haciendo clic en  Ver código.

  6. Opcional: Para borrar un widget, coloca el puntero sobre él para activar la barra de herramientas y, luego, realiza una de las siguientes acciones:

    • Si la barra de herramientas del widget muestra un botón Borrar , haz clic en él.
    • De lo contrario, haz clic en Más opciones y, luego, selecciona Borrar widget.

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

  7. Opcional: Para cambiar la posición de un widget, usa el puntero para arrastrar el widget por su encabezado a una ubicación nueva. Para aplicar los cambios en el panel, en la barra de herramientas, haz clic en Aplicar. Para descartar los cambios, haz clic en Cancelar.

    No puedes cambiar la posición de los widgets cuando un panel está en modo de cuadrícula.

  8. Opcional: Para cambiar el tamaño de un widget, usa el puntero para cambiar la posición de la esquina derecha del widget. Para aplicar los cambios en el panel, en la barra de herramientas, haz clic en Aplicar. Para descartar los cambios, haz clic en Cancelar.

    No puedes cambiar el tamaño de los widgets cuando un panel está en modo de cuadrícula.

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

Cómo borrar un panel

Borrar un panel que contiene un gráfico para una política de alertas no elimina las políticas de alertas cuyos datos se mostraban en esos gráficos. Por lo tanto, es posible que recibas notificaciones de esas políticas después de que se borre el panel. Para obtener información sobre cómo administrar tus políticas, lo que haces desde la página Alertas en la consola de Google Cloud , consulta Administra las políticas de alertas.

Si deseas crear un panel personalizado, 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 Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
  3. Para comenzar la acción de borrado, busca el panel que deseas borrar y haz clic en Borrar.
  4. En el diálogo de confirmación, haz clic en Borrar.
  5. Para guardar el panel modificado, haz clic en Guardar en la barra de herramientas.

Cómo guardar un panel como plantilla en un sistema local

Es posible que hayas creado un panel personalizado que otros miembros de tu equipo u organización quieran instalar en sus proyectos. Cuando quieras compartir una plantilla de panel, guárdala en tu sistema local y, luego, muévela o cópiala a una ubicación compartida. Por ejemplo, puedes copiar la plantilla en una unidad compartida o en un repositorio de código fuente, como GitHub. Cualquier persona con acceso a la ubicación almacenada puede instalar el panel en sus proyectos de Google Cloud .

Para guardar una plantilla de un panel personalizado en un archivo con formato JSON que se almacena en tu sistema local, 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 Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
  3. En la barra de herramientas del panel, haz clic en Configuración, luego en JSON y, por último, en Editor de JSON.

  4. Haz clic en Descarga de archivos:

    El archivo creado, que tiene el mismo nombre que el panel, contiene una representación JSON del panel. Este archivo es solo una plantilla; no almacena datos de series temporales.

Cómo compartir un panel

Cuando investigas una anomalía en los datos, es posible que quieras que otra persona de tu equipo o de tu organización vea los mismos datos que tú. Por ejemplo, es posible que veas una disminución o un aumento inesperado en una métrica de rendimiento y quieras consultar a un compañero de equipo. En esta situación, quieres que tu compañero de equipo vea el panel y sus datos.

Para obtener información sobre cómo compartir un vínculo a un panel, consulta Comparte un panel personalizado.

Configura la actualización de datos

Cuando abres un panel, este se configura con la actualización automática inhabilitada. La barra de herramientas muestra un botón de activación, , que indica este estado.

Para habilitar la actualización automática en tu sesión actual, ve a la barra de herramientas y selecciona Habilitar actualización automática.

Para inhabilitar la actualización automática después de habilitarla, ve a la barra de herramientas y selecciona Inhabilitar la actualización automática.

Habilita el guardado automático de los cambios de configuración

De forma predeterminada, los paneles no guardan tus cambios. Para habilitar el guardado automático, haz clic en el botón de activación Guardado automático hasta que esté en la posición Activado. Cuando se muestre Cloud listo, se habrán guardado los cambios.

¿Qué sigue?