Cómo instalar una plantilla de panel

Cloud Monitoring proporciona un conjunto seleccionado de plantillas de paneles 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 pertinentes para un servicio específico. Puedes instalar estas plantillas en tu Google Cloud proyecto como paneles personalizados con la API de Cloud Monitoring o con la Google Cloud consola.

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

Esta función solo es compatible con Google Cloud proyectos. Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.

Instala una plantilla de panel

Google Cloud Consola de Cloud

Para instalar una plantilla de panel con la Google Cloud consola, haz lo siguiente:

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

    Acceder 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 de la Google Cloud consola, elige el Google Cloud proyecto. Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.

  3. Realiza una de las siguientes acciones:

    • Para instalar una plantilla desde la biblioteca disponible en la Google Cloud consola, 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 luego, completa el cuadro de diálogo.

      El cuadro de diálogo te permite seleccionar el nombre del panel y agregarle etiquetas.

    • 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

      1. Haz clic en Crear panel.
      2. En la barra de herramientas del panel, Configuración, luego en JSON y, por último, 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": {}
}
      1. En la barra de herramientas del editor, haz clic en upload Subir archivo.
      2. 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.

      1. 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.
      2. 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 la definición del panel sea accesible para tu sistema local.

    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 gcloud monitoring dashboards create comando y proporciona la representación JSON del panel.

    Por ejemplo, para instalar el panel gce-vm-instance-monitoring.json, ejecuta 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. Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.

REST

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

  1. Asegúrate de que la definición del panel sea accesible para tu sistema local.

    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. Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub. Este campo tiene el siguiente formato:

    projects/PROJECT_ID

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

Visualiza 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 Google Cloud consola de Cloud, accede a la  página Paneles:

    Acceder 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 de la Google Cloud consola, elige el Google Cloud proyecto. Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.
  3. En la lista de paneles, haz clic en “Supervisión de instancias de VM de 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:

Ejemplo del panel de Monitoring de la instancia de VM de Compute Engine.

Agrega o quita etiquetas definidas por el usuario

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.

Solo puedes agregar etiquetas a 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 en un panel personalizado, haz lo siguiente:

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

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