Instalar um modelo de painel

Os modelos de painel no Cloud Monitoring permitem configurar rapidamente painéis personalizados com gráficos pré-configurados para serviços do Google Cloud , como Compute Engine, Cloud Storage e BigQuery. É possível instalar modelos JSON da biblioteca de modelos no console do Google Cloud . Também é possível instalar modelos do repositório do GitHub monitoring-dashboard-samples usando o console do Google Cloud , a Google Cloud CLI ou a API Cloud Monitoring.

Instalar um modelo de painel

Observação :alguns dos modelos de painel armazenados no repositório monitoring-dashboard-samples do GitHub exibem dados de métrica personalizada. Para instalar esses painéis, é preciso criar as métricas definidas pelo usuário necessárias. Para mais informações, consulte a documentação de cada serviço no repositório.

Console do Google Cloud

Para instalar um modelo de painel usando o console do Google Cloud , faça o seguinte:

1. No console Google Cloud , acesse a página  Painéis:

   Acesse Painéis

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

2. Na barra de ferramentas do console do Google Cloud , selecione seu projeto do Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.

3. Escolha uma destas opções:

   • Para instalar um modelo da biblioteca disponível no console doGoogle Cloud , faça o seguinte:

     1. Clique em Modelos de painel.
     2. Encontre o painel que você quer instalar.
     3. Opcional: para visualizar o painel, selecione-o.
     4. Clique em Adicionar painel à sua lista e preencha a caixa de diálogo.

     Na caixa de diálogo, é possível selecionar o nome do painel e adicionar rótulos a ele.

   • Para instalar um painel fazendo upload de um arquivo JSON, faça o seguinte:

     1. Opcional: para instalar um modelo de painel selecionado, faça o download do repositório do GitHub:

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

     1. Clique em Criar dashboard.
     2. Na barra de ferramentas do painel, clique em Configurações, selecione JSON e, em seguida, Editor JSON.

     O código exibido para um novo painel é semelhante ao seguinte:

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

     1. Na barra de ferramentas do editor, clique em upload Upload de arquivo.
     2. Selecione o arquivo que contém o modelo e clique em Abrir.

     Depois do upload do arquivo, o JSON do painel é atualizado.

     Caso você veja a mensagem "Não foi possível salvar o painel: o campo mosaicLayout.tiles[0] tem um valor inválido", selecione Grid na barra de ferramentas do painel.

     1. Opcional: personalize o painel. Por exemplo, é possível atualizar o título, adicionar um widget de texto que indica a origem do painel, excluir gráficos indesejados ou adicionar gráficos.
     2. Para salvar o painel modificado, clique em Salvar na barra de ferramentas.

CLI da gcloud

Para instalar uma definição de painel usando a Google Cloud CLI, faça o seguinte:

1. Verifique se a definição do painel está acessível para o sistema local.

   Para painéis armazenados no repositório do GitHub, é possível salvar painéis específicos ou fazer o download de todo o repositório:

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

2. Identifique os painéis que você quer instalar.

   Por exemplo, no repositório do GitHub, o diretório monitoring-dashboard-samples/dashboards/compute contém um arquivo chamado gce-vm-instance-monitoring.json.

3. Emita o comando gcloud monitoring dashboards create e forneça a representação JSON do painel.

   Por exemplo, para instalar o painel gce-vm-instance-monitoring.json, emita o seguinte comando:

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

   Antes de executar o comando anterior, substitua o seguinte:

   • PROJECT_ID: o identificador do projeto. Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.

REST

Para instalar uma definição de painel usando a API Cloud Monitoring, faça o seguinte:

1. Verifique se a definição do painel está acessível para o sistema local.

   Para painéis armazenados no repositório do GitHub, é possível salvar painéis específicos ou fazer o download de todo o repositório:

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

2. Identifique os painéis que você quer instalar.

   Por exemplo, no repositório do GitHub, o diretório monitoring-dashboard-samples/dashboards/compute contém um arquivo chamado gce-vm-instance-monitoring.json.

3. Chame dashboards.create e forneça a representação JSON do painel. Na chamada de API, o pai é o projeto em que o painel será criado. Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub. Esse campo tem o seguinte formato:

   projects/PROJECT_ID
   

Para mais informações, consulte Criar e gerenciar painéis.

Consultar o painel instalado

Cada arquivo no repositório cria um novo painel personalizado. Por exemplo, o arquivo gce-vm-instance-monitoring.json cria um painel com o título "GCE VM Instance Monitoring". Para acessar esse painel, faça o seguinte:

1. No console Google Cloud , acesse a página  Painéis:

   Acesse Painéis

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

2. Na barra de ferramentas do console do Google Cloud , selecione seu projeto do Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.
3. Na lista de painéis, clique em "Monitoramento de instâncias de VM do GCE". Se você tiver muitos painéis, filtre por painéis personalizados ou pelo nome do novo painel.

A captura de tela a seguir mostra parte do painel instalado:

Adicionar ou remover rótulos definidos pelo usuário

Os rótulos podem ajudar você a localizar painéis com base no tipo de conteúdo que eles exibem. Por exemplo, é possível adicionar o rótulo prod aos painéis que exibem informações sobre sistemas de produção. Da mesma forma, é possível adicionar o rótulo staging para indicar que o painel exibe informações sobre sistemas de preparo.

Só é possível adicionar rótulos a painéis personalizados. Quando um painel exibe o botão Adicionar rótulos ao painel, é possível configurar quais rótulos são aplicados ao painel.

Para adicionar ou remover rótulos definidos pelo usuário em um painel personalizado, faça o seguinte:

1. No console Google Cloud , acesse a página  Painéis:

   Acesse Painéis

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

2. Na lista de painéis, localize o painel e clique em Adicionar rótulos ao painel.
3. Siga uma destas opções:

   • Para criar um rótulo e adicioná-lo ao painel, na seção Criar um novo rótulo, insira o nome do rótulo na caixa de texto e clique em Criar e aplicar.

   • Para configurar quais rótulos são adicionados ao painel, clique em Selecionar rótulos para aplicar, selecione os rótulos e clique em Ok.
4. Para salvar as mudanças, clique em Confirmar.