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 consola de Google Cloud, 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 es compatible con los proyectos de Google Cloud.

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 de varios proyectos de Google Cloud.

Un panel personalizado puede mostrar lo siguiente:

Puedes mejorar el tiempo de carga o la usabilidad de un panel si agrupas los widgets. Por ejemplo, puedes agregar secciones a un panel. Como alternativa, puedes agregar widgets a un contenedor que esté expandido o colapsado.

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

  • Los filtros del panel se aplican a todos los widgets del panel. Estos filtros pueden ser útiles cuando intentas solucionar 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 su visibilidad. Para obtener más información, consulta Cómo crear y administrar variables y filtros fijos.

  • 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 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. De manera similar, puedes agregar la etiqueta staging para indicar que el panel muestra información sobre los sistemas de etapa.

Antes de comenzar

Completa lo siguiente en el proyecto de 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 de 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 de Google Cloud y quieres 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. A continuación, puedes instalar esa plantilla en otros proyectos de Google 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 de Google Cloud.
  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 cómo deseas 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 Á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 a tu 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, busca 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 diferentes opciones de agregación, puedes copiar un panel y, luego, usar el nuevo panel con 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 de Google Cloud.
  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.

Cómo copiar un panel en otro proyecto

Para copiar un panel de un proyecto a otro, tu rol de IAM para los proyectos de Google Cloud de destino 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 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. Copia el JSON del panel en el portapapeles:

    1. En la barra de herramientas del panel, haz clic en Configuración, luego en JSON y, luego, en Editor de JSON.
    2. En la barra de herramientas del editor, haz clic en Copiar.
  4. Pega el JSON en el portapapeles en un panel nuevo creado en otro proyecto:

    1. Usa el selector de proyectos de la consola de Google Cloud 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, finalmente, 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.

Instala una plantilla de panel

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

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

Para obtener más información, consulta Cómo instalar 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 crea Cloud Monitoring 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 de Google Cloud.

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

  3. Para encontrar un panel, haz lo siguiente:

    • Usa las opciones Recientes y Favoritos para restringir los paneles que se muestran.

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

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

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

    • Agrega filtros a la barra Filtro de :

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

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

        1. Selecciona Buscar en tus paneles y, luego, selecciona un campo por el que deseas 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 elige una opción del menú.

      • Para ver una lista de los paneles que no tienen gráficos, selecciona Buscar tus paneles, Etiquetas y, luego, (Vacío).

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

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

Modifica 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 cambiar la forma en que un widget muestra los datos. Además, te recomendamos que agregues etiquetas a un panel para que sea más fácil encontrarlo o indicar el tipo de contenido que contiene.

Agrega o quita etiquetas

Las etiquetas pueden ayudarte a encontrar 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. De manera similar, puedes agregar la etiqueta staging para indicar que el panel muestra información sobre los sistemas de etapa. A continuación, cuando crees una lista de tus paneles, podrás seleccionar una etiqueta para filtrar la lista y mostrar solo aquellos paneles que contengan la etiqueta seleccionada.

Para agregar o quitar etiquetas definidas por el usuario 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. En la lista de paneles, busca 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 ver, 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 de 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 de Google Cloud.
  3. Busca y selecciona el panel.

    • Para agregar un filtro en todo el 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 en 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 Cómo crear y administrar variables y filtros fijos.

Modificar widgets o cambiar el diseño

Para modificar los widgets de un panel o su diseño, 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. Busca 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, haz lo siguiente:

    • Coloca el puntero sobre el widget para activar la barra de herramientas, haz clic en  Editar widget y, luego, actualízalo. 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. 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 Cambia el tipo de un widget.

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

      También puedes acceder al JSON de un widget. Para ello, debes editarlo en la barra de herramientas de widgets y, luego, hacer clic en  Ver código.

  6. Opcional: Para borrar un widget, coloca el puntero sobre él para activar la barra de herramientas y, luego, haz 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 de una política de alertas no borra 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, que puedes hacer desde la página Alertas en la consola de Google Cloud, consulta Administra 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 de Google Cloud.
  3. Para comenzar la acción de eliminación, 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 otras personas de tu equipo o 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 un disco compartido 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 de Google Cloud.
  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 investigues una anomalía de 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 inesperados en una métrica de rendimiento y quieras consultar con un compañero de equipo. En esta situación, deseas 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 Cómo compartir un panel personalizado.

Cómo configurar 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 Enable auto refresh.

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

Cómo habilitar el guardado automático de los cambios de configuración

De forma predeterminada, los paneles no guardan los 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 muestra Cloud listo, se guardan los cambios.

¿Qué sigue?