Instalar um modelo de painel

O Cloud Monitoring fornece um conjunto selecionado de modelos de painel no GitHub que são específicos para vários serviços Google Cloud , por exemplo, 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 do Google Cloud como painéis personalizados usando a API Cloud Monitoring ou o console do Google Cloud.

Esta página descreve 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 visualizar o painel no console do Google Cloud.

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

Instalar um modelo de painel

Console do Google Cloud

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

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

    Ir para Painéis

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

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

  3. Escolha uma destas opções:

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

      1. Clique em Modelos de painéis.
      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.

        A caixa de diálogo permite 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

      2. Clique em Criar dashboard.

      3. Na barra de ferramentas do painel, Configurações, 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 painel modificado, clique em Salvar na barra de ferramentas.

CLI da gcloud

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

  1. Verifique se a definição do painel pode ser acessada pelo 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, emitir 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 as configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta ativada por apps.

API Cloud Monitoring

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

  1. Verifique se a definição do painel pode ser acessada pelo 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 as configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta ativada por apps. Esse campo tem o seguinte formato:

    projects/PROJECT_ID
    

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

Conferir 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 do Google Cloud, acesse a página  Painéis:

    Ir para Painéis

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

  2. Na barra de ferramentas do console do Google Cloud, selecione seu projeto. Para as configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta ativada por apps.
  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, é possível adicionar o rótulo prod a 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 preparação.

É possível adicionar rótulos apenas 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 do Google Cloud, acesse a página  Painéis:

    Ir para Painéis

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

  2. Na lista de painéis, localize o painel e clique em Adicionar rótulos ao painel.
  3. Faça uma das seguintes ações:
    • Para criar um marcador e adicioná-lo ao seu 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 seu 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.