Instala una plantilla de panel

Cloud Monitoring proporciona un conjunto seleccionado de plantillas de panel en GitHub que son específicas para una variedad de Google Cloud servicios, como Compute Engine, Cloud Storage, BigQuery y otros. Los gráficos de estos paneles presentan una selección de métricas relevantes para un servicio específico. Puedes instalar estas plantillas en tu proyecto de Google Cloud como paneles personalizados con la API de Cloud Monitoring o la consola de Google Cloud.

En esta página, se describe cómo instalar una plantilla que está disponible en la consola de Google Cloud o que se almacena en el repositorio monitoring-dashboard-samples de GitHub. Cada plantilla se almacena como un archivo JSON. En esta página, también se describe cómo ver el panel en la consola de Google Cloud.

Esta función solo es compatible con los proyectos de Google Cloud.

Instala una plantilla de panel

Nota: Algunas de las plantillas de paneles almacenadas en el repositorio monitoring-dashboard-samples de GitHub muestran datos de métricas personalizadas. Para instalar estos paneles de forma correcta, debes crear las métricas definidas por el usuario necesarias. Para obtener más información, consulta la documentación por servicio en el repositorio.

Consola de Google Cloud

Para instalar una plantilla de panel con la consola 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. Realiza una de las siguientes acciones:

   • Para instalar una plantilla de la biblioteca disponible en la consola de Google Cloud, haz lo siguiente:

     1. Haz clic en Plantillas de panel.
     2. Busca el panel que deseas instalar.
     3. Opcional: Para obtener una vista previa del panel, selecciónalo.

     4. Haz clic en Agregar panel a tu lista y completa el diálogo.

        El diálogo te permite seleccionar el nombre del panel y agregar etiquetas a él.

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

     1. Opcional: Para instalar una plantilla de panel seleccionada, descarga el repositorio de GitHub:

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

     2. Haz clic en Create Dashboard.

     3. En la barra de herramientas del panel, Configuración, luego, JSON y, luego, selecciona Editor de JSON.

        En un panel nuevo, el código que se muestra es similar al siguiente:

        {
        "displayName": "New Dashboard",
        "mosaicLayout": {
           "columns": 12,
           "tiles": []
        },
        "dashboardFilters": [],
        "labels": {}
        }
        

     4. En la barra de herramientas del editor, haz clic en Subir archivo.

     5. Selecciona el archivo que contiene la plantilla 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: el campo mosaicLayout.tiles[0] tiene un valor no válido", selecciona Cuadrícula en la barra de herramientas del panel.

     6. Opcional: Personaliza el panel. Por ejemplo, puedes actualizar el título, agregar un widget de texto que indique la fuente del panel, borrar gráficos no deseados o agregar gráficos.

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

gcloud CLI

Para instalar una definición de panel con Google Cloud CLI, haz lo siguiente:

1. Asegúrate de que tu sistema local pueda acceder a la definición del panel.

   Para los paneles almacenados en el repositorio de GitHub, puedes guardar paneles específicos o descargar todo el repositorio:

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

2. Identifica los paneles que deseas instalar.

   Por ejemplo, en el repositorio de GitHub, el directorio monitoring-dashboard-samples/dashboards/compute contiene un archivo llamado gce-vm-instance-monitoring.json.

3. Ejecuta el comando gcloud monitoring dashboards create y proporciona la representación JSON del panel.

   Por ejemplo, para instalar el panel gce-vm-instance-monitoring.json, emite el siguiente comando:

   gcloud monitoring dashboards create --config-from-file=gce-vm-instance-monitoring.json --project=PROJECT_ID
   

   Antes de ejecutar el comando anterior, reemplaza lo siguiente:

   • PROJECT_ID: Es el identificador del proyecto.

API de Cloud Monitoring

Para instalar una definición de panel con Google Cloud CLI, haz lo siguiente:

1. Asegúrate de que tu sistema local pueda acceder a la definición del panel.

   Para los paneles almacenados en el repositorio de GitHub, puedes guardar paneles específicos o descargar todo el repositorio:

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

2. Identifica los paneles que deseas instalar.

   Por ejemplo, en el repositorio de GitHub, el directorio monitoring-dashboard-samples/dashboards/compute contiene un archivo llamado gce-vm-instance-monitoring.json.

3. Llama a dashboards.create y proporciona la representación JSON del panel. En la llamada a la API, el elemento superior es el proyecto en el que se creará el monitor sintético. Este campo tiene el siguiente formato:

   projects/PROJECT_ID
   

Para obtener más información, consulta Crea y administra paneles.

Cómo ver el panel instalado

Cada archivo en el repositorio crea un nuevo panel personalizado. Por ejemplo, el archivo gce-vm-instance-monitoring.json crea un panel con el título “Supervisión de instancias de VM de GCE”. Para ver este 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, haz clic en “Supervisión de instancias de VM en GCE”. Si tienes muchos paneles, es posible que quieras filtrar los paneles personalizados o el nombre del nuevo panel.

En la siguiente captura de pantalla, se muestra la parte del panel instalado:

Cómo agregar o quitar etiquetas definidas por el usuario

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.

Solo puedes agregar etiquetas a los paneles personalizados. Cuando un panel muestra el botón Agregar etiquetas al panel, puedes configurar qué etiquetas se aplican al panel.

Para agregar o quitar etiquetas definidas por el usuario a 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 lista de paneles, busca el panel y, luego, haz clic en Agregar etiquetas al panel.
3. 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.
4. Para guardar los cambios, haz clic en Confirmar.