Instalar um modelo de painel

O Cloud Monitoring fornece um conjunto selecionado de modelos de painel no GitHub específicos para vários serviços do Google Cloud , como Compute Engine, Cloud Storage, BigQuery e outros. Os gráficos nesses painéis apresentam uma seleção de métricas relevantes para um serviço específico. É possível instalar esses modelos no seu projeto Google Cloud como painéis personalizados usando a API Cloud Monitoring ou o console Google Cloud .

Nesta página, descrevemos como instalar um modelo disponível no console do Google Cloud ou armazenado no repositório monitoring-dashboard-samples do GitHub. Cada modelo é armazenado como um arquivo JSON. Esta página também descreve como acessar o painel no console do Google Cloud .

Esse recurso só é compatível com projetos Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.

Instalar um modelo de painel

Console do Google Cloud

Para instalar um modelo de painel usando o console 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 Google Cloud , selecione seu projeto 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 consoleGoogle 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, selecione o nome do painel e adicione 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

      2. Clique em Criar dashboard.

      3. Na barra de ferramentas do painel, clique em Configurações, depois em JSON e selecione Editor JSON.

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

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

      4. Na barra de ferramentas do editor, clique em Upload de arquivo.

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

      6. Opcional: personalize o painel. Por exemplo, você pode atualizar o título, adicionar um widget de texto que indique a origem do painel, excluir gráficos indesejados ou adicionar gráficos.

      7. Para salvar o dashboard 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 ao seu 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, execute 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.

API Cloud Monitoring

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 ao seu 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 monitor sintético 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.

Acessar 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 Google Cloud , selecione seu projeto 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 a parte do painel instalado:

Exemplo do painel de monitoramento de instâncias de VM do Compute Engine.

Adicionar ou remover rótulos definidos pelo usuário

Os rótulos ajudam a localizar dashboards com base no tipo de conteúdo que eles mostram. Por exemplo, você pode adicionar o rótulo prod aos painéis que mostram informações sobre sistemas de produção. Da mesma forma, você pode adicionar o rótulo staging para indicar que o painel mostra informações sobre sistemas de staging.

Só é possível adicionar rótulos a painéis personalizados. Quando um painel mostra 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 de 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. Faça o seguinte:

    • Para criar um marcador e adicioná-lo ao painel, na seção Criar um novo marcador, digite o nome do marcador 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.