Administrar paneles personalizados

Los paneles personalizados son paneles que usted crea. Estos paneles te permiten mostrar la información que te interesa, organizada de una manera que te resulte útil. Para crear paneles personalizados, puedes usar Google Cloud Console o la API de Cloud Monitoring.

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. A diferencia de los paneles específicos de servicios, puedes hacer lo siguiente con los paneles personalizados:

  • Gráfico de métricas y entradas de registro de varios proyectos de Google Cloud.
  • Gráfico de métricas de varios servicios.
  • Muestra las políticas de alertas.

También puede copiar, modificar y compartir paneles personalizados.

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

De forma predeterminada, los paneles actualizan su pantalla de forma automática cuando hay datos nuevos disponibles y guardan automáticamente los cambios de configuración. Para obtener información sobre cómo cambiar esta configuración, consulta Inhabilita la actualización de datos y Inhabilita el guardado automático de cambios de configuración.

Antes de comenzar

Para ver un panel, la función de administración de identidades y accesos (IAM) en el proyecto de permisos de un alcance de métricas debe incluir el permiso de visualizador.

Si quieres crear o editar un panel, la función de IAM para el proyecto de permisos de un alcance de métricas debe incluir el permiso de editor.

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

Creación de un panel personalizado

  1. En Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles.
  3. En la página Descripción general de los paneles, haz clic en Crear panel.
  4. Para cada widget que desees agregar al panel, haz lo siguiente:

    1. Selecciona un widget de la Biblioteca de gráficos o arrastra uno desde la biblioteca hasta el á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:

      Ejemplo de un gráfico de líneas

    2. Para cambiar las series temporales que muestra el widget, selecciona la configuración de tipo que desees hacer y, luego, completa el formulario. Por ejemplo, para minimizar la cantidad de campos que debes completar, selecciona la pestaña Básica y, luego, usa los menús de esa pestaña a fin de configurar el widget. Para obtener más información sobre tus opciones, consulta Cómo agregar widgets al panel.

Ver un panel personalizado

  1. En Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles.
  3. Selecciona el nombre del panel. Puedes restringir la lista solo a los paneles personalizados si agregas el filtro Tipo: Personalizado.
  4. Si se muestra el botón Cerrar editor, haz clic en él.
  5. Opcional: Agrega o modifica los filtros del panel para cambiar temporalmente las series temporales que muestran los widgets del panel. Para obtener más información, consulta Filtra un panel.

  6. Opcional: Cambia el período de visualización de todos los widgets en el panel. De forma predeterminada, el selector de hora está configurado en una hora. Para los paneles que muestran datos dispersos, como las métricas de cuota, establece el selector de intervalo de tiempo en al menos una semana.

  7. Opcional: Cambia la configuración de cada widget de un panel mediante 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:

  1. En Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, selecciona el panel que deseas ver o editar.
  3. Si se muestra el botón Editar panel, haz clic en él.
  4. Para modificar el panel, realiza 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, selecciona ese widget 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 . Cuando completes 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:

      Ilustra el botón para expandir en el editor de JSON.

    • 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 Cómo cambiar un tipo de widget.

    • Para borrar un widget, haz clic en Borrar en la barra de herramientas del widget.

    • Para cambiar el tamaño o cambiar la posición de un widget, usa el puntero. Estas opciones se inhabilitan 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 Grid y Mosaic. Cuando seleccionas Grid, 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 tus políticas, desde la página Alertas en la consola, consulta Administra políticas.

Si deseas crear un panel personalizado, haz lo siguiente:

  1. En Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles.
  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, haga clic en Borrar.

Duplica 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:

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

Cómo copiar 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. A fin de copiar un panel, 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 de panel a otro proyecto de Cloud, haz lo siguiente:

  1. En Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, selecciona el panel que deseas ver o editar.
  3. 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.
  4. Pega la definición en un panel nuevo creado en otro proyecto:

    1. Usa el selector de proyectos de la consola a fin de 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 quieras compartir un panel que hayas creado con otros proyectos de Google Cloud o con otras personas, puedes guardar la definición del panel en tu sistema local. Este archivo se puede compartir y, luego, instalar en otros 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:

  1. En Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, selecciona el panel que deseas ver o editar.
  3. Si se muestra el botón Editar panel, haz clic en él.
  4. En la barra de herramientas del panel, haz clic en Editor de JSON para abrir el editor de JSON.
  5. 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.

Instale un panel personalizado compartido

Para usar o personalizar un panel que creó otra persona, instala la definición de ese panel en tu proyecto de Cloud. 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. 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 la CLI de Google Cloud, consulta Instala paneles de muestra.

Para instalar una definición de panel mediante la consola, haz lo siguiente:

  1. En Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring

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

        Pantalla de la pestaña de la biblioteca de muestra seleccionada.

      2. Selecciona los paneles que deseas instalar.

      3. Para obtener detalles sobre un panel o para obtener una vista previa de su contenido, haz clic en Preview (opcional).

      4. Para ver la representación JSON de un panel, haz clic en Vista previa (Preview) y, luego, en JSON (opcional).

      5. Haz clic en Importar.

    • Para instalar un panel mediante la carga de un archivo JSON, haz lo siguiente:

      1. Para instalar una definición de panel seleccionado, descarga el repositorio de GitHub (opcional):

        git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples.git

        Nota: Algunas de las definiciones de los paneles almacenados 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 "No se puede guardar el panel": TileLayout.tiles[0] tiene un valor no válido. Luego, selecciona Cuadrícula 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 gráficos no deseados o agregar gráficos.

Inhabilitar actualización de datos

Cuando veas una anomalía de datos que se muestra en 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 datos nuevos disponibles.

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

Para habilitar la actualización automática del panel, haz clic en el botón de activación de actualización automática hasta que aparezca 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 realiza. Sin embargo, cuando quieras experimentar o editar la representación de JSON para configurar un panel, te recomendamos usar un proceso manual a fin de guardar los cambios.

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

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

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

¿Qué sigue?