Crea y administra paneles personalizados

En este documento, se describe cómo crear y administrar paneles personalizados mediante 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 el 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:

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, en los paneles se muestran todos los datos de métricas disponibles para tu proyecto de Google Cloud. Si configuras un permiso de métricas, el panel puede mostrar datos de métricas para varios proyectos de Google Cloud.

Un panel personalizado puede mostrar todo lo siguiente:

Para mejorar el tiempo de carga o la usabilidad de un panel, puedes agrupar widgets. Por ejemplo, puedes agregar secciones a un panel. Como alternativa, puedes agregar widgets a un contenedor que se expanda o se contraiga.

Después de crear un panel, puedes agregar filtros, eventos o etiquetas:

  • Los filtros de todo el panel se aplican a todos o algunos widgets del panel. Estos filtros pueden ser útiles para 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.

  • 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 Muestra 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. Del mismo modo, puedes agregar la etiqueta staging para indicar que el panel muestra información sobre los sistemas de etapa de pruebas.

    Cuando visualizas tus paneles, puedes seleccionar una etiqueta para filtrar la lista según los paneles que contienen la etiqueta seleccionada.

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.

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 deseas que definan el mismo panel personalizado. Para esta situación, puedes crear el panel en un proyecto y, luego, copiar la definición del panel en otros proyectos. Como alternativa, puedes descargar la definición del panel en tu sistema local y, luego, instalarla 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.

    Ir a Paneles

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

  2. En la página Paneles, haz clic en Crear panel personalizado.
  3. 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 quieras mostrar o cómo quieras hacerlo. En todos los casos, se abre un panel de configuración. Por ejemplo, puedes seleccionar el widget Métrica y, luego, configurar la visualización en Área apilada. También puedes seleccionar el widget Stacked area y, luego, seleccionar la métrica.

    3. Configura el widget.

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

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

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

  5. Opcional: Agrega etiquetas a tu panel:

    1. En la lista de paneles, ubica el panel y, luego, haz clic en Seleccionar.
    2. En la barra de herramientas, haz clic en Etiquetas y, luego, realiza una de las siguientes acciones:
      • Para crear una etiqueta y agregarla a tu panel, en el cuadro de texto Crear una etiqueta nueva, ingresa el nombre de la etiqueta y, luego, haz clic en Crear y aplicar.

        La etiqueta se crea y se agrega a tu panel.

      • 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 con diferentes opciones de agregación, puedes copiar un panel y, luego, usar el panel nuevo para fines de experimentación.

Para copiar un panel, haz lo siguiente:

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

    Ir a Paneles

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

  2. En la página Descripción general de los paneles, identifica el panel que deseas copiar y, luego, haz clic en Copiar panel.
  3. Opcional: Actualiza el nombre del panel.
  4. Haz clic en Copiar en el cuadro de diálogo de confirmación.

Cómo copiar un panel en otro proyecto

Si deseas copiar un panel de un proyecto a otro, tu función de IAM para los proyectos de destino de Google Cloud debe incluir el permiso de editor de Monitoring. Para obtener más información sobre las funciones, consulta Cómo controlar el acceso con Identity and Access Management.

Para copiar un panel en otro proyecto de Google Cloud, haz lo siguiente:

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

    Ir a Paneles

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

  2. Copia la definición 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.
  3. Pega la definición en un panel nuevo creado en otro proyecto:

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

Instalación de un panel

Puedes subir a tu proyecto de Google Cloud un panel personalizado cuya definición se almacena en una ubicación compartida. Cloud Monitoring, por ejemplo, proporciona un conjunto seleccionado de definiciones 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 definición de panel, puedes modificarla para que muestre los datos que deseas ver.

Para obtener más información, consulta Instala paneles de muestra.

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 buscar 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.

    Ir a Paneles

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

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

  2. Para encontrar un panel, realiza una de las siguientes acciones:

    • Usa la barra de filtros para buscar por el nombre completo o parcial del panel, o para filtrar por tipo de panel.

    • Selecciona una categoría. Para definir mejor la lista, usa la barra de filtros.

    • Selecciona la etiqueta para enumerar solo los paneles que la contienen. Para definir mejor la lista, usa la barra de filtros.

    Para reducir la cantidad de resultados enumerados, usa la barra de filtros. Cuando agregas varios filtros y no incluyes el operador OR entre dos filtros, un AND lógico une los filtros.

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

Cómo modificar un panel

Después de crear un panel, puedes determinar 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 la forma en que un widget muestra los datos. Además, es posible que desees agregar etiquetas a un panel, ya sea para que sea más fácil de encontrar o para indicar el tipo de contenido en el panel.

Cómo agregar o quitar etiquetas

Para agregar o quitar etiquetas, haz lo siguiente:

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

    Ir a Paneles

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

  2. En la lista de paneles, ubica el panel y, luego, haz clic en Seleccionar.
  3. En la barra de herramientas, haz clic en Etiquetas y, luego, realiza una de las siguientes acciones:
    • Para crear una etiqueta y agregarla a tu panel, en el cuadro de texto Crear una etiqueta nueva, ingresa el nombre de la etiqueta y, luego, haz clic en Crear y aplicar.

      La etiqueta se crea y se agrega a tu panel.

    • 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.
  4. Para guardar los cambios, haz clic en Confirmar.

Cómo agregar o quitar filtros

Después de crear un panel, puedes agregar filtros de todo el panel que se apliquen a todos o algunos widgets del panel. Estos filtros pueden ser útiles cuando estás solucionando problemas. Por ejemplo, puedes usar estos filtros para mostrar datos solo de una zona específica.

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

    Ir a Paneles

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

  2. Ubica y selecciona el panel.

    • Si deseas agregar un filtro para 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 a 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 Filtros permanentes.

Cómo modificar widgets o cambiar el diseño

Para modificar los widgets en un panel o el diseño del panel, realiza una de las siguientes acciones:

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

    Ir a Paneles

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

  2. Ubica y selecciona el panel.
  3. 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 al panel, en la barra de herramientas, haz clic en Apply. Para descartar los cambios, haz clic en Cancelar.

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

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

    • Coloca el puntero en el widget para activar la barra de herramientas, haz clic en  Editar widget y, luego, actualízalo. Para aplicar los cambios al panel, en la barra de herramientas, haz clic en Apply. Para descartar los cambios, haz clic en Cancelar.

      Puedes cambiar la mayoría de las opciones de configuración del widget, incluido su 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 Cómo cambiar el tipo de widget.

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

      También puedes acceder al JSON de un widget si lo editas en la barra de herramientas de widgets y, luego, haces clic en  Ver código.

  5. Opcional: Para borrar un widget, coloca el puntero en é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 ese botón.
    • De lo contrario, haz clic en Más opciones y, luego, selecciona Borrar widget.

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

  6. Opcional: Si quieres cambiar la posición de un widget, usa el puntero para arrastrarlo por su encabezado a una nueva ubicación. Para aplicar los cambios al panel, en la barra de herramientas, haz clic en Apply. 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.

  7. Opcional: Si quieres 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 al panel, en la barra de herramientas, haz clic en Apply. Para descartar los cambios, haz clic en Cancelar.

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

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

Cómo borrar un panel

Borrar un panel que contiene gráficos de alertas no elimina las políticas de alertas cuyos datos se mostraban en esos gráficos de alertas. Por lo tanto, es posible que recibas notificaciones de esas políticas después de que se borre el panel. Si quieres obtener información para administrar tus políticas, lo que puedes hacer en la página Alertas de 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.

    Ir a Paneles

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

  2. Para comenzar con la acción de borrar, busca el panel que deseas borrar y haz clic en Borrar.
  3. En el diálogo de confirmación, haz clic en Borrar.
  4. Para guardar el panel modificado, en la barra de herramientas, haz clic en Guardar.

Guardar una definición de panel en un sistema local

Es posible que hayas creado un panel personalizado que otros miembros de tu organización o equipo quieran instalar en sus proyectos. Cuando desees compartir una definición de panel, guárdala en tu sistema local y, luego, mueve o copia la definición a una ubicación compartida. Por ejemplo, puedes copiar la definición 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 la definición 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.

    Ir a Paneles

    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 del panel, haz clic en Configuración, JSON y, luego, Editor de JSON.
  3. Para guardar la definición del panel en un sistema local, haz clic en File Download:

    El archivo creado, que tiene el mismo nombre que el panel, contiene una representación JSON del panel. En este archivo, solo se almacena la definición del panel, no se almacenan datos de series temporales.

Cómo compartir un panel

Cuando investigas una anomalía de datos, es posible que desees 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 repentinos en una métrica de rendimiento y desees consultar con un compañero de equipo. En esta situación, quieres que tu compañero de equipo vea el panel y sus datos.

Si deseas obtener información para compartir un vínculo a un panel, consulta Comparte un panel personalizado.

Configura la actualización de datos

En la barra de herramientas del panel, se muestra un botón que indica si la actualización automática está habilitada, o inhabilitada (). Para cambiar el estado, haz clic en el botón.

Habilitar 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 Guardar automáticamente hasta que se encuentre en la posición Activado. Cuando se muestre Cloud Done, se guardarán los cambios.

¿Qué sigue?