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:

• Para obtener información sobre la API y Google Cloud CLI, consulta Crea y administra paneles con la API.
• Para obtener información sobre los paneles de Google Cloud específicos de cada servicio, consulta Cómo ver los paneles 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:

• Gráficos e indicadores.
• Entradas de registro de varios proyectos o vistas de registro de Google Cloud
• Gráficos para políticas de alertas.
• Incidentes.
• Objetivos de nivel de servicio (SLO)
• Texto:

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, eventos o etiquetas:

• Los filtros del panel se aplican a todos o algunos 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.

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

  Cuando veas tus paneles de control, puedes seleccionar una etiqueta para filtrar la lista y mostrar solo aquellos paneles que contengan la etiqueta seleccionada.

Antes de comenzar

Para 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 de editor de Monitoring (roles/monitoring.editor) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Para obtener más información sobre los roles, 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 quieres que definan el mismo panel personalizado. En esta situación, puedes crear el panel en un proyecto y, luego, copiar la definición del panel a otros proyectos. Como alternativa, puedes descargar la definición del panel en tu sistema local y, luego, instalar esa definición 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 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 add 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.

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

5. Opcional: Agrega etiquetas a tu panel:

   1. En la lista de paneles, busca el panel y, luego, haz clic en check_box_outline_blank 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.

        Se creará la etiqueta y se agregará a tu panel.

      • Para configurar qué etiquetas se agregan a tu panel, haz clic en arrow_drop_down 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 página Descripción general de los paneles, identifica el panel que deseas copiar y, luego, haz clic en content_copy 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

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. Copia la definición del panel en el portapapeles:

   1. En la barra de herramientas del panel, haz clic en settings Configuración, luego en JSON y, luego, en Editor de JSON.
   2. En la barra de herramientas del editor, haz clic en content_copyCopiar.

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 seleccionar 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 settings Configuración, en JSON y, luego, 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.

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. Por ejemplo, Cloud Monitoring proporciona un conjunto seleccionado de definiciones de paneles 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 relevantes para un servicio específico.

Después de subir una definición de panel, puedes modificarla para mostrar 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 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.

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

2. Para encontrar un panel, haz lo siguiente:

   • Selecciona una categoría. Por ejemplo, para ver una lista de los paneles que Google Cloud crea automáticamente según tu uso de los servicios de Google Cloud, selecciona G​C​P. Para definir mejor la lista, usa la barra Filtrar.

   • Selecciona una etiqueta 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 Filtrar.

   • Agrega filtros a la barra Filtro:

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

     • Para mostrar una lista de paneles después de filtrar por el valor del campo de panel, haz lo siguiente:

       1. Selecciona Filtrar paneles y, luego, selecciona 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 elige una opción del menú.

     • Para ver una lista de los paneles que no tienen gráficos, selecciona Filtrar 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.

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

Para agregar o quitar etiquetas, 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 lista de paneles, busca el panel y, luego, haz clic en check_box_outline_blank 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.

     Se creará la etiqueta y se agregará a tu panel.

   • Para configurar qué etiquetas se agregan a tu panel, haz clic en arrow_drop_down 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 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. 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 filter_list 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 settings 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. Busca y selecciona el panel.

3. Opcional: Para agregar un widget a tu panel, en la barra de herramientas del panel, haz clic en add 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:

   • Cómo agregar gráficos y tablas
   • Cómo mostrar políticas de alertas e incidentes
   • Cómo mostrar registros
   • Cómo mostrar SLO
   • Agrega texto y agrupaciones

4. Opcional: Para modificar un widget, haz lo siguiente:

   • Coloca el puntero sobre el widget para activar la barra de herramientas, haz clic en edit 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 arrow_drop_down 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 settings 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 code Ver código.

5. 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 delete Borrar, haz clic en él.
   • De lo contrario, haz clic en more_vert 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.

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

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

8. 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. Para comenzar la acción de eliminación, busca el panel que deseas borrar y haz clic en delete Borrar.
3. En el diálogo de confirmación, haz clic en Borrar.
4. Para guardar el panel modificado, haz clic en Guardar en la barra de herramientas.

Cómo guardar una definición de panel 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 definición 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 definición 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 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.

   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 del panel, haz clic en settings Configuración, luego, en JSON y, luego, en Editor de JSON.

3. Para guardar la definición del panel en un sistema local, haz clic en Descargar archivo:

   El archivo creado, que tiene el mismo nombre que el panel, contiene una representación JSON del panel. Este archivo solo almacena la definición del panel, 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, sync_disabled, que indica este estado.

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

Para inhabilitar la actualización automática después de habilitarla, ve a la barra de herramientas y selecciona sincronizar Inhabilitar 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_done Cloud listo, se guardan los cambios.

¿Qué sigue?

• Cómo agregar gráficos y tablas
• Explora los datos representados
• Configura un permiso de métricas para varios proyectos