Neste documento, descrevemos como mostrar dados de rastreamento em painéis personalizados. Ao adicionar widgets de trace aos seus painéis, é possível criar uma visualização unificada de solução de problemas que correlaciona latências de período com métricas do sistema e registros de aplicativos.
Para mostrar dados de rastreamento em um painel, adicione um widget específico de rastreamento, use uma opção de salvar na página Explorador de rastreamento ou use a API Cloud Monitoring.
Como visualizar dados de trace
A página Explorador de traces oferece um conjunto pré-configurado de visualizações para solução de problemas. Por padrão, ele mostra um mapa de calor das latências de período e listas de períodos individuais ou agrupados. Para mais informações, consulte Encontrar e analisar traces.
Como os painéis personalizados são modulares, é possível criar uma versão persistente dessa visão abrangente combinando widgets de rastreamento individuais. Por exemplo, você pode adicionar um widget de mapa de calor ao lado de tabelas separadas para intervalos agrupados e individuais. Ao recriar esse layout em um painel, você pode monitorar todos os aspectos dos dados de rastreamento em uma única visualização compartilhada com sua outra telemetria:
Por padrão, os widgets de rastreamento mostram dados dos recursos no seu escopo de rastreamento padrão. No entanto, é possível modificar o escopo de widgets individuais para pesquisar projetos diferentes ou se concentrar em grupos de recursos específicos.
Ao editar um widget de rastreamento, uma versão integrada do Explorador de rastreamentos é aberta. Com ele, é possível adicionar filtros e modificar opções de configuração, assim como faria ao realizar investigações, antes de aplicar as mudanças permanentes aos blocos do painel.
Antes de começar
Para ter as permissões necessárias para mostrar dados de rastreamento em um painel personalizado, peça ao administrador para conceder a você os seguintes papéis do IAM:
- Editor do Monitoring (
roles/monitoring.editor) no projeto. - Usuário do Cloud Trace (
roles/cloudtrace.user) em cada projeto cujas entradas de rastreamento você quer visualizar.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.
É possível incluir até 100 widgets em um painel.
Use a opção de salvar na página Explorador de traces.
O Explorador de rastreamentos oferece várias visualizações dos seus dados de rastreamento. É possível adicionar essas visualizações a um painel para criar uma visualização semelhante.
Para salvar dados do Trace Explorer em um painel personalizado, faça o seguinte:
-
No console Google Cloud , acesse a página
Explorador de traces:
Acessar o Explorador de traces
Também é possível encontrar essa página usando a barra de pesquisa.
Na barra de ferramentas, selecione Salvar no painel.
Selecione o estilo de exibição. Siga uma destas instruções:
- Visualizador: adicione um mapa de calor ao seu painel.
- Tabela de períodos: adicione uma tabela de períodos individuais ao painel.
- Tabela de períodos agrupada: adicione uma tabela de períodos agrupados ao painel.
Selecione ou crie um painel.
Clique em Salvar no painel.
Adicionar um widget de rastreamento a um painel personalizado
Esta seção descreve como mostrar dados de rastreamento em um painel personalizado. Estas instruções são para o console Google Cloud e presumem que você está editando um painel. Para informações sobre como usar a API Cloud Monitoring, consulte Painel que mostra dados de rastreamento.
Para mostrar dados de rastreamento em um painel personalizado, faça o seguinte:
Abra um painel personalizado:
-
No console Google Cloud , acesse a página Painéis:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- 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.
Selecione um painel ou clique em Criar painel.
Se você criar um painel, use o menu Escopo para configurar quais recursos são pesquisados para dados de rastreamento. Por padrão, o sistema pesquisa os recursos no escopo de rastreamento padrão para dados de rastreamento.
-
Na barra de ferramentas, clique em add Adicionar widget.
Na caixa de diálogo Adicionar widget, acesse a seção Dados e selecione Rastreamento.
Configure o widget Trace. É possível mudar a visualização padrão, o título e adicionar filtros.
Para mudar a visualização, na barra de ferramentas, expanda o menu Visualização de gráfico e selecione uma opção:
- Para adicionar um mapa de calor (padrão), selecione Duração do período (mapa de calor).
- Para mostrar a taxa de períodos, selecione Taxa do período (gráfico de linhas).
- Para mostrar os dados de latência, selecione Duração do intervalo (percentil).
- Para listar períodos em formato tabular, selecione Taxa de período (gráfico de linhas) ou Duração do período (percentil) e use o menu Tipo de widget para mostrar uma tabela. Com os seletores, é possível mostrar dados agrupados ou não agrupados.
Para restringir os rastreamentos mostrados, adicione filtros.
Para atualizar o título, digite o novo título no campo Título do widget.
Para aplicar as mudanças ao painel, clique em Aplicar na barra de ferramentas. Para descartar as mudanças, clique em Cancelar.
Para salvar o dashboard modificado, clique em Salvar na barra de ferramentas.
Modificar ou editar um widget que mostra dados de rastreamento
Para modificar um widget, posicione o ponteiro sobre ele para ativar a barra de ferramentas e clique em edit Editar widget.
Um editor do Trace Explorer é aberto. Nessa visualização, é possível adicionar ou remover filtros e modificar as opções de configuração. Em seguida, aplique ou descarte as mudanças no painel.
Limitações
- Os filtros no nível do painel não se aplicam a widgets de rastreamento.
- Não é possível aplicar uma variável à consulta de um widget de rastreamento.