Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Cloud Monitoring fornece um conjunto selecionado de modelos de painel
no GitHub que são específicos para vários Google Cloud serviços, 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 projeto Google Cloud como painéis personalizados usando a API Cloud Monitoring ou o console Google Cloud .
Esta página descreve como instalar um modelo disponível no
consoleGoogle 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 doGoogle Cloud .
Esse recurso é compatível apenas com projetos 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 Google Cloud ,
faça o seguinte:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.
Na barra de ferramentas do console do Google Cloud ,
selecione o projeto 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.
Escolha uma destas opções:
Para instalar um modelo da biblioteca disponível no
consoleGoogle Cloud , faça o seguinte:
Clique em Modelos de painéis.
Encontre o painel que você quer instalar.
Opcional: para visualizar o painel, selecione-o.
Clique em playlist_addAdicionar 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:
Opcional: para instalar um modelo de painel selecionado, faça o download do
repositório do GitHub:
Na barra de ferramentas do editor, clique em Upload de arquivo.
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.
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.
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:
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:
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.
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:
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:
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.
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:
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:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.
Na barra de ferramentas do console do Google Cloud ,
selecione o projeto 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.
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:
Adicionar ou remover rótulos definidos pelo usuário
Os rótulos podem ajudar você 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 sellAdicionar 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:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.
Na lista de painéis, localize o painel e clique em sellAdicionar rótulos ao painel.
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 arrow_drop_downSelecionar rótulos para aplicar,
selecione os rótulos e clique em Ok.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-28 UTC."],[],[],null,["# Install a dashboard template\n\nCloud Monitoring provides a curated set of dashboard templates\non GitHub that are specific to a variety of Google Cloud services, for example\nCompute Engine, Cloud Storage, BigQuery, and others. The charts\non these dashboards present a selection of metrics relevant to a specific\nservice. You can install these templates in your Google Cloud project as\ncustom\ndashboards by using the Cloud Monitoring API or by using the Google Cloud console.\n\nThis page describes how to install a template that is available from the\nGoogle Cloud console or that is stored in the\nGitHub [`monitoring-dashboard-samples` repository](https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples).\nEach template is stored as a JSON file.\nThis page also describes how to view the dashboard in the\nGoogle Cloud console.\n\nThis feature is supported only for Google Cloud projects.\nFor [App Hub](/app-hub/docs/overview)\nconfigurations, select the App Hub host project or\nthe app-enabled folder's management project.\n\nInstall a dashboard template\n----------------------------\n\n**Note:** Some of the dashboards templates stored in the GitHub [`monitoring-dashboard-samples` repository](https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples) display custom metric data. To install these dashboards successfully, you must create the necessary user-defined metrics. For more information, consult the per-service documentation in the repository. \n\n### Google Cloud console\n\n\nTo install a dashboard template by using the Google Cloud console,\ndo the following:\n\n1. In the Google Cloud console, go to the **Dashboards** page:\n\n [Go to **Dashboards**](https://console.cloud.google.com/monitoring/dashboards)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Monitoring**.\n2. In the toolbar of the Google Cloud console,\n select your Google Cloud project. For [App Hub](/app-hub/docs/overview)\n configurations, select the App Hub host project or\n the app-enabled folder's management project.\n\n3. Do one of the following:\n\n - To install a template from the library available in the\n Google Cloud console, do the following:\n\n 1. Click **Dashboard Templates**.\n 2. Find the dashboard that you want to install.\n 3. Optional: To preview the dashboard, select it.\n 4. Click *playlist_add* **Add dashboard to your list** and\n then complete the dialog.\n\n The dialog lets you select the name of the dashboard,\n and add labels to the dashboard.\n - To install a dashboard by uploading a JSON file, do the following:\n\n 1. Optional: To install a curated dashboard template, download the\n GitHub repository:\n\n ```\n git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples.git\n ```\n\n \u003cbr /\u003e\n\n 2. Click **Create Dashboard**.\n\n 3. In the dashboard toolbar, *settings* **Settings** , then\n **JSON** , and then select **JSON Editor**.\n\n For a new dashboard, the displayed code is similar to the following: \n\n ```\n {\n \"displayName\": \"New Dashboard\",\n \"mosaicLayout\": {\n \"columns\": 12,\n \"tiles\": []\n },\n \"dashboardFilters\": [],\n \"labels\": {}\n }\n ```\n 4. In the editor's toolbar, click\n **File Upload**.\n\n 5. Select the file that contains the template and then\n click **Open**.\n\n After the file is uploaded, the dashboard's JSON is updated.\n\n If you see the following message, \"Unable to save dashboard:\n Field mosaicLayout.tiles\\[0\\] has an invalid value\", then select\n **Grid** in the dashboard toolbar.\n 6. Optional: Customize the dashboard. For example, you can update the\n title, add a text widget that indicates the dashboard source, delete\n unwanted charts, or add charts.\n\n 7. To save your modified dashboard, in the toolbar, click **Save**.\n\n\u003cbr /\u003e\n\n### gcloud CLI\n\n\nTo install a dashboard definition by using the Google Cloud CLI, do the\nfollowing:\n\n1. Ensure the dashboard definition is accessible to your local system.\n\n For dashboards stored in the GitHub repository, you can save specific\n dashboards, or you can download the entire repository: \n\n git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples.git\n\n2. Identify the dashboards you want to install.\n\n For example, in the GitHub\n repository, the directory `monitoring-dashboard-samples/dashboards/compute`\n contains a file named `gce-vm-instance-monitoring.json`.\n3. Issue the [`gcloud monitoring dashboards create`](/sdk/gcloud/reference/monitoring/dashboards/create)\n command and provide the JSON representation of the dashboard.\n\n For example, to install the dashboard `gce-vm-instance-monitoring.json`,\n issue the following command: \n\n gcloud monitoring dashboards create --config-from-file=gce-vm-instance-monitoring.json --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\n\n Before you run the previous command, replace the following:\n - \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: The identifier of the project. For [App Hub](/app-hub/docs/overview) configurations, select the App Hub host project or the app-enabled folder's management project.\n\n\u003cbr /\u003e\n\n### Cloud Monitoring API\n\n\nTo install a dashboard definition by using the Google Cloud CLI, do the\nfollowing:\n\n1. Ensure the dashboard definition is accessible to your local system.\n\n For dashboards stored in the GitHub repository, you can save specific\n dashboards, or you can download the entire repository: \n\n git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples.git\n\n2. Identify the dashboards you want to install.\n\n For example, in the GitHub\n repository, the directory `monitoring-dashboard-samples/dashboards/compute`\n contains a file named `gce-vm-instance-monitoring.json`.\n3. Call [`dashboards.create`](/monitoring/api/ref_v3/rest/v1/projects.dashboards/create) and provide the\n JSON representation of the dashboard. In the API call, the parent is\n the project in which to create the synthetic monitor.\n For [App Hub](/app-hub/docs/overview)\n configurations, select the App Hub host project or\n the app-enabled folder's management project. This field has the following format:\n\n projects/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\n\nFor more information, see\n[Create and manage dashboards](/monitoring/dashboards/api-dashboard).\n\n\u003cbr /\u003e\n\nView the installed dashboard\n----------------------------\n\nEach file in the repository creates a new custom dashboard. For example,\nthe file `gce-vm-instance-monitoring.json` creates a dashboard with the title\n\"GCE VM Instance Monitoring\". To view this dashboard, do the following:\n\n1. In the Google Cloud console, go to the **Dashboards** page:\n\n [Go to **Dashboards**](https://console.cloud.google.com/monitoring/dashboards)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Monitoring**.\n2. In the toolbar of the Google Cloud console, select your Google Cloud project. For [App Hub](/app-hub/docs/overview) configurations, select the App Hub host project or the app-enabled folder's management project.\n3. In the list of dashboards, click \"GCE VM Instance Monitoring\". If you have a lot of dashboards, then you might want to filter for custom dashboards or for the name of the new dashboard.\n\nThe following screenshot shows the part of the installed dashboard:\n\nAdd or remove user-defined labels\n---------------------------------\n\nLabels can help you locate dashboards based on the type of content\nthey display. For example, you might add the label `prod` to dashboards\nthat display information about production systems. Similarly, you might\nadd the label `staging` to indicate the dashboard displays information\nabout staging systems.\n\nYou can add labels only to custom dashboards. When a dashboard displays the\nsell **Add labels to dashboard** button, then you can\nconfigure which labels are applied to the dashboard.\n\nTo add or remove user-defined labels to a custom dashboard, do the following:\n\n1. In the Google Cloud console, go to the **Dashboards** page:\n\n [Go to **Dashboards**](https://console.cloud.google.com/monitoring/dashboards)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Monitoring**.\n2. In the list of dashboards, locate the dashboard and then click sell **Add labels to dashboard**.\n3. Do one of the following:\n - To create a label and add it to your dashboard,\n in the **Create a new label** section, enter the name of the label\n in the textbox and then click **Create and apply**.\n\n - To configure which labels are added to your dashboard, click *arrow_drop_down* **Select labels to apply** , select the labels, and then click **Ok**.\n4. To save your changes, click **Confirm**."]]