Se usó la API de Cloud Translation para traducir esta página.

Administra paneles personalizados

En este documento, se describe cómo crear y administrar paneles personalizados mediante Google Cloud Console. Los paneles personalizados te permiten mostrar información que te interesa y que se organiza de una forma que te resulta útil. Por ejemplo, puedes crear un panel para mostrar los registros, las métricas de rendimiento y las políticas de alertas para 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 personalizados, puedes usar Google Cloud Console, la API de Cloud Monitoring o Google Cloud CLI.

Los paneles personalizados admiten una variedad de tipos de widgets, por lo que puedes elegir la mejor manera de mostrar tus datos de métricas. Estos paneles también te permiten mostrar datos de métricas de varios proyectos de Google Cloud y métricas de varios servicios de Google Cloud. Además de las métricas, los paneles personalizados pueden mostrar entradas de registro de varios proyectos de Google Cloud y políticas de alertas, y puedes crear variables de plantilla para filtrar el panel.

En este documento, se describe cómo crear y administrar tus paneles personalizados mediante Google Cloud Console:

Para obtener información sobre cómo administrar paneles personalizados mediante la API y Google Cloud CLI, consulta Administra paneles mediante la API.
Para obtener información sobre los paneles de Google Cloud específicos del servicio, consulta Visualiza los paneles de Google Cloud.

Antes de comenzar

Asegúrate de que la función de Identity and Access Management incluya los permisos necesarios:

A fin de obtener los permisos que necesitas para ver los paneles, solicita al administrador que te otorgue la función de visualizador de Monitoring (roles/monitoring.viewer).
A fin de obtener los permisos que necesitas para crear y editar paneles, y editar paneles, solicita a tu administrador que te otorgue la función de editor de Monitoring (roles/monitoring.editor).

Para obtener más información sobre las funciones, consulta Control de acceso.

Creación de un panel personalizado

En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
Ir a Monitoring
En el panel de navegación, selecciona Paneles.
En la página Descripción general de los paneles, haz clic en Crear panel.
Para cada widget que deseas agregar al panel, haz lo siguiente:
1. Selecciona un widget de la Biblioteca de gráficos o arrastra uno de la biblioteca al área del gráfico.
  
  Se muestra un widget preconfigurado del tipo seleccionado. En el siguiente ejemplo, se ilustra un gráfico de líneas y su panel de configuración:
2. Para cambiar las series temporales que muestra el widget, selecciona el tipo de configuración que desees realizar y, luego, completa el formulario. Por ejemplo, para minimizar la cantidad de campos que necesitas completar, selecciona la pestaña Basic y, luego, usa los menús de esa pestaña a fin de configurar el widget. Para obtener información sobre las opciones que elegiste, consulta Agrega widgets de panel.

Ver un panel personalizado

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 personalizado, haz lo siguiente:

En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
Ir a Monitoring
En el panel de navegación, selecciona Paneles.
Selecciona el nombre del panel. Puedes restringir la lista solo a los paneles personalizados si agregas el filtro Tipo: Personalizado.
Si se muestra el botón Cerrar editor, haz clic en él.
Opcional: Agrega o modifica los filtros del panel para cambiar de forma temporal la serie temporal que muestran los widgets del panel. Para obtener más información, consulta Filtra un panel.
Opcional: Cambia el período de visualización de todos los widgets en el panel. De forma predeterminada, el selector de intervalo de tiempo está configurado en una hora.

Para cambiar el intervalo de tiempo que se muestra, usa el selector de intervalo de tiempo. Por ejemplo, si quieres ver los datos de la semana pasada, selecciona Última semana en el selector de rango de tiempo. También puedes especificar una hora de inicio y una de finalización, o bien una hora de visualización.

En el caso de los paneles que muestran datos dispersos, como las métricas de cuotas, establece el selector de intervalo de tiempo en, al menos, una semana.
Opcional: Para cambiar la configuración de cada widget de un panel, usa las opciones de Configuración del panel. Estas opciones te permiten, por ejemplo, ocultar o mostrar leyendas.

Cómo modificar un panel personalizado

Modifica un panel cuando desees agregar o quitar widgets, cambiar el diseño de los widgets del panel, cambiar el tipo de widget o cambiar las series temporales que muestra un widget.

Para modificar un panel personalizado, haz lo siguiente:

En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
Ir a Monitoring
En el panel de navegación, selecciona Paneles y, luego, selecciona el panel que deseas ver o editar.
Si se muestra el botón Editar panel, haz clic en él.
Para modificar el panel, realice una de las siguientes acciones:
- Para agregar un widget, haz clic en Agregar gráfico, selecciona el widget que quieres agregar y completa el cuadro de diálogo. Para obtener más información, consulta Cómo agregar widgets al panel.
- Para modificar las series temporales que muestra un widget existente, selecciónalo y, luego, realiza los cambios mediante el panel de configuración del widget. Para obtener información sobre cómo configurar un widget, consulta Cómo agregar widgets al panel.
- Para modificar un widget o el panel mediante la edición de la representación JSON, haz clic en Editor de JSON. Una vez que se completen los cambios, haz clic en Aplicar cambios en la barra de herramientas del editor.
  
  Cuando abres el editor de JSON después de seleccionar un widget, este solo expande la representación de ese widget. Para ver toda la definición del panel, en el editor de JSON, selecciona Mostrar más:
- Para cambiar el tipo de widget, haz clic en el nombre del widget actual y luego selecciona una opción del menú. 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 widget.
- Para borrar un widget, haz clic en Borrar en la barra de herramientas del widget.
- Para cambiar el tamaño o la posición de un widget, usa el puntero. Estas opciones están inhabilitadas cuando un panel está en modo de cuadrícula.
- Para cambiar el diseño de los widgets en el panel, usa el botón de activación Cuadrícula y Mosaic. Cuando seleccionas Cuadrícula, todos los widgets tienen las mismas dimensiones.

Borrado de un panel personalizado

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. Para obtener información sobre cómo administrar las políticas, lo que se hace desde la página Alertas en Google Cloud Console, consulta Administra políticas.

Si deseas crear un panel personalizado, haz lo siguiente:

En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
Ir a Monitoring
En el panel de navegación, selecciona Paneles.
Para comenzar la acción de borrado, busca el panel que deseas borrar y haz clic en Borrar.
En el diálogo de confirmación, haga clic en Borrar.

Duplicar un panel personalizado dentro del mismo proyecto

Cuando quieras experimentar con diferentes métricas o con diferentes opciones de agregación, una opción es duplicar un panel y usar la copia para fines de experimentación.

Para duplicar un panel, haz lo siguiente:

En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
Ir a Monitoring
En el panel de navegación, selecciona Paneles.
En la página Descripción general de los paneles, identifica el panel que deseas copiar y, luego, haz clic en Copiar.
Haz clic en Copiar en el cuadro de diálogo de confirmación.

Copia un panel personalizado en otro proyecto

Cuando tienes varios proyectos de Cloud y quieres que tengan el mismo panel personalizado, puedes crear el panel en un proyecto y, luego, copiarlo en otros. La copia tiene el mismo diseño y las mismas propiedades que el panel de origen. Sin embargo, los datos que se muestran son diferentes.

A fin de copiar un panel de un proyecto a otro, la función de IAM para los proyectos de Cloud de destino debe incluir el permiso de editor de Monitoring. Para obtener más información sobre las funciones, consulta Control de acceso.

Para copiar una definición del panel en otro proyecto de Cloud, haz lo siguiente:

En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
Ir a Monitoring
En el panel de navegación, selecciona Paneles y, luego, selecciona el panel que deseas ver o editar.
Copia la definición del panel en el portapapeles:
1. Si se muestra el botón Editar panel, haz clic en él.
2. En la barra de herramientas del panel, haz clic en Editor de JSON para abrir el editor de JSON.
3. En la barra de herramientas del editor, haz clic en Copiar.
Pega la definición en un panel nuevo creado en otro proyecto:
1. Usa el selector de proyectos de Google Cloud Console para seleccionar el proyecto en el que deseas guardar la definición del panel.
2. Haz clic en Crear panel de control.
3. En la barra de herramientas del panel, haz clic en Editor de JSON para abrir el editor de JSON.
4. Pega el contenido del portapapeles en el editor.
5. Haz clic en Aplicar cambios.

Cómo compartir un panel personalizado

Cuando investigas una anomalía de datos, es posible que desees que otra persona de tu equipo o de tu organización vea un panel personalizado. Por ejemplo, es posible que veas una disminución o un aumento esperado en una métrica de rendimiento y que 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 sobre cómo otorgar otro permiso individual para ver un panel de control en tu proyecto de Google Cloud, consulta Otorga acceso a Cloud Monitoring.

Como alternativa, es posible que hayas creado un panel personalizado que otras personas de tu equipo o de tu organización deseen instalar en sus proyectos. Cuando quieras 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 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:

En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
Ir a Monitoring
En el panel de navegación, selecciona Paneles y, luego, selecciona el panel que deseas ver o editar.
Si se muestra el botón Editar panel, haz clic en él.
En la barra de herramientas del panel, haz clic en Editor de JSON para abrir el editor de JSON.
Para guardar la definición del panel en un sistema local, haz clic en Descargar archivo:

El archivo creado, que lleva el nombre del panel, contiene una representación JSON del panel. Este archivo solo almacena la definición del panel, no almacena datos de series temporales.

Instala una definición de panel personalizada

Para usar o personalizar un panel creado por otra persona, instala la definición de ese panel en el proyecto de Cloud. Cloud Monitoring, por ejemplo, proporciona un conjunto seleccionado de definiciones de panel en GitHub que son específicos para varios servicios de Google Cloud. En los gráficos de estos paneles, se presenta una selección de métricas relevantes para un servicio específico. Puedes instalar estas definiciones en tu proyecto de Cloud como paneles personalizados y, luego, modificarlas para que muestren los datos que deseas ver.

Para obtener información sobre cómo instalar un panel mediante la API de Cloud Monitoring o Google Cloud CLI, consulta Instala paneles de muestra.

Para instalar una definición de panel mediante Google Cloud Console, haz lo siguiente:

En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
Ir a Monitoring
En el panel de navegación, selecciona Paneles y, luego, realiza una de las siguientes acciones:
- Para instalar un panel desde la biblioteca de muestra, haz lo siguiente:
  1. Haz clic en la pestaña Biblioteca de muestra.
  2. Selecciona los paneles que deseas instalar.
  3. Para ver los detalles sobre un panel o para obtener una vista previa de su contenido, haz clic en Vista previa (opcional).
  4. Opcional: Para ver la representación JSON de un panel, haz clic en Vista previa y, luego, en JSON.
  5. Haz clic en Importar.
- Para instalar un panel mediante la carga de un archivo JSON, haz lo siguiente:
  1. (Opcional) Para instalar una definición de panel seleccionada, descarga el repositorio de GitHub:
```
git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples.git
```
    Nota: Algunas de las definiciones de paneles almacenadas en el repositorio de GitHub muestran datos de métricas personalizadas. Para instalar estos paneles de forma correcta, debes crear las métricas personalizadas necesarias. Para obtener más información, consulta la documentación por servicio en el repositorio.
  2. Haz clic en Crear panel de control.
  3. En la barra de herramientas del panel, haz clic en Editor de JSON.
    
    En un panel nuevo, el código que se muestra es similar al siguiente:
```
{
  "category": "CUSTOM",
  "displayName": "New Dashboard",
  "mosaicLayout": {
    "columns": 12
  },
}
```
  4. En la barra de herramientas del editor, haz clic en Subir archivo.
  5. Selecciona el archivo que contiene la definición del panel y, luego, haz clic en Abrir.
    
    Después de subir el archivo, se actualiza el JSON del panel.
    
    Si ves el siguiente mensaje, “Unable to save dashboard: Field mosaicLayout.tiles[0] has an invalid value”, selecciona Grid en la barra de herramientas del panel.
  6. (Opcional) Personalice el panel. Por ejemplo, puedes actualizar el título, agregar un cuadro de texto que indique la fuente del panel, borrar los gráficos no deseados o agregar gráficos.

Inhabilitar actualización de datos

Cuando ves una anomalía de datos que muestra un gráfico, es posible que quieras conservar la vista actual mientras investigas la anomalía. De forma predeterminada, los paneles actualizan automáticamente la pantalla a medida que hay nuevos datos disponibles.

Para detener la actualización automática del panel, haz clic en el botón de activación de la actualización automática hasta que muestre Desactivado.

Para habilitar la actualización automática del panel, haz clic en el botón de activación de la actualización automática hasta que muestre Activado.

Inhabilitar el guardado automático de cambios de configuración

De forma predeterminada, los paneles están configurados para guardar los cambios a medida que los realizas. Sin embargo, cuando quieras experimentar o editar la representación JSON en un panel de control, deberás usar un proceso manual para guardar los cambios.

Para guardar de forma manual los cambios que realizas, haz lo siguiente:

Haga clic en el botón de activación Guardar de forma automática hasta que se muestre el botón Guardar.
Realice las modificaciones en el panel.
Para conservar los cambios, haz clic en Guardar.

Para habilitar el guardado automático de tus cambios de configuración, asegúrate de que el botón de activación Guardar de forma automática esté en la posición de activado. Cuando se muestra Cloud Done, se guardaron tus cambios.